本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 API Gateway 中將共用入口網站產品新增至您的入口網站
<a name="apigateway-portals-use-shared-products"></a>

身為入口網站擁有者，您可以使用入口網站中其他帳戶與您共用的入口網站產品。您可以維護入口網站的完整控制權。

## 考量事項
<a name="apigateway-portals-use-shared-products-considerations"></a>

下列考量可能會影響您共享入口網站資源的方式：
+ 您必須接受產品擁有者的產品資源共享，才能在入口網站中使用其產品。如果您和產品擁有者位於相同的 Organizations， AWS RAM 可以為您完成一些共用步驟。
+ 如果產品擁有者在您發佈的入口網站中取消共用產品，該產品仍會顯示在入口網站上，但在您移除此產品之前，您將無法再次發佈入口網站。身為入口網站擁有者，您有責任從入口網站移除產品，因為產品擁有者無法為您執行此操作。
+ 您可以檢視入口網站產品、產品頁面和產品 REST 端點頁面，但您無法修改任何這些資源。
+ 如果產品與您共用，您就無法與其他帳戶共用。

## （選用） 接受資源共享
<a name="apigateway-portals-use-shared-products-accept"></a>

產品擁有者建立資源共享後，您有 **12 小時**的時間可以接受它。如果您使用 AWS Organizations 與產品擁有者位於相同的組織中，則系統會自動接受共用。如果您所在的組織已啟用自動分享資源，則會自動與您分享資源。

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

若要使用 AWS 管理主控台，請參閱*AWS RAM 《 使用者指南*》中的[接受和拒絕資源共用邀請](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. 在以下網址登入 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
```

------