Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda
AWS memungkinkan Anda untuk menetapkan metadata ke AWS sumber daya Anda dalam bentuk tag. Anda dapat menggunakan tag ini untuk membantu mengelola pembuat gambar WorkSpaces Aplikasi, gambar, armada, dan tumpukan, dan juga mengatur data, termasuk data penagihan.
Anda dapat:
+ Secara logis mengelompokkan sumber daya dengan cara yang berbeda (misalnya, berdasarkan tujuan, pemilik, atau lingkungan).
Hal ini berguna jika Anda memiliki banyak sumber daya dengan jenis yang sama.
+ Identifikasi sumber daya tertentu dengan cepat berdasarkan tag yang telah Anda tetapkan
+ Identifikasi dan kendalikan AWS biaya
Misalnya, Anda dapat mengidentifikasi dan mengelompokkan armada WorkSpaces Aplikasi yang berada di lingkungan yang berbeda (seperti Pengembangan atau Produksi) atau yang ditugaskan ke unit bisnis yang berbeda (seperti SDM atau Pemasaran). Anda kemudian dapat melacak AWS biaya terkait untuk armada ini pada tingkat terperinci. Untuk melakukan ini, daftar untuk mendapatkan tagihan akun Amazon Web Services Anda dengan menyertakan nilai kunci tag. Untuk informasi selengkapnya tentang menyiapkan laporan alokasi biaya dengan tag, lihat [Laporan Alokasi Biaya Bulanan](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) di *AWS Billing Panduan Pengguna*.
**Topics**
+ [Dasar Penandaan](tagging-introduction.md)
+ [Pembatasan Tag](tag-restrictions.md)
+ [Menambahkan Tag selama Pembuatan Sumber Daya](basic-tagging-resource-creation-console.md)
+ [Menambahkan, Mengedit, dan Menghapus Tag](basic-tagging-console.md)
+ [Menggunakan API, SDK, atau CLI](basic-tagging-API-SDK-CLI.md)
# Dasar-dasar Penandaan untuk Aplikasi Amazon WorkSpaces
Tag terdiri dari pasangan kunci-nilai, mirip dengan tag AWS layanan lainnya. Untuk menandai sumber daya, Anda menentukan *kunci* dan *nilai* untuk setiap tag. Kunci dapat berupa kategori umum, seperti “proyek”, “pemilik”, atau “lingkungan”, dengan nilai terkait tertentu, dan Anda dapat berbagi kunci dan nilai yang sama di beberapa sumber daya. Anda dapat menandai sumber daya WorkSpaces Aplikasi segera setelah Anda membuatnya atau nanti. Jika Anda menghapus sumber daya, tag akan dihapus dari sumber daya tersebut saat dihapus. Namun, WorkSpaces Aplikasi dan AWS sumber daya lain yang memiliki kunci tag yang sama tidak terpengaruh.
Anda dapat mengedit kunci dan nilai tanda, dan Anda dapat menghapus tanda dari sumber daya kapan pun. Anda dapat mengatur nilai tag ke string kosong, tetapi Anda tidak dapat mengatur nama tag ke null. Jika Anda menambahkan tanda yang memiliki kunci yang sama dengan tanda yang sudah ada di sumber daya tersebut, nilai baru akan menimpa nilai lama. Jika sumber daya dihapus, semua tanda untuk sumber daya tersebut juga akan dihapus.
**catatan**
Jika Anda berencana menyiapkan laporan alokasi biaya bulanan untuk melacak AWS biaya sumber daya WorkSpaces Aplikasi, ingatlah bahwa tag yang ditambahkan ke sumber daya WorkSpaces Aplikasi yang ada muncul di laporan alokasi biaya pada bulan pertama bulan berikutnya untuk sumber daya yang diperbarui pada bulan tersebut.
# Batasan Tag untuk WorkSpaces Aplikasi Amazon
+ Jumlah maksimum tag per sumber daya WorkSpaces Aplikasi adalah 50.
+ Panjang kunci maksimum adalah 128 karakter Unicode di UTF-8.
+ Panjang nilai maksimum adalah 256 karakter Unicode di UTF-8.
+ Kunci dan nilai tag peka terhadap huruf besar dan kecil.
+ Jangan gunakan awalan “aws:” dalam nama atau nilai tag Anda karena ini adalah tag sistem yang dicadangkan untuk AWS digunakan. Anda tidak dapat mengedit atau menghapus nama atau nilai tag dengan awalan ini. Tanda dengan prefiks ini tidak dihitung terhadap tanda Anda per batas sumber daya.
+ Karakter yang diizinkan secara umum adalah: huruf, angka, dan spasi yang dapat direpresentasikan dalam UTF-8, dan karakter khusus berikut: \$1 - =. \$1:/@.
+ Meskipun Anda dapat berbagi kunci dan nilai yang sama di beberapa sumber daya, Anda tidak dapat memiliki kunci duplikat pada sumber daya yang sama.
+ Anda dapat menambahkan tag untuk sumber daya selama pembuatan sumber daya. Anda juga dapat menambahkan, mengedit, dan menghapus tag untuk sumber daya yang sudah dibuat.
# Menambahkan Tag selama Pembuatan Sumber Daya di Amazon WorkSpaces Applications Console
Saat membuat sumber daya di konsol WorkSpaces Aplikasi, Anda dapat menambahkan satu atau beberapa tag untuk mengelola sumber daya. Untuk informasi selengkapnya, lihat topik berikut:
+ Pembangun gambar -[Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md), langkah 4
+ Gambar -[Langkah 6: Selesai Membuat Gambar Anda](tutorial-image-builder.md#tutorial-image-builder-finish-create-image), langkah 1
+ Armada -[Buat Armada di WorkSpaces Aplikasi Amazon](set-up-stacks-fleets-create.md), langkah 3
+ Tumpukan -[Buat Tumpukan di WorkSpaces Aplikasi Amazon](set-up-stacks-fleets-install.md), langkah 2
# Menambahkan, Mengedit, dan Menghapus Tag untuk Sumber Daya yang Ada di Konsol WorkSpaces Aplikasi Amazon
Anda dapat menambahkan, mengedit, dan menghapus tag untuk sumber daya yang ada dengan menggunakan konsol WorkSpaces Aplikasi.
**Untuk menambah, mengedit, atau menghapus tag untuk sumber daya WorkSpaces Aplikasi yang ada**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Dari bilah navigasi, pilih Wilayah yang berisi sumber daya yang ingin Anda tambahkan, edit, atau hapus tag.
1. Di panel navigasi, pilih jenis sumber daya. Jenis sumber daya dapat berupa pembuat gambar, gambar, armada, atau tumpukan.
1. Pilih sumber daya dari daftar sumber daya.
1. Pilih **Tag**, **Tambahkan/Edit Tag**, lalu lakukan satu atau beberapa hal berikut:
+ Untuk menambahkan tag, pilih **Tambah Tag**, dan ketik kunci dan nilai untuk setiap tag.
+ Untuk mengedit tag, ubah kunci dan nilai untuk tag sesuai kebutuhan.
+ Untuk menghapus tag, pilih ikon **Hapus** (X) untuk tag.
1. Pilih **Simpan**.
# Bekerja dengan Tag dengan Menggunakan Amazon WorkSpaces Applications API, AWS SDK, atau AWS CLI
Jika Anda menggunakan WorkSpaces Applications API, AWS SDK, atau AWS Command Line Interface (AWS CLI), Anda dapat menggunakan operasi Aplikasi WorkSpaces berikut dengan `tags` parameter untuk menambahkan tag saat Anda membuat sumber daya baru.
**catatan**
Anda dapat menggunakan spasi dalam kunci tag dan nilai. Untuk menunjukkan spasi saat Anda menggunakan AWS CLI, gunakan “\$1 s” (tanpa tanda kutip).
| Tugas | AWS CLI | Operasi API |
| --- | --- | --- |
| Tambahkan satu atau beberapa tag untuk armada baru | [membuat-armada](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html) | [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags) |
| Tambahkan satu atau beberapa tag untuk pembuat gambar baru | [buat-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) | [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags) |
| Tambahkan satu atau beberapa tag untuk tumpukan baru | [buat-tumpukan](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html) | [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags) |
Anda dapat menggunakan operasi WorkSpaces Aplikasi berikut untuk menambah, mengedit, menghapus, atau mencantumkan tag untuk sumber daya yang ada:
| Tugas | AWS CLI | Operasi API |
| --- | --- | --- |
| Menambahkan atau menimpa satu atau beberapa tag untuk sumber daya | [tag-sumber daya](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html) |
| Hapus satu atau beberapa tag untuk sumber daya | [untag-sumber daya](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html) |
| Buat daftar satu atau beberapa tag untuk sumber daya | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html) |
Saat Anda menggunakan WorkSpaces Applications API, AWS SDK, atau tindakan AWS CLI untuk menambahkan, mengedit, menghapus, atau mencantumkan tag untuk sumber daya Aplikasi yang WorkSpaces ada, tentukan sumber daya dengan menggunakan Amazon Resource Name (ARN). ARN secara unik mengidentifikasi AWS sumber daya dan menggunakan sintaks umum berikut.
```
arn:aws:appstream:region:account:resourceType/resourceName
```
***region***
AWS Wilayah di mana sumber daya dibuat (misalnya,`us-east-1`).
***account***
Akun AWS ID, tanpa tanda hubung (misalnya,`123456789012`).
***resourceType***
Jenis sumber daya. Anda dapat menandai jenis sumber daya WorkSpaces Aplikasi berikut:`image-builder`,`image`,`fleet`, dan`stack`.
***resourceName***
Nama sumber daya.
[Misalnya, Anda dapat memperoleh ARN untuk armada WorkSpaces Aplikasi dengan menggunakan perintah AWS CLI describe-fleet.](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) Salin perintah berikut.
```
aws appstream describe-fleets
```
Untuk lingkungan yang berisi satu armada bernama`TestFleet`, ARN untuk sumber daya ini akan muncul di output JSON yang mirip dengan yang berikut ini.
```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```
Setelah Anda mendapatkan ARN untuk sumber daya ini, Anda dapat menambahkan dua tag dengan menggunakan perintah [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html):
```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```
Tag pertama,`Environment=Test`, menunjukkan bahwa armada berada dalam lingkungan pengujian. Tag kedua,`Department=IT`, menunjukkan bahwa armada ada di departemen TI.
Anda dapat menggunakan perintah berikut untuk mencantumkan dua tag yang Anda tambahkan ke armada.
```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```
Untuk contoh ini, output JSON muncul sebagai berikut:
```
{
"Tags": {
"Environment" : "Test",
"Department" : "IT"
}
}
```