Compartilhar seu produto do portal com um proprietário do portal no API Gateway - Amazon API Gateway
ConsideraçõesCompartilhar o produto do portal

Compartilhar seu produto do portal com um proprietário do portal no API Gateway

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

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

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 no Guia do usuário do AWS RAM.

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

AWS CLI

O create-resource-share 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.

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

  3. Escolha um produto.

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

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

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