WorkSpaces イメージや BYOL イメージを他の AWS アカウントと共有するにはどうすればよいですか?

解決方法

同じリージョン内の AWS アカウント間でカスタム WorkSpaces イメージを共有できます。WorkSpaces イメージが共有されると、受け手のアカウントは必要に応じてイメージを他のリージョンにコピーできます。WorkSpaces のイメージ転送は、WorkSpaces コンソールまたは AWS コマンドラインインターフェイス (AWS CLI) を使用して自己管理できます。

BYOL イメージは、同じ AWS 支払いアカウント ID を持つ他のアカウントとのみ共有できます。BYOL イメージを別のリージョンにコピーするには、コピー先のリージョンを BYOL イメージ用に設定する必要があります。

WorkSpaces コンソールを使用してイメージを共有する

WorkSpaces コンソールを使用して、同じリージョンの他のアカウントとイメージを共有または共有解除できます。手順については、「WorkSpaces のカスタムイメージの共有または共有解除」を参照してください。

AWS CLI を使用してイメージを共有する

API コールと AWS CLI を使用して、プログラムでイメージを共有または共有解除できます。

重要: 次のプロセスのコマンドには、AWS CLI のバージョン 2 が必要です。インストール手順については、「AWS CLI の最新バージョンをインストールまたは更新します」を参照してください。

WorkSpaces イメージを同じリージョン内の別のアカウントにコピーするには、次のステップを実行します。

1.    ソースアカウントから、ソースイメージのイメージ ID を特定します。次のコマンドを実行し、region-code を WorkSpaces リージョンコードに置き換えます。

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

その後、出力の ImageId を書き留めます。

2.    ソースアカウントから UpdateWorkspaceImagePermission API を呼び出して、ソースイメージをターゲットアカウントと共有します。次のコマンドを実行し、ImageId をステップ 1 の出力に、region-code を WorkSpaces リージョンコードに、target-account をターゲットアカウント番号に置き換えます。

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

3.    (オプション) ソースアカウントから DescribeWorkspaceImagePermissions API を呼び出して、許可を表示し、イメージがターゲットアカウントと共有されていることを確認します。次のコマンドを実行し、ImageId と region-code を自分の値に置き換えます。

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

4.    (オプション) ターゲットアカウントから DescribeWorkspaceImages API を呼び出して、共有イメージを表示します。次のコマンドを実行し、ImageId と region-code を自分の値に置き換えます。

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

5.    ターゲットアカウントから、CopyWorkspaceImage API を呼び出して、共有イメージをコピーします。次のコマンドを実行し、ImageId と region-code を自分の値に置き換えます。また、new-image-name を、ターゲットアカウントのイメージに使用する名前に置き換えます。

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

これで、ターゲットアカウントが WorkSpaces コンソールで新しいイメージを参照できるようになります。ワークフローが完了すると、イメージの状態が [Pending] (保留中) から [Available] (使用可能) に変わります。通常、これには約 15 分かかります。

関連情報

WorkSpaces イメージを作成する方法を教えてください。

カスタム WorkSpaces イメージのコピー