WorkSpaces イメージまたは BYOL イメージを他の AWS アカウントと共有する方法を教えてください。

解決策

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

注: AWS CLI のコマンドの実行時にエラーが発生する場合は、「AWS CLI でのエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

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

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

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

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 分かかります。

関連情報

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

WorkSpace Personal でカスタムイメージをコピーする