# Ejemplos de identidades de Amazon Cognito que utilizan la AWS CLI
<a name="cli_cognito-identity_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo ejecutar acciones e implementar escenarios comunes usando AWS Command Line Interface con Amazon Cognito Identity.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `create-identity-pool`
<a name="cognito-identity_CreateIdentityPool_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-identity-pool`.

**AWS CLI**  
**Para crear un grupo de identidades con el proveedor de grupos de identidades de Cognito**  
En este ejemplo, se crea un grupo de identidades denominado MyIdentityPool. Tiene un proveedor de grupo de identidades de Cognito. No se permiten identidades no autenticadas.  
Comando:  

```
aws cognito-identity create-identity-pool --identity-pool-name MyIdentityPool --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_aaaaaaaaa",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false
```
Salida:  

```
{
  "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
  "IdentityPoolName": "MyIdentityPool",
  "AllowUnauthenticatedIdentities": false,
  "CognitoIdentityProviders": [
      {
          "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",
          "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado",
          "ServerSideTokenCheck": false
      }
  ]
}
```
+  Para obtener detalles sobre la API, consulte [CreateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/create-identity-pool.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-identities`
<a name="cognito-identity_DeleteIdentities_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-identities`.

**AWS CLI**  
**Para eliminar un grupo de identidades**  
En este ejemplo, se elimina un grupo de identidades.  
Comando:  

```
aws cognito-identity delete-identity-pool --identity-ids-to-delete "us-west-2:11111111-1111-1111-1111-111111111111"
```
Salida:  

```
{
  "UnprocessedIdentityIds": []
}
```
+  Para obtener detalles sobre la API, consulte [DeleteIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identities.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-identity-pool`
<a name="cognito-identity_DeleteIdentityPool_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-identity-pool`.

**AWS CLI**  
**Para eliminar un grupo de identidades**  
En el siguiente ejemplo de `delete-identity-pool` se elimina el grupo de identidades especificado.  
Comando:  

```
aws cognito-identity delete-identity-pool \
    --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111"
```
Este comando no genera ninguna salida.  
+  Para obtener detalles de la API, consulte [DeleteIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identity-pool.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-identity-pool`
<a name="cognito-identity_DescribeIdentityPool_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-identity-pool`.

**AWS CLI**  
**Descripción de un grupo de identidades**  
En este ejemplo, se describe un grupo de identidades.  
Comando:  

```
aws cognito-identity describe-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111"
```
Salida:  

```
{
  "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
  "IdentityPoolName": "MyIdentityPool",
  "AllowUnauthenticatedIdentities": false,
  "CognitoIdentityProviders": [
      {
          "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",
          "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado",
          "ServerSideTokenCheck": false
      }
  ]
}
```
+  Para obtener detalles sobre la API, consulte [DescribeIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/describe-identity-pool.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-identity-pool-roles`
<a name="cognito-identity_GetIdentityPoolRoles_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-identity-pool-roles`.

**AWS CLI**  
**Obtención de los roles del grupo de identidades**  
En este ejemplo, se obtienen los roles de grupos de identidades.  
Comando:  

```
aws cognito-identity get-identity-pool-roles --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111"
```
Salida:  

```
{
  "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
  "Roles": {
      "authenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role",
      "unauthenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolUnauth_Role"
  }
}
```
+  Para obtener detalles sobre la API, consulte [GetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/get-identity-pool-roles.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-identity-pools`
<a name="cognito-identity_ListIdentityPools_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-identity-pools`.

**AWS CLI**  
**Para mostrar grupos de identidades**  
En este ejemplo, se muestran los grupos de identidades. Hay un máximo de 20 identidades en la lista.  
Comando:  

```
aws cognito-identity list-identity-pools --max-results 20
```
Salida:  

```
{
  "IdentityPools": [
      {
          "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
          "IdentityPoolName": "MyIdentityPool"
      },
      {
          "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
          "IdentityPoolName": "AnotherIdentityPool"
      },
      {
          "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
          "IdentityPoolName": "IdentityPoolRegionA"
      }
  ]
}
```
+  Para obtener detalles sobre la API, consulte [ListIdentityPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/list-identity-pools.html) en la *Referencia de comandos de la AWS CLI*. 

### `set-identity-pool-roles`
<a name="cognito-identity_SetIdentityPoolRoles_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `set-identity-pool-roles`.

**AWS CLI**  
**Establecimiento de los roles del grupo de identidades**  
En el siguiente ejemplo de `set-identity-pool-roles`, se establecen roles para un grupo de identidades.  

```
aws cognito-identity set-identity-pool-roles \
    --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" \
    --roles authenticated="arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role"
```
+  Para obtener detalles sobre la API, consulte [SetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/set-identity-pool-roles.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-identity-pool`
<a name="cognito-identity_UpdateIdentityPool_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-identity-pool`.

**AWS CLI**  
**Actualización de un grupo de identidades**  
En este ejemplo, se actualiza un grupo de identidades. Establece el nombre como MyIdentityPool. Añade Cognito como un proveedor de identidades. No permite las identidades no autenticadas.  
Comando:  

```
aws cognito-identity update-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" --identity-pool-name "MyIdentityPool" --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false
```
Salida:  

```
{
  "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111",
  "IdentityPoolName": "MyIdentityPool",
  "AllowUnauthenticatedIdentities": false,
  "CognitoIdentityProviders": [
      {
          "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",
          "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado",
          "ServerSideTokenCheck": false
      }
  ]
}
```
+  Para obtener detalles sobre la API, consulte [UpdateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/update-identity-pool.html) en la *Referencia de comandos de la AWS CLI*.