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

# 共享产品组合
<a name="catalogs_portfolios_sharing_how-to-share"></a>

要使其他 AWS 账户的 AWS Service Catalog 管理员能够将您的产品分发给最终用户，请使用共享或与他们 account-to-account共享您的产品 AWS Service Catalog 组合 AWS Organizations。

 当您使用共享或 Organizations account-to-account 共享作品集时，您就是在共享该作品集的*引用*。导入的产品组合中产品和约束与您对*共享的产品组合*（共享的原始产品组合）进行的更改保持同步。

收件人不能更改产品或约束，但可以为最终用户添加 AWS Identity and Access Management 访问权限。

**注意**  
 您无法共享已共享的资源。这包括含有共享产品的产品组合。

## Account-to-account 共享
<a name="portfolio-sharing-account"></a>

要完成这些步骤，您必须获取目标账户的 AWS 账户 ID。您可以在目标账户的 “**我的账户**” 页面上找到该ID。 AWS 管理控制台 

**与 AWS 账户共享投资组合**

1. 打开 Service Catalog 控制台，网址为[https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/)。

1. 在左侧导航菜单中，选择**产品组合**，然后选择要共享的产品组合。在**操作**菜单中，选择**共享**。

1. 在**输入账户 ID** 中，输入您要与之共享的 AWS 账户的账户 ID。（可选）选择 “[TagOption 共享](#tagoptions-share)”。然后选择**共享**。

1. 将 URL 发送给目标账户的 AWS Service Catalog 管理员。URL 将打开**导入产品组合**页面，并会自动提供共享产品组合的 ARN。

### 导入产品组合
<a name="catalogs_portfolios_sharing_importing"></a>

如果其他 AWS 账户的 AWS Service Catalog 管理员与您共享投资组合，请将该投资组合导入您的账户，以便您可以将其产品分发给最终用户。

如果投资组合是通过共享的，则无需导入该投资组合 AWS Organizations。

要导入产品组合，您必须从管理员处获取产品 ID。

要查看所有导入的投资组合，请打开 AWS Service Catalog 控制台，网址为[https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/)。在**产品组合**页面上，选择**已导入**选项卡。查看**导入的产品组合**表。

## 与共享 AWS Organizations
<a name="portfolio-sharing-organizations"></a>

您可以使用共享 AWS Service Catalog 投资组合 AWS Organizations。

 首先，您必须决定是从管理账户还是从委托管理员账户进行共享。如果您不想从管理账户进行共享，请注册一个委托管理员账户并使用它进行共享。有关更多信息，请参阅《CloudFormation 用户指南》中的[注册委托管理员](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html)。

 接下来，您必须决定与谁共享。您可以与以下实体共享：
+ 组织账户。
+ 组织部门（OU）。
+ 组织本身。（这将与组织中的每个账户共享。）

### 从管理账户共享
<a name="sharing-from-master"></a>

当使用组织结构或输入组织节点的 ID 时，您可以与组织共享产品组合。

****使用组织结构与组织共享投资组合****

1. 打开 AWS Service Catalog 控制台，网址为[https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/)。

1. 在**产品组合**页面上，选择要共享的产品组合。在**操作**菜单中，选择**共享**。

1. 选择 **AWS Organizations** 并筛选到您的组织结构。

   您可以选择根节点与整个组织、上级组织单位 (OU)、子组织单位或组织内的 AWS 帐户共享产品组合。

   共享给父级组织单位会将此产品组合共享给该父级组织单位中的所有账户和子组织单位。

   您可以选择 “**仅查看 AWS 帐户**” 以查看组织中所有 AWS 帐户的列表。

****要通过输入组织节点的 ID与组织共享投资组合****

1. 打开 AWS Service Catalog 控制台，网址为[https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/)。

1. 在**产品组合**页面上，选择要共享的产品组合。在**操作**菜单中，选择**共享**。

1. 选择**组织节点**。

   选择与整个组织、组织内的 AWS 账户或 OU 共享。

   输入您选择的组织节点的 ID，您可以在 AWS Organizations 控制台中找到该节点，网址为[ https://console.aws.amazon.com/organizations/](https://console.aws.amazon.com/organizations/)。

### 从委托管理员账户共享
<a name="delegated-admin"></a>

 组织的管理账户可以将其他账户注册为组织的委托管理员，也可取消注册。

委派的管理员可以像管理账号一样共享其组织中的 AWS Service Catalog 资源。他们有权创建、删除和共享产品组合。

要注册或取消注册委托管理员，您必须从管理账户中使用 API 或 CLI。有关更多信息，请参阅《*AWS Organizations API 参考*》中的[RegisterDelegatedAdministrator](https://docs.aws.amazon.com/organizations/latest/APIReference/API_RegisterDelegatedAdministrator.html)和[DeregisterDelegatedAdministrator](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DeregisterDelegatedAdministrator.html)。

**注意**  
管理员必须先致电 [https://docs.aws.amazon.com/servicecatalog/latest/dg/API_EnableAWSOrganizationsAccess.html](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_EnableAWSOrganizationsAccess.html)，然后才能指定委托 。

从委托管理员账户共享产品组合的过程与从管理账户共享相同，如 [从管理账户共享](#sharing-from-master) 中上述所示。

 如果某个成员被取消注册为委托管理员，则会发生以下情况：
+ 从该账户创建的产品组合共享将被删除。
+ 他们不能再创建新的产品组合共享。

**注意**  
 如果取消注册委托管理员后，委托管理员创建的产品组合和共享未被删除，请重新注册并取消注册委托管理员。此操作将删除由该账户创建的产品组合和共享。

### 在组织内移动账户
<a name="move-account"></a>

如果您在组织内转移账户，则与该账户共享 AWS Service Catalog 的产品组合可能会发生变化。

账户只能访问与其目标组织或组织单位共享的产品组合。

## 共享作品集 TagOptions 时共享
<a name="tagoptions-share"></a>

作为管理员，您可以创建要包含的共享 TagOptions。 TagOptions 是键值对，使管理员能够：
+ 定义并强制执行标签分类法。
+ 定义标签选项并将其与产品和产品组合相关联。
+ 与其他账户共享与产品组合和产品关联的标签选项。

当您在主账户中添加或删除标签选项时，更改会自动显示在收件人账户中。在收款人账户中，当最终用户使用配置产品时 TagOptions，他们必须为标签选择值，这些标签将成为预配置产品上的标签。

在收款人账户中，管理员可以将其他本地账户关联 TagOptions 到其导入的投资组合，以强制执行特定于该账户的标记规则。

**注意**  
要共享投资组合，您需要消费者的 AWS 账户 ID。在控制台的 AWS “**我的账户**” 中找到账户 ID。

**注意**  
如果 a TagOption 只有一个值，则会在置备过程中 AWS 自动强制使用该值。

**共享作品集 TagOptions 时共享**

1. 从左侧导航菜单中，选择**产品组合**。

1. 在**本地产品组合**中，选择并打开产品组合。

1. 从上方的列表中选择**共享**，然后选择**共享**按钮。

1. 选择与其他 AWS 账户或组织共享。

1. 输入 12 位的账户 ID 号，选择**启用**，然后选择**共享**。

   您共享的账户显示在**与之共享的账户**部分中。它表示是否 TagOptions 已启用。

您也可以更新投资组合份额以包含在内 TagOptions。现在 TagOptions ，所有属于产品组合和产品的产品都将共享到该账户。

**更新投资组合份额以包括 TagOptions**

1. 从左侧导航菜单中，选择**产品组合**。

1. 在**本地投资组合**中，选择并打开投资组合。

1. 从上方的列表中选择**共享**。

1. 在**与之共享的账户**中，选择账户 ID，然后选择**操作**。

1. 选择**更新取消共享**或**取消共享**。

   选择 “**更新取消共享**” 时，选择 “**启用**” 以启动共享 TagOptions。您共享的账户显示在**与之共享的账户**部分中。

   选择**取消共享**时，请确认您不想再共享该账户。

## 共享产品组合时共享主体名称
<a name="principal-name-share"></a>

作为管理员，您可以创建包含主体名称的产品组合共享。主体名称是群组、角色和用户的名称，管理员可以在产品组合中指定这些名称，然后与产品组合共享。当您共享投资组合时，请 AWS Service Catalog 验证这些委托人名称是否已经存在。如果确实存在，则 AWS Service Catalog 自动将匹配的 IAM 委托人与共享产品组合关联以向用户授予访问权限。

**注意**  
当您将主体与产品组合相关联时，当该产品组合随后与其他账户共享时，可能会出现潜在的权限提升路径。对于收款人账户中*不是* AWS Service Catalog 管理员但仍有能力创建委托人（用户/角色）的用户，该用户可以创建与投资组合的委托人名称关联相匹配的 IAM 委托人。尽管该用户可能不知道通过哪些主体名称相关联 AWS Service Catalog，但他们可能能够猜出该用户。如果担心这种潜在的升级路径，则 AWS Service Catalog 建议使用 a `PrincipalType` s `IAM`。使用此配置，`PrincipalARN` 必须先存在于收件人账户中，然后才能将其关联。

当您在主账户中添加或删除委托人姓名时， AWS Service Catalog 会自动将这些更改应用到收款人账户中。然后，收件人账户中的用户可以根据其角色执行任务：
+ **最终用户**可以预配置、更新和终止产品组合的产品。
+ **管理员**可以将其他 IAM 主体关联到其导入的产品组合，以向特定于该账户的最终用户授予访问权限。

**注意**  
主人姓名共享仅适用于 AWS Organizations。

**要在共享产品组合时共享主体名称**

1. 从左侧导航菜单中，选择**产品组合**。

1. 在**本地产品组合**中，选择要共享的产品组合。

1. 在**操作**菜单中，选择**共享**。

1. 在 AWS Organizations中选择一个组织。

1. 选择整个**组织根目录**、**组织单位（OU）** 或**组织成员**。

1. 在**共享**设置中，启用**主体共享**选项。

您也可以更新产品组合共享，使其包含主体名称共享。这会与收件人账户共享属于该产品组合的所有主体名称。

**要更新投资组合共享以启用或禁用主体名称**

1. 从左侧导航菜单中，选择**产品组合**。

1. 在**本地产品组合**中，选择要更新的产品组合。

1. 选择**共享** 选项卡。

1. 选择要更新的共享，然后选择**共享**。

1. 选择 “**更新共享**”，然后选择 “**启用**” 以启动委托人共享。 AWS Service Catalog 然后在收款人账户中共享主体姓名。

如果您想停止与收件人账户共享主体名称，请**禁用**委托人共享。

### 在共享主体名称时使用通配符
<a name="wildcards-principal-names"></a>

AWS Service Catalog 支持使用通配符（例如 “\$1” 或 “？”）向 IAM 委托人（用户、群组或角色）名称授予投资组合访问权限。使用通配符模式可以同时覆盖多个 IAM 主体名称。ARN 路径和主体名称允许使用无限制通配符。

**可接受的**通配符 ARN 示例：
+ **arn:aws:iam:::role/ResourceName\$1\$1**
+ **arn:aws:iam:::role/\$1/ResourceName\$1?**

**不可接受的**通配符 ARN 示例：
+ **arn:aws:iam:::\$1/ResourceName**

在 IAM 主体 ARN 格式（**arn:partition:iam:::resource-type/resource-path/resource-name**）中，有效值包括**用户/**、**组/**或**角色/**。“?”和“\$1”只能在 resource-id 段中的 resource-type 后使用。您可以在 resource-id 中的任何位置使用特殊字符。

“\$1”字符还与“/”字符匹配，从而允许在 resource-id *中*形成路径。例如：

**arn:aws:iam:::role/**\$1**/ResourceName\$1?** 匹配 **arn:aws:iam:::role/pathA/pathB/ResourceName\$11** 和 **arn:aws:iam:::role/pathA/ResourceName\$11**。