Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de Amazon Cognito Identity utilizando AWS CLI
<a name="cli_2_cognito-identity_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes mediante Amazon Cognito Identity. AWS Command Line Interface 

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_2_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 más información sobre la API, consulte [CreateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/create-identity-pool.html)la *Referencia de AWS CLI comandos*. 

### `delete-identities`
<a name="cognito-identity_DeleteIdentities_cli_2_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 más información sobre la API, consulte [DeleteIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identities.html)la *Referencia de AWS CLI comandos*. 

### `delete-identity-pool`
<a name="cognito-identity_DeleteIdentityPool_cli_2_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 más información sobre la API, consulte [DeleteIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identity-pool.html)la *Referencia de AWS CLI comandos*. 

### `describe-identity-pool`
<a name="cognito-identity_DescribeIdentityPool_cli_2_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 más información sobre la API, consulte [DescribeIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/describe-identity-pool.html)la *Referencia de AWS CLI comandos*. 

### `get-identity-pool-roles`
<a name="cognito-identity_GetIdentityPoolRoles_cli_2_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 más información sobre la API, consulte [GetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/get-identity-pool-roles.html)la *Referencia de AWS CLI comandos*. 

### `list-identity-pools`
<a name="cognito-identity_ListIdentityPools_cli_2_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 más información sobre la API, consulte [ListIdentityPools](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/list-identity-pools.html)la *Referencia de AWS CLI comandos*. 

### `set-identity-pool-roles`
<a name="cognito-identity_SetIdentityPoolRoles_cli_2_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 más información sobre la API, consulte [SetIdentityPoolRoles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/set-identity-pool-roles.html)la *Referencia de AWS CLI comandos*. 

### `update-identity-pool`
<a name="cognito-identity_UpdateIdentityPool_cli_2_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 en 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 más información sobre la API, consulte [UpdateIdentityPool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/update-identity-pool.html)la *Referencia de AWS CLI comandos*.