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

解决方法

您可以在同一区域内的多个 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 分钟。

相关信息

如何创建 WorkSpaces 映像？

在 WorkSpaces Personal 中复制自定义映像