Add a shared portal product to your portal in API Gateway - Amazon API Gateway
Considerations(Optional) Accept the resource shareAdd a shared product to your portal
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Add a shared portal product to your portal in API Gateway

As a portal owner, you can use portal products shared with you by other accounts in your portal. You maintain full control of your portal.

Considerations

The following considerations might impact how you share portal resources:

  • You must accept the product resource share from the product owner to use their product in your portal. If you and the product owner are in the same Organizations, Amazon RAM can complete some sharing steps for you.

  • If the product owner unshares a product while it's in your published portal, the product will still be visible on the portal, but you won't be able to publish the portal again until you remove this product. It's your responsibility as the portal owner to remove the product from your portal, as the product owner can't do that for you.

  • You can view the portal products, the product pages, and the product REST endpoint pages, but you cannot modify any of these resources.

  • If a product is shared with you, you can't share it with another account.

(Optional) Accept the resource share

After your product owner creates a resource share, you have 12 hours to accept it. If you are in the same organization using Amazon Organizations as the product owner, the share is automatically accepted. If you are in an organization that has automatic shared resources enabled, the resource is automatically shared with you.

Amazon Web Services Management Console

To use the Amazon Web Services Management Console, see Accepting and rejecting resource share invitations in the Amazon RAM User Guide.

Amazon CLI

To find all the resources shared with you, use the following get-resource-share-invitations command:

aws ram get-resource-share-invitations \
    --region us-west-2

Use the resulting resource share ARN to accept the resource share invitation. The following accept-resource-share-invitation command accepts the resource share.

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

Add a shared product to your portal

After you accept the resource share, you add the product to your portal.

Amazon Web Services Management Console
To add a shared product to your portal

  1. Sign in to the API Gateway console at https://console.amazonaws.cn/apigateway.

  2. In the main navigation pane, choose Portals.

  3. Choose a portal.

  4. In the Products tab, for Portal products, choose Add products.

  5. Add a product to your portal. Shared products are shown as shared in the products list.

  6. Choose Save changes.

Amazon CLI

To find all the portal products shared with you, use the following get-portal-products command:

aws apigatewayv2 get-portal-products \
    --resource-owner OTHER_ACCOUNTS \
    --region us-west-2

To add a shared portal product to your portal, use the following update-portal command:

aws apigateway update-portal \
    --included-portal-product-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \
    --region us-west-2