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).

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 do WorkSpaces.

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 outra conta na mesma região, siga estas 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, substituindo ImageId pelo resultado da etapa 1, region-code pelo código de região WorkSpaces e target-account 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. O estado da imagem passa de Pendente para Disponível após a conclusão do fluxo de trabalho, o que normalmente leva cerca de 15 minutos.

Informações relacionadas

Como faço para criar uma imagem do WorkSpaces?

Copie uma imagem personalizada do WorkSpaces