Wie kann ich WorkSpaces-Bilder oder BYOL-Bilder für andere AWS-Konten freigeben?

Behebung

Du kannst benutzerdefinierte WorkSpaces-Bilder in AWS-Konten innerhalb derselben Region gemeinsam nutzen. Nachdem du ein WorkSpaces-Bild freigegeben hast, kann das Empfängerkonto das Bild nach Bedarf in andere Regionen kopieren. Verwende die WorkSpaces-Konsole oder die AWS Command Line Interface (AWS CLI), um WorkSpaces-Bild-Übertragungen selbst zu verwalten.

Hinweis: Wenn du beim Ausführen von AWS CLI-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

BYOL-Bilder können nur für andere Konten mit der gleichen AWS-Zahler-Konto-ID freigegeben werden. Um ein BYOL-Bild in eine andere Region zu kopieren, muss die Zielregion für BYOL-Bilder eingerichtet sein.

Freigabe eines Bildes über die WorkSpaces-Konsole

Verwende die WorkSpaces-Konsole, um ein Bild für andere Konten in derselben Region freizugeben oder die Freigabe aufzuheben. Anweisungen findest du unter Freigabe oder Aufheben der Freigabe eines benutzerdefinierten Bildes in WorkSpaces Personal.

Freigeben eines Bildes mit der AWS CLI

Du kannst Bilder mithilfe von API-Aufrufen und der AWS CLI programmatisch freigeben oder die Freigabe aufheben.

Wichtig: Im folgenden Prozess benötigen die Befehle Version 2 der AWS-CLI. Anweisungen zur Installation findest du unter Installieren oder Aktualisieren der neuesten Version der AWS CLI.

Gehe wie folgt vor, um ein WorkSpaces-Bild in ein anderes Konto innerhalb derselben Region zu kopieren:

1. Identifiziere im Quellkonto die Bild-ID für das Quell-Bild. Führe den folgenden Befehl aus und ersetze region-code durch den Regionscode der WorkSpaces:

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

   Notiere dir dann die ImageId aus der Ausgabe.

2. Rufe vom Quellkonto aus die API UpdateWorkspaceImagePermission auf, um das Quell-Bild für das Zielkonto freizugeben. Führe den folgenden Befehl aus und ersetze ImageID durch die Ausgabe aus Schritt 1. Ersetze außerdem region-code durch den WorkSpaces-Regionscode und target-account durch die Zielkontonummer:

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

3. (Optional) Rufe vom Quellkonto aus die API DescribeWorkspaceImagePermissions auf, um die Berechtigungen anzuzeigen und zu überprüfen, ob das Bild für das Zielkonto freigegeben ist. Führe den folgenden Befehl aus und ersetze ImageId und region-code durch deine Werte:

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

4. (Optional) Rufe vom Zielkonto aus die API DescribeWorkspaceImages auf, um das freigegebene Bild anzuzeigen. Führe den folgenden Befehl aus und ersetze ImageId und region-code durch deine Werte:

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

5. Rufe vom Zielkonto aus die API CopyWorkspaceImage auf, um das freigegebene Bild zu kopieren. Führe den folgenden Befehl aus und ersetze ImageId und region-code durch deine Werte. Ersetze außerdem new-image-name durch den Namen, den du für das Bild im Zielkonto verwenden möchtest:

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

   Das Zielkonto kann nun das neue Bild in der WorkSpaces-Konsole sehen. In der Regel dauert es etwa 15 Minuten, bis der Workflow abgeschlossen ist und der Bild-Status von Ausstehend zu Available (Verfügbar) wechselt.

Ähnliche Informationen

Wie erstelle ich ein WorkSpaces-Bild?

Ein benutzerdefiniertes Bild in WorkSpaces Personal kopieren