Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh Identitas Amazon Cognito menggunakan AWS CLI
<a name="cli_cognito-identity_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Amazon Cognito Identity.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

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

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

### `buat-identiti-kumpulan`
<a name="cognito-identity_CreateIdentityPool_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`create-identity-pool`.

**AWS CLI**  
**Untuk membuat kumpulan identitas dengan penyedia kumpulan identitas Cognito **  
Contoh ini membuat kumpulan identitas bernama MyIdentityPool. Ini memiliki penyedia kumpulan identitas Cognito. Identitas yang tidak diautentikasi tidak diperbolehkan.  
Perintah:  

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

```
{
  "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
      }
  ]
}
```
+  Untuk detail API, lihat [ CreateIdentityPool ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/create-identity-pool.html) di Refer *AWS CLI ensi Perintah*. 

### `hapus identitas`
<a name="cognito-identity_DeleteIdentities_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-identities`.

**AWS CLI**  
**Untuk menghapus identitas **  
Contoh ini menghapus identitas dari kumpulan identitas.  
Perintah:  

```
aws cognito-identity delete-identities --identity-ids-to-delete {{"us-west-2:11111111-1111-1111-1111-111111111111"}}
```
Output:  

```
{
  "UnprocessedIdentityIds": []
}
```
+  Untuk detail API, lihat [ DeleteIdentities ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identities.html) di Refer *AWS CLI ensi Perintah*. 

### `hapus kumpulan identitas`
<a name="cognito-identity_DeleteIdentityPool_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-identity-pool`.

**AWS CLI**  
**Untuk menghapus kumpulan identitas **  
`delete-identity-pool`Contoh berikut menghapus kumpulan identitas yang ditentukan.  
Perintah:  

```
aws cognito-identity delete-identity-pool \
    --identity-pool-id {{"us-west-2:11111111-1111-1111-1111-111111111111"}}
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [ DeleteIdentityPool ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/delete-identity-pool.html) di Refer *AWS CLI ensi Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`describe-identity-pool`.

**AWS CLI**  
**Untuk menggambarkan kumpulan identitas **  
Contoh ini menjelaskan kumpulan identitas.  
Perintah:  

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

```
{
  "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
      }
  ]
}
```
+  Untuk detail API, lihat [ DescribeIdentityPool ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/describe-identity-pool.html) di Refer *AWS CLI ensi Perintah*. 

### `dapatkan-identiti-pool-peran`
<a name="cognito-identity_GetIdentityPoolRoles_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-identity-pool-roles`.

**AWS CLI**  
**Untuk mendapatkan peran kumpulan identitas **  
Contoh ini mendapatkan peran kumpulan identitas.  
Perintah:  

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

```
{
  "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"
  }
}
```
+  Untuk detail API, lihat [ GetIdentityPoolRoles ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/get-identity-pool-roles.html) di Refer *AWS CLI ensi Perintah*. 

### `daftar identiti-kumpulan`
<a name="cognito-identity_ListIdentityPools_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-identity-pools`.

**AWS CLI**  
**Untuk membuat daftar kumpulan identitas **  
Contoh ini mencantumkan kumpulan identitas. Maksimal ada 20 identitas yang terdaftar.  
Perintah:  

```
aws cognito-identity list-identity-pools --max-results {{20}}
```
Output:  

```
{
  "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"
      }
  ]
}
```
+  Untuk detail API, lihat [ ListIdentityPools ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/list-identity-pools.html) di Refer *AWS CLI ensi Perintah*. 

### `setelan identiti-pool-peran`
<a name="cognito-identity_SetIdentityPoolRoles_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`set-identity-pool-roles`.

**AWS CLI**  
**Untuk mengatur peran kumpulan identitas **  
`set-identity-pool-roles`Contoh berikut menetapkan peran kumpulan identitas.  

```
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"
```
+  Untuk detail API, lihat [ SetIdentityPoolRoles ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/set-identity-pool-roles.html) di Refer *AWS CLI ensi Perintah*. 

### `perbarui kumpulan identitas`
<a name="cognito-identity_UpdateIdentityPool_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`update-identity-pool`.

**AWS CLI**  
**Untuk memperbarui kumpulan identitas **  
Contoh ini memperbarui kumpulan identitas. Ini menetapkan nama ke MyIdentityPool. Ini menambahkan Cognito sebagai penyedia identitas. Ini melarang identitas yang tidak diautentikasi.  
Perintah:  

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

```
{
  "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
      }
  ]
}
```
+  Untuk detail API, lihat [ UpdateIdentityPool ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cognito-identity/update-identity-pool.html) di Refer *AWS CLI ensi Perintah*.