

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

# Menandai sumber daya koneksi
<a name="connections-tag"></a>

*Tag* adalah label atribut kustom yang Anda atau AWS tetapkan ke AWS sumber daya. Setiap AWS tag memiliki dua bagian:
+ Sebuah *kunci tag* (misalnya, `CostCenter`, `Environment`, atau `Project`). Kunci tanda peka terhadap huruf besar dan kecil.
+ Bidang opsional yang dikenal sebagai *nilai tag* (misalnya, `111122223333`, `Production`, atau nama tim). Mengabaikan nilai tag sama dengan menggunakan rangkaian kosong. Seperti kunci tanda, nilai tanda peka huruf besar dan kecil.

Bersama-sama ini dikenal sebagai *pasangan nilai kunci*.

Anda dapat menggunakan konsol atau CLI untuk menandai sumber daya.

Anda dapat menandai jenis sumber daya berikut di AWS CodeConnections:
+ Koneksi
+ Host

Langkah-langkah ini mengasumsikan bahwa Anda telah menginstal versi terbaru AWS CLI atau diperbarui ke versi saat ini. Untuk informasi selengkapnya, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) dalam *Panduan Pengguna AWS Command Line Interface *.

Selain mengidentifikasi, mengatur, dan melacak sumber daya Anda dengan tag, Anda dapat menggunakan kebijakan tag dalam AWS Identity and Access Management (IAM) untuk membantu mengontrol siapa yang dapat melihat dan berinteraksi dengan sumber daya Anda. Untuk contoh kebijakan akses berbasis tag, lihat [Menggunakan tag untuk mengontrol akses ke AWS CodeConnections sumber daya](connections-tag-based-access-control.md).

