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

# 在 “个人” 中 WorkSpaces 共享或取消共享自定义镜像
<a name="share-custom-image"></a>

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

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

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

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

**共享自带许可映像**  
您只能与启用 BYOL 的 AWS 帐户共享自带许可 (BYOL) 图片。您要与之共享 BYOL 图片的 AWS 账户也必须是您的组织的一部分（使用相同的付款人账户）。

**注意**  
目前， AWS GovCloud (US-West) 和 AWS GovCloud (US-East) 区域不支持跨 AWS 账户共享 BYOL 图片。要在 AWS GovCloud (US-West) 和 AWS GovCloud (US-East) 区域的账户之间共享 BYOL 图片，请联系 Su AWS pport。

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

**重要**  
在复制共享镜像之前，请务必确认该镜像是从正确的 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-imag [es 和 describe-work](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-images.html) space-[image-permission](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-image-permissions.html) s 命令。 AWS 

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

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

**共享映像**

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-p](https://docs.aws.amazon.com/cli/latest/reference/workspaces/update-workspace-image-permission.html) AWS Command Line Interface ermissions () 命令。AWS CLI要确定图像是否已共享，请使用 [DescribeWorkspaceImagePermissions](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeWorkspaceImagePermissions.html)API 操作或 d [escribe-workspace-image-permisspace-](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspace-image-permissions.html) permissions CLI 命令。