Come faccio a condividere immagini WorkSpaces o immagini BYOL con altri account AWS?

Soluzione

È possibile condividere immagini WorkSpaces personalizzate tra account AWS all'interno della stessa Regione. Dopo aver condiviso un'immagine di WorkSpaces, l'account destinatario può copiare l'immagine in altre Regioni, se necessario. Per gestire autonomamente i trasferimenti di immagini di WorkSpaces, utilizza la console WorkSpaces o l'interfaccia della linea di comando AWS (AWS CLI).

Nota: se ricevi messaggi di errore quando esegui i comandi dell'interfaccia della linea di comando AWS (AWS CLI), consulta Troubleshooting errors for the AWS CLI (Risoluzione degli errori per AWS CLI). Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Le immagini BYOL possono essere condivise solo con altri account con lo stesso ID account di pagamento AWS. Per copiare un'immagine BYOL in un'altra Regione, la Regione di destinazione deve essere impostata per le immagini BYOL.

Condivisione di un'immagine utilizzando la console WorkSpaces

Utilizza la console WorkSpaces per condividere o annullare la condivisione di un'immagine con altri account nella stessa Regione. Per istruzioni, consulta Share or unshare a custom image in WorkSpaces Personal (Condivisione o annullamento della condivisione di un'immagine personalizzata in WorkSpaces Personal).

Condivisione di un'immagine utilizzando l'interfaccia della linea di comando AWS (AWS CLI)

Condivi o annulla la condivisione di immagini a livello di codice utilizzando le chiamate API e l'interfaccia della linea di comando AWS (AWS CLI).

Importante: nel seguente processo, i comandi richiedono la versione 2 dell'interfaccia della linea di comando AWS (AWS CLI). Per le istruzioni di installazione, consulta Installing or updating to the latest version of the AWS CLI (Installazione o aggiornamento della versione più recente dell'interfaccia della linea di comando AWS).

Per copiare un'immagine di WorkSpaces su un altro account all'interno della stessa Regione, completa le seguenti operazioni:

1. Dall'account di origine, identifica l'ID dell'immagine di origine. Esegui il comando seguente e sostituisci region-code con il codice Regione di WorkSpaces:

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

   Quindi, prendi nota dell'ImageId dall'output.

2. Dall'account di origine, chiama l'API UpdateWorkspaceImagePermission per condividere l'immagine di origine con l'account di destinazione. Esegui il seguente comando e sostituisci ImageId con l'output del passaggio 1. Inoltre, sostituisci region-code con il codice Regione di WorkSpaces e target-account con il numero dell'account di destinazione:

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

3. (Facoltativo) Dall'account di origine, chiama l'API DescribeWorkspaceImagePermissions per visualizzare le autorizzazioni e verificare che l'immagine sia condivisa con l'account di destinazione. Esegui il comando seguente e sostituisci ImageId e region-code con i tuoi valori:

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

4. (Facoltativo) Dall'account di destinazione, chiama l'API DescribeWorkspaceImages per visualizzare l'immagine condivisa. Esegui il comando seguente e sostituisci ImageId e region-code con i tuoi valori:

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

5. Dall'account di destinazione, chiama l'API CopyWorkspaceImage per copiare l'immagine condivisa. Esegui il comando seguente e sostituisci ImageId e region-code con i tuoi valori. Inoltre, sostituisci new-image-name con il nome che desideri utilizzare per l'immagine sull'account di destinazione:

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

   L'account di destinazione può ora visualizzare la nuova immagine nella console di WorkSpaces. In genere sono necessari circa 15 minuti perché il flusso di lavoro sia completato e lo stato dell'immagine passi da In attesa a Disponibile.

Informazioni correlate

Come posso creare un'immagine WorkSpaces?

Copy a custom image in WorkSpaces Personal (Copia di un'immagine personalizzata in WorkSpaces Personal)