如何与其他 AWS 账户共享 WorkSpaces 映像或 BYOL 映像？

解决方法

您可以在同一区域内的 AWS 账户之间共享自定义 WorkSpaces 映像。共享 WorkSpaces 映像后，收件人账户可以在需要时将映像复制到其他区域。您可以使用 WorkSpaces 控制台或 AWS 命令行界面（AWS CLI）自行管理 WorkSpaces 映像传输。

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 控制台中查看新映像。工作流完成后，映像状态将从待处理变成可用，此过程通常需要大约 15 分钟。

---

相关信息

如何创建 WorkSpaces 映像？

复制自定义 WorkSpaces 映像