Amazon WorkSpaces イメージまたは WorkSpaces の持ち込みライセンス (BYOL) イメージを別の Amazon Web Services (AWS) アカウントと共有したいです。そのアカウントは同じ 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 イメージを同じリージョン内の別のアカウントにコピーするには、次の手順を実行します。
-
ソースアカウントから、ソースイメージのイメージ ID を特定します。次のコマンドを実行し、region-code を WorkSpaces のリージョンコードに置き換えます。
aws workspaces describe-workspace-images --region region-code
次に、出力の ImageID を書き留めます。
-
ソースアカウントから 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
-
(オプション) ソースアカウントから DescribeWorkspaceImagePermissions API を呼び出してアクセス許可を確認し、イメージがターゲットアカウントと共有されていることを確認します。次のコマンドを実行し、ImageId と region-code を適切な値に置き換えます。
aws workspaces describe-workspace-image-permissions --image-id ImageId --region region-code
-
(オプション) ターゲットアカウントから DescribeWorkspaceImages API を呼び出して共有イメージを確認します。次のコマンドを実行し、ImageId と region-code を適切な値に置き換えます。
aws workspaces describe-workspace-images --image-ids ImageId --region region-code --image-type SHARED
-
ターゲットアカウントから 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 でカスタムイメージをコピーする