Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menandai sumber daya Amazon Cognito
*Tag adalah label* metadata yang Anda atau tetapkan ke AWS sumber daya. AWS Setiap tanda terdiri dari *kunci* dan *nilai*. Untuk tanda yang Anda tetapkan, Anda menentukan kunci dan nilai. Misalnya, Anda dapat menentukan kunci sebagai `stage` dan nilai untuk satu sumber daya sebagai `test`.
Tanda membantu Anda melakukan hal berikut:
+ Identifikasi dan atur AWS sumber daya Anda. Banyak AWS layanan mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya dari layanan yang berbeda. Ini membantu Anda menunjukkan sumber daya mana yang terkait. Misalnya, Anda dapat menugaskan tanda yang sama ke kolam pengguna Amazon Cognito yang Anda tetapkan ke tabel Amazon DynamoDB.
+ Lacak AWS biaya Anda. Anda dapat mengaktifkan tag ini di AWS Manajemen Penagihan dan Biaya dasbor. AWS menggunakan tag alokasi biaya untuk mengkategorikan biaya Anda dan mengirimkan laporan alokasi biaya bulanan kepada Anda. Untuk informasi selengkapnya, lihat [Menggunakan tag alokasi biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) di *Panduan AWS Billing Pengguna*.
+ Kontrol akses ke sumber daya Anda berdasarkan tanda yang ditetapkan untuk sumber daya tersebut. Anda dapat mengontrol akses dengan menentukan kunci tag dan nilai dalam kondisi untuk kebijakan AWS Identity and Access Management (IAM). Misalnya, Anda dapat mengizinkan pengguna untuk memperbarui kumpulan pengguna hanya jika kumpulan pengguna memiliki `owner` tag dengan nilai nama pengguna tersebut. Untuk informasi selengkapnya, lihat [Mengontrol akses menggunakan tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) di *Panduan Pengguna IAM*.
Anda dapat menggunakan AWS Command Line Interface atau Amazon Cognito API untuk menambahkan, mengedit, atau menghapus tag untuk kumpulan pengguna dan identitas. Anda juga dapat mengelola tag untuk kumpulan pengguna dengan menggunakan konsol Amazon Cognito.
Untuk tips menggunakan tag, lihat posting [strategi AWS penandaan](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/) di blog *AWS Jawaban*.
Bagian berikut menyediakan informasi selengkapnya tentang tanda untuk Amazon Cognito.
## Sumber daya yang didukung di Amazon Cognito
Sumber daya berikut di Amazon Cognito mendukung penandaan:
+ Kolam pengguna
+ Kolam identitas
## Pembatasan tag
Pembatasan berikut berlaku untuk tag di sumber daya Amazon Cognito:
+ Jumlah tanda maksimum yang dapat Anda tetapkan ke sumber daya — 50
+ Panjang kunci maksimum – 128 karakter Unicode
+ Panjang nilai maksimum – 256 karakter Unicode
+ Karakter yang valid untuk kunci dan nilai — a-z, A-Z, 0-9, spasi, dan karakter berikut: \$1.:/= \$1 - @
+ Kunci dan nilai peka huruf besar dan kecil
+ Jangan gunakan `aws:` sebagai prefiks untuk kunci; ini dicadangkan untuk penggunaan AWS
## Mengelola tag menggunakan konsol Amazon Cognito
Anda dapat menggunakan konsol Amazon Cognito untuk mengelola tanda yang ditetapkan ke kolam pengguna Anda.
**Untuk menambahkan tanda ke kolam pengguna**
1. Arahkan ke konsol [Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensional Anda.
1. Pilih **Kolam Pengguna**.
1. Pilih kolam pengguna yang ada dari daftar, atau [buat kolam pengguna](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-as-user-directory.html).
1. Pilih menu **Pengaturan** dan cari tab **Tag**.
1. Pilih **Tambahkan tag** untuk menambahkan tag pertama Anda. Jika sebelumnya Anda telah menetapkan tag ke kumpulan pengguna ini, di **Kelola tag**, pilih **Tambahkan yang lain**.
1. Tentukan nilai untuk **Kunci Tanda** dan **Nilai Tanda**.
1. Untuk setiap tag tambahan yang ingin Anda tambahkan, pilih **Tambahkan yang lain**.
1. Setelah Anda selesai menambahkan tanda, pilih **Simpan perubahan.**
Untuk menandai kumpulan identitas, navigasikan ke menu **Identity pool** dan pilih atau buat kumpulan identitas. Di tab **Properti kumpulan identitas**, cari **Tag**. Pilih **Tambahkan tanda**.
## AWS CLI contoh
AWS CLI Ini menyediakan perintah yang membantu Anda mengelola tag yang Anda tetapkan ke kumpulan pengguna dan kumpulan identitas Amazon Cognito Anda.
### Menetapkan tanda
Gunakan perintah berikut untuk menetapkan tanda ke kolam pengguna dan kolam identitas yang ada.
**Example `tag-resource`Perintah untuk kumpulan pengguna**
Menetapkan tanda ke kolam pengguna dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html) dalam set perintah `cognito-idp`:
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test
```
Perintah ini mencakup parameter-parameter berikut ini:
+ `resource-arn` — Amazon Resource Name (ARN) dari kolam pengguna tempat Anda menerapkan tanda. Untuk mencari ARN, pilih kolam pengguna di konsol Amazon Cognito, dan lihat nilai **ARN Kolam** pada tab **Pengaturan umum**.
+ `tags`— Pasangan kunci-nilai tag, dalam format. `key=value`
Untuk menetapkan beberapa tanda sekaligus, tentukan tanda tersebut dalam daftar yang dipisahkan koma:
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
**Example `tag-resource`Perintah untuk kumpulan identitas**
Menetapkan tanda ke kolam identitas dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html) dalam set perintah `cognito-identity`:
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test
```
Perintah ini mencakup parameter-parameter berikut ini:
+ `resource-arn` — Amazon Resource Name (ARN) dari kolam identitas tempat Anda menerapkan tanda. Untuk mencari ARN, pilih kolam identitas di konsol Amazon Cognito, dan pilih **Edit kolam identitas**. Kemudian, di **ID kolam identitas**, pilih **Tampilkan ARN**.
+ `tags`— Pasangan kunci-nilai tag, dalam format. `key=value`
Untuk menetapkan beberapa tanda sekaligus, tentukan tanda tersebut dalam daftar yang dipisahkan koma:
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
### Melihat tanda
Gunakan perintah berikut untuk melihat tanda yang telah Anda tetapkan ke kolam pengguna dan kolam identitas Anda.
**Example `list-tags-for-resource`Perintah untuk kumpulan pengguna**
Melihat tanda yang ditetapkan ke kolam pengguna dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html) dalam set perintah `cognito-idp`:
```
$ aws cognito-idp list-tags-for-resource --resource-arn user-pool-arn
```
**Example `list-tags-for-resource`Perintah untuk kumpulan identitas**
Melihat tanda yang ditetapkan ke kolam identitas dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html) dalam set perintah `cognito-identity`:
```
$ aws cognito-identity list-tags-for-resource --resource-arn identity-pool-arn
```
### Menghapus tanda
Gunakan perintah berikut untuk menghapus tanda dari kolam pengguna dan kolam identitas Anda.
**Example `untag-resource`Perintah untuk kumpulan pengguna**
Menghapus tanda dari kolam pengguna dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html) dalam set perintah `cognito-idp`:
```
$ aws cognito-idp untag-resource \
> --resource-arn user-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Untuk `--tag-keys` parameter, tentukan satu atau lebih kunci tag. Jangan sertakan nilai tag. Pisahkan kunci dengan spasi.
**Example `untag-resource`Perintah untuk kumpulan identitas**
Menghapus tanda dari kolam identitas dengan menggunakan [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html) dalam set perintah `cognito-identity`:
```
$ aws cognito-identity untag-resource \
> --resource-arn identity-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Untuk `--tag-keys` parameter, tentukan satu atau lebih kunci tag. Jangan sertakan nilai tag.
**penting**
Setelah menghapus pengguna atau kumpulan identitas, tag yang terkait dengan kumpulan yang dihapus masih dapat muncul di konsol atau panggilan API hingga 30 hari setelah penghapusan.
### Menerapkan tanda saat Anda membuat sumber daya
Gunakan perintah berikut untuk menetapkan tanda saat Anda membuat kolam pengguna atau kolam identitas.
**Example `create-user-pool`Perintah dengan tag**
Ketika Anda membuat kolam pengguna dengan menggunakan perintah [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html), Anda dapat menentukan tanda dengan parameter `--user-pool-tags`:
```
$ aws cognito-idp create-user-pool \
> --pool-name user-pool-name \
> --user-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Pasangan nilai kunci untuk tag harus dalam format. `key=value` Jika Anda menambahkan beberapa tag, tentukan dalam daftar yang dipisahkan koma.
**Example `create-identity-pool`Perintah dengan tag**
Ketika Anda membuat kolam identitas dengan menggunakan perintah [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html), Anda dapat menentukan tanda dengan parameter `--identity-pool-tags`:
```
$ aws cognito-identity create-identity-pool \
> --identity-pool-name identity-pool-name \
> --allow-unauthenticated-identities \
> --identity-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Pasangan nilai kunci untuk tag harus dalam format. `key=value` Jika Anda menambahkan beberapa tag, tentukan dalam daftar yang dipisahkan koma.
## Mengelola tag menggunakan Amazon Cognito API
Anda dapat menggunakan tindakan berikut di API Amazon Cognito untuk mengelola tanda untuk kolam pengguna dan kolam identitas Anda.
### Tindakan API untuk tag kumpulan pengguna
Gunakan tindakan API berikut untuk menetapkan, melihat, dan menghapus tanda untuk kolam pengguna.
+ [TagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UntagResource.html)
+ [CreateUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPool.html)
### Tindakan API untuk tag kumpulan identitas
Gunakan tindakan API berikut untuk menetapkan, melihat, dan menghapus tanda untuk kolam identitas.
+ [TagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_UntagResource.html)
+ [CreateIdentityPool](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_CreateIdentityPool.html)