Adicionar um produto compartilhado ao seu portal no API Gateway - Amazon API Gateway

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

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

  2. No painel de navegação principal, selecione Portais.

  3. Escolha um portal.

  4. Na guia Produtos, para Produtos do portal, escolha Adicionar produtos.

  5. Adicione um produto ao seu portal. Os produtos compartilhados são exibidos como shared na lista de produtos.

  6. 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