

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

# Menandai sumber daya Amazon Aurora dan 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 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 Aurora dan Amazon 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 Aurora dan Amazon 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 Aurora dan Amazon 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, Aurora 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 klaster DB](#USER_Tagging.CopyTagsCluster)
+ [Menandai sumber daya pencadangan otomatis](#USER_Tagging.AutomatedBackups)
+ [Menambahkan dan menghapus tag di Amazon RDS](#Tagging.HowTo)
+ [Tutorial: Menggunakan tag untuk menentukan klaster DB Aurora yang akan dihentikan.](Tagging.Aurora.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 Aurora](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 cluster DB
<a name="Tagging.Billing.Snapshots"></a>

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

Snapshot cluster 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 cluster 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 klaster DB
<a name="USER_Tagging.CopyTagsCluster"></a>

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

Anda dapat menentukan bahwa tag disalin ke snapshot DB untuk tindakan berikut: 
+ Membuat klaster DB
+ Memulihkan cluster DB
+ Membuat replika baca
+ Menyalin snapshot klaster 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`

#### 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.

**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 Aurora 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/AuroraUserGuide/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/AuroraUserGuide/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/AuroraUserGuide/USER_Tagging.html)

# Tutorial: Menggunakan tag untuk menentukan klaster DB Aurora yang akan dihentikan.
<a name="Tagging.Aurora.Autostop"></a>

 Misalkan Anda membuat sejumlah klaster DB Aurora dalam lingkungan pengembangan atau pengujian. Anda perlu menyimpan semua klaster ini selama beberapa hari. Beberapa klaster menjalankan pengujian di malam hari. Klaster lainnya dapat dihentikan di malam hari dan dimulai lagi keesokan harinya. Contoh berikut menunjukkan cara menetapkan tag untuk klaster yang cocok untuk dihentikan di malam hari. Kemudian contoh berikut menunjukkan bagaimana skrip dapat mendeteksi klaster yang memiliki tag dan kemudian menghentikan klaster tersebut. Dalam contoh ini, porsi nilai dari pasangan kunci-nilai tidaklah penting. Keberadaan tag `stoppable` menandakan bahwa klaster memiliki properti yang ditetapkan pengguna ini. 

**Untuk menentukan klaster DB Aurora yang akan dihentikan**

1. Tentukan cluster ARN yang ingin Anda tetapkan sebagai stoppable.

   Perintah dan APIs untuk penandaan berfungsi denganARNs. Dengan begitu, mereka dapat bekerja dengan lancar di seluruh AWS Wilayah, AWS akun, dan berbagai jenis sumber daya yang mungkin memiliki nama pendek yang identik. Anda dapat menentukan ARN bukan ID cluster dalam CLI perintah yang beroperasi pada cluster. Ganti nama klaster Anda sendiri *dev-test-cluster*. Dalam perintah berikutnya yang menggunakan ARN parameter, gantikan cluster Anda sendiri. ARN ARNTermasuk ID AWS akun Anda sendiri dan nama AWS Wilayah tempat cluster Anda berada. 

   ```
   $ aws rds describe-db-clusters --db-cluster-identifier dev-test-cluster \
     --query "*[].{DBClusterArn:DBClusterArn}" --output text
   arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster
   ```

1. Tambahkan tag `stoppable` ke klaster ini.

   Pilih nama untuk tag ini. 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. Karena memperlakukan tag sebagai atribut yang ada atau tidak ada, contoh ini menghilangkan bagian `Value=` dari parameter `--tags`. 

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

1. Konfirmasi bahwa tag tersebut ada dalam klaster.

   Perintah ini mengambil informasi tag untuk cluster dalam JSON format dan dalam teks yang dipisahkan tab biasa. 

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

1. Untuk menghentikan semua klaster yang ditunjuk sebagai `stoppable`, siapkan daftar semua klaster Anda. Lihat daftar dan periksa apakah setiap klaster diberi tag dengan atribut yang relevan.

   Contoh Linux ini menggunakan shell scripting untuk menyimpan daftar cluster ARNs ke file sementara dan kemudian melakukan CLI perintah untuk setiap cluster.

   ```
   $ aws rds describe-db-clusters --query "*[].[DBClusterArn]" --output text >/tmp/cluster_arns.lst
   $ for arn in $(cat /tmp/cluster_arns.lst)
   do
     match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep 'TAGLIST\tstoppable')"
     if [[ ! -z "$match" ]]
     then
         echo "Cluster $arn is tagged as stoppable. Stopping it now."
   # Note that you can specify the full ARN value as the parameter instead of the short ID 'dev-test-cluster'.
         aws rds stop-db-cluster --db-cluster-identifier $arn
     fi
   done
   
   Cluster arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster is tagged as stoppable. Stopping it now.
   {
       "DBCluster": {
           "AllocatedStorage": 1,
           "AvailabilityZones": [
               "us-east-1e",
               "us-east-1c",
               "us-east-1d"
           ],
           "BackupRetentionPeriod": 1,
           "DBClusterIdentifier": "dev-test-cluster",
           ...
   ```

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

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

```
$ aws rds describe-db-clusters \
  --query '*[].{DBClusterArn:DBClusterArn,Status:Status}|[?Status == `available`]|[].{DBClusterArn:DBClusterArn}' \
  --output text
arn:aws:rds:us-east-1:123456789:cluster:cluster-2447
arn:aws:rds:us-east-1:123456789:cluster:cluster-3395
arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster
arn:aws:rds:us-east-1:123456789:cluster:pg2-cluster
```

**Tip**  
Anda dapat menggunakan penetapan tag dan pencarian klaster dengan tag tersebut untuk mengurangi biaya dengan cara lain. Misalnya, gunakan skenario ini dengan klaster DB Aurora yang digunakan untuk pengembangan dan pengujian. Di sini, Anda dapat menunjuk beberapa klaster untuk dihapus di akhir setiap hari, atau hanya instans DB pembaca saja yang dihapus. Atau Anda dapat menunjuk beberapa klaster agar instans DB-nya diubah menjadi kelas instans DB kecil selama waktu penggunaan rendah yang diharapkan. 