

# Compartilhar seu produto do portal com um proprietário do portal no API Gateway
<a name="apigateway-portals-share-products"></a>

Como proprietário do produto, você pode compartilhá-lo com um proprietário do portal em outra Conta da AWS utilizando AWS RAM. Você mantém o controle total de todas as páginas do produto e das páginas de endpoint REST do produto.

## Considerações
<a name="apigateway-portals-share-products-considerations"></a>

As seguintes considerações podem afetar a maneira como você compartilha produtos do portal:
+ Você pode compartilhar ou cancelar o compartilhamento de seus produtos do portal a qualquer momento. Se você cancelar o compartilhamento de um produto do portal enquanto ele estiver sendo utilizado em um portal publicado, o proprietário do portal não poderá visualizar o produto, visualizar nenhuma atualização feita nele nem publicar novamente ou visualizar o portal até remover o produto.
+ Você pode visualizar os produtos do portal compartilhados com outras contas.
+ Você não pode modificar nenhum portal que contenha seu produto do portal, a menos que você crie o próprio portal.

## Compartilhar o produto do portal
<a name="apigateway-portals-share-products-share"></a>

O procedimento a seguir mostra como criar um compartilhamento de recursos.

------
#### [ Console de gerenciamento da AWS ]

Para usar o Console de gerenciamento da AWS, consulte [Creating a resource share in AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-create.html) no *Guia do usuário do AWS RAM*.

Em **Selecionar tipo de recurso**, escolha **Produto do API Gateway**.

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

O [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) indicado abaixo cria um compartilhamento de recursos para seu nome de domínio personalizado privado. Pode levar alguns minutos para que as associações de entidades principais entre recurso e principal sejam concluídas. Para entidades principais, forneça um ID de conta ou um ID de organização, como `arn:aws:organizations::123456789012:organization/o-1234abcd`. Você pode fornecer várias entidades principais para seu compartilhamento de recursos.

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

------

Para cancelar o compartilhamento do seu produto do portal, utilize AWS RAM para excluir o compartilhamento de recursos.

A qualquer momento, você pode modificar a política de compartilhamento de produtos a fim de modificar quais entidades principais podem utilizar seus produtos nos respectivos portais.

**Como atualizar a política de compartilhamento de produtos**

1. Inicie uma sessão no console do API Gateway em [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. No painel de navegação principal, selecione **Produtos do portal**.

1. Escolha um produto.

1. Na guia **Compartilhamento de produtos**, em **Política de compartilhamento de produtos**, selecione **Gerenciar política de compartilhamento de produtos**.

1. Se você não compartilhou seu produto antes, sua política de compartilhamento de produtos negará todo o acesso a outras contas dos seus produtos do portal. Você precisa atualizar a política para permitir o acesso de determinadas contas ao seu produto do portal.

1. Depois de atualizar sua política de compartilhamento de produtos, escolha **Salvar alterações**.