# 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 Management Console ]

AWS Management Console을 사용하려면 *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 Management Console ]

**포털에 공유 제품 추가**

1. [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)에서 API Gateway 콘솔에 로그인합니다.

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

------