# 在 API Gateway 中与门户所有者共享门户产品
<a name="apigateway-portals-share-products"></a>

作为产品所有者，您可以使用 AWS RAM 与其他 AWS 账户账户中的门户所有者共享您的产品。您对所有产品页面和产品 REST 端点页面拥有完全控制权。

## 注意事项
<a name="apigateway-portals-share-products-considerations"></a>

以下注意事项可能会影响您共享门户产品的方式：
+ 您可以随时共享或取消共享门户产品。如果在已发布的门户中正在使用某个门户产品时取消共享，门户所有者将无法查看该门户产品、无法查看对其进行的任何更新，也无法重新发布或预览门户，除非他们移除该门户产品。
+ 您可以查看已共享给其他账户的门户产品。
+ 您无法修改包含您的门户产品的任何门户，除非该门户是您自己创建的。

## 共享门户产品
<a name="apigateway-portals-share-products-share"></a>

以下步骤演示了如何创建资源共享。

------
#### [ AWS 管理控制台 ]

要使用 AWS 管理控制台，请参阅《AWS RAM User Guide**》中的 [Creating a resource share in AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-create.html)。

对于**选择资源类型**，选择 **API Gateway 产品**。

------
#### [ AWS CLI ]

使用以下 [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) 命令为您的私有自定义域名创建资源共享。可能需要花几分钟时间，才能完成资源和委托人关联。对于主体，请提供账户 ID 或 Organizations ID，例如 `arn:aws:organizations::123456789012:organization/o-1234abcd`。您可以为资源共享提供多个主体。

```
aws ram create-resource-share \ 
 --region us-west-2 \ 
 --name portal-product-resource-share \ 
 --permission-arns arn:aws:ram::aws:permission/AWSRAMDefaultPermissionAPIGatewayDeveloperPortalProduct \ 
 --resource-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \ 
 --principals 222222222222
```

------

要取消共享您的门户产品，请使用 AWS RAM 删除资源共享。

您可以随时修改产品共享策略，以指定哪些主体可以在其门户中使用您的门户产品。

**更新产品共享策略**

1. 通过以下网址登录到 Amazon API Gateway 控制台：[https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)。

1. 在主导航窗格中，选择**门户产品**。

1. 选择产品。

1. 在**产品共享**选项卡中，为**产品共享策略**选择**管理产品共享策略**。

1. 如果您之前未共享过产品，则您的产品共享策略将拒绝所有其他账户访问您的门户产品。您需要更新策略以允许某些账户访问您的门户产品。

1. 更新产品共享策略后，选择**保存更改**。