**Topics**
+ [Menandai sumber daya (konsol)](#connections-tag-console)
+ [Tanda sumber daya (CLI)](#connections-tag-cli)

## Menandai sumber daya (konsol)
<a name="connections-tag-console"></a>

Anda dapat menggunakan konsol untuk menambah, memperbarui, atau menghapus tanda pada sumber daya koneksi.

**Topics**
+ [Menambahkan tanda ke sumber daya koneksi (konsol)](#connections-tag-console-add)
+ [Melihat tanda untuk sumber daya koneksi (konsol)](#connections-tag-console-view)
+ [Edit tanda untuk sumber daya koneksi (konsol)](#connections-tag-console-edit)
+ [Hapus tanda dari sumber daya koneksi (konsol)](#connections-tag-console-remove)

### Menambahkan tanda ke sumber daya koneksi (konsol)
<a name="connections-tag-console-add"></a>

Anda dapat menggunakan konsol untuk menambahkan tanda ke koneksi atau host yang ada.

**catatan**  
Saat Anda membuat koneksi untuk penyedia yang diinstal seperti GitHub Enterprise Server, dan sumber daya host juga dibuat untuk Anda, tag selama pembuatan ditambahkan ke koneksi saja. Hal ini memungkinkan Anda untuk menandai host secara terpisah jika Anda ingin menggunakannya kembali untuk koneksi baru. Jika Anda ingin menambahkan tanda ke host, gunakan langkah-langkah di sini.

****Untuk menambahkan tag untuk koneksi****

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Koneksi**.

1. Pilih koneksi yang ingin Anda edit. Halaman pengaturan koneksi ditampilkan.

1. Pada **Tanda koneksi**, pilih **Edit**. Halaman **Edit Tanda koneksi** ditampilkan.

1. Di bidang **Kunci** dan **Nilai**, masukkan pasangan kunci untuk setiap kumpulan tanda yang ingin Anda tambahkan. (Bidang **Nilai** adalah bersifat opsional.) Contohnya, dalam **Key** (Kunci), masukkan **Project**. Dalam **Value** (Nilai), masukkan **ProjectA**.  
![\[Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/connections-tags.png)

1. (Opsional) Pilih **Tambahkan tanda** untuk menambahkan lebih banyak baris dan masukkan lebih banyak tanda.

1. Pilih **Kirim**. Tanda tercantum di bawah pengaturan koneksi.

****Untuk menambahkan tag untuk host****

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Host**.

1. Pilih host yang ingin Anda edit. Halaman pengaturan host ditampilkan.

1. Pada **Tanda host**, pilih **Edit**. Halaman **Tanda host** ditampilkan.

1. Di bidang **Kunci** dan **Nilai**, masukkan pasangan kunci untuk setiap kumpulan tanda yang ingin Anda tambahkan. (Bidang **Nilai** adalah bersifat opsional.) Contohnya, dalam **Key** (Kunci), masukkan **Project**. Di **Nilai**, masukkan **ProjectA**.  
![\[Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/hosts-tag.png)

1. (Opsional) Pilih **Tambahkan tanda** untuk menambahkan lebih banyak baris dan masukkan lebih banyak tanda untuk host.

1. Pilih **Kirim**. Tanda tercantum di bawah pengaturan host.

### Melihat tanda untuk sumber daya koneksi (konsol)
<a name="connections-tag-console-view"></a>

Anda dapat menggunakan konsol untuk melihat tanda untuk sumber daya yang ada.

**Untuk melihat tag untuk koneksi**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Koneksi**.

1. Pilih koneksi yang ingin Anda lihat. Halaman pengaturan koneksi ditampilkan.

1. Pada **Tanda koneksi**, lihat tanda untuk koneksi di bawah kolom **Kunci** dan **Nilai**.

**Untuk melihat tag untuk host**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Host**.

1. Pilih host yang ingin Anda lihat.

1. Pada **Tanda host**, lihat tanda untuk host di bawah kolom **Kunci** dan **Nilai**.

### Edit tanda untuk sumber daya koneksi (konsol)
<a name="connections-tag-console-edit"></a>

Anda dapat menggunakan konsol untuk mengedit tanda yang telah ditambahkan ke sumber daya koneksi.

**Untuk mengedit tag untuk koneksi**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Koneksi**.

1. Pilih koneksi yang ingin Anda edit. Halaman pengaturan koneksi ditampilkan.

1. Pada **Tanda koneksi**, pilih **Edit**. Halaman **Tanda koneksi** ditampilkan.

1. Di bidang **Kunci** dan **Nilai**, perbarui nilai di setiap bidang sesuai kebutuhan. Misalnya, untuk kunci **Project**, di **Nilai**, ubah **ProjectA** ke **ProjectB**.

1. Pilih **Kirim**.

**Untuk mengedit tag untuk host**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Host**.

1. Pilih host yang ingin Anda edit. Halaman pengaturan host ditampilkan.

1. Pada **Tanda host**, pilih **Edit**. Halaman **Tanda host** ditampilkan.

1. Di bidang **Kunci** dan **Nilai**, perbarui nilai di setiap bidang sesuai kebutuhan. Misalnya, untuk kunci **Project**, di **Nilai**, ubah **ProjectA** ke **ProjectB**.

1. Pilih **Kirim**.

### Hapus tanda dari sumber daya koneksi (konsol)
<a name="connections-tag-console-remove"></a>

Anda dapat menggunakan konsol untuk menghapus tanda dari sumber daya koneksi. Saat Anda menghapus tanda dari sumber daya yang terkait, tanda akan dihapus.

**Untuk menghapus tag untuk koneksi**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Koneksi**.

1. Pilih koneksi yang ingin Anda edit. Halaman pengaturan koneksi ditampilkan.

1. Pada **Tanda koneksi**, pilih **Edit**. Halaman **Tanda koneksi** ditampilkan.

1. Di samping kunci dan nilai untuk setiap tanda yang ingin Anda hapus, pilih **Hapus tanda**.

1. Pilih **Kirim**.

**Untuk menghapus tag untuk host**

1. Masuk ke konsol . Dari panel navigasi, pilih **Pengaturan**.

1. Pada **Pengaturan**, pilih **Koneksi**. Pilih tab **Host**.

1. Pilih host yang ingin Anda edit. Halaman pengaturan host ditampilkan.

1. Pada **Tanda host**, pilih **Edit**. Halaman **Tanda host** ditampilkan.

1. Di samping kunci dan nilai untuk setiap tanda yang ingin Anda hapus, pilih **Hapus tanda**.

1. Pilih **Kirim**.

## Tanda sumber daya (CLI)
<a name="connections-tag-cli"></a>

Anda dapat menggunakan CLI untuk melihat, menambah, memperbarui, atau menghapus tanda pada sumber daya koneksi.

**Topics**
+ [Menambahkan tanda ke sumber daya koneksi (CLI)](#connections-tag-add)
+ [Melihat tanda untuk sumber daya koneksi (CLI)](#connections-tag-view)
+ [Edit tanda untuk sumber daya koneksi (CLI)](#connections-tag-edit)
+ [Hapus tanda dari sumber daya koneksi (CLI)](#connections-tag-delete)

### Menambahkan tanda ke sumber daya koneksi (CLI)
<a name="connections-tag-add"></a>

Anda dapat menggunakan AWS CLI untuk menandai sumber daya dalam koneksi.

Pada terminal atau baris perintah, jalankan perintah **tag-resource**, tentukan Amazon Resource Name (ARN) dari sumber daya tempat Anda ingin menambahkan tanda serta kunci dan nilai dari tanda yang ingin Anda tambahkan. Anda dapat menambahkan lebih dari satu tanda. 

****Untuk menambahkan tag untuk koneksi****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-connections** yang ditampilkan di [Daftar koneksi](connections-list.md) untuk mendapatkan ARN koneksi.

1. Di terminal atau pada baris perintah, jalankan perintah **tag-resource**. 

   Misalnya, gunakan perintah berikut untuk menandai koneksi dengan dua tag, kunci tag bernama *Project* dengan nilai tag dari*ProjectA*, dan kunci tag bernama *ReadOnly* dengan nilai tag dari*true*.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
   ```

   Jika berhasil, perintah ini tidak mengembalikan apa pun.

****Untuk menambahkan tag untuk host****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-hosts** yang ditampilkan di [Daftar host](connections-host-list.md) untuk mendapatkan ARN host.

1. Di terminal atau pada baris perintah, jalankan perintah **tag-resource**.

   Misalnya, gunakan perintah berikut untuk menandai host dengan dua tag, kunci tag bernama *Project* dengan nilai tag dari*ProjectA*, dan kunci tag bernama *IscontainerBased* dengan nilai tag dari*true*.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
   ```

   Jika berhasil, perintah ini tidak mengembalikan apa pun.

### Melihat tanda untuk sumber daya koneksi (CLI)
<a name="connections-tag-view"></a>

Anda dapat menggunakan AWS CLI untuk melihat AWS tag untuk sumber daya koneksi. Jika tidak ada tanda yang telah ditambahkan, daftar yang dikembalikan kosong. Gunakan perintah **list-tags-for-resource** untuk melihat tanda yang telah ditambahkan ke koneksi atau host.

****Untuk melihat tag untuk koneksi****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-connections** yang ditampilkan di [Daftar koneksi](connections-list.md) untuk mendapatkan ARN koneksi.

1. Di terminal atau pada baris perintah, jalankan perintah **list-tags-for-resource**. Misalnya, gunakan perintah berikut untuk melihat daftar kunci tanda dan nilai tanda untuk koneksi.

   ```
   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
   ```

   Perintah ini mengembalikan tanda yang terkait dengan sumber daya. Contoh ini menunjukkan dua pasangan nilai kunci yang dikembalikan untuk koneksi.

   ```
   {
       "Tags": [
           {
               "Key": "Project",
               "Value": "ProjectA"
           },
           {
               "Key": "ReadOnly",
               "Value": "true"
           }
       ]
   }
   ```

****Untuk melihat tag untuk host****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-hosts** yang ditampilkan di [Daftar host](connections-host-list.md) untuk mendapatkan ARN host.

1. Di terminal atau pada baris perintah, jalankan perintah **list-tags-for-resource**. Misalnya, gunakan perintah berikut untuk melihat daftar kunci tanda dan nilai tanda untuk host.

   ```
   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605
   ```

   Perintah ini mengembalikan tanda yang terkait dengan sumber daya. Contoh ini menunjukkan dua pasangan nilai kunci yang dikembalikan untuk host.

   ```
   {
       "Tags": [
           {
               "Key": "IscontainerBased",
               "Value": "true"
           },
           {
               "Key": "Project",
               "Value": "ProjectA"
           }
       ]
   }
   ```

### Edit tanda untuk sumber daya koneksi (CLI)
<a name="connections-tag-edit"></a>

Anda dapat menggunakan AWS CLI untuk mengedit tag untuk sumber daya. Anda dapat mengubah nilai untuk kunci yang ada atau menambahkan kunci lain.

Pada terminal atau baris perintah, jalankan perintah **tag-resource**, tentukan ARN sumber daya tempat Anda ingin memperbarui tanda dan menentukan kunci tabda dan nilai tanda yang akan diperbarui.

Ketika Anda mengedit tanda, kunci tanda apa pun yang tidak ditentukan akan dipertahankan, sementara apa pun dengan kunci yang sama tetapi memiliki nilai baru akan diperbarui. Kunci baru yang ditambahkan dengan perintah edit ditambahkan sebagai pasangan nilai kunci baru.

****Untuk mengedit tag untuk koneksi****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-connections** yang ditampilkan di [Daftar koneksi](connections-list.md) untuk mendapatkan ARN koneksi.

1. Di terminal atau pada baris perintah, jalankan perintah **tag-resource**.

   Dalam contoh ini, nilai untuk kunci `Project` diubah menjadi `ProjectB`.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
   ```

   Jika berhasil, perintah ini tidak mengembalikan apa pun. Untuk memverifikasi tanda yang terkait dengan koneksi, jalankan perintah **list-tags-for-resource**.

****Untuk mengedit tag untuk host****

1. Dapatkan ARN untuk sumber daya Anda. Gunakan perintah **list-hosts** yang ditampilkan di [Daftar host](connections-host-list.md) untuk mendapatkan ARN host.

1. Di terminal atau pada baris perintah, jalankan perintah **tag-resource**.

   Dalam contoh ini, nilai untuk kunci `Project` diubah menjadi `ProjectB`.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
   ```

   Jika berhasil, perintah ini tidak mengembalikan apa pun. Untuk memverifikasi tanda yang terkait dengan host, jalankan perintah **list-tags-for-resource**.

### Hapus tanda dari sumber daya koneksi (CLI)
<a name="connections-tag-delete"></a>

Ikuti langkah-langkah ini untuk menggunakan AWS CLI untuk menghapus tag dari sumber daya. Saat Anda menghapus tanda dari sumber daya yang terkait, tanda akan dihapus.

**catatan**  
Jika Anda menghapus sumber daya koneksi, semua pengaitan tanda akan dihapus dari sumber daya yang dihapus. Anda tidak perlu menghapus tanda sebelum Anda menghapus sumber daya koneksi.

Pada terminal atau baris perintah, jalankan perintah **untag-resource**, tentukan ARN dari sumber daya tempat Anda ingin menghapus tanda serta kunci tanda dari tanda yang ingin Anda hapus. Misalnya, untuk menghapus beberapa tag pada koneksi dengan tombol tag *Project* dan*ReadOnly*, gunakan perintah berikut.

```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly
```

Jika berhasil, perintah ini tidak mengembalikan apa pun. Untuk memverifikasi tanda yang terkait dengan sumber daya, jalankan perintah **list-tags-for-resource**. Output menunjukkan bahwa semua tanda telah dihapus.

```
{
    "Tags": []
}
```