

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

# Menandai sumber Amazon RDS
<a name="USER_Tagging"></a><a name="tagging"></a>

Tag Amazon RDS adalah pasangan nama-nilai yang Anda tentukan dan kaitkan dengan sumber daya Amazon RDS seperti instans DB atau snapshot DB. Nama ini disebut sebagai kunci. Secara opsional, Anda dapat memberikan nilai untuk kunci tersebut.

Anda dapat menggunakan, API Konsol Manajemen AWS AWS CLI, atau Amazon RDS untuk menambahkan, membuat daftar, dan menghapus tag pada sumber daya Amazon RDS. Saat menggunakan CLI atau API, pastikan untuk menyediakan Amazon Resource Name (ARN) agar sumber daya RDS dapat berfungsi. Untuk informasi selengkapnya tentang cara membuat konsep ARN, lihat [Membuat konsep ARN untuk Amazon RDS](USER_Tagging.ARN.Constructing.md).

Anda dapat menggunakan tag untuk menambahkan metadata ke sumber daya Amazon RDS Amazon RDS Anda. Anda dapat menggunakan tag untuk menambahkan notasi Anda sendiri tentang instans basis data, snapshot, klaster Aurora, dan sebagainya. Melakukannya dapat membantu Anda mendokumentasikan sumber daya Amazon RDS RDS Anda. Anda juga dapat menggunakan tag dengan prosedur pemeliharaan otomatis. 

 Khususnya, Anda dapat menggunakan tag ini dengan kebijakan IAM. Anda dapat menggunakannya untuk mengelola akses ke sumber daya Amazon RDS RDS dan untuk mengontrol tindakan apa yang dapat diterapkan pada sumber daya tersebut. Anda dapat menggunakan tag ini untuk melacak biaya dengan mengelompokkan pengeluaran untuk sumber daya serupa yang diberi tag. 

Anda dapat menandai sumber daya Amazon RDS RDS berikut:
+ Instans DB
+ Klaster DB
+ Kluster global Aurora
+ Titik akhir cluster DB
+ Replika baca
+ Snapshot DB
+ Snapshot klaster DB
+ Instans DB terpesan
+ Langganan peristiwa
+ Grup opsi DB
+ Grup parameter DB
+ Grup parameter klaster DB
+ Grup subnet DB
+ Proksi RDS
+ Titik akhir Proksi RDS
+ Deployment blue/green
+ Integrasi nol-ETL
+ Pencadangan otomatis
+ Cluster backup otomatis

**catatan**  
Saat menandai instans DB, Amazon RDS secara otomatis menerapkan tag tersebut ke sumber daya Performance Insights terkait. Saat ini, Anda tidak dapat menandai RDS Proxies dan RDS Proxy endpoint dengan menggunakan. Konsol Manajemen AWS

