Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Perbanyakan tag kustom
Amazon SageMaker AI mendukung kemampuan untuk menyebarkan tag khusus yang ditetapkan pada domain, profil pengguna, dan tingkat ruang ke semua sumber daya SageMaker AI yang dibuat dalam konteks Amazon SageMaker Studio, Editor Kode, JupyterLab berdasarkan Code-OSS, Visual Studio Code - Open Source, dan Amazon Canvas. SageMaker Dengan propagasi tag kustom, pengguna dapat menyebarkan tag kustom mereka sendiri ke sumber daya untuk meningkatkan pelacakan biaya dan mengikat sumber daya ke proyek dan tim tertentu.
Untuk mengaktifkan fitur ini, gunakan `TagPropagation` atribut di [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)dan [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs. Perbanyakan tag khusus hanya dapat diatur pada tingkat domain, yang berarti bahwa semua pengguna dan spasi dalam domain menggunakan fitur tersebut saat diaktifkan. Tidak mungkin mengubah pengaturan propagasi tag khusus di profil pengguna atau tingkat ruang. Untuk informasi selengkapnya tentang penggunaan propagasi tag kustom, lihat[Tambahkan tag kustom ke sumber daya](custom-tags-add.md).
**catatan**
Tag sistem yang ditambahkan oleh AWS layanan pada domain, profil pengguna, dan ruang tidak disebarkan.
## Contoh kasus penggunaan
Perbanyakan tag khusus sangat berguna untuk kasus penggunaan berikut.
+ Lacak biaya di semua sumber daya SageMaker AI yang dibuat di Amazon SageMaker Studio.
+ Lacak biaya untuk sumber daya SageMaker AI yang dibuat di Amazon SageMaker Canvas. Ini termasuk model yang digunakan pada titik akhir SageMaker AI.
+ Lacak biaya yang dikeluarkan untuk DataZone proyek Amazon dengan menyebarkan ID DataZone proyek Amazon ke semua sumber daya yang dibuat oleh Amazon Studio. SageMaker
## Penggabungan tag
Dengan propagasi tag kustom diaktifkan, sumber daya yang dibuat di profil pengguna dan tingkat ruang mengambil tag yang ditentukan pada tingkat domain, serta yang ditentukan selama profil pengguna atau pembuatan ruang.
SageMaker Sumber daya AI memiliki batas 50 tag. Jika jumlah tag yang ditambahkan ke sumber daya melebihi 50, SageMaker AI mengembalikan kesalahan selama pembuatan sumber daya. Sebaiknya batasi jumlah tag untuk menghindari hal ini. Misalnya, asumsikan pengguna memiliki 25 tag untuk domain mereka dan 30 tag untuk profil pengguna mereka. Saat pengguna membuat sumber daya, total 55 tag menyebar ke sumber daya. Karena total tag agregat melebihi 50, pembuatan sumber daya gagal hingga pengguna menghapus setidaknya 5 tag.
**catatan**
Secara default, SageMaker AI secara otomatis menambahkan`sagemaker:user-profile-arn`,`sagemaker:domain-arn`, atau `sagemaker:space-arn` tag ke sumber daya SageMaker AI. SageMaker AI menambahkan tag ARN terlepas dari apakah domain tersebut menggunakan propagasi tag khusus atau tidak. Tag ARN ini juga berkontribusi terhadap batas 50 tag.
# Tambahkan tag kustom ke sumber daya
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
+ 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
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
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
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
Proses untuk menambahkan propagasi tag khusus berbeda berdasarkan apakah Anda menambahkannya dari konsol atau dari AWS CLI.
### Tambahkan dari konsol
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
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
```
# Menyisih dari propagasi tag kustom
Proses untuk memilih keluar dari propagasi tag kustom berbeda berdasarkan apakah Anda memilih keluar dari konsol atau dari. AWS CLI
## Memilih keluar dari konsol
Langkah-langkah berikut menguraikan cara memilih keluar dari propagasi tag kustom dari konsol. Anda hanya dapat memilih keluar dari 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 pilih keluar dari 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**.
## Opt-out menggunakan AWS CLI
Untuk memilih keluar dari propagasi tag kustom, atur `TagPropagation` atribut di [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)dan [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs ke `DISABLED` seperti yang ditunjukkan pada contoh berikut. Secara default, nilai bidang ini adalah`DISABLED`. Nilai kosong juga default ke. `DISABLED`
**catatan**
Perambatan tag tidak dimatikan secara otomatis untuk aplikasi yang ada saat `TagPropagation` disetel ke`DISABLED`. Aplikasi harus dimulai ulang agar opt-out diterapkan pada aplikasi yang ada.
```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation DISABLED
```