

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

# AWS Direct Connect Sumber daya tag
<a name="using-tags"></a>

Tag adalah label yang diberikan pemilik sumber daya ke sumber Direct Connect daya mereka. Setiap tag terdiri dari kunci dan nilai opsional, yang keduanya Anda tentukan. Tag memungkinkan pemilik sumber daya untuk mengkategorikan Direct Connect sumber daya Anda dengan cara yang berbeda, misalnya, berdasarkan tujuan, atau lingkungan. Hal ini berguna ketika Anda memiliki banyak sumber daya dengan jenis yang sama—Anda dapat dengan cepat mengidentifikasi sumber daya tertentu berdasarkan tanda yang telah Anda tetapkan. 

Misalnya, Anda memiliki dua Direct Connect koneksi di Wilayah, masing-masing di lokasi yang berbeda. Koneksi `dxcon-11aa22bb` adalah koneksi melayani lalu lintas produksi, dan berhubungan dengan antarmuka virtual `dxvif-33cc44dd`. Koneksi `dxcon-abcabcab` adalah koneksi berlebihan (cadangan), dan berhubungan dengan antarmuka virtual `dxvif-12312312`. Anda dapat memilih untuk menandai koneksi dan antarmuka virtual sebagai berikut, untuk membantu membedakannya:

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/directconnect/latest/UserGuide/using-tags.html)

Kami menyarankan agar Anda merancang serangkaian kunci tanda yang memenuhi kebutuhan Anda untuk setiap jenis sumber daya. Penggunaan set kunci tag yang konsisten akan memudahkan manajemen sumber daya Anda. Tag tidak memiliki arti semantik Direct Connect dan ditafsirkan secara ketat sebagai serangkaian karakter. Selain itu, tag tidak secara otomatis ditetapkan ke sumber daya Anda. Anda dapat mengedit kunci dan nilai tanda, dan dapat menghapus tanda dari sumber daya kapan saja. Anda dapat mengatur nilai tanda ke string kosong, tetapi tidak dapat mengatur nilai tanda ke null. Jika Anda menambahkan tanda yang memiliki kunci yang sama dengan tanda yang telah ada pada sumber daya tersebut, nilai yang baru akan menimpa nilai yang lama. Jika sumber daya dihapus, semua tanda untuk sumber daya tersebut juga akan dihapus. 

Anda dapat menandai Direct Connect sumber daya berikut menggunakan Direct Connect konsol, Direct Connect API AWS CLI, AWS Tools for Windows PowerShell, atau AWS SDK. Ketika Anda menggunakan alat ini untuk mengelola tanda, Anda harus menentukan Amazon Resource Name (ARN) untuk sumber daya. Untuk informasi selengkapnya ARNs, lihat [Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) di *Referensi Umum Amazon Web*.


| Sumber daya | Dukungan tanda | Dukungan tanda saat penciptaan | Mendukung tanda yang mengendalikan akses dan alokasi sumber daya | Mendukung alokasi biaya | 
| --- | --- | --- | --- | --- | 
| Koneksi |  Ya | Ya | Ya | Ya | 
| Antarmuka virtual | Ya | Ya | Ya | Tidak | 
| Kelompok agregasi tautan (LAG) | Ya | Ya | Ya | Ya | 
| Antarkoneksi | Ya | Ya | Ya | Ya | 
| Gateway Direct Connect | Ya | Ya | Ya | Tidak | 

## Batasan tanda
<a name="using-tags-restrictions"></a>

Batasan dan aturan berikut berlaku untuk tanda:
+ Jumlah maksimum tanda per sumber daya: 50
+ Panjang kunci maksimum: 128 karakter Unicode
+ Panjang nilai maksimum: 256 karakter Unicode
+ Kunci dan nilai tag peka huruf besar dan kecil.
+ `aws:`Awalan dicadangkan untuk AWS digunakan. Anda tidak dapat mengedit atau menghapus kunci atau nilai tanda jika tanda memiliki kunci tanda dengan `aws:` prefiks. Tanda dengan kunci tanda dengan prefiks `aws:` tidak dihitung terhadap tanda Anda per batas sumber daya.
+ Karakter yang diperbolehkan adalah: huruf, spasi, dan angka yang dapat mewakili dalam UTF-8, serta karakter berikut: \$1 - = . \$1 : / @
+ Hanya pemilik sumber daya yang dapat menambahkan atau menghapus tanda. Misalnya, jika ada koneksi yang di-host, partner tidak akan dapat menambahkan, menghapus, atau melihat tanda. 
+ Tag alokasi biaya hanya didukung untuk koneksi, interkoneksi, dan. LAGs Untuk informasi tentang cara menggunakan tag dengan manajemen biaya, lihat [Menggunakan Tag Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) di *Panduan AWS Manajemen Penagihan dan Biaya Pengguna*.

## Bekerja dengan tanda menggunakan CLI atau API
<a name="working-with-tags"></a>

Gunakan yang berikut ini untuk menambahkan, memperbarui, membuat daftar, dan menghapus tanda untuk sumber daya Anda.


| Tugas | API | CLI | 
| --- | --- | --- | 
| Tambahkan atau timpa satu atau beberapa tanda. |  [TagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_TagResource.html) | [tag-sumber daya](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) | 
| Hapus satu atau beberapa tanda. |  [UntagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_UntagResource.html) | [untag-sumber daya](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) | 
| Penjelasan satu tanda atau lebih | [DescribeTags](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_DescribeTags.html) | [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) | 

### Contoh
<a name="working-with-tags-examples"></a>

Menggunakan perintah [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) untuk menandai `dxcon-11aa22bb` Koneksi.

```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"
```

Menggunakan perintah [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) untuk menjelaskan tanda `dxcon-11aa22bb` Koneksi.

```
aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```

Gunakan perintah [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) untuk menghapus tanda dari Koneksi `dxcon-11aa22bb`.

```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose
```