

# Agregación de un producto del portal compartido al portal en API Gateway
<a name="apigateway-portals-use-shared-products"></a>

Como propietario del portal, puede usar productos del portal compartidos con usted por otras cuentas en el portal. Mantenga pleno control del portal.

## Consideraciones
<a name="apigateway-portals-use-shared-products-considerations"></a>

Las siguientes consideraciones pueden afectar a cómo comparte los recursos del portal:
+ Debe aceptar el recurso compartido del producto del propietario del producto para poder utilizar el producto en el portal. Si el propietario del producto y usted están en la misma organización, AWS RAM puede completar algunos pasos compartidos para usted.
+ Si el propietario del producto deja de compartir un producto mientras está en el portal publicado, el producto seguirá visible en el portal, pero no podrá volver a publicar el portal hasta que lo elimine. Como propietario del portal, es su responsabilidad eliminar el producto del portal, ya que el propietario del producto no puede hacerlo por usted.
+ Puede ver los productos del portal, las páginas de productos y las páginas de punto de conexión REST del producto, pero no puede modificar ninguno de estos recursos.
+ Si se comparte un producto con usted, no podrá compartirlo con otra cuenta.

## (Opcional) Aceptación del recurso compartido
<a name="apigateway-portals-use-shared-products-accept"></a>

Después de que el propietario del producto cree un recurso compartido, dispone de **12 horas** para aceptarlo. Si pertenece a la misma organización que utiliza AWS Organizations como el propietario del producto, el recurso compartido se acepta automáticamente. Si pertenece a una organización que tiene habilitados los recursos compartidos automáticos, el recurso se comparte automáticamente con usted.

------
#### [ Consola de administración de AWS ]

Para usar la Consola de administración de AWS, consulte [Aceptar y rechazar invitaciones a recursos compartidos](https://docs.aws.amazon.com/ram/latest/userguide/working-with-shared-invitations.html) en la *Guía del usuario de AWS RAM*. 

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

Para buscar todos los recursos que se comparten con usted, utilice el siguiente 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
```

Utilice el ARN del recurso compartido resultante para aceptar la invitación al recurso compartido. El siguiente comando [accept-resource-share-invitation](https://docs.aws.amazon.com/cli/latest/reference/ram/accept-resource-share-invitation.html) permite aceptar el recurso compartido.

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

------

## Agregación de un producto compartido en el portal
<a name="apigateway-portals-use-shared-products-add"></a>

Tras aceptar el recurso compartido, agregue el producto al portal.

------
#### [ Consola de administración de AWS ]

**Agregación de un producto compartido al portal**

1. Inicie sesión en la consola de API Gateway, en [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. En el panel de navegación principal, elija **Portales**.

1. Elija un portal.

1. En la pestaña **Productos**, para los **productos del portal**, elija **Agregar productos**.

1. Agregue un producto al portal. Los productos compartidos se muestran como `shared` en la lista de productos.

1. Seleccione **Save changes (Guardar cambios)**.

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

Para encontrar todos los productos del portal que se han compartido con usted, utilice el comando `get-portal-products` siguiente:

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

Para agregar un producto de portal compartido al portal, utilice el comando `update-portal` siguiente:

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

------