# 在 API Gateway 中将共享门户产品添加到您的门户
<a name="apigateway-portals-use-shared-products"></a>

作为门户所有者，您可以在您的门户中使用其他账户共享给您的门户产品。您对自己的门户拥有完全控制权。

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

以下注意事项可能会影响您共享门户资源的方式：
+ 要在您的门户中使用产品所有者的产品，您必须接受产品所有者的产品资源共享。如果您和产品所有者属于同一个组织，AWS RAM 可以为您完成部分共享步骤。
+ 如果产品所有者在您已发布的门户中取消共享某个产品，该产品仍会在门户上显示，但您必须移除该产品后才能重新发布门户。作为门户所有者，移除门户中的产品是您的责任，产品所有者无法为您执行此操作。
+ 您可以查看门户产品、产品页面和产品 REST 端点页面，但无法修改这些资源中的任何内容。
+ 如果某个产品是共享给您的，您不能再将其共享给其他账户。

## （可选）接受资源共享
<a name="apigateway-portals-use-shared-products-accept"></a>

如果您的产品所有者创建了资源共享，则您有 **12 小时**的时间来接受该共享。如果您和产品所有者在同一个组织中使用 AWS Organizations，则会自动接受共享。如果您所在的组织启用了自动共享资源，则会自动与您共享资源。

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

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

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

要查找与您共享的所有资源，请使用以下 [get-resource-share-invitations](https://docs.aws.amazon.com/cli/latest/reference/ram/get-resource-share-invitations.html) 命令：

```
aws ram get-resource-share-invitations \
    --region us-west-2
```

使用生成的资源共享 ARN 来接受资源共享邀请。以下 [accept-resource-share-invitation](https://docs.aws.amazon.com/cli/latest/reference/ram/accept-resource-share-invitation.html) 命令接受资源共享。

```
aws ram accept-resource-share-invitation \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE \
    --region us-west-2
```

------

## 向门户中添加共享产品
<a name="apigateway-portals-use-shared-products-add"></a>

接受资源共享后，将产品添加到您的门户中。

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

**向门户中添加共享产品**

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

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

1. 选择一个门户。

1. 在**产品**选项卡中，对于**门户产品**，选择**添加产品**。

1. 向门户中添加产品。共享产品在产品列表中显示为 `shared`。

1. 选择**保存更改**。

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

要查找与您共享的所有门户产品，请使用以下 `get-portal-products` 命令：

```
aws apigatewayv2 get-portal-products \
    --resource-owner OTHER_ACCOUNTS \
    --region us-west-2
```

要将共享门户产品添加到您的门户，请使用以下 `update-portal` 命令：

```
aws apigateway update-portal \
    --included-portal-product-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \
    --region us-west-2
```

------