Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menandai aturan dan grup pengambilan sampel X-Ray
Tag adalah kata atau frasa yang dapat Anda gunakan untuk mengidentifikasi dan mengatur AWS sumber daya Anda. Anda dapat menambahkan beberapa tanda pada setiap sumber daya. Setiap tanda mencakup kunci dan nilai opsional yang Anda tentukan. Misalnya, kunci tanda mungkin **domain**, dan nilai tanda mungkin **example.com**. Anda dapat mencari dan memfilter sumber daya Anda berdasarkan tanda yang Anda tambahkan. Untuk informasi selengkapnya tentang cara menggunakan tanda, lihat [Penandaan sumber daya AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) di *Referensi Umum AWS *.
Anda dapat menggunakan tag untuk menerapkan izin berbasis tag pada distribusi. CloudFront Untuk informasi selengkapnya, lihat [Mengontrol Akses ke Sumber Daya AWS Menggunakan Tanda Sumber Daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
**catatan**
[Editor Tanda](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) dan [Resource Groups AWS](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) saat ini tidak mendukung sumber daya X-Ray. Anda menambahkan dan mengelola tag dengan menggunakan AWS X-Ray konsol atau API.
Anda dapat menerapkan tag ke sumber daya dengan menggunakan konsol X-Ray, API AWS CLI, SDKs, dan AWS Tools for Windows PowerShell. Untuk informasi selengkapnya, lihat dokumentasi berikut ini:
+ API X-Ray – Lihat operasi berikut di *Referensi API AWS X-Ray *:
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [CreateSamplingRule](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html)
+ [CreateGroup](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)
+ AWS CLI — Lihat [xray di Referensi AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html) *Perintah*
+ SDKs — Lihat dokumentasi SDK yang berlaku di halaman [AWS Dokumentasi](https://docs.aws.amazon.com/)
**catatan**
Jika Anda tidak dapat menambahkan atau mengubah tanda pada sumber daya X-Ray, atau Anda tidak dapat menambahkan sumber daya yang memiliki tanda tertentu, Anda mungkin tidak memiliki izin untuk melakukan operasi ini. Untuk meminta akses, hubungi AWS pengguna di perusahaan Anda yang memiliki izin **Administrator** di X-Ray.
**Topics**
+ [Pembatasan tag](#xray-tagging-restrictions)
+ [Mengelola tanda di konsol tersebut](#xray-tagging-manage)
+ [Mengelola tag di AWS CLI](#xray-tagging-manage-cli)
+ [Kontrol akses ke sumber daya X-Ray berdasarkan tanda](#xray-tagging-policy)
## Pembatasan tag
Batasan berikut berlaku untuk tanda.
+ Jumlah maksimum tanda per sumber daya – 50
+ Panjang kunci maksimum – 128 karakter Unicode
+ Panjang nilai maksimum – 256 karakter Unicode
+ Nilai yang valid untuk kunci dan nilai – a-z, A-Z, 0-9, spasi, dan karakter berikut: \$1 . : / = \$1 - dan @
+ Kunci dan nilai tag sensitif huruf besar dan kecil.
+ Jangan gunakan `aws:` sebagai prefiks untuk kunci; ini disimpan untuk penggunaan AWS .
**catatan**
Anda tidak dapat mengedit atau menghapus tanda sistem.
## Mengelola tanda di konsol tersebut
Anda dapat menambahkan tanda opsional saat membuat grup X-Ray atau aturan pengambilan sampel. Tanda juga dapat diubah atau dihapus di konsol tersebut nanti.
Prosedur berikut menjelaskan cara menambahkan, mengedit, dan menghapus tanda untuk grup dan aturan pengambilan sampel Anda di konsol X-Ray.
**Topics**
+ [Tambahkan tanda ke grup baru (konsol)](#xray-tagging-add-group-console)
+ [Tambahkan tanda ke aturan pengambilan sampel baru (konsol)](#xray-tagging-add-rule-console)
+ [Edit atau hapus tanda untuk grup (konsol)](#xray-tagging-change-group-console)
+ [Edit atau hapus tanda untuk aturan pengambilan sampel (konsol)](#xray-tagging-change-rule-console)
### Tambahkan tanda ke grup baru (konsol)
Saat membuat grup X-Ray baru, Anda dapat menambahkan tanda opsional di halaman **Buat grup**.
1. Masuk ke Konsol Manajemen AWS dan buka konsol X-Ray di [https://console.aws.amazon.com/xray/rumah](https://console.aws.amazon.com/xray/home).
1. Di panel navigasi, luaskan **Konfigurasi**, dan pilih **Grup**.
1. Pilih **Buat grup**.
1. Pada halaman **Buat grup**, tentukan nama dan ekspresi filter untuk grup. Untuk informasi selengkapnya tentang properti ini, lihat [Mengkonfigurasi grup](xray-console-groups.md).
1. Di **Tanda**, masukkan kunci tanda dan, secara opsional, nilai tanda. Misalnya, Anda dapat memasukkan kunci tanda **Stage**, dan nilai tanda **Production**, untuk menunjukkan bahwa grup ini digunaan untuk produksi. Saat Anda menambahkan tanda, baris baru akan muncul bagi Anda untuk menambahkan tanda lain, jika diperlukan. Lihat [Pembatasan tag](#xray-tagging-restrictions) di topik ini untuk keterbatasan pada tanda.
1. Setelah Anda selesai menambahkan tanda, pilih **Buat grup**.
### Tambahkan tanda ke aturan pengambilan sampel baru (konsol)
Saat membuat aturan pengambilan sampel X-Ray baru, Anda dapat menambahkan tanda di halaman **Buat aturan pengambilan sampel**.
1. Masuk ke Konsol Manajemen AWS dan buka konsol X-Ray di [https://console.aws.amazon.com/xray/rumah](https://console.aws.amazon.com/xray/home).
1. Di panel navigasi, luaskan **Konfigurasi**, dan pilih **Pengambilan Sampel**.
1. Pilih **Buat aturan pengambilan sampel**.
1. Pada **Buat aturan pengambilan sampel**, tentukan nama, prioritas, batas, kriteria pencocokan, dan atribut yang cocok. Untuk informasi selengkapnya tentang properti ini, lihat [Mengonfigurasi aturan pengambilan sampel](xray-console-sampling.md).
1. Di **Tanda**, masukkan kunci tanda dan, secara opsional, nilai tanda. Misalnya, Anda dapat memasukkan kunci tanda **Stage**, dan nilai tanda **Production**, untuk menunjukkan bahwa aturan pengambilan sampel ini digunaan untuk produksi. Saat Anda menambahkan tanda, baris baru akan muncul untuk menambahkan tanda lain, jika diperlukan. Lihat [Pembatasan tag](#xray-tagging-restrictions) di topik ini untuk keterbatasan pada tanda.
1. Setelah Anda selesai menambahkan tanda, pilih **Buat aturan pengambilan sampel**.
### Edit atau hapus tanda untuk grup (konsol)
Anda dapat mengubah atau menghapus tanda pada grup X-Ray di halaman **Edit grup**.
1. Masuk ke Konsol Manajemen AWS dan buka konsol X-Ray di [https://console.aws.amazon.com/xray/rumah](https://console.aws.amazon.com/xray/home).
1. Di panel navigasi, luaskan **Konfigurasi**, dan pilih **Grup**.
1. Di tabel **Grup**, pilih nama grup.
1. Pada halaman **Edit grup**, di **Tanda**, edit kunci dan nilai tanda. Anda tidak dapat memiliki kunci tanda duplikat. Nilai tanda bersifat opsional; Anda dapat menghapus nilai jika diinginkan. Untuk informasi selengkapnya tentang properti lain di halaman **Edit grup**, lihat [Mengkonfigurasi grup](xray-console-groups.md). Lihat [Pembatasan tag](#xray-tagging-restrictions) di topik ini untuk keterbatasan pada tanda.
1. Untuk menghapus tanda, pilih **X** di sebelah kanan tanda.
1. Setelah selesai mengedit atau menghapus tanda, pilih **Perbarui grup**.
### Edit atau hapus tanda untuk aturan pengambilan sampel (konsol)
Anda dapat mengubah atau menghapus tanda pada aturan pengambilan sampel X-Ray di halaman **Edit aturan pengambilan sampel**.
1. Masuk ke Konsol Manajemen AWS dan buka konsol X-Ray di [https://console.aws.amazon.com/xray/rumah](https://console.aws.amazon.com/xray/home).
1. Di panel navigasi, luaskan **Konfigurasi**, dan pilih **Pengambilan Sampel**.
1. Di tabel **Aturan pengambilan sampel**, pilih nama aturan pengambilan sampel.
1. Di **Tanda**, edit kunci dan nilai tanda. Anda tidak dapat memiliki kunci tanda duplikat. Nilai tanda bersifat opsional; Anda dapat menghapus nilai jika diinginkan. Untuk informasi selengkapnya tentang properti lain di halaman **Edit aturan pengambilan sampel**, lihat [Mengonfigurasi aturan pengambilan sampel](xray-console-sampling.md). Lihat [Pembatasan tag](#xray-tagging-restrictions) di topik ini untuk keterbatasan pada tanda.
1. Untuk menghapus tanda, pilih **X** di sebelah kanan tanda.
1. Setelah selesai mengedit atau menghapus tanda, pilih **Perbarui aturan pengambilan sampel**.
## Mengelola tag di AWS CLI
Anda dapat menambahkan tanda saat membuat grup X-Ray atau aturan pengambilan sampel. Anda juga dapat menggunakan AWS CLI untuk membuat dan mengelola tag. Untuk memperbarui tag pada grup atau aturan pengambilan sampel yang ada, gunakan AWS X-Ray konsol, atau atau. [TagResource[UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html) APIs
**Topics**
+ [Tambahkan tanda ke grup X-Ray atau aturan pengambilan sampel baru (CLI)](#xray-tagging-cli-create)
+ [Tambahkan tanda ke sumber daya yang ada (CLI)](#xray-tagging-cli-add)
+ [Daftar tanda pada sumber daya (CLI)](#xray-tagging-cli-list)
+ [Hapus tanda pada sumber daya (CLI)](#xray-tagging-cli-delete)
### Tambahkan tanda ke grup X-Ray atau aturan pengambilan sampel baru (CLI)
Untuk menambahkan tanda opsional saat Anda membuat grup X-Ray atau aturan pengambilan sampel baru, gunakan salah satu perintah berikut.
+ Untuk menambahkan tag ke grup baru, jalankan perintah berikut, ganti *group\$1name* dengan nama grup Anda, *mydomain.com* dengan titik akhir layanan Anda, *key\$1name* dengan kunci tag, dan opsional, *value* dengan nilai tag. Untuk informasi selengkapnya tentang cara membuat grup, lihat [Grup](xray-api-configuration.md#xray-api-configuration-groups).
```
aws xray create-group \
--group-name "group_name" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]
```
Berikut adalah contohnya.
```
aws xray create-group \
--group-name "AdminGroup" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
+ Untuk menambahkan tag ke aturan sampling baru, jalankan perintah berikut, ganti *key\$1name* dengan kunci tag, dan opsional, *value* dengan nilai tag. Perintah ini menentukan nilai dalam parameter `--sampling-rule` sebagai file JSON. Untuk informasi selengkapnya tentang cara membuat aturan pengambilan sampel, lihat [Aturan pengambilan sampel](xray-api-configuration.md#xray-api-configuration-sampling).
```
aws xray create-sampling-rule \
--cli-input-json file://file_name.json
```
Berikut ini adalah isi dari file JSON *file\$1name.json* yang ditentukan oleh `--cli-input-json` parameter.
```
{
"SamplingRule": {
"RuleName": "rule_name",
"RuleARN": "string",
"ResourceARN": "string",
"Priority": integer,
"FixedRate": double,
"ReservoirSize": integer,
"ServiceName": "string",
"ServiceType": "string",
"Host": "string",
"HTTPMethod": "string",
"URLPath": "string",
"Version": integer,
"Attributes": {"attribute_name": "value","attribute_name": "value"...}
}
"Tags": [
{
"Key":"key_name",
"Value":"value"
},
{
"Key":"key_name",
"Value":"value"
}
]
}
```
Berikut adalah contoh perintah tersebut.
```
aws xray create-sampling-rule \
--cli-input-json file://9000-base-scorekeep.json
```
Berikut ini adalah isi dari contoh file `9000-base-scorekeep.json` yang ditentukan oleh parameter `--cli-input-json`.
```
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1
}
"Tags": [
{
"Key":"Stage",
"Value":"Prod"
},
{
"Key":"Department",
"Value":"QA"
}
]
}
```
### Tambahkan tanda ke sumber daya yang ada (CLI)
Anda dapat menjalankan perintah `tag-resource` untuk menambahkan tanda ke grup X-Ray atau aturan pengambilan sampel yang ada. Metode ini mungkin lebih sederhana daripada menambahkan tanda dengan menjalankan `update-group` atau `update-sampling-rule`.
Untuk menambahkan tanda ke grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya, dan tentukan kunci dan nilai opsional tanda yang ingin Anda tambahkan.
```
aws xray tag-resource \
--resource-arn "ARN" \
--tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]
```
Berikut adalah contohnya.
```
aws xray tag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
--tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
### Daftar tanda pada sumber daya (CLI)
Anda dapat menjalankan perintah `list-tags-for-resource` untuk daftar tanda dari grup X-Ray atau aturan pengambilan sampel.
Untuk mendaftarkan tanda yang terkait dengan grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya.
```
aws xray list-tags-for-resource \
--resource-arn "ARN"
```
Berikut adalah contohnya.
```
aws xray list-tags-for-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
```
### Hapus tanda pada sumber daya (CLI)
Anda dapat menjalankan perintah `untag-resource` untuk menghapus tanda dari grup X-Ray atau aturan pengambilan sampel.
Untuk menghapus tanda dari grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya, dan tentukan kunci tanda yang ingin Anda hapus.
Anda hanya dapat menghapus seluruh tanda dengan perintah `untag-resource`. Untuk menghapus nilai tanda, gunakan konsol X-Ray, atau hapus tanda dan tambahkan tanda baru dengan kunci yang sama, tetapi nilai yang berbeda atau kosong.
```
aws xray untag-resource \
--resource-arn "ARN" \
--tag-keys ["key_name","key_name"]
```
Berikut adalah contohnya.
```
aws xray untag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
--tag-keys ["Stage","Department"]
```
## Kontrol akses ke sumber daya X-Ray berdasarkan tanda
Anda dapat melampirkan tanda ke grup X-Ray atau aturan pengambilan sampel, atau meneruskan tanda dalam permintaan ke X-Ray. Untuk mengendalikan akses berdasarkan tanda, Anda dapat memberikan informasi tentang tanda di kebijakan [elemen syarat](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) menggunakan kunci syarat `xray:ResourceTag/key-name`, `aws:RequestTag/key-name`, atau `aws:TagKeys`. Untuk mempelajari selengkapnya tentang kunci kondisi ini, lihat [Mengontrol akses ke AWS sumber daya menggunakan tag sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
Untuk melihat contoh kebijakan berbasis identitas untuk membatasi akses ke sumber daya berdasarkan tag pada sumber daya tersebut, lihat [Mengelola akses ke grup X-Ray dan aturan pengambilan sampel berdasarkan tanda](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags).