# Adicionar um produto compartilhado ao seu portal no API Gateway Como proprietário de um portal, você pode utilizar produtos do portal compartilhados com você por outras contas no seu portal. Você mantém total controle do seu portal. ## Considerações As considerações a seguir podem afetar a maneira como você compartilha recursos do portal: + Você precisa aceitar o compartilhamento de recursos do produto do proprietário para utilizar o produto dele em seu portal. Se você e o proprietário do produto estiverem nas mesmas organizações, o AWS RAM poderá concluir algumas etapas de compartilhamento para você. + Se o proprietário do produto cancelar o compartilhamento de um produto enquanto ele estiver no seu portal publicado, ele ainda estará visível no portal, mas você não poderá publicar o portal novamente até removê-lo. É sua responsabilidade, como proprietário do portal, remover o produto, pois o proprietário não pode fazer isso por você. + Você pode visualizar os produtos do portal, as respectivas páginas e as páginas do endpoint REST do produto, mas não pode modificar nenhum desses recursos. + Se um produto for compartilhado, você não poderá compartilhá-lo com outra conta. ## (Opcional) Aceitar o compartilhamento de recursos Se o proprietário do produto criar um compartilhamento de recursos, você terá **12 horas** para aceitá-lo. Se você estiver na mesma organização que está usando o AWS Organizations como proprietário do produto, o compartilhamento será aceito automaticamente. Se estiver em uma organização que tem recursos compartilhados automáticos habilitados, o recurso será compartilhado automaticamente com você. ------ #### [ Console de gerenciamento da AWS ] Para usar o Console de gerenciamento da AWS, consulte [Accepting and rejecting resource share invitations](https://docs.aws.amazon.com/ram/latest/userguide/working-with-shared-invitations.html) no *Guia do usuário do AWS RAM*. ------ #### [ AWS CLI ] Para encontrar todos os recursos compartilhados com você, use o seguinte comando [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 ``` Use o ARN de compartilhamento de recursos resultante para aceitar o convite de compartilhamento de recursos. O comando [accept-resource-share-invitation](https://docs.aws.amazon.com/cli/latest/reference/ram/accept-resource-share-invitation.html) a seguir aceita o compartilhamento de recursos. ``` 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 ``` ------ ## Adicionar um produto compartilhado ao seu portal Depois de aceitar o compartilhamento de recursos, você vai adicionar o produto ao seu portal. ------ #### [ Console de gerenciamento da AWS ] **Como adicionar um produto compartilhado ao seu portal** 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 **Portais**. 1. Escolha um portal. 1. Na guia **Produtos**, para **Produtos do portal**, escolha **Adicionar produtos**. 1. Adicione um produto ao seu portal. Os produtos compartilhados são exibidos como `shared` na lista de produtos. 1. Escolha **Salvar alterações**. ------ #### [ AWS CLI ] Para localizar todos os produtos do portal compartilhados com você, utilize o seguinte comando `get-portal-products`: ``` aws apigatewayv2 get-portal-products \ --resource-owner OTHER_ACCOUNTS \ --region us-west-2 ``` Para adicionar um produto compartilhado ao seu portal, utilize o seguinte comando `update-portal`: ``` aws apigateway update-portal \ --included-portal-product-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \ --region us-west-2 ``` ------