¿Cómo comparto imágenes de WorkSpaces o imágenes BYOL con otras cuentas de AWS?

Resolución

Puede compartir imágenes personalizadas de WorkSpaces entre cuentas de AWS de la misma región. Después de compartir una imagen de WorkSpaces, la cuenta del destinatario puede copiarla a otras regiones según sea necesario. Puede autogestionar las transferencias de imágenes de WorkSpaces mediante la consola de WorkSpaces o la Interfaz de la línea de comandos de AWS (AWS CLI).

Las imágenes BYOL solo se pueden compartir con otras cuentas que tengan el mismo ID de cuenta de pago de AWS. Para copiar una imagen BYOL a otra región, la región de destino debe estar configurada para las imágenes BYOL.

Compartir una imagen mediante la consola de WorkSpaces

Puede usar la consola de WorkSpaces para compartir o dejar de compartir una imagen con otras cuentas de la misma región. Para obtener instrucciones, consulte Compartir o dejar de compartir una imagen personalizada de WorkSpaces.

Compartir una imagen mediante la AWS CLI

Puede compartir o dejar de compartir imágenes mediante programación con llamadas a la API y la AWS CLI.

Importante: Los comandos del siguiente proceso requieren la versión 2 de la AWS CLI. Para obtener instrucciones de instalación, consulte Instalación o actualización de la versión más reciente de la AWS CLI.

Para copiar una imagen de WorkSpaces a otra cuenta de la misma región, siga estos pasos:

1.    En la cuenta de origen, identifique el identificador de imagen de la imagen de origen. Ejecute el siguiente comando y sustituya region-code por el código de región de WorkSpaces:

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

A continuación, anote el ImageId del resultado.

2.    En la cuenta de origen, llame a la API UpdateWorkspaceImagePermission para compartir la imagen de origen con la cuenta de destino. Ejecute el siguiente comando y sustituya ImageId por el resultado del paso 1, region-code por el código de región de WorkSpaces y target-account por el número de cuenta de destino:

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

3.    (Opcional) En la cuenta de origen, llame a la API DescribeWorkspaceImagePermissions para ver los permisos y comprobar que la imagen se comparte con la cuenta de destino. Ejecute el siguiente comando y sustituya ImageId y region-code por sus valores:

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

4.    (Opcional) En la cuenta de destino, llame a la API DescribeWorkspaceImages para ver la imagen compartida. Ejecute el siguiente comando y sustituya ImageId y region-code por sus valores:

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

5.    En la cuenta de destino, llame a la API CopyWorkspaceImage para copiar la imagen compartida. Ejecute el siguiente comando y sustituya ImageId y region-code por sus valores. Además, sustituya new-image-name por el nombre que quiera usar para la imagen en la cuenta de destino:

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

La cuenta de destino ahora puede ver la nueva imagen en la consola de WorkSpaces. El estado de la imagen pasa de Pendiente a Disponible una vez finalizado el flujo de trabajo, lo que suele tardar unos 15 minutos.

Información relacionada

¿Cómo creo una imagen de WorkSpaces?

Copiar una imagen personalizada de WorkSpaces