Comment puis-je partager des images WorkSpaces ou des images BYOL avec d'autres comptes AWS ?

Résolution

Vous pouvez partager des images WorkSpaces personnalisées entre plusieurs comptes AWS au sein d'une même région. Une fois que vous avez partagé une image WorkSpaces, le compte destinataire peut la copier dans d'autres régions si nécessaire. Pour gérer vous-même les transferts d'images WorkSpaces, utilisez la console WorkSpaces ou l'interface de ligne de commande AWS (AWS CLI).

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes AWS CLI, consultez la section Résoudre les erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Les images BYOL ne peuvent être partagées qu'avec d'autres comptes ayant le même ID de compte AWS payeur. Pour copier une image BYOL dans une autre région, la région de destination doit être configurée pour les images BYOL.

Partager une image à l'aide de la console WorkSpaces

Utilisez la console WorkSpaces pour partager ou annuler le partage d'une image avec d'autres comptes de la même région. Pour obtenir des instructions, consultez la section Partager ou annuler le partage d'une image personnalisée dans WorkSpaces Personal.

Partager une image à l'aide de l'interface de ligne de commande AWS

Partagez ou annulez le partage d'images par programmation à l'aide d'appels d'API et de l'interface de ligne de commande AWS.

Important : Dans le processus suivant, les commandes requièrent la version 2 de l'AWS CLI. Pour les instructions d'installation, consultez la section Installation ou mise à jour de la dernière version de l'AWS CLI.

Pour copier une image WorkSpaces vers un autre compte au sein de la même région, procédez comme suit :

1. À partir du compte source, identifiez l'ID de l'image source. Exécutez la commande suivante et remplacez region-code par le code de région WorkSpaces :

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

   Puis, notez l'ImageId de la sortie.

2. Depuis le compte source, appelez l'API UpdateWorkspaceImagePermission pour partager l'image source avec le compte cible. Exécutez la commande suivante et remplacez ImageId par la sortie de l'étape 1. Remplacez également region-code par le code de région WorkSpaces et target-account par le numéro de compte cible :

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

3. (Facultatif) À partir du compte source, appelez l'API DescribeWorkspaceImagePermissions pour voir les autorisations et vérifier que l'image est partagée avec le compte cible. Exécutez la commande suivante et remplacez ImageId et region-code par vos valeurs :

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

4. (Facultatif) À partir du compte cible, appelez l'API DescribeWorkspaceImages pour voir l'image partagée. Exécutez la commande suivante et remplacez ImageId et region-code par vos valeurs :

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

5. À partir du compte cible, appelez l'API CopyWorkspaceImage pour copier l'image partagée. Exécutez la commande suivante et remplacez ImageId et region-code par vos valeurs. Remplacez également new-image-name par le nom que vous souhaitez utiliser pour l'image sur le compte cible :

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

   Le compte cible peut maintenant voir la nouvelle image dans la console WorkSpaces. Il faut généralement au flux de travail environ 15 minutes pour se terminer et voir l'état de l'image passer de En attente à Disponible.

Informations connexes

Comment puis-je créer une image WorkSpaces ?

Copier une image personnalisée dans WorkSpaces Personal