# 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 ユーザーガイド*の「[リソース共有の招待の承諾と拒否](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. [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway) で API Gateway コンソールにサインインします。

1. メインナビゲーションペインで、**[ポータル]** を選択します。

1. ポータルを選択します。

1. **[製品]** タブの **[ポータル製品]** で、**[製品の追加]** を選択します。

1. 製品をポータルに追加します。共有製品は、製品リストに `shared` として表示されます。

1. **[Save changes]** (変更の保存) をクリックします。

------
#### [ 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
```

------