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

Lesedauer: 3 Minute
0

Ich möchte ein Amazon WorkSpaces-Bild oder ein WorkSpaces Bring Your Own License (BYOL)-Image für einen anderen Amazon Web Services (AWS)-Konto in derselben AWS-Region freigeben. Wie muss ich dazu vorgehen?

Behebung

Sie können benutzerdefinierte WorkSpaces-Images in AWS-Konten innerhalb derselben Region gemeinsam nutzen. Nachdem ein WorkSpaces-Bild freigegeben wurde, kann das Empfängerkonto das Bild nach Bedarf in andere Regionen kopieren. Sie können Übertragungen von WorkSpaces-Bildern über die WorkSpaces-Konsole oder die AWS Command Line Interface (AWS CLI) selbst verwalten.

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

Sie können die WorkSpaces-Konsole verwenden, um ein Bild für andere Konten in derselben Region freizugeben oder die Freigabe aufzuheben. Anweisungen finden Sie unter Freigeben oder Aufheben der Freigabe eines benutzerdefinierten WorkSpaces-Bildes.

Freigeben eines Bildes mit der AWS CLI

Sie können Bilder mithilfe von API-Aufrufen und der AWS CLI programmatisch freigeben oder die Freigabe aufheben.

Wichtig: Die Befehle im folgenden Verfahren erfordern Version 2 der AWS CLI. Anweisungen zur Installation finden Sie unter Installieren oder Aktualisieren der neuesten Version der AWS CLI.

Gehen Sie folgendermaßen vor, um ein WorkSpaces-Bild auf ein anderes Konto innerhalb derselben Region zu kopieren:

1.    Identifizieren Sie im Quellkonto die Bild-ID für das Quell-Bild. Führen Sie den folgenden Befehl aus und ersetzen Sie region-code durch den WorkSpaces-Regionscode:

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

Notieren Sie sich dann die ImageId aus der Ausgabe.

2.    Rufen Sie vom Quellkonto aus die API UpdateWorkspaceImagePermission auf, um das Quell-Bild für das Zielkonto freizugeben. Führen Sie den folgenden Befehl aus und ersetzen Sie dabei ImageId durch die Ausgabe aus Schritt 1, region-code durch den WorkSpaces-Regionscode und target-account durch die Nummer des Zielkontos:

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

3.    (Optional) Rufen Sie 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ühren Sie den folgenden Befehl aus und ersetzen Sie ImageId und region-code durch Ihre Werte:

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

4.    (Optional) Rufen Sie vom Zielkonto aus die API DescribeWorkspaceImages auf, um das freigegebene Bild anzuzeigen. Führen Sie den folgenden Befehl aus und ersetzen Sie ImageId und region-code durch Ihre Werte:

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

5.    Rufen Sie vom Zielkonto aus die API CopyWorkspaceImage auf, um das freigegebene Bild zu kopieren. Führen Sie den folgenden Befehl aus und ersetzen Sie ImageId und region-code durch Ihre Werte. Ersetzen Sie außerdem new-image-name durch den Namen, den Sie für das Bild im Zielkonto verwenden möchten:

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. Der Status des Bildes wechselt von Ausstehend zu Verfügbar sobald der Workflow abgeschlossen ist, was normalerweise etwa 15 Minuten dauert.


Weitere Informationen

Wie erstelle ich ein WorkSpaces-Bild?

Kopieren eines benutzerdefinierten WorkSpaces-Bild