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

Resolución

Puedes 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. Para autogestionar las transferencias de imágenes de WorkSpaces, usa la consola de WorkSpaces o Interfaz de la línea de comandos de AWS (AWS CLI).

**Nota:**Si se muestran errores al usar comandos de AWS CLI, consulta Solución de errores para AWS CLI. Además, asegúrate de utilizar la versión más reciente de 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

Usa la consola de WorkSpaces para compartir o dejar de compartir una imagen con otras cuentas de la misma región. Para obtener instrucciones, consulta Share or unshare a custom image in WorkSpaces Personal.

Compartir una imagen mediante AWS CLI

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

Importante: Los comandos del siguiente proceso requieren la versión 2 de AWS CLI. Para obtener instrucciones de instalación, consulta Installing or updating to the latest version of the AWS CLI.

Para copiar una imagen de WorkSpaces a una cuenta diferente dentro de la misma región, sigue estos pasos:

1. En la cuenta de origen, busca el ID de imagen de la imagen de origen. Usa el siguiente comando y sustituye region-code por el código de región de WorkSpaces:

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

   A continuación, anota el ImageId del resultado.

2. En la cuenta de origen, llama a la API UpdateWorkspaceImagePermission para compartir la imagen de origen con la cuenta de destino. Usa el siguiente comando y sustituye ImageId por el resultado del paso 1. Además, sustituye el region-code por el código de región de WorkSpaces y target-account por el número de la 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, llama a la API DescribeWorkspaceImagePermissions para ver los permisos y comprobar que la imagen se comparte con la cuenta de destino. Usa el siguiente comando y sustituye ImageId y region-code por tus valores:

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

4. (Opcional) En la cuenta de destino, llama a la API DescribeWorkspaceImages para ver la imagen compartida. Usa el siguiente comando y sustituye ImageId y region-code por tus valores:

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

5. En la cuenta de destino, llama a la API CopyWorkspaceImage para copiar la imagen compartida. Usa el siguiente comando y sustituye ImageId y region-code por tus valores. Además, sustituye new-image-name por el nombre que quieras 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. Por lo general, el flujo de trabajo tarda unos 15 minutos en completarse y el estado de la imagen pasa de Pendiente a Disponible.

Información relacionada

¿Cómo creo una imagen de WorkSpaces?

Copy a custom image in WorkSpaces Personal