

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

# Tambahkan tag kustom ke sumber daya
<a name="custom-tags-add"></a>

 Halaman berikut menunjukkan langkah-langkah yang diperlukan untuk menggunakan propagasi tag kustom. Perbanyakan tag khusus memerlukan langkah-langkah berikut: 
+  Ikut serta dalam propagasi tag khusus 
+  Tambahkan tag kustom ke sumber daya 

 Saat Anda mengaktifkan propagasi tag kustom di domain yang ada, propagasi tag tidak berfungsi untuk aplikasi yang ada sampai aplikasi dimulai ulang. Demikian pula, tag tidak diperbarui pada sumber daya yang ada saat tag kustom baru ditambahkan. Misalnya, asumsikan domain memiliki dua tag dan pengguna membuat sumber daya di domain itu. Sumber daya kemudian memiliki dua tag. Jika tag baru ditambahkan ke domain, maka tag baru itu tidak ditambahkan ke sumber daya yang ada. Namun, setiap sumber daya baru yang dibuat akan memiliki tag baru yang dilampirkan ke sumber daya.

## Prasyarat
<a name="custom-tags-add-prereq"></a>
+  Pengguna harus memiliki `sagemaker:AddTags` izin untuk pembuatan sumber daya apa pun. 
  +  Untuk domain baru yang dibuat dengan kebijakan `SageMakerFullAccess` terkelola atau menggunakan Manajer SageMaker Peran, `sagemaker:AddTags` izin telah diisi sebelumnya. 
  +  Untuk domain yang ada menggunakan AWS Identity and Access Management kebijakan khusus, Anda harus memperbarui kebijakan untuk menyertakan `sagemaker:AddTags` izin untuk mengizinkan pengguna membuat sumber daya.

## Ikut serta dalam propagasi tag khusus
<a name="custom-tags-add-opt-in"></a>

Proses untuk ikut serta dalam propagasi tag kustom berbeda berdasarkan apakah Anda ikut serta dari konsol atau dari. AWS CLI Dari konsol, Anda hanya dapat ikut serta dalam propagasi tag kustom dengan memperbarui domain yang ada. Dari AWS CLI, Anda dapat ikut serta dalam propagasi tag kustom saat membuat domain atau memperbarui domain yang ada.



### Ikut serta dari konsol
<a name="custom-tags-add-opt-in-console"></a>

Langkah-langkah berikut menguraikan cara ikut serta dalam propagasi tag kustom dari konsol. Anda hanya dapat ikut serta dalam propagasi tag kustom dari konsol dengan memperbarui domain yang ada.

1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).

1. Di navigasi kiri, pilih **Konfigurasi admin**. Di bawah **Konfigurasi admin**, pilih **Domain**.

1. Pada halaman **Domain**, pilih domain yang ingin Anda aktifkan propagasi tag kustom.

1. Dari halaman **Detail domain**, pilih tab **Pengaturan domain**.

1. Pada tab **Pengaturan domain**, navigasikan ke **Propagasi Tag Kustom**.

1. Pilih **Edit**.

1. Dari halaman **Edit propagasi tag kustom**, pilih **Secara otomatis menyebarkan** tag kustom

1. Pilih **Kirim**.

### Keikutsertaan menggunakan AWS CLI
<a name="custom-tags-add-opt-in-cli"></a>

 Untuk ikut serta dalam propagasi tag kustom menggunakan AWS CLI, gunakan `TagPropagation` atribut di dan. [CreateDomain[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) APIs Secara default, nilai bidang ini adalah`DISABLED`. Nilai kosong juga default ke. `DISABLED` Contoh berikut menunjukkan cara mengaktifkan propagasi tag kustom. 

```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```

## Tambahkan tag kustom
<a name="custom-tags-add-tags"></a>

Proses untuk menambahkan propagasi tag khusus berbeda berdasarkan apakah Anda menambahkannya dari konsol atau dari AWS CLI.

### Tambahkan dari konsol
<a name="custom-tags-add-tags-console"></a>

Langkah-langkah berikut menguraikan cara menambahkan tag khusus ke domain dari konsol.

1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).

1. Di navigasi kiri, pilih **Konfigurasi admin**. Di bawah **Konfigurasi admin**, pilih **Domain**.

1. Pada halaman **Domain**, pilih domain yang ingin Anda tambahkan tag kustom.

1. Dari halaman **Detail domain**, pilih tab **Pengaturan domain**.

1. Pada tab **Pengaturan domain**, navigasikan ke **Tag**.

1. Pilih **Edit**.

1. Dari halaman **Tag**, pilih **Tambahkan tag**. Tambahkan pasangan kunci dan nilai untuk tag kustom.

1. Pilih **Simpan**. Tag khusus ini sekarang disebarkan ke sumber daya SageMaker AI yang dibuat di domain.

Langkah-langkah berikut menguraikan cara menambahkan tag khusus ke profil pengguna dari konsol.

1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).

1. Di navigasi kiri, pilih **Konfigurasi admin**. Di bawah **Konfigurasi admin**, pilih **Domain**.

1. Pada halaman **Domain**, pilih domain yang berisi profil pengguna yang ingin Anda tambahkan tag kustom.

1. Dari halaman **Detail domain**, pilih tab **Profil pengguna**.

1. Pada tab **Profil pengguna**, pilih profil pengguna yang ingin Anda tambahkan tag khusus.

1. Pada tab **Detail Pengguna**, arahkan ke bagian **Detail**.

1. Pilih **Edit**.

1. Dari bagian **Tag**, pilih **Tambahkan tag**. Tambahkan pasangan kunci dan nilai untuk tag kustom.

1. Pilih **Kirim**. Tag khusus ini sekarang disebarkan ke sumber daya SageMaker AI yang dibuat di domain.

### Tambahkan menggunakan AWS CLI
<a name="custom-tags-add-tags-cli"></a>

 Setelah Anda mengaktifkan propagasi tag kustom, Anda dapat menambahkan tag khusus menggunakan AWS CLI di domain, profil pengguna, atau tingkat ruang selama pembuatan atau pembaruan. Metode untuk menambahkan tag kustom berbeda tergantung pada Anda membuat sumber daya baru atau menambahkan tag ke sumber daya yang ada.

 Contoh berikut menunjukkan cara menambahkan tag kustom di tingkat domain selama pembuatan. 

```
aws sagemaker create-domain \
    --domain-name domain-id \
    --auth-mode IAM \
    --default-user-settings '{"ExecutionRole": "execution-role"}' \
    --subnet-ids subnet-id \
    --vpc-id vpc-id \
    --tags Key=key,Value=value \
    --tag-propagation ENABLED
```

 Anda harus menggunakan [AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html)API untuk menambahkan tag khusus untuk domain, profil pengguna, dan spasi yang ada sebagai berikut. 

```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```