Como faço para compartilhar imagens do WorkSpaces ou imagens BYOL com outras contas da AWS?

Resolução

Você pode compartilhar imagens personalizadas do WorkSpaces entre contas da AWS na mesma região. Depois que uma imagem do WorkSpaces é compartilhada, a conta do destinatário pode copiar a imagem para outras regiões, conforme necessário. Você pode autogerenciar as transferências de imagens do WorkSpaces usando o console do WorkSpaces ou a AWS Command Line Interface (AWS CLI).

Observação: se você receber erros ao executar comandos da AWS CLI, consulte Solucionar erros da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

As imagens BYOL só podem ser compartilhadas com outras contas com o mesmo ID da conta de pagador da AWS. Para copiar uma imagem BYOL para outra região, a região de destino deve ser configurada para aceitar imagens BYOL.

Compartilhar uma imagem usando o console do WorkSpaces

Você pode usar o console do WorkSpaces para compartilhar ou cancelar o compartilhamento de uma imagem com outras contas na mesma região. Para obter instruções, consulte Compartilhar ou cancelar o compartilhamento de uma imagem personalizada no WorkSpaces Personal.

Compartilhar uma imagem usando o AWS CLI

Você pode compartilhar ou cancelar o compartilhamento de imagens de forma programática usando chamadas de API e o AWS CLI.

Importante: os comandos do processo a seguir exigem a versão 2 da AWS CLI. Para obter instruções de instalação, consulte Instalar ou atualizar a versão mais recente do AWS CLI.

Para copiar uma imagem do WorkSpaces para uma conta diferente na mesma região, conclua as seguintes etapas:

1. Na conta de origem, identifique o ID da imagem de origem. Execute o comando a seguir, substituindo region-code pelo Código da região do WorkSpaces:

   aws workspaces describe-workspace-images --region region-code

   Em seguida, anote o ImageId da saída.

2. Na conta de origem, chame a API UpdateWorkspaceImagePermission para compartilhar a imagem de origem com a conta de destino. Execute o comando a seguir e substitua ImageID pela saída da etapa 1. Além disso, substitua o código da região pelo código da região do WorkSpaces e a conta-alvo pelo número da conta de destino:

   aws workspaces update-workspace-image-permission --image-id ImageId --region region-code --shared-account-id target-account --allow-copy-image

3. (Opcional) Na conta de origem, chame a API DescribeWorkspaceImagePermissions para ver as permissões e verificar se a imagem foi compartilhada com a conta de destino. Execute o comando a seguir, substituindo ImageId e region-code por seus valores:

   aws workspaces describe-workspace-image-permissions --image-id ImageId --region region-code

4. (Opcional) Na conta de destino, chame a API DescribeWorkspaceImages para ver a imagem compartilhada. Execute o comando a seguir, substituindo ImageId e region-code por seus valores:

   aws workspaces describe-workspace-images --image-ids ImageId --region region-code --image-type SHARED

5. Na conta de destino, chame a API CopyWorkspaceImage para copiar a imagem compartilhada. Execute o comando a seguir, substituindo ImageId e region-code por seus valores. Além disso, substitua new-image-name pelo nome que você deseja usar para a imagem na conta de destino:

   aws workspaces copy-workspace-image --source-image-id ImageId --source-region region-code --name new-image-name --region region-code

   A conta de destino agora pode ver a nova imagem no console do WorkSpaces. Normalmente, leva cerca de 15 minutos para que o fluxo de trabalho seja concluído e para que o estado da imagem passe de Pendente para Disponível.

Informações relacionadas

Como faço para criar uma imagem do WorkSpaces?

Copiar uma imagem personalizada no WorkSpaces Personal