**Topics**
+ [Mengapa menggunakan tag sumber daya Amazon RDS?](#Tagging.Purpose)
+ [Cara kerja tag sumber daya Amazon RDS](#Overview.Tagging)
+ [Praktik terbaik untuk menandai sumber daya Amazon RDS](#Tagging.best-practices)
+ [Menyalin tag ke snapshot DB](#USER_Tagging.CopyTags)
+ [Menandai sumber daya pencadangan otomatis](#USER_Tagging.AutomatedBackups)
+ [Menambahkan dan menghapus tag di Amazon RDS](#Tagging.HowTo)
+ [Tutorial: Tentukan instance DB mana yang harus dihentikan dengan menggunakan tag](Tagging.RDS.Autostop.md)

## Mengapa menggunakan tag sumber daya Amazon RDS?
<a name="Tagging.Purpose"></a>

Anda dapat menggunakan tag untuk melakukan hal berikut:
+ Kategorikan sumber daya RDS Anda berdasarkan aplikasi, proyek, departemen, lingkungan, dan sebagainya. Misalnya, Anda dapat menggunakan kunci tag untuk menentukan kategori, di mana nilai tag adalah item dalam kategori ini. Anda dapat membuat tag`environment=prod`. Atau Anda dapat menentukan kunci tag `project` dan nilai tag`Salix`, yang menunjukkan bahwa sumber daya Amazon RDS ditetapkan ke proyek Salix.
+ Mengotomatiskan tugas manajemen sumber daya. Misalnya, Anda dapat membuat jendela pemeliharaan untuk instance yang diberi tag `environment=prod` yang berbeda dari jendela untuk instance yang diberi tag. `environment=test` Anda juga dapat mengonfigurasi snapshot DB otomatis untuk instance yang ditandai. `environment=prod`
+ Kontrol akses ke sumber daya RDS dalam kebijakan IAM. Anda dapat melakukan ini dengan menggunakan kunci kondisi `aws:ResourceTag/tag-key` global. Misalnya, kebijakan mungkin hanya mengizinkan pengguna dalam `DBAdmin` grup untuk memodifikasi instans DB yang diberi tag. `environment=prod` Untuk informasi tentang mengelola akses ke sumber daya yang ditandai dengan kebijakan IAM, lihat [Manajemen identitas dan akses untuk Amazon RDS](UsingWithRDS.IAM.md) dan [Mengontrol akses ke AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) di *Panduan Pengguna AWS Identity and Access Management*. 
+ Pantau sumber daya berdasarkan tag. Misalnya, Anda dapat membuat CloudWatch dasbor Amazon untuk instans DB yang ditandai dengan. `environment=prod`
+ Lacak biaya dengan mengelompokkan biaya untuk sumber daya yang ditandai serupa. Misalnya, jika Anda menandai sumber daya RDS yang terkait dengan proyek Salix`project=Salix`, Anda dapat menghasilkan laporan biaya dan mengalokasikan pengeluaran untuk proyek ini. Untuk informasi selengkapnya, lihat [Cara kerja AWS penagihan dengan tag di Amazon RDS](#Tagging.Billing).

## Cara kerja tag sumber daya Amazon RDS
<a name="Overview.Tagging"></a>

AWS tidak menerapkan makna semantik apa pun pada tag Anda. Tanda ditafsirkan dengan ketat sebagai string karakter. 

**Topics**
+ [Set tag di Amazon RDS](#Overview.Tagging.Sets)
+ [Struktur tag di Amazon RDS](#Overview.Tagging.Structure)
+ [Sumber daya Amazon RDS memenuhi syarat untuk penandaan](#Overview.Tagging.Resources)
+ [Cara kerja AWS penagihan dengan tag di Amazon RDS](#Tagging.Billing)

### Set tag di Amazon RDS
<a name="Overview.Tagging.Sets"></a>

Setiap sumber daya Amazon RDS memiliki wadah yang disebut set tag. Wadah mencakup semua tag yang ditetapkan ke sumber daya. Sumber daya memiliki tepat satu set tag. 

Satu set tag berisi 0-50 tag. Jika Anda menambahkan sumber daya RDS dengan kunci yang sama dengan tag sumber daya yang sudah ada di sumber daya tersebut, nilai baru akan menimpa nilai lama.

### Struktur tag di Amazon RDS
<a name="Overview.Tagging.Structure"></a>

Struktur tag RDS adalah sebagai berikut:

**Kunci tag**  
Kuncinya adalah nama tag yang diperlukan. Nilai string harus 1—128 karakter Unicode panjangnya dan tidak dapat diawali dengan atau. `aws:` `rds:` String hanya dapat berisi kumpulan huruf Unicode, digit, spasi putih,,,,`_`,`.`, `:` `/``=`, `+` dan. `-` `@` Java regex adalah. `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"` Kunci tag peka terhadap huruf besar dan kecil. Dengan demikian, kunci `project` dan `Project` berbeda.  
Kunci unik untuk set tag. Misalnya, Anda tidak dapat memiliki pasangan kunci dalam set tag dengan kunci yang sama tetapi dengan nilai yang berbeda, seperti `project=Trinity` dan. `project=Xanadu`

**Nilai tag**  
Nilai adalah nilai string opsional dari tag. Nilai string harus 1-256 karakter Unicode panjangnya. String hanya dapat berisi kumpulan huruf Unicode, digit, spasi putih,,,,`_`,`.`, `:` `/``=`, `+` dan. `-` `@` Java regex adalah. `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"` Kunci dan nilai tag peka terhadap huruf besar dan kecil. Dengan demikian, nilai-nilai `prod` dan `Prod` berbeda.  
Nilai tidak perlu unik dalam satu set tag dan bisa null. Misalnya, Anda dapat menggunakan pasangan kunci-nilai dalam satu rangkaian tag `project=Trinity` dan `cost-center=Trinity`. 

### Sumber daya Amazon RDS memenuhi syarat untuk penandaan
<a name="Overview.Tagging.Resources"></a>

Anda dapat memberi tag pada sumber daya Amazon RDS berikut:
+ Instans DB
+ Klaster DB
+ Titik akhir cluster DB
+ Replika baca
+ Snapshot DB
+ Snapshot klaster DB
+ Instans DB terpesan
+ Langganan peristiwa
+ Grup opsi DB
+ Grup parameter DB
+ Grup parameter klaster DB
+ Grup subnet DB
+ Proksi RDS
+ Titik akhir Proksi RDS
**catatan**  
Saat ini, Anda tidak dapat memberi tag pada Proksi RDS dan titik akhir Proksi RDS dengan menggunakan Konsol Manajemen AWS.
+ Deployment blue/green
+ Integrasi nol-ETL (pratinjau)
+ Pencadangan otomatis
+ Cluster backup otomatis

### Cara kerja AWS penagihan dengan tag di Amazon RDS
<a name="Tagging.Billing"></a>

Gunakan tag untuk mengatur AWS tagihan Anda untuk mencerminkan struktur biaya Anda sendiri. Untuk melakukan ini, daftar untuk mendapatkan Akun AWS tagihan Anda dengan nilai kunci tag disertakan. Kemudian, untuk melihat biaya sumber daya gabungan, atur informasi penagihan Anda sesuai dengan sumber daya Anda dengan nilai kunci tag yang sama. Misalnya, Anda dapat memberi tag pada beberapa sumber daya dengan nama aplikasi tertentu, kemudian mengatur informasi penagihan Anda untuk melihat biaya total aplikasi tersebut di beberapa layanan. Untuk informasi selengkapnya, lihat [Menggunakan Tag Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dalam *Panduan Pengguna AWS Billing *.

#### Bagaimana tag alokasi biaya bekerja dengan snapshot DB
<a name="Tagging.Billing.Snapshots"></a>

Anda dapat menambahkan tag ke snapshot DB. Namun, tagihan Anda tidak akan mencerminkan pengelompokan ini. Agar tag alokasi biaya diterapkan ke snapshot DB, kondisi berikut harus dipenuhi:
+ Tag harus dilampirkan ke instance DB induk.
+ Instance DB induk harus ada Akun AWS sama dengan snapshot DB.
+ Instance DB induk harus ada Wilayah AWS sama dengan snapshot DB.

Snapshot DB dianggap yatim piatu jika tidak ada di Wilayah yang sama dengan instans DB induk, atau jika instans DB induk dihapus. Snapshot DB yatim piatu tidak mendukung tag alokasi biaya. Biaya untuk snapshot yatim piatu digabungkan dalam satu item baris yang tidak ditandai. Snapshot DB lintas akun tidak dianggap yatim piatu ketika kondisi berikut terpenuhi:
+ Mereka ada di Wilayah yang sama dengan instans DB induk.
+ Instance DB induk dimiliki oleh akun sumber.
**catatan**  
Jika instans DB induk dimiliki oleh akun lain, tag alokasi biaya tidak berlaku untuk snapshot lintas akun di akun tujuan.

## Praktik terbaik untuk menandai sumber daya Amazon RDS
<a name="Tagging.best-practices"></a>

Saat Anda menggunakan tag, kami sarankan Anda mematuhi praktik terbaik berikut:
+ Konvensi dokumen untuk penggunaan tag yang diikuti oleh semua tim di organisasi Anda. Secara khusus, pastikan nama-nama itu deskriptif dan konsisten. Misalnya, standarisasi pada format `environment:prod` daripada menandai beberapa sumber daya dengan. `env:production`
**penting**  
Jangan menyimpan informasi pengenal pribadi (PII) atau informasi rahasia atau sensitif lainnya dalam tag.
+ Otomatiskan penandaan untuk memastikan konsistensi. Misalnya, Anda dapat menggunakan teknik berikut:
  + Sertakan tag dalam CloudFormation templat. Saat Anda membuat sumber daya dengan templat, sumber daya ditandai secara otomatis.
  + Tentukan dan terapkan tag menggunakan AWS Lambda fungsi.
  + Buat dokumen SSM yang menyertakan langkah-langkah untuk menambahkan tag ke sumber daya RDS Anda.
+ Gunakan tag hanya jika diperlukan. Anda dapat menambahkan hingga 50 tag untuk satu sumber daya RDS, tetapi praktik terbaik adalah menghindari proliferasi dan kompleksitas tag yang tidak perlu.
+ Tinjau tag secara berkala untuk relevansi dan akurasi. Hapus atau ubah tag usang sesuai kebutuhan.
+ Pertimbangkan untuk membuat AWS tag dengan Editor Tag di Konsol Manajemen AWS. Anda dapat menggunakan Editor Tag untuk menambahkan tag ke beberapa AWS sumber daya yang didukung, termasuk sumber daya RDS, secara bersamaan. Untuk informasi selengkapnya, lihat [Editor Tag](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) di *Panduan Pengguna AWS *.

## Menyalin tag ke snapshot DB
<a name="USER_Tagging.CopyTags"></a>

Saat membuat atau memulihkan instans DB, Anda dapat menentukan bahwa tag dari instans DB disalin ke snapshot instans DB. Penyalinan tag memastikan bahwa metadata untuk snapshot DB cocok dengan metadata instans DB sumber. Ini juga memastikan bahwa kebijakan akses apa pun untuk snapshot DB juga cocok dengan kebijakan akses instans DB sumber.

Anda dapat menentukan bahwa tag disalin ke snapshot DB untuk tindakan berikut: 
+ Membuat instans DB
+ Memulihkan instans DB
+ Membuat replika baca
+ Menyalin snapshot DB

Untuk menyalin tag untuk tindakan sebelumnya, pilih **Salin tag ke snapshot** di Konsol Manajemen AWS, atau tentukan `--copy-tags-to-snapshot` di. AWS CLI Saat menyalin snapshot DB, Anda hanya dapat menyalin tag terkait jika menyalin snapshot DB di akun yang sama. Anda tidak dapat menyalin tag saat menyalin snapshot DB di seluruh akun.

Dalam kebanyakan kasus, tag tidak disalin secara default. Namun, saat Anda memulihkan instans DB dari snapshot DB, RDS memeriksa apakah Anda menentukan tag baru. Jika ya, tag baru akan ditambahkan ke instans DB yang dipulihkan. Jika tidak ada tag baru, dan snapshot DB berada di akun yang sama dengan instans DB sumber, RDS menambahkan tag dari instans DB sumber pada saat pembuatan snapshot ke instans DB yang dipulihkan. RDS tidak menambahkan tag dari instans DB sumber jika snapshot DB disalin dan dipulihkan di akun yang berbeda.

Untuk mencegah tag dari instans DB sumber ditambahkan ke instans DB yang dipulihkan, sebaiknya Anda menentukan tag baru saat memulihkan instans DB.

**catatan**  
Dalam beberapa kasus, Anda mungkin menyertakan nilai untuk `--tags` parameter [create-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-snapshot.html) AWS CLI perintah. Atau Anda mungkin menyediakan setidaknya satu tag ke operasi [Create DBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBSnapshot.html) API. Dalam kasus ini, RDS tidak menyalin tag dari instans DB sumber ke snapshot DB baru. Fungsi ini berlaku meskipun opsi `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`) di instans DB sumber diaktifkan.  
Jika menggunakan pendekatan ini, Anda dapat membuat salinan instans DB dari snapshot DB. Pendekatan ini menghindari penambahan tag yang tidak berlaku untuk instans DB baru. Anda membuat snapshot DB menggunakan AWS CLI `create-db-snapshot` perintah (atau operasi `CreateDBSnapshot` RDS API). Setelah membuat snapshot DB, Anda dapat menambahkan tag seperti yang dijelaskan nanti dalam topik ini.

## Menandai sumber daya pencadangan otomatis
<a name="USER_Tagging.AutomatedBackups"></a>

Sumber daya pencadangan otomatis dibuat saat Anda menetapkan nilai periode retensi cadangan dari 0 menjadi lebih besar dari 0. Anda dapat menandai instance atau mengelompokkan sumber daya pencadangan otomatis selama pembuatan menggunakan `--tag-specifications` parameter.

### Parameter Spesifikasi Tag
<a name="USER_Tagging.AutomatedBackups.TagSpecifications"></a>

APIs yang mendukung parameter `--tag-specifications` permintaan (seperti [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html), [restore-db-instance-from-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html), [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html), dll.) Dapat menandai cadangan otomatis (Jenis Sumber Daya: atau) selama pembuatan. `auto-backup` `cluster-auto-backup`

#### Pencadangan otomatis instance penandaan
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.Instance"></a>

Gunakan `--tag-specifications` dengan `ResourceType=auto-backup` saat membuat atau memodifikasi instans DB yang mengaktifkan pencadangan otomatis.

#### Menandai cadangan otomatis cluster
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.Cluster"></a>

Gunakan `--tag-specifications` dengan `ResourceType=cluster-auto-backup` saat membuat cluster DB yang memiliki backup otomatis diaktifkan.

#### Menandai cadangan otomatis saat memodifikasi instans DB
<a name="USER_Tagging.AutomatedBackups.TagSpecifications.ModifyBehavior"></a>

 Anda hanya dapat menandai pencadangan otomatis menggunakan `--tag-specifications` saat menyetel retensi cadangan dari 0 ke lebih besar dari 0. Jika backup otomatis sudah ada, gunakan [AddTagsToResource](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html)API sebagai gantinya.

**catatan**  
Tag cadangan otomatis tidak tergantung pada tag instans DB sumber, tag cluster DB, atau tag snapshot DB.

## Menambahkan dan menghapus tag di Amazon RDS
<a name="Tagging.HowTo"></a>

Anda dapat melakukan tindakan berikut:
+ Buat tag saat Anda membuat sumber daya, misalnya, saat Anda menjalankan AWS CLI perintah`create-db-instance`.
+ Tambahkan tag ke sumber daya yang ada menggunakan perintah`add-tags-to-resource`.
+ Daftar tag yang terkait dengan sumber daya tertentu menggunakan perintah`list-tags-for-resource`.
+ Perbarui tag menggunakan perintah`add-tags-to-resource`.
+ Hapus tag dari sumber daya menggunakan perintah`remove-tags-from-resource`.

Prosedur berikut menunjukkan bagaimana Anda dapat melakukan operasi penandaan khas pada sumber daya yang terkait dengan instans DB dan cluster DB. Perhatikan bahwa tag disimpan di cache untuk diotorisasi. Untuk alasan ini, ketika Anda menambahkan atau memperbarui tag pada sumber daya Amazon RDS, beberapa menit dapat berlalu sebelum modifikasi tersedia. 

### Konsol
<a name="USER_Tagging.CON"></a>

Proses pemberian tag pada sumber daya Amazon RDS untuk semua sumber daya sama. Prosedur berikut menunjukkan cara memberi tag pada instans DB Amazon RDS. 

**Untuk menambahkan tag ke instans DB**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, pilih **Basis Data**.
**catatan**  
Untuk memfilter daftar instans DB di panel **Basis data**, masukkan string teks untuk **Filter basis data**. Hanya instans DB yang berisi string yang muncul.

1. Pilih nama instans DB yang ingin diberi tag untuk menampilkan detailnya. 

1. Di bagian detail, gulir ke bawah hingga bagian **Tag**. 

1. Pilih **Tambahkan**. Jendela **Tambahkan tag** akan muncul.   
![\[Jendela Tambahkan tag\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging5.png)

1. Masukkan nilai untuk **Kunci tag** dan **Nilai**.

1. Untuk menambahkan tag lain, Anda dapat memilih **Tambahkan Tag lain** dan memasukkan nilai untuk **Kunci tag** dan **Nilai**-nya. 

   Ulangi langkah ini seperlunya.

1. Pilih **Tambahkan**. 

**Untuk menghapus tag dari instans DB**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, pilih **Basis data**.
**catatan**  
Untuk memfilter daftar instans DB di panel **Basis data**, masukkan string teks dalam kotak **Filter basis data**. Hanya instans DB yang berisi string yang muncul.

1. Pilih nama instans DB untuk menampilkan detailnya. 

1. Di bagian detail, gulir ke bawah hingga bagian **Tag**. 

1. Pilih tag yang ingin dihapus.  
![\[Bagian Tag\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/RDSConsoleTagging6.png)

1. Pilih **Hapus**, lalu pilih **Hapus** di jendela **Hapus tag**. 

### AWS CLI
<a name="USER_Tagging.CLI"></a>

Anda dapat menambahkan, mencantumkan, atau menghapus tag untuk instans DB menggunakan AWS CLI.
+ Untuk menambahkan satu atau beberapa tag ke sumber daya Amazon RDS, gunakan AWS CLI perintah [https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html).
+ Untuk membuat daftar tag pada sumber daya Amazon RDS, gunakan AWS CLI perintah [https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html).
+ Untuk menghapus satu atau beberapa tag dari sumber daya Amazon RDS, gunakan AWS CLI perintah [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html).

Untuk mempelajari lebih lanjut tentang cara membuat ARN yang diperlukan, lihat [Membuat konsep ARN untuk Amazon RDS](USER_Tagging.ARN.Constructing.md).

### RDS API
<a name="USER_Tagging.API"></a>

Anda dapat menambahkan, mencantumkan, atau menghapus tag untuk instans DB menggunakan Amazon RDS API.
+ Untuk menambahkan tag ke sumber daya Amazon RDS, gunakan operasi [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html).
+ Untuk mencantumkan tag yang ditetapkan ke sumber daya Amazon RDS, gunakan [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html).
+ Untuk menghapus tag dari sumber daya Amazon RDS, gunakan operasi [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html).

Untuk mempelajari lebih lanjut tentang cara membuat konsep ARN yang diperlukan, lihat [Membuat konsep ARN untuk Amazon RDS](USER_Tagging.ARN.Constructing.md).

Saat bekerja dengan XML menggunakan Amazon RDS API, tag menggunakan skema berikut:

```
 1. <Tagging>
 2.       <TagSet>
 3.           <Tag>
 4.               <Key>Project</Key>
 5.               <Value>Trinity</Value>
 6.           </Tag>
 7.           <Tag>
 8.               <Key>User</Key>
 9.               <Value>Jones</Value>
10.           </Tag>
11.       </TagSet>
12.   </Tagging>
```

Tabel berikut menyediakan daftar tag XML yang diizinkan beserta karakteristiknya. Nilai untuk `Key` dan `Value` peka huruf besar/kecil. Misalnya, `project=Trinity` dan `PROJECT=Trinity` merupakan tag yang berbeda. 


****  
<a name="user-tag-reference"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_Tagging.html)

# Tutorial: Tentukan instance DB mana yang harus dihentikan dengan menggunakan tag
<a name="Tagging.RDS.Autostop"></a>

Tutorial ini mengasumsikan bahwa Anda memiliki beberapa instance DB dalam lingkungan pengembangan atau pengujian. Anda perlu menyimpan instans DB ini selama beberapa hari. Beberapa instans DB menjalankan tes dalam semalam, sedangkan yang lain dapat dihentikan dalam semalam dan dimulai lagi pada hari berikutnya. 

Tutorial berikut menunjukkan cara menetapkan tag ke instans DB yang cocok untuk berhenti dalam semalam. Tutorial menunjukkan bagaimana skrip dapat mendeteksi instance DB mana yang memiliki tag dan kemudian menghentikan instance DB yang ditandai. Dalam contoh ini, porsi nilai dari pasangan kunci-nilai tidaklah penting. Keberadaan tag `stoppable` menandakan bahwa instans DB memiliki properti yang ditetapkan pengguna ini. 

Dalam tutorial berikut, perintah dan APIs untuk penandaan bekerja dengan ARNs, yang memungkinkan RDS bekerja dengan mulus di seluruh AWS Wilayah, AWS akun, dan berbagai jenis sumber daya yang mungkin memiliki nama pendek yang identik. Anda dapat menentukan ARN, bukan ID instans DB, dalam perintah CLI yang beroperasi pada instans DB.

**Untuk menentukan instans DB yang akan dihentikan**

1. Tentukan ARN instans DB yang ingin ditentukan sebagai dapat dihentikan.

   Dalam contoh berikut, ganti nama instans DB Anda sendiri untuk*dev-test-db-instance*. Dalam perintah berikutnya yang menggunakan parameter ARN, ganti ARN instans DB Anda sendiri. ARN menyertakan ID AWS akun Anda sendiri dan nama AWS Wilayah tempat instans DB Anda berada. 

   ```
   $ aws rds describe-db-instances --db-instance-identifier dev-test-db-instance \
     --query "*[].{DBInstance:DBInstanceArn}" --output text
   arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance
   ```

1. Tambahkan tag `stoppable` ke instans DB ini.

   Pilih nama untuk tag ini. Karena memperlakukan tag sebagai atribut yang ada atau tidak ada, contoh ini menghilangkan bagian `Value=` dari parameter `--tags`. Pendekatan ini berarti Anda dapat menghindari merancang konvensi penamaan yang mengenkode semua informasi yang relevan dalam nama. Dalam konvensi tersebut, Anda dapat mengenkode informasi dalam nama instans DB atau nama-nama sumber daya lainnya. 

   ```
   $ aws rds add-tags-to-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance \
     --tags Key=stoppable
   ```

1. Konfirmasi bahwa tag tersebut ada dalam instans DB.

   Perintah berikut mengambil informasi tag untuk instance DB dalam format JSON dan teks yang dipisahkan tab biasa. 

   ```
   $ aws rds list-tags-for-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance 
   {
       "TagList": [
           {
               "Key": "stoppable",
               "Value": ""
   
           }
       ]
   }
   aws rds list-tags-for-resource \
     --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance --output text
   TAGLIST stoppable
   ```

1. Hentikan semua instans DB yang ditetapkan sebagai`stoppable`.

   Contoh berikut membuat file teks yang mencantumkan semua instance DB Anda. Perintah shell melakukan loop melalui daftar dan memeriksa apakah setiap instance DB ditandai dengan atribut yang relevan dan menjalankan perintah `aws rds stop-db-instance` untuk setiap instans DB. 

   ```
   $ aws rds describe-db-instances --query "*[].[DBInstanceArn]" --output text >/tmp/db_instance_arns.lst
   $ for arn in $(cat /tmp/db_instance_arns.lst)
   do
     match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep stoppable)"
     if [[ ! -z "$match" ]]
     then
         echo "DB instance $arn is tagged as stoppable. Stopping it now."
   # Note that you need to get the DB instance identifier from the ARN.
         dbid=$(echo $arn | sed -e 's/.*://')
         aws rds stop-db-instance --db-instance-identifier $dbid
     fi
   done
   
   DB instance arn:arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance is tagged as stoppable. Stopping it now.
   {
       "DBInstance": {
           "DBInstanceIdentifier": "dev-test-db-instance",
           "DBInstanceClass": "db.t3.medium",
           ...
   ```

Anda dapat menjalankan skrip seperti yang sebelumnya di akhir setiap hari untuk memastikan bahwa instans DB yang tidak penting dihentikan. Anda juga dapat menjadwalkan pekerjaan menggunakan utilitas seperti `cron` melakukan pemeriksaan setiap malam. Misalnya, Anda mungkin melakukan ini jika beberapa instans DB dibiarkan berjalan secara tidak sengaja. Di sini, Anda dapat menyempurnakan perintah yang mempersiapkan daftar instans DB untuk diperiksa. 

Perintah berikut menghasilkan daftar instans DB, tetapi hanya yang berada dalam status `available`. Skrip ini dapat mengabaikan instans DB yang sudah dihentikan, karena instans tersebut akan memiliki nilai status yang berbeda seperti `stopped` atau `stopping`. 

```
$ aws rds describe-db-instances \
  --query '*[].{DBInstanceArn:DBInstanceArn,DBInstanceStatus:DBInstanceStatus}|[?DBInstanceStatus == `available`]|[].{DBInstanceArn:DBInstanceArn}' \
  --output text
arn:aws:rds:us-east-1:123456789102:db:db-instance-2447
arn:aws:rds:us-east-1:123456789102:db:db-instance-3395
arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance
arn:aws:rds:us-east-1:123456789102:db:pg2-db-instance
```

**Tip**  
Anda dapat menggunakan penetapan tag dan pencarian instans DB dengan tag tersebut untuk mengurangi biaya dengan cara lain. Misalnya, gunakan skenario ini dengan instans DB yang digunakan untuk pengembangan dan pengujian. Dalam hal ini, Anda dapat menunjuk beberapa instans DB yang akan dihapus pada akhir setiap hari. Atau Anda dapat menunjuk instans tersebut agar instans DB-nya diubah menjadi kelas instans DB kecil selama waktu penggunaan rendah yang diharapkan. 