本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 共享或取消共享自定义 WorkSpaces 个人版映像
<a name="share-custom-image"></a>

您可以在同一 AWS 区域内的 AWS 账户间共享自定义 WorkSpaces 映像。共享映像后，收件人账户可以根据需要将映像复制到其他 AWS 区域。有关复制映像的更多信息，请参阅[在 “个 WorkSpaces 人” 中复制自定义镜像](copy-custom-image.md)。

**注意**  
在中国（宁夏）区域，您只能复制同一区域内的映像。  
在 AWS GovCloud (US) Region中，要将映像复制到其他 AWS 区域或从此类区域复制映像，请联系 AWS Support。

共享映像不会产生额外的费用。但需遵循 AWS 区域中的映像数量配额。在收件人复制共享映像之前，该映像不会计入收件人账户的配额。有关 Amazon WorkSpaces 配额的更多信息，请参阅 [亚马逊 WorkSpaces 配额](workspaces-limits.md)。

要删除共享映像，您必须首先取消共享映像，然后才能将其删除。

**共享自带许可映像**  
您只能与启用 BYOL 的 AWS 账户共享自带许可 (BYOL) 映像。您想要与其共享 BYOL 映像的 AWS 账户也必须是您组织的一部分（在同一付款人账户下）。

**注意**  
目前，AWS GovCloud（美国西部）和 AWS GovCloud（美国东部）区域不支持跨 AWS 账户共享 BYOL 映像。要在 AWS GovCloud（美国西部）和 AWS GovCloud（美国东部）区域跨账户共享 BYOL 映像，请联系 AWS Support。

**与您共享的映像**  
如果与您共享映像，则您可以复制此类映像。然后，您可以使用共享映像的副本创建用于启动新 WorkSpaces 的捆绑包。

**重要**  
在复制共享映像之前，请务必确认该映像是从正确的 AWS 账户共享的。要以编程方式确定映像是否已共享，请在 AWS 命令行界面 (CLI) 中使用 [DescribeWorkSpaceImages](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeWorkspaceImages.html) 和 [DescribeWorkSpaceImagePermissions](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeWorkspaceImagePermissions.html) API 操作或 [describe-workspace-images](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-images.html) 和 [describe-workspace-image-permissions](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-image-permissions.html) 命令。

为与您共享的映像显示的创建日期是该映像最初的创建日期，而不是与您共享映像的日期。

如果映像已与您共享，则您无法与其他账户进一步共享该映像。

**共享映像**

1. 打开 WorkSpaces 控制台，网址为：[https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home)。

1. 在导航窗格中，选择**映像**。

1. 选择映像以打开其详细信息页面。

1. 在映像详细信息页面的**共享账户**部分，选择**添加账户**。

1. 在**添加账户**页面的**添加要与之共享的账户**下，输入要与之共享映像的账户的账户 ID。
**重要**  
在共享映像之前，请确认您正在共享到正确的 AWS 账户 ID。

1. 选择**共享映像**。
**注意**  
要使用共享映像，收件人账户必须先[复制该映像](copy-custom-image.md)。然后，收件人账户可以使用共享映像的副本创建用于启动新 WorkSpaces 的捆绑包。

**停止共享映像**

1. 打开 WorkSpaces 控制台，网址为：[https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home)。

1. 在导航窗格中，选择**映像**。

1. 选择映像以打开其详细信息页面。

1. 在映像详细信息页面的**共享账户**部分，选择要停止共享的 AWS 账户，然后选择**取消共享**。

1. 当系统提示您确认取消共享映像时，选择**取消共享**。
**注意**  
如果要在取消共享映像后将其删除，则必须先取消与其共享的所有账户的共享。

如果您停止共享映像，则收件人账户将无法再复制映像。但是，收件人账户中已存在的共享映像的任何副本都将保留在该账户中，并且可以从这些副本启动新的 WorkSpaces。

**以编程方式共享或取消共享映像**  
要以编程方式共享或取消共享映像，请使用 [UpdateWorkSpaceImagePermission](https://docs.aws.amazon.com/workspaces/latest/api/API_UpdateWorkspaceImagePermission.html) API 操作或 [update-workspace-image-permission](https://docs.aws.amazon.com/cli/latest/reference/workspaces/update-workspace-image-permission.html) AWS Command Line Interface (AWS CLI) 命令。要确定映像是否已共享，请使用 [DescribeWorkSpaceImagePermissions](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeWorkspaceImagePermissions.html) API 操作或 [describe-workspace-image-permissions](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-image-permissions.html) CLI 命令。