Copiar uma imagem personalizada do WorkSpaces

Você pode copiar uma imagem personalizada do WorkSpaces em uma região ou entre regiões da AWS. A cópia de uma imagem resulta na criação de uma imagem idêntica, mas com seu próprio identificador exclusivo.

É possível copiar uma imagem BYOL (Bring Your Own License) para outra região, desde que a região de destino esteja habilitada para BYOL. O BYOL deve estar habilitado para todas as contas e regiões envolvidas.

nota

Na região China (Ningxia), só é possível copiar imagens dentro da mesma região.

Nas regiões AWS GovCloud (EUA), para copiar imagens de e para outras regiões da AWS, entre em contato com o AWS Support.

Em regiões Opt-in, para copiar imagens para outras regiões, entre em contato com o AWS Support. Para obter mais informações sobre as regiões Opt-in disponíveis, consulte a Regiões disponíveis.

Também é possível copiar uma imagem que tenha sido compartilhada com você por outra conta da AWS. Para obter mais informações sobre imagens compartilhadas, consulte Compartilhar ou cancelar o compartilhamento de uma imagem personalizada do WorkSpaces.

Não há cobrança adicional para a cópia de imagens dentro ou entre regiões. No entanto, é aplicada a cota de número de imagens na região de destino. Para obter mais informações sobre cotas do Amazon WorkSpaces, consulte WorkSpaces Cotas da Amazon.

Permissões do IAM para a cópia de imagens

Se você usar um usuário do IAM para copiar uma imagem, o usuário deverá ter permissões para workspaces:DescribeWorkspaceImages e workspaces:CopyWorkspaceImage.

A política de exemplo a seguir permite que o usuário copie a imagem especificada para a conta especificada na região especificada.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "workspaces:DescribeWorkspaceImages",
        "workspaces:CopyWorkspaceImage"
      ],
      "Resource": [
          "arn:aws:workspaces:us-east-1:123456789012:workspaceimage/wsi-a1bcd2efg"
      ]
    }
  ]
}

Importante

Se você estiver criando uma política do IAM para copiar imagens compartilhadas para contas que não possuem as imagens, não é possível especificar um ID de conta no ARN. Em vez disso, você deve usar * como o ID da conta, conforme exibido no exemplo de política a seguir.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "workspaces:DescribeWorkspaceImages",
        "workspaces:CopyWorkspaceImage"
      ],
      "Resource": [
          "arn:aws:workspaces:us-east-1:*:workspaceimage/wsi-a1bcd2efg"
      ]
    }
  ]
}

É possível especificar um ID de conta no ARN somente quando essa conta possui as imagens a serem copiadas.

Para obter mais informações sobre como trabalhar com o IAM, consulte Gerenciamento de identidade e acesso para o WorkSpaces.

Cópia de imagens em massa

É possível copiar imagens uma a uma usando o console. Para copiar imagens em massa, use a operação de API CopyWorkspaceImage ou o comando copy-workspace-image no AWS Command Line Interface (AWS CLI). Para obter mais informações, consulte CopyWorkspaceImage na Referência da API do Amazon WorkSpaces ou consulte copy-workspace-image na Referência de comando da AWS CLI.

Importante

Antes de copiar uma imagem compartilhada, verifique se ela foi compartilhada da conta da AWS correta. Para determinar se uma imagem foi compartilhada e ver o ID da conta da AWS que possui uma imagem, use as operações da API DescribeWorkSpaceImages e DescribeWorkspaceImagePermissions ou os comandos describe-workspace-images and describe-workspace-image-permissions na AWS CLI.

Como copiar uma imagem usando o console

1. Abra o console do WorkSpaces em https://console.aws.amazon.com/workspaces/.

2. No painel de navegação, selecione Images (Imagens).

3. Selecione a imagem e escolha Ações, Copiar imagem.

4. Em Selecionar destino, selecione a região da AWS para a qual você deseja copiar a imagem.

5. Em Nome da cópia, insira o novo nome para a imagem copiada e, em Descrição, insira uma descrição para ela.

6. (Opcional) Em Tags, insira etiquetas para a imagem copiada. Para obter mais informações, consulte Marcar recursos do WorkSpaces.

7. Escolha Copiar imagem.