Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola cluster Amazon DocumentDB
Untuk mengelola klaster Amazon DocumentDB, Anda harus memiliki kebijakan IAM dengan izin bidang kontrol Amazon DocumentDB yang sesuai. Izin ini memungkinkan Anda untuk membuat, memodifikasi, dan menghapus klaster dan instans. Kebijakan `AmazonDocDBFullAccess` menyediakan semua izin yang diperlukan untuk mengelola klaster Amazon DocumentDB.
Topik berikut menunjukkan bagaimana caranya melakukan berbagai tugas ketika bekerja dengan klaster Amazon DocumentDB, termasuk menciptakan, menghapus, memodifikasi, menghubungkan ke, dan melihat klaster.
**Topics**
+ [Memahami cluster](db-clusters-understanding.md)
+ [Pengaturan cluster](db-cluster-parameters.md)
+ [Konfigurasi penyimpanan cluster](db-cluster-storage-configs.md)
+ [Menentukan status klaster](db-cluster-status.md)
+ [Siklus hidup cluster](db-cluster-life-cycle.md)
+ [Menskalakan klaster](db-cluster-manage-performance.md)
+ [Mengkloning volume untuk cluster](db-cluster-cloning.md)
+ [Memahami toleransi kesalahan cluster](db-cluster-fault-tolerance.md)
# Memahami cluster
Amazon DocumentDB memisahkan perhitungan dan penyimpanan, dan replikasi data offload dan backup ke volume klaster. Volume klaster menyediakan lapisan penyimpanan tahan lama, andal, dan sangat tersedia yang mereplikasi data enam cara di tiga Zona Ketersediaan. Replika memungkinkan ketersediaan data yang lebih tinggi dan membaca penskalaan. Setiap klaster dapat diskalakan ke atas hingga 15 replika.
| Kata benda | Deskripsi | Operasi API (Kata Kerja) |
| --- | --- | --- |
| Klaster | Terdiri atas satu atau beberapa instans dan volume penyimpanan klaster yang mengelola data untuk instans tersebut. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Instans | Membaca dan menulis data ke volume penyimpanan klaster dilakukan melalui instans. Dalam sebuah klaster tertentu, ada dua jenis instans: primer dan replika. Sebuah klaster selalu memiliki satu instans utama dan dapat memiliki 0–15 replika. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Volume klaster | Volume penyimpanan basis data virtual yang mencakup tiga Availability Zone, dengan setiap Availability Zone memiliki dua salinan data klaster. | N/A |
| Instans utama | Mendukung operasi baca dan tulis, dan melakukan semua modifikasi data pada volume klaster. Setiap klaster memiliki satu instans utama. | N/A |
| Instans replika | Mendukung hanya operasi baca. Setiap klaster Amazon DocumentDB dapat memiliki hingga 15 instans replika di samping instans utama. Beberapa replika mendistribusikan beban kerja baca. Dengan menemukan replika di Availability Zone terpisah, Anda juga dapat meningkatkan ketersediaan basis data. | N/A |
| Titik akhir klaster | Titik akhir untuk klaster Amazon DocumentDB yang menghubungkan ke instans utama saat ini untuk klaster. Setiap klaster Amazon DocumentDB memiliki titik akhir klaster dan satu instans utama. | N/A |
| Reader endpoint | Titik akhir untuk klaster Amazon DocumentDB yang terhubung ke salah satu replika yang tersedia untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki reader endpoint. Jika ada lebih dari satu replika, reader endpoint mengarahkan setiap permintaan koneksi ke salah satu replika Amazon DocumentDB. | N/A |
| Instans titik akhir | Titik akhir untuk instans dalam klaster Amazon DocumentDB yang terhubung ke instans tertentu. Setiap instans dalam sebuah klaster, apa pun jenis instansnya, memiliki titik akhir instans uniknya sendiri. | N/A |
# Pengaturan Amazon DocumentDB Cluster
Ketika Anda membuat atau memodifikasi klaster, penting untuk memahami parameter yang tetap dan yang dimodifikasi setelah klaster selesai dibuat. Tabel berikut mencantumkan semua pengaturan, atau parameter, yang khusus dibuat untuk klaster. Seperti yang ditentukan dalam tabel, beberapa dapat dimodifikasi, yang lain tidak.
**catatan**
Pengaturan ini jangan sampai tertukar dengan grup parameter klaster Amazon DocumentDB dan parameternya. Untuk informasi selengkapnya tentang grup parameter klaster, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md).
| Parameter | Dapat diubah | Catatan |
| --- | --- | --- |
| DBClusterIdentifier | Ya | Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | Tidak | Harus berupa docdb. |
| BackupRetentionPeriod | Ya | Harus antara [1-35] hari. |
| DBClusterParameterGroupName | Ya | Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | Tidak | Setelah klaster selesai dibuat, Anda tidak dapat mengubah subnet klaster. |
| EngineVersion | Tidak | Nilai bisa 5.0.0 (default),4.0.0, atau3.6.0. |
| KmsKeyId | Tidak | Jika Anda memilih untuk mengenkripsi klaster Anda, Anda tidak dapat mengubah AWS KMS kunci yang Anda gunakan untuk mengenkripsi klaster Anda. |
| MasterUsername | Tidak | Setelah sebuah klaster telah dibuat, Anda tidak dapat mengubah `MasterUsername`. Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Ya | Aturan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Ya | Nomor port berlaku untuk semua instans dalam klaster. |
| PreferredBackupWindow | Ya | |
| PreferredMaintenanceWindow | Ya | |
| StorageEncrypted | Tidak | Jika Anda memilih untuk mengenkripsi klaster Anda, klaster tersebut tidak dapat terenkripsi. |
| StorageType | Ya | Jenis penyimpanan untuk cluster DB: Standard (`standard`) atau I/O-Optimized (`iopt1`). Default: `standard` Parameter ini dapat dikonfigurasi dengan `CreateDBCluster` dan`ModifyDBCluster`. Untuk informasi selengkapnya, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md). |
| Tags | Ya | |
| VpcSecurityGroupIds | Tidak | Setelah klaster telah dibuat, Anda tidak dapat mengubah VPC tempat klaster berada. |
# Konfigurasi penyimpanan klaster Amazon DocumentDB
Mulai dari Amazon DocumentDB 5.0, cluster berbasis instance mendukung dua jenis konfigurasi penyimpanan:
+ Penyimpanan **standar Amazon DocumentDB**: Dirancang untuk pelanggan dengan konsumsi rendah hingga sedang. I/O Jika Anda mengharapkan I/O biaya Anda kurang dari 25% dari total cluster Amazon DocumentDB Anda, pilihan ini mungkin ideal untuk Anda. Dengan konfigurasi penyimpanan standar Amazon DocumentDB, Anda akan ditagih berdasarkan biaya pay-per-request I/O instans dan penyimpanan. Ini berarti tagihan Anda mungkin bervariasi dari satu siklus ke siklus lainnya berdasarkan penggunaan. Konfigurasi disesuaikan untuk mengakomodasi I/O permintaan aplikasi Anda yang berfluktuasi.
+ **Amazon DocumentDB I/O penyimpanan yang dioptimalkan**: Dirancang untuk pelanggan yang memprioritaskan prediktabilitas harga atau memiliki aplikasi intensif. I/O I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/OOperasi, memastikan biaya yang dapat diprediksi setiap siklus penagihan. Konfigurasi menstabilkan biaya sekaligus meningkatkan kinerja.
Anda dapat mengalihkan kluster database yang ada setiap 30 hari sekali ke I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O Amazon DocumentDB -dioptimalkan dapat dilacak `describe-db-clusters` dengan perintah AWS CLI menggunakan atau Konsol Manajemen AWS melalui di halaman konfigurasi cluster.
[Anda dapat membuat kluster database baru termasuk konfigurasi Amazon DocumentDB I/O yang dioptimalkan atau mengonversi kluster database yang ada dengan beberapa klik di, perubahan parameter tunggal [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/)di (), atau melalui.AWS Command Line InterfaceAWS CLI[AWS SDKs](https://aws.amazon.com/developer/tools/)](https://aws.amazon.com/cli/) Tidak ada downtime atau reboot instance yang diperlukan selama atau setelah memodifikasi konfigurasi penyimpanan.
![\[Gambar: Tabel yang menjelaskan perbedaan antara standar Amazon DocumentDB dan penyimpanan yang dioptimalkan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/io-diagram-1.png)
## Membuat cluster yang dioptimalkan I/O
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membuat atau memodifikasi cluster yang dioptimalkan I/O menggunakan: Konsol Manajemen AWS
1. **Di konsol manajemen Amazon DocumentDB, **di bawah** Clusters, pilih Create **atau** pilih cluster dan pilih Actions, lalu pilih **Modify**.**
1. Jika Anda membuat klaster baru, pastikan Anda memilih **Instance Based Cluster** **di bagian tipe Cluster** (ini adalah opsi default).
![\[Gambar: Tangkapan layar konsol dari opsi tipe cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. Di bagian **Konfigurasi**, di bawah **konfigurasi penyimpanan Cluster**, pilih **Amazon DocumentDB** I/O-Optimized.
![\[Gambar: Tangkapan layar konsol dari opsi konfigurasi penyimpanan cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/storage-config-1.png)
1. Selesaikan pembuatan atau modifikasi cluster Anda dan pilih **Create cluster** atau **Modify cluster**.
Untuk proses Create cluster yang lengkap, lihat[Membuat cluster dan instance primer menggunakan Konsol Manajemen AWS](db-cluster-create.md#db-cluster-create-con).
Untuk proses klaster Modify yang lengkap, lihat[Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Untuk membuat cluster yang dioptimalkan I/O menggunakan: AWS CLI
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Untuk Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Analisis biaya untuk menentukan konfigurasi penyimpanan
Dengan Amazon DocumentDB, Anda memiliki fleksibilitas untuk memilih konfigurasi penyimpanan untuk setiap cluster database yang Anda miliki. Untuk mengalokasikan cluster Anda dengan benar antara standar dan I/O yang dioptimalkan, Anda dapat melacak biaya Amazon DocumentDB Anda berdasarkan klaster. Untuk melakukannya, Anda dapat menambahkan tag ke cluster yang ada, mengaktifkan penandaan alokasi biaya di [AWS Manajemen Penagihan dan Biaya dasbor](https://aws.amazon.com/pricing/) Anda, dan menganalisis biaya Anda untuk klaster tertentu di. [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/) Untuk informasi tentang analisis biaya, lihat blog kami [Menggunakan tag alokasi biaya](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Menentukan status klaster
Anda dapat menentukan status cluster menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
Gunakan prosedur berikut untuk melihat status klaster Amazon DocumentDB Anda menggunakan Konsol Manajemen AWS
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
1. Dalam kolom **Pengidentifikasi klaster**, temukan nama klaster yang Anda minati. Kemudian, untuk menemukan status klaster, bacalah di baris tersebut pada kolom **Status**, seperti yang ditunjukkan di bawah ini.
![\[Screenshot dari halaman klaster dengan contoh-klaster yang menunjukkan status aktif.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Gunakan operasi `describe-db-clusters` untuk melihat status klaster Amazon DocumentDB Anda menggunakan AWS CLI.
Kode berikut menemukan status klaster `sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Siklus hidup klaster Amazon DocumentDB
Siklus hidup dari Klaster Amazon DocumentDB termasuk menciptakan, menggambarkan, memodifikasi, dan menghapus klaster. Bagian ini menyediakan informasi tentang cara menyelesaikan proses ini.
**Topics**
+ [Membuat kluster](db-cluster-create.md)
+ [Menggambarkan cluster](db-cluster-view-details.md)
+ [Mengubah klaster](db-cluster-modify.md)
+ [Menentukan pemeliharaan yang tertunda](db-cluster-determine-pending-maintenance.md)
+ [Patch memperbarui versi mesin cluster](db-cluster-version-upgrade.md)
+ [Menghentikan dan memulai klaster](db-cluster-stop-start.md)
+ [Menghapus klaster](db-cluster-delete.md)
# Membuat cluster Amazon DocumentDB
Sebuah klaster Amazon DocumentDB terdiri dari instans dan volume yang mewakili data untuk klaster. Volume klaster direplikasi dengan enam cara di tiga Availability Zone sebagai volume virtual tunggal. Klaster berisi instans utama dan, secara opsional, hingga 15 instans replika.
Bagian berikut menunjukkan cara membuat cluster Amazon DocumentDB menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Anda kemudian dapat menambahkan instans replika tambahan untuk klaster tersebut. Bila Anda menggunakan konsol untuk membuat klaster Amazon DocumentDB, instans utama secara otomatis dibuat untuk Anda pada saat yang sama. Jika Anda menggunakan AWS CLI untuk membuat klaster Amazon DocumentDB, setelah status klaster *tersedia*, Anda harus membuat instance utama untuk klaster tersebut.
## Prasyarat
Berikut ini adalah prasyarat untuk membuat klaster Amazon DocumentDB.
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.
Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Prasyarat VPC
Anda hanya dapat membuat cluster Amazon DocumentDB di Amazon Virtual Private Cloud (Amazon VPC). VPC Amazon Anda harus memiliki setidaknya satu subnet di masing-masing setidaknya dua Availability Zone agar Anda dapat menggunakannya dengan cluster Amazon DocumentDB. Dengan mendistribusikan instance klaster di seluruh Availability Zone, Anda memastikan bahwa instance tersedia di klaster jika terjadi kegagalan Availability Zone.
### Prasyarat subnet
Saat membuat klaster Amazon DocumentDB, Anda harus memilih VPC dan grup subnet yang sesuai dalam VPC itu untuk meluncurkan klaster Anda. Subnet menentukan Availability Zone dan cakupan IP dalam Availability Zone yang ingin Anda gunakan untuk meluncurkan instans. Untuk tujuan diskusi ini, istilah *subnet* dan *Availability Zone* digunakan secara bergantian. Grup subnet adalah set subnet yang telah diberi nama (atau Availability Zone). Apa yang grup subnet izinkan untuk Anda lakukan adalah menentukan Availability Zone yang ingin Anda gunakan untuk meluncurkan instans Amazon DocumentDB. Misalnya, dalam klaster dengan tiga instans, untuk ketersediaan tinggi direkomendasikan agar masing-masing instans tersebut disediakan di Availability Zone yang terpisah. Jadi, jika performa Availability Zone menurun, itu hanya memengaruhi satu instans.
Instans Amazon DocumentDB saat ini dapat disediakan dalam hingga tiga Availability Zone. Bahkan jika grup subnet memiliki lebih dari tiga subnet, Anda hanya dapat menggunakan tiga subnet tersebut untuk membuat klaster Amazon DocumentDB. Oleh karenanya, disarankan agar saat Anda membuat grup subnet, pilih hanya tiga subnet tempat Anda ingin menerapkan instans. Di US East (N. Virginia), grup subnet Anda dapat memiliki enam subnet (atau Availability Zones). Namun, ketika sebuah klaster Amazon DocumentDB disediakan, Amazon DocumentDB memilih tiga dari Availability Zones yang digunakannya untuk menyediakan instans.
Sebagai contoh, misalkan bahwa ketika Anda membuat sebuah klaster, Amazon DocumentDB memilih Availability Zone \$11A, 1B, dan 1C\$1. Jika Anda mencoba untuk membuat sebuah instans di Availability Zone \$11D\$1, panggilan API gagal. Namun, jika Anda memilih untuk membuat sebuah instans tanpa menentukan Availability Zone tertentu, maka Amazon DocumentDB memilih Availability Zone atas nama Anda. Amazon DocumentDB menggunakan algoritme untuk menyeimbangkan beban instans di Availability Zone untuk membantu Anda mencapai ketersediaan tinggi. Sebagai contoh, jika tiga instans disediakan, secara default, mereka disediakan di tiga Availability Zone dan tidak disediakan secara bersamaan di Availability Zone tunggal.
**Rekomendasi:**
+ Kecuali Anda memiliki alasan tertentu, selalu buat grup subnet dengan tiga subnet. Dengan melakukannya, Anda dibantu untuk memastikan bahwa klaster dengan tiga instans atau lebih dapat mencapai ketersediaan yang lebih tinggi karena instans disediakan di tiga Availability Zone.
+ Selalu sebarkan instans di beberapa Availability Zone untuk mencapai ketersediaan yang tinggi. Jangan pernah menempatkan semua instans untuk klaster dalam Availability Zone tunggal.
+ Karena peristiwa failover dapat terjadi setiap saat, Anda tidak boleh berasumsi bahwa instans utama atau instans replika selalu berada di Availability Zone tertentu.
### Prasyarat tambahan
Berikut ini adalah beberapa prasyarat tambahan untuk menciptakan sebuah klaster Amazon DocumentDB:
+ Jika Anda terhubung ke kredensial AWS menggunakan AWS Identity and Access Management (IAM), akun IAM Anda harus memiliki kebijakan IAM yang memberikan izin yang diperlukan untuk menjalankan operasi Amazon DocumentDB.
Jika Anda menggunakan akun IAM untuk mengakses konsol Amazon DocumentDB, Anda harus terlebih dahulu masuk Konsol Manajemen AWS ke akun dengan IAM Anda. [Lalu pergi ke konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
+ Jika Anda ingin menyesuaikan parameter konfigurasi untuk klaster, Anda harus menentukan grup parameter klaster dan grup parameter dengan pengaturan parameter yang diperlukan. Untuk informasi tentang membuat atau memodifikasi grup parameter klaster atau grup parameter, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ Anda harus menentukan nomor TCP/IP port yang ingin Anda tentukan untuk cluster Anda. Firewall di beberapa perusahaan memblokir koneksi ke port default untuk Amazon DocumentDB. Jika firewall perusahaan Anda memblokir port default, pilih port lain untuk klaster Anda. Semua instans dalam klaster menggunakan port yang sama.
## Membuat cluster dan instance primer menggunakan Konsol Manajemen AWS
Prosedur berikut menjelaskan cara menggunakan konsol untuk meluncurkan klaster Amazon DocumentDB dengan satu atau beberapa instans.
### Buat cluster: menggunakan pengaturan default
**Untuk membuat cluster dengan instance menggunakan pengaturan default menggunakan Konsol Manajemen AWS**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Jika Anda ingin membuat klaster di wilayah Wilayah AWS lain selain Wilayah AS Timur (Virginia N.), pilih Wilayah dari daftar di bagian kanan atas konsol.
1. Di panel navigasi, pilih **Klaster**, lalu pilih **Buat**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Pada halaman **Buat klaster Amazon DocumentDB**, selesaikan panel **Konfigurasi**.
1. **Pengidentifikasi klaster**—Terima nama yang disediakan oleh Amazon DocumentDB, atau masukkan nama untuk klaster Anda; misalnya, **sample-cluster**.
Aturan penamaan klaster:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
1. **Versi mesin** —Terima versi mesin default 5.0.0, atau opsional pilih 8.0.0, 4.0.0, atau 3.6.0.
1. **Kelas instans**—Terima default`db.r5.large`, atau pilih kelas instans yang Anda inginkan dari daftar.
1. **Jumlah instans**—Dalam daftar, pilih jumlah instans yang ingin Anda buat dengan klaster ini. Instans pertama adalah instans utama, dan semua instans lain adalah instans replika hanya baca. Anda dapat menambahkan dan menghapus instans nanti jika Anda perlu. Secara default, sebuah klaster Amazon DocumentDB melakukan peluncuran dengan tiga instans (satu primer dan dua replika).
1. Lengkapi bagian **konfigurasi penyimpanan Cluster**.
**Pilih **Amazon DocumentDB Standard (default) atau Amazon DocumentDB** I/O-Optimized.** Untuk informasi selengkapnya, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md).
1. Menyelesaikan panel **Autentikasi**.
1. **Username** —Masukkan nama untuk pengguna utama. Untuk masuk ke cluster Anda, Anda harus menggunakan nama pengguna utama.
Kendala penamaan pengguna utama:
+ Panjangnya adalah [1—63] karakter alfanumerik.
+ Karakter pertamanya harus berupa huruf.
+ Tidak dapat berupa kata yang dicadangkan oleh mesin basis data.
1. Pilih salah satu opsi kata sandi berikut:
+ **Dikelola di AWS Secrets Manager** —Pilih opsi ini jika Anda AWS Secrets Manager ingin mengelola kata sandi pengguna utama secara otomatis.
Jika Anda memilih opsi ini, konfigurasikan kunci KMS dengan membuat sendiri atau menggunakan kunci yang dibuat Secrets Manager.
+ **Dikelola sendiri** —Pilih opsi ini jika Anda ingin mengelola sendiri kata sandi pengguna utama Anda. Jika Anda memilih opsi ini, masukkan kata sandi untuk pengguna utama, lalu konfirmasikan. Untuk masuk ke cluster Anda, Anda harus menggunakan kata sandi untuk pengguna utama.
Aturan kata sandi:
+ Panjangnya adalah [8-100] karakter ASCII yang dapat dicetak.
+ Dapat menggunakan karakter ASCII apa pun yang dapat dicetak kecuali untuk yang berikut ini:
+ **/** (garis miring ke depan)
+ **"** (tanda kutip ganda)
+ **@** (simbol pada)
1. Di bagian bawah layar, pilih salah satu dari berikut ini:
+ Untuk membuat klaster sekarang, pilih **Buat klaster**.
+ Untuk membatalkan pembuatan klaster, pilih **Batalkan**.
+ Untuk lebih mengkonfigurasi klaster sebelum membuat, pilih **Menampilkan konfigurasi tambahan**, dan kemudian lanjutkan di [Buat cluster: konfigurasi tambahan](#db-cluster-create-con-additional-configs).
Konfigurasi yang tercakup dalam bagian **Konfigurasi tambahan** adalah sebagai berikut:
+ **Pengaturan jaringan**—Default di sini akan menggunakan grup keamanan VPC `default`.
+ **Opsi klaster**—Default di sini akan menggunakan port 27017 dan grup parameter default.
+ **Enkripsi**—Default adalah untuk mengaktifkan enkripsi dengan menggunakan kunci `(default) aws/rds`.
**penting**
Setelah dienkripsi, klaster tidak dapat dibuat tanpa enkripsi.
+ **Backup**—Default adalah untuk mempertahankan backup selama 1 hari dan membiarkan Amazon DocumentDB memilih jendela backup.
+ **Ekspor log** —Defaultnya adalah tidak mengekspor log audit ke CloudWatch Log.
+ **Pemeliharaan**—Defaultnya adalah membiarkan Amazon DocumentDB memilih jendela pemeliharaan.
+ **Perlindungan penghapusan**—Lindungi klaster Anda dari penghapusan yang tidak disengaja. Default untuk klaster yang dibuat dengan menggunakan konsol *diaktifkan*.
Jika Anda menerima pengaturan default sekarang, Anda dapat mengubah sebagian besar pengaturan tersebut nanti dengan memodifikasi klaster.
1. Mengaktifkan sambungan masuk untuk grup keamanan klaster Anda.
Jika Anda tidak mengubah pengaturan default untuk klaster Anda, Anda membuat sebuah klaster menggunakan grup keamanan default untuk VPC default di wilayah tertentu. Untuk terhubung ke Amazon DocumentDB, Anda harus mengaktifkan koneksi masuk pada port 27017 (atau port pilihan Anda) untuk grup keamanan klaster Anda.
**Untuk menambahkan koneksi masuk ke grup keamanan klaster Anda**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Di bagian **Sumber Daya** dari jendela utama, pilih **Grup keamanan**.
![\[Gambar: Daftar sumber daya yang menyoroti opsi tautan Grup Keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Dari daftar grup keamanan, temukan grup keamanan yang Anda gunakan saat membuat klaster Anda (kemungkinan besar grup keamanan *default*) dan pilih kotak di sebelah kiri nama grup keamanan.
![\[Gambar: Daftar grup keamanan yang menyoroti satu grup keamanan dengan kotak yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. Dari menu **Tindakan**, pilih **Edit aturan masuk** lalu pilih atau masukkan batasan aturan.
1. **Jenis**—Dari daftar tersebut, pilih protokol untuk membuka lalu lintas jaringan.
1. **Protokol**—Dari daftar, pilih jenis protokol.
1. **Cakupan Port**—Untuk aturan kustom, masukkan nomor port atau cakupan port. Pastikan bahwa nomor port atau cakupan terdiri atas port yang Anda tentukan ketika membuat klaster Anda (default: 27017).
1. **Sumber**—Menentukan lalu lintas yang dapat menjangkau instans Anda. Dari daftar, pilih sumber lalu lintas. Jika Anda memilih **Khusus**, tentukan alamat IP tunggal atau cakupan alamat IP dalam notasi CIDR (misalnya, 203.0.113.5/32).
1. **Deskripsi**—Masukkan deskripsi untuk aturan ini.
1. Setelah selesai membuat aturan, pilih **Simpan**.
### Buat cluster: konfigurasi tambahan
Jika Anda ingin menerima pengaturan default untuk klaster Anda, Anda dapat melewatkan langkah-langkah berikut dan memilih **Buat klaster**.
1. Menyelesaikan panel **Pengaturan jaringan**.
![\[Cuplikan layar yang menampilkan panel pengaturan jaringan dan langkah-langkah untuk mengkonfigurasi pengaturan jaringan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Virtual Private Cloud (VPC)**—Dalam daftar, pilih Amazon VPC tempat Anda ingin meluncurkan klaster ini.
1. **Grup subnet**—Dalam daftar, pilih grup subnet yang ingin Anda gunakan untuk klaster ini.
1. **Grup keamanan VPC**—Di daftar, pilih grup keamanan VPC untuk klaster ini.
1. Lengkapi panel **Opsi klaster**.
![\[Screenshot menampilkan panel pilihan klaster dengan langkah-langkah untuk mengkonfigurasi pengaturan klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Port basis data** —Gunakan panah atas dan bawah untuk mengatur TCP/IP port yang akan digunakan aplikasi untuk terhubung ke instans Anda.
1. **Grup parameter klaster**—Dalam daftar grup parameter, pilih grup parameter klaster untuk klaster ini.
1. Menyelesaikan panel **Enkripsi**.
![\[Cuplikan layar dari panel enkripsi yang menunjukkan langkah-langkah untuk mengkonfigurasi enkripsi pada klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** —Pilih salah satu dari berikut ini:
+ **Aktifkan enkripsi**—Default. Semua data at rest dienkripsi. Jika Anda memilih untuk mengenkripsi data, Anda tidak dapat membatalkan tindakan ini.
+ **Menonaktifkan enkripsi**—Data Anda tidak dienkripsi.
1. **AWS Kunci KMS** —Ini hanya tersedia jika Anda mengenkripsi data Anda. Dalam daftar, pilih kunci yang ingin Anda gunakan untuk mengenkripsi data dalam klaster ini. Nilai default-nya `(default) aws/rds`.
Jika Anda memilih **Masukkan ARN kunci**, Anda harus memasukkan Amazon Resource Name (ARN) untuk kunci tersebut.
1. Menyelesaikan panel **Backup**.
![\[Cuplikan layar dari panel Backup menampilkan langkah-langkah untuk mengkonfigurasi jendela backup klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Periode retensi cadangan**—Dalam daftar, pilih jumlah hari untuk menyimpan backup otomatis klaster ini sebelum menghapusnya.
1. **Jendela backup**—Atur waktu harian dan durasi yang akan digunakan oleh Amazon DocumentDB untuk membuat backup dari klaster ini.
1. **Waktu mulai**—Pada daftar pertama, pilih jam waktu mulai (UTC) untuk memulai pencadangan otomatis. Dalam daftar kedua, pilih menit dari jam pilihan Anda untuk memulai backup otomatis.
1. **Durasi**—Dalam daftar, pilih jumlah jam yang akan dialokasikan untuk membuat cadangan otomatis.
1. Lengkapi panel **ekspor Log** dengan memilih jenis log yang ingin Anda ekspor ke CloudWatch Log.
![\[Cuplikan layar dari panel ekspor Log menunjukkan langkah-langkah untuk mengkonfigurasi pencatatan DLL klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Log audit** —Pilih opsi ini untuk mengaktifkan mengekspor log audit ke Amazon CloudWatch Logs. Jika Anda memilih **Log audit**, Anda harus mengaktifkan `audit_logs` di grup parameter kustom klaster. Untuk informasi selengkapnya, lihat [Mengaudit acara Amazon DocumentDB](event-auditing.md).
+ **Log profiler** —Pilih opsi ini untuk mengaktifkan mengekspor log profiler operasi ke Amazon Logs. CloudWatch Jika Anda memilih **Log profil**, Anda juga harus mengubah parameter berikut dalam grup parameter kustom klaster:
+ `profiler`—Setel ke`enabled`.
+ `profiler_threshold_ms`—Set ke nilai `[0-INT_MAX]` untuk mengatur ambang batas pada profil operasi.
+ `profiler_sampling_rate`—Set ke nilai `[0.0-1.0]` untuk mengatur persentase operasi lambat ke profil.
Untuk informasi selengkapnya, lihat [Membuat profil operasi Amazon DocumentDB](profiling.md).
1. Menyelesaikan panel **Pemeliharaan**.
![\[Cuplikan layar dari panel Pemeliharaan yang menampilkan langkah-langkah untuk mengkonfigurasi jendela pemeliharaan klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Pilih salah satu dari berikut
+ **Pilih jendela**—Anda dapat menentukan hari dalam seminggu, waktu mulai UTC, dan durasi untuk Amazon DocumentDB untuk melakukan pemeliharaan pada klaster Anda.
1. **Hari mulai**—Dalam daftar, pilih hari dalam seminggu untuk memulai pemeliharaan klaster.
1. **Waktu mulai**—Dalam daftar, pilih jam dan menit (UTC) untuk memulai pemeliharaan.
1. **Durasi**—Dalam daftar, pilih berapa banyak waktu yang akan dialokasikan untuk pemeliharaan klaster. Jika pemeliharaan tidak dapat diselesaikan dalam waktu yang ditentukan, proses pemeliharaan akan berlanjut melewati waktu yang ditentukan sampai selesai.
+ **Tidak Ada preferensi**-Amazon DocumentDB memilih hari dalam seminggu, waktu mulai, dan durasi untuk melakukan pemeliharaan.
1. Jika Anda ingin menambahkan satu atau beberapa tag ke klaster ini, lengkapi panel **Tag**.
![\[Cuplikan layar dari kotak centang Aktifkan perlindungan penghapusan, yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Untuk setiap tag yang ingin Anda tambahkan ke klaster, ulangi langkah-langkah berikut. Anda mungkin memiliki hingga 10 di sebuah klaster.
1. Pilih **Tambahkan tag**.
1. Ketik **Kunci** tag.
1. Secara opsional, ketik **Nilai** tag.
Untuk menghapus sebuah tag, pilih **Hapus tag**.
1. **Perlindungan penghapusan** diaktifkan secara default ketika Anda membuat klaster dengan menggunakan konsol. Untuk menonaktifkan perlindungan penghapusan, kosongkan **Aktifkan perlindungan penghapusan**. Ketika diaktifkan, perlindungan penghapusan mencegah agar klaster tidak terhapus. Untuk menghapus klaster yang dilindungi dari penghapusan, Anda harus terlebih dahulu memodifikasi klaster untuk menonaktifkan penghapusan perlindungan.
![\[Cuplikan layar dari kotak centang Aktifkan perlindungan penghapusan, yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
1. Untuk membuat klaster, pilih **Buat klaster**. Jika tidak, pilih **Batalkan**.
## Membuat cluster menggunakan AWS CLI
Prosedur berikut menjelaskan cara menggunakan AWS CLI untuk meluncurkan cluster Amazon DocumentDB dan membuat replika Amazon DocumentDB.
**Parameter**
+ **--db-cluster-identifier**—Diperlukan. Sebuah string huruf kecil yang mengidentifikasi klaster ini.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**—Diperlukan. Harus berupa **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**—Opsional. Ketika diaktifkan, perlindungan penghapusan mencegah agar klaster tidak terhapus. Saat Anda menggunakan AWS CLI, pengaturan defaultnya adalah menonaktifkan perlindungan penghapusan.
Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**—Opsional. Default: **standard**. Konfigurasi penyimpanan cluster. Nilai yang valid adalah `standard` (Standar) atau `iopt1` (I/O dioptimalkan).
+ **--master-username**—Diperlukan. Nama pengguna yang digunakan untuk mengautentikasi pengguna.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**—Opsional. Kata sandi pengguna yang digunakan untuk mengautentikasi pengguna.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**—Opsional. Amazon DocumentDB menghasilkan kata sandi pengguna utama dan mengelolanya sepanjang siklus hidupnya di Secrets Manager.
Untuk parameter tambahan, lihat [CreateDBCluster](API_CreateDBCluster.md).
**Untuk meluncurkan cluster Amazon DocumentDB menggunakan AWS CLI**
Untuk membuat cluster Amazon DocumentDB, hubungi file. `create-db-cluster` AWS CLI AWS CLI Perintah berikut membuat klaster Amazon DocumentDB `sample-cluster` bernama dengan perlindungan penghapusan diaktifkan. Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
Juga, `--engine-version` adalah parameter opsional yang default ke versi mesin utama terbaru. Versi mesin default saat ini adalah 5.0.0 (catatan: Amazon DocumentDB 8.0 tersedia tetapi harus ditentukan secara eksplisit). Ketika versi mesin utama baru dirilis, versi mesin default untuk `--engine-version` akan diperbarui untuk mencerminkan versi mesin utama terakhir. Akibatnya, untuk beban kerja produksi, dan terutama yang bergantung pada skrip, otomatisasi, atau CloudFormation templat, kami menyarankan Anda secara eksplisit menentukan `--engine-version` ke versi utama yang dimaksud.
**catatan**
Jika `db-subnet-group-name` atau `vpc-security-group-id` tidak ditentukan, Amazon DocumentDB akan menggunakan grup subnet default dan grup keamanan Amazon VPC untuk wilayah tertentu.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Untuk Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Dibutuhkan beberapa menit untuk membuat klaster. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memantau status cluster Anda. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**penting**
Saat Anda menggunakan AWS CLI untuk membuat klaster Amazon DocumentDB, tidak ada instance yang dibuat. Akibatnya, Anda harus secara eksplisit membuat instans primer dan semua instans replika yang Anda butuhkan. Anda dapat menggunakan konsol atau AWS CLI untuk membuat instance. Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md).
Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) di *Referensi API Amazon DocumentDB*.
# Menggambarkan cluster Amazon DocumentDB
Anda dapat menggunakan Amazon DocumentDB Management Console atau AWS CLI untuk melihat detail seperti titik akhir koneksi, grup keamanan VPCs, dan grup parameter yang berkaitan dengan cluster Amazon DocumentDB Anda.
Untuk informasi selengkapnya, lihat berikut ini:
+ [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Menemukan titik akhir klaster](db-cluster-endpoints-find.md)
------
#### [ Using the Konsol Manajemen AWS ]
Gunakan prosedur berikut untuk melihat perincian klaster Amazon DocumentDB yang ditentukan dengan menggunakan konsol.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Dalam daftar klaster, pilih nama klaster yang ingin Anda lihat perinciannya. Informasi tentang klaster diatur ke dalam pengelompokan berikut:
+ **Ringkasan** — Informasi umum tentang klaster, termasuk versi mesin, status klaster, pemeliharaan tertunda, dan status grup parameter.
+ **Konektivitas & Keamanan** —Bagian **Hubungkan** berisi daftar titik akhir sambungan untuk membuat sambungan ke klaster ini dengan mongo shell atau dengan aplikasi. Bagian **Grup Keamanan** terdiri atas daftar grup keamanan yang terkait dengan klaster ini dan ID VPC serta deskripsinya.
+ **Konfigurasi** — Bagian **Detail klaster** berisi daftar perincian tentang klaster, termasuk Amazon Resource Name (ARN) klaster, titik akhir, dan grup parameter. Ini juga berisi daftar informasi backup klaster, perincian pemeliharaan, dan pengaturan keamanan dan jaringan. Bagian **Instans klaster** berisi daftar instans yang dimiliki klaster ini dengan masing-masing peran instans dan status grup parameter klaster.
+ **Monitoring** — Metrik Amazon CloudWatch Logs untuk klaster ini. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md).
+ **Acara & tag** — Bagian **Peristiwa terbaru** berisi daftar peristiwa terbaru untuk klaster ini. Amazon DocumentDB menyimpan catatan peristiwa yang terkait dengan klaster, instans, snapshot, grup keamanan, dan grup parameter klaster Anda. Informasi ini mencakup tanggal, waktu, dan pesan yang terkait dengan setiap peristiwa. Bagian **Tag** berisi daftar tag yang dilampirkan ke klaster ini.
------
#### [ Using the AWS CLI ]
Untuk melihat detail cluster Amazon DocumentDB Anda menggunakan, gunakan perintah seperti AWS CLI yang ditunjukkan pada contoh `describe-db-clusters` di bawah ini. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)di Referensi *API Manajemen Sumber Daya Amazon DocumentDB*.
**catatan**
Untuk fitur pengelolaan tertentu seperti pengelolaan siklus hidup klaster dan instans, Amazon DocumentDB memanfaatkan teknologi operasi yang dibagikan dengan Amazon RDS. Parameter filter `filterName=engine,Values=docdb` hanya mengembalikan klaster Amazon DocumentDB.
**Example**
**Contoh 1: Daftar semua cluster Amazon DocumentDB**
AWS CLI Kode berikut mencantumkan detail untuk semua cluster Amazon DocumentDB di suatu wilayah.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
Output dari operasi ini akan terlihat seperti berikut.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Contoh 2: Daftar semua detail untuk klaster Amazon DocumentDB tertentu**
AWS CLI Kode berikut mencantumkan rincian untuk cluster`sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
Output dari operasi ini terlihat seperti berikut ini.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Contoh 3: Daftar detail spesifik untuk klaster Amazon DocumentDB**
Untuk mencantumkan subset detail kluster menggunakan AWS CLI, tambahkan yang menentukan anggota klaster mana yang akan dicantumkan `describe-db-clusters` operasi. `--query` Parameter `--db-cluster-identifier` adalah pengenal untuk klaster tertentu yang perinciannya ingin Anda tampilkan. Untuk informasi selengkapnya tentang kueri, lihat [ Cara Filter Output dengan `--query` Opsi](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) di *AWS Command Line Interface Panduan Pengguna*.
Contoh berikut mencantumkan instans dalam klaster Amazon DocumentDB.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
Output dari operasi ini terlihat seperti berikut ini.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Memodifikasi cluster Amazon DocumentDB
Untuk mengubah suatu klaster, klaster tersebut harus dalam kondisi *tersedia*. Anda tidak dapat mengubah klaster yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu hingga klaster *tersedia*, lalu buat modifikasi yang diinginkan. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Konsol Manajemen AWS ]
Gunakan prosedur berikut untuk memodifikasi klaster Amazon DocumentDB tertentu menggunakan konsol.
**Cara memodifikasi klaster Amazon DocumentDB**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Tentukan klaster yang ingin Anda modifikasi dengan memilih tombol di sebelah kiri nama klaster.
1. Pilih **Tindakan**, lalu pilih **Modifikasi**.
1. Di **Modifikasi klaster: panel **, buat perubahan yang Anda inginkan. Anda dapat membuat perubahan di bidang berikut:
+ **Spesifikasi klaster** —Nama klaster, grup keamanan, dan manajemen kredensialnya.
+ **Konfigurasi penyimpanan cluster** —Mode penyimpanan data cluster. Pilih antara konfigurasi Standar dan I/O-Optimized.
+ **Opsi klaster**—Port klaster dan grup parameter.
+ **Backup**—Periode penyimpanan backup klaster dan jendela backup.
+ **Ekspor log**—Aktifkan atau nonaktifkan ekspor audit atau log pembuat profil.
+ **Pemeliharaan**—Atur jendela pemeliharaan klaster.
+ **Perlindungan penghapusan**—Aktifkan atau nonaktifkan perlindungan penghapusan pada klaster. Perlindungan penghapusan diaktifkan secara default.
1. Setelah selesai, pilih **Lanjutkan** untuk melihat ringkasan perubahan Anda.
1. Jika Anda puas dengan perubahan Anda, Anda dapat memilih **Modifikasi klaster** untuk memodifikasi klaster Anda. Sebagai alternatif, Anda dapat memilih **Kembali** atau **Batalkan** untuk mengedit atau membatalkan perubahan Anda, masing-masing.
Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya *tersedia*. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Gunakan operasi `modify-db-cluster` untuk mengubah klaster yang ditentukan dengan menggunakan AWS CLI. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) di *Referensi API Amazon DocumentDB*.
**Parameter**
+ **--db-cluster-identifier**—Diperlukan. Pengenal klaster Amazon DocumentDB yang akan Anda modifikasi.
+ **--backup-retention-period**—Opsional. Jumlah hari untuk penyimpanan cadangan otomatis dipertahankan. Nilai yang valid adalah 1–35.
+ **--storage-type**—Opsional. Konfigurasi penyimpanan cluster. Nilai yang valid adalah `standard` (Standar) atau `iopt1` (I/O dioptimalkan).
+ **--db-cluster-parameter-group-name**—Opsional. Nama grup parameter klaster yang digunakan untuk klaster.
+ **--manage-master-user-password**—Opsional. Amazon DocumentDB menghasilkan kata sandi pengguna utama dan mengelolanya sepanjang siklus hidupnya di Secrets Manager.
+ **--rotate-master-user-password**—Opsional. Secrets Manager menghasilkan versi rahasia baru untuk rahasia yang ada. Versi baru rahasia berisi kata sandi pengguna utama yang baru. Amazon DocumentDB mengubah kata sandi pengguna utama untuk cluster agar sesuai dengan kata sandi untuk versi rahasia baru.
Anda harus menentukan **--apply-immediately** opsi ketika Anda memutar kata sandi utama.
+ **--master-user-password**—Opsional. Kata sandi baru untuk pengguna basis data utama.
Aturan kata sandi:
+ Panjang adalah [8—100] karakter ASCII yang dapat dicetak.
+ Dapat menggunakan karakter ASCII yang dapat dicetak kecuali untuk berikut ini:
+ **/** (garis miring ke depan)
+ **"** (tanda kutip ganda)
+ **@** (simbol pada)
+ **--new-db-cluster-identifier**—Opsional. Pengenal klaster baru untuk klaster ketika mengubah nama klaster. Nilai ini disimpan sebagai string huruf kecil.
Aturan penamaan:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB per, per wilayah. Akun AWS
+ **--preferred-backup-window**—Opsional. Dalam rentang waktu harian selama pencadangan otomatis dibuat, dalam Waktu Terkoordinasi Universal (UTC).
+ Format: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**—Opsional. Rentang waktu mingguan untuk melakukan pemeliharaan sistem dapat terjadi, dalam UTC.
+ Format: `ddd:hh24:mm-ddd:hh24:mm`
+ Hari yang sah: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, dan `Sat`.
+ **--deletion-protection** atau **--no-deletion-protection**—Opsional. Apakah perlindungan penghapusan harus diaktifkan pada klaster ini. Perlindungan penghapusan mencegah sebuah klaster dari yang sengaja dihapus sampai klaster dimodifikasi untuk menonaktifkan perlindungan penghapusan. Untuk informasi selengkapnya, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--apply-immediately** atau **--no-apply-immediately**—Gunakan `--apply-immediately` untuk segera membuat perubahan. Gunakan `--no-apply-immediately` untuk membuat perubahan selama jendela pemeliharaan berikutnya pada klaster Anda.
**Example**
Kode berikut mengubah periode penyimpanan cadangan untuk klaster `sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Untuk Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
Output dari operasi ini terlihat seperti berikut ini.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya *tersedia*. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
# Menentukan pemeliharaan yang tertunda
Anda dapat menentukan apakah Anda memiliki versi mesin Amazon DocumentDB terbaru dengan menentukan apakah Anda memiliki pemeliharaan klaster tertunda.
------
#### [ Using the Konsol Manajemen AWS ]
Anda dapat menggunakan Konsol Manajemen AWS untuk menentukan apakah klaster memiliki pemeliharaan yang tertunda.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika panel navigasi tidak terlihat di sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Temukan kolom **Pemeliharaan** untuk menentukan apakah sebuah klaster memiliki pemeliharaan tertunda.
![\[Cuplikan layar konsol yang menunjukkan bidang pemeliharaan klaster Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**Tidak ada** menunjukkan bahwa klaster menjalankan versi mesin terbaru. **Tersedia** menunjukkan bahwa klaster memiliki pemeliharaan tertunda, yang mungkin berarti bahwa peningkatan mesin diperlukan.
1. Jika klaster Anda memiliki pemeliharaan tertunda, lanjutkan dengan langkah-langkah di [Melakukan pembaruan tambalan ke versi mesin cluster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Anda dapat menggunakan AWS CLI untuk menentukan apakah sebuah cluster memiliki versi mesin terbaru dengan menggunakan `describe-pending-maintenance-actions` operasi dengan parameter berikut.
**Parameter**
+ **--resource-identifier**—Opsional. ARN untuk sumber daya (klaster). Jika parameter ini dihilangkan, tindakan pemeliharaan tertunda untuk semua klaster didaftarkan.
+ **--region**—Opsional. Wilayah AWS tempat Anda ingin menjalankan operasi ini, misalnya, `us-east-1`.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Untuk Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
Output dari operasi ini terlihat seperti berikut ini.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Jika klaster Anda memiliki pemeliharaan tertunda, lanjutkan dengan langkah-langkah di [Melakukan pembaruan tambalan ke versi mesin cluster](db-cluster-version-upgrade.md).
------
# Melakukan pembaruan tambalan ke versi mesin cluster
Di bagian ini, kami akan menjelaskan cara menerapkan pembaruan tambalan menggunakan Konsol Manajemen AWS atau. AWS CLI Pembaruan patch adalah pembaruan dalam versi mesin yang sama (misalnya, memperbarui versi mesin 3.6 ke versi mesin 3.6 yang lebih baru). Anda dapat memperbaruinya segera atau selama jendela pemeliharaan berikutnya pada klaster Anda. Untuk menentukan apakah mesin Anda memerlukan pembaruan, lihat [Menentukan pemeliharaan yang tertunda](db-cluster-determine-pending-maintenance.md). Silakan dicatat bahwa ketika Anda menerapkan pembaruan, klaster Anda akan mengalami waktu henti selama beberapa saat.
**catatan**
Jika Anda mencoba untuk meng-upgrade dari versi mesin utama ke yang lain, seperti 3.6 ke 5.0, lihat salah satu [Peningkatan versi utama Amazon DocumentDB di tempat](docdb-mvu.md) atau[Memutakhirkan cluster Amazon DocumentDB Anda menggunakan AWS Database Migration Service](docdb-migration.versions.md). Upgrade versi utama di tempat hanya mendukung docdb 5.0 sebagai versi mesin target.
Ada dua persyaratan konfigurasi untuk mendapatkan pembaruan patch terbaru untuk sebuah versi mesin pada suatu klaster:
+ Status klaster harus *tersedia*.
+ Klaster harus menjalankan versi mesin sebelumnya.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menerapkan pembaruan patch untuk versi mesin pada klaster dengan menggunakan konsol. Anda memiliki pilihan untuk memperbarui segera atau selama jendela pemeliharaan berikutnya pada klaster Anda.
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda tingkatkan. Status klaster harus *tersedia*.
**Tip**
Jika panel navigasi tidak terlihat di sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Dari menu **Tindakan**, pilih salah satu dari berikut ini. Opsi menu ini dapat dipilih hanya jika klaster yang Anda pilih tidak menjalankan versi mesin terbaru.
![\[Gambar: Tindakan Pembaruan Amazon DocumentDB\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Tingkatkan sekarang**—Segera memulai proses peningkatan. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.
+ **Tingkatkan pada jendela berikutnya**—Memulai proses peningkatan selama jendela pemeliharaan berikutnya pada klaster. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.
1. Jika jendela konfirmasi terbuka, pilih salah satu hal berikut:
+ **Meningkatkan**—Untuk meningkatkan klaster Anda ke versi mesin terbaru sesuai dengan jadwal yang dipilih pada langkah sebelumnya.
+ **Batalkan**—Untuk membatalkan peningkatan mesin klaster dan melanjutkan dengan versi mesin saat ini pada klaster.
------
#### [ Using the AWS CLI ]
Anda dapat menerapkan pembaruan tambalan ke cluster Anda menggunakan AWS CLI dan `apply-pending-maintenance-action` operasi dengan parameter berikut.
**Parameter**
+ **--resource-identifier**—Diperlukan. ARN dari klaster Amazon DocumentDB yang akan Anda tingkatkan.
+ **--apply-action**—Diperlukan. Nilai berikut diizinkan. Untuk meningkatkan versi mesin klaster Anda, gunakan `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**—Diperlukan. Nilai berikut diizinkan.
+ `immediate`—Terapkan tindakan pemeliharaan segera.
+ `next-maintenance`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya.
+ `undo-opt-in`—Membatalkan permintaan keikutsertaan `next-maintenance` yang ada.
**Example**
Patch contoh berikut memperbarui versi mesin `sample-cluster` ke versi 4.0.0.
Untuk Linux, macOS, atau Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Untuk Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
Output dari operasi ini terlihat seperti berikut ini.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Menghentikan dan memulai cluster Amazon DocumentDB
Menghentikan dan memulai klaster Amazon DocumentDB membantu Anda mengelola biaya untuk pengembangan dan pengujian lingkungan. Alih-alih menciptakan dan menghapus klaster dan instans setiap kali Anda menggunakan Amazon DocumentDB, untuk sementara, Anda dapat menghentikan semua instans pada klaster ketika tidak diperlukan. Anda kemudian dapat memulainya lagi saat melanjutkan pengujian.
**Topics**
+ [Ikhtisar menghentikan dan memulai klaster](#db-cluster-stop-start-overview)
+ [Operasi yang dapat Anda lakukan pada cluster yang dihentikan](#db-cluster-stopped-operations)
## Ikhtisar menghentikan dan memulai klaster
Selama periode di mana Anda tidak memerlukan klaster Amazon DocumentDB, Anda dapat menghentikan semua instans dalam klaster itu sekaligus. Anda lalu dapat memulai klaster lagi kapan saja Anda memerlukannya. Memulai dan menghentikan menyederhanakan proses pengaturan dan perombakan pada klaster yang digunakan untuk pengembangan, pengujian, atau aktifitas serupa yang tidak memerlukan ketersediaan berkelanjutan. Anda dapat menghentikan dan memulai cluster menggunakan Konsol Manajemen AWS atau AWS CLI dengan satu tindakan, terlepas dari berapa banyak instance yang ada di cluster.
Sementara klaster Anda berhenti, volume penyimpanan klaster tetap tidak berubah. Anda hanya dikenakan biaya untuk penyimpanan, snapshot manual, dan penyimpanan cadangan otomatis dalam jendela penyimpanan yang Anda tentukan. Anda tidak dikenakan biaya untuk jam instans apa pun. Amazon DocumentDB secara otomatis memulai klaster Anda setelah tujuh hari sehingga tidak tertinggal pembaruan pemeliharaan yang diperlukan. Ketika klaster Anda dimulai setelah tujuh hari, Anda akan mulai dikenakan biaya untuk instans di klaster lagi. Sementara klaster Anda berhenti, Anda tidak dapat mengajukan kueri untuk volume penyimpanan Anda karena kueri mengharuskan instans dalam keadaan tersedia.
Ketika sebuah klaster Amazon DocumentDB dihentikan, baik klaster maupun instans dapat dimodifikasi dengan cara apa pun. Ini termasuk menambahkan atau menghapus instans, atau menghapus klaster.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menunjukkan kepada Anda caranya menghentikan sebuah klaster dengan satu atau beberapa instans dalam keadaan tersedia, atau caranya memulai klaster yang telah dihentikan.
**Untuk menghentikan atau memulai klaster Amazon DocumentDB**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika panel navigasi tidak terlihat di sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda mulai atau tingkatkan.
1. Pilih **Tindakan**, lalu pilih tindakan yang ingin Anda lakukan pada klaster.
+ Jika Anda ingin menghentikan klaster dan klaster tersedia:
1. Pilih **Berhenti**.
![\[Gambar: Menghentikan sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop.png)
Untuk menghindari pengaktifan mekanisme failover, operasi stop menghentikan instans replika terlebih dahulu, lalu instans utama.
1. Pada dialog konfirmasi, konfirmasikan bahwa Anda ingin menghentikan klaster dengan memilih **Hentikan klaster**, atau untuk mempertahankan klaster agar terus berjalan, pilih **Batalkan**.
![\[Gambar: Mulai sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Jika Anda ingin memulai klaster, dan klaster berhenti, pilih **Mulai**.
![\[Gambar: Mulai sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Pantau status klaster dan instansnya. Jika Anda memulai klaster, Anda dapat melanjutkan penggunaan klaster ketika klaster dan instansnya *tersedia*. Untuk informasi selengkapnya, lihat [Menentukan status klaster](db-cluster-status.md).
![\[Gambar: Status klaster berhenti dan mulai\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
Contoh kode berikut menunjukkan kepada Anda caranya menghentikan sebuah klaster dengan satu atau beberapa instans dalam keadaan tersedia, atau caranya memulai klaster yang telah dihentikan.
Untuk menghentikan cluster dengan satu atau lebih instance yang tersedia menggunakan AWS CLI, gunakan `stop-db-cluster` operasi. Untuk memulai klaster yang telah dihentikan, gunakan operasi `start-db-cluster`. Kedua operasi menggunakan parameter `--db-cluster-identifier`.
**Parameter:**
+ **--db-cluster-identifier**—Diperlukan. Nama klaster untuk berhenti atau mulai.
**Example — Untuk menghentikan cluster menggunakan AWS CLI**
Kode berikut menghentikan klaster `sample-cluster`. Klaster harus memiliki satu atau beberapa instans dalam keadaan tersedia.
Untuk Linux, macOS, atau Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Untuk Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Untuk memulai cluster menggunakan AWS CLI**
Kode berikut memulai klaster `sample-cluster`. Klaster saat ini harus dihentikan.
Untuk Linux, macOS, atau Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Untuk Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operasi yang dapat Anda lakukan pada cluster yang dihentikan
Saat klaster Amazon DocumentDB dihentikan, Anda dapat melakukan point-in-time pemulihan ke titik mana pun dalam jendela retensi cadangan otomatis yang Anda tentukan. Untuk detail tentang melakukan point-in-time pemulihan, lihat[Memulihkan ke titik waktu](backup_restore-point_in_time_recovery.md).
Anda tidak dapat memodifikasi konfigurasi klaster Amazon DocumentDB, atau salah satu instansnya saat klaster dihentikan. Anda juga tidak dapat menambahkan atau menghapus instans dari klaster, atau menghapus klaster tersebut jika masih memiliki instans terkait. Anda harus memulai klaster sebelum melakukan tindakan administratif tersebut.
Amazon DocumentDB menerapkan pemeliharaan terjadwal pada klaster yang dihentikan hanya setelah dimulai lagi. Setelah tujuh hari, Amazon DocumentDB secara otomatis memulai klaster yang telah dihentikan sehingga tidak jauh tertinggal dalam status pemeliharaan. Ketika klaster dinyalakan kembali, Anda akan mulai kembali dikenakan biaya untuk instans dalam klaster.
Sementara klaster dihentikan, Amazon DocumentDB tidak melakukan backup otomatis atau memperpanjang periode retensi cadangan.
# Menghapus cluster Amazon DocumentDB
Anda dapat menghapus cluster Amazon DocumentDB menggunakan Konsol Manajemen AWS atau file. AWS CLI Untuk menghapus sebuah klaster, klaster harus dalam kondisi *tersedia* dan tidak harus memiliki instans apa pun yang terkait dengannya. Jika klaster berhenti, pertama mulai klaster, tunggu sampai klaster *tersedia*, kemudian hapus klaster tersebut. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md).
## Perlindungan penghapusan
Untuk melindungi klaster Anda dari penghapusan tidak disengaja, Anda dapat mengaktifkan *perlindungan penghapusan*. Perlindungan penghapusan diaktifkan secara default ketika Anda membuat klaster dengan menggunakan konsol. Namun, perlindungan penghapusan dinonaktifkan secara default jika Anda membuat klaster menggunakan AWS CLI.
Amazon DocumentDB memberlakukan perlindungan penghapusan untuk klaster, tidak soal apakah Anda melakukan operasi hapus dengan menggunakan konsol atau AWS CLI. Jika perlindungan penghapusan diaktifkan, Anda tidak dapat menghapus klaster. Untuk menghapus klaster yang mengaktifkan perlindungan penghapusan, Anda harus terlebih dahulu mengubah klaster dan menonaktifkan perlindungan penghapusan.
Saat menggunakan konsol dengan perlindungan penghapusan yang diaktifkan di sebuah klaster, Anda tidak dapat menghapus instans terakhir pada klaster karena hal itu juga akan menghapus klaster. Anda dapat menghapus instans terakhir dari klaster dengan perlindungan penghapusan menggunakan AWS CLI. Namun, klaster itu sendiri masih ada, dan data Anda disimpan. Anda dapat mengakses data dengan membuat instans baru untuk klaster. Untuk informasi selengkapnya tentang mengaktifkan dan menonaktifkan perlindungan penghapusan, lihat:
+ [Membuat cluster Amazon DocumentDB](db-cluster-create.md)
+ [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Konsol Manajemen AWS ]
Untuk menghapus cluster menggunakan Konsol Manajemen AWS, perlindungan penghapusan harus dinonaktifkan.
**Untuk menentukan apakah sebuah klaster memiliki perlindungan penghapusan yang diaktifkan:**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.
1. Perhatikan bahwa di kotak navigasi Cluster, kolom **pengenal Cluster menunjukkan cluster** dan instance. Instans tercantum di bawah klaster, mirip dengan tangkapan layar di bawah ini.
![\[Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/clusters.png)
1. Pilih nama klaster, dan pilih tab **Konfigurasi**. Di bagian **Detail klaster**, temukan **Perlindungan penghapusan**. Jika perlindungan penghapusan diaktifkan, modifikasi klaster untuk menonaktifkan perlindungan penghapusan. Untuk informasi tentang memodifikasi klaster, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
Setelah **Perlindungan penghapusan** dinonaktifkan, Anda siap untuk menghapus klaster.
**Untuk menghapus klaster:**
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Tentukan apakah cluster memiliki instance dengan memeriksa kolom **pengidentifikasi Cluster** untuk contoh yang tercantum di bawahnya. Sebelum dapat menghapus klaster, Anda harus menghapus semua instans. Untuk informasi selengkapnya, lihat [Menghapus instans Amazon DocumentDB](db-instance-delete.md).
1. Tergantung pada apakah klaster Anda memiliki instans, lakukan salah satu langkah berikut.
+ Jika klaster tidak memiliki instans, pilih tombol di sebelah kiri nama klaster dan pilih **Tindakan**. Dari menu pilihan menurun, pilih **Hapus**. Lengkapi kotak dialog **Hapus **, lalu pilih **Hapus**.
+ Jika klaster memiliki satu atau beberapa instans, lakukan hal berikut:
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Hapus setiap instance cluster dengan memilih kotak centang di sebelah kiri nama cluster. Pilih **Tindakan**, lalu pilih **Hapus**. Lengkapi kotak dialog **Hapus **, lalu pilih **Hapus**.
Ketika Anda menghapus contoh terakhir, cluster juga akan dihapus. Untuk informasi selengkapnya tentang menghapus instance, lihat. [Menghapus instans Amazon DocumentDB](db-instance-delete.md)
Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Anda tidak dapat menghapus klaster yang memiliki instans yang berhubungan dengan itu. Untuk menentukan instans mana yang terkait dengan klaster Anda, jalankan perintah `describe-db-clusters` dan hapus semua instans klaster. Kemudian, jika diperlukan, nonaktifkan perlindungan penghapusan pada klaster Anda, dan terakhir, hapus klaster.
1. **Pertama, hapus semua instance cluster.**
Untuk menentukan instans mana yang perlu Anda hapus, jalankan perintah berikut.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Jika klaster yang Anda ingin hapus memiliki suatu instans, hapuslah dengan cara yang ditunjukkan di bawah ini.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **Kedua, nonaktifkan perlindungan penghapusan.**
Menggunakan AWS CLI untuk menghapus semua instance cluster tidak menghapus cluster. Anda juga harus menghapus klaster, tetapi Anda dapat melakukan ini hanya jika perlindungan penghapusan dinonaktifkan.
Untuk menentukan apakah klaster memiliki perlindungan penghapusan yang diaktifkan, jalankan perintah berikut.
**Tip**
Untuk melihat status perlindungan penghapusan di seluruh klaster Amazon DocumentDB Anda, hilangkan parameter `--db-cluster-identifier`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
Output dari operasi ini terlihat seperti berikut ini.
```
[
[
"sample-cluster",
"true"
]
]
```
Jika klaster memiliki perlindungan penghapusan yang diaktifkan, modifikasi klaster dan nonaktifkan perlindungan penghapusan. Untuk menonaktifkan perlindungan penghapusan pada klaster, jalankan perintah berikut.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Akhirnya, hapus cluster.**
Setelah perlindungan penghapusan dinonaktifkan, Anda siap untuk menghapus klaster. Untuk menghapus klaster, gunakan operasi `delete-db-cluster` dengan parameter berikut.
+ **--db-cluster-identifier**—Diperlukan. Pengenal klaster yang ingin Anda hapus.
+ **--final-db-snapshot-identifier**—Opsional. Jika Anda ingin snapshot akhir, Anda harus menyertakan parameter ini dengan nama untuk snapshot akhir. Anda harus menyertakan `--final-db-snapshot-identifier` atau `--skip-final-snapshot`.
Aturan penamaan:
+ Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa huruf.
+ Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
+ Harus unik untuk semua cluster di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB per, per Wilayah. Akun AWS
+ **--skip-final-snapshot**—Opsional. Gunakan parameter ini hanya jika Anda tidak ingin mengambil snapshot akhir sebelum menghapus klaster Anda. Pengaturan default adalah untuk mengambil snapshot akhir. Anda harus menyertakan `--final-db-snapshot-identifier` atau `--skip-final-snapshot`.
AWS CLI Kode berikut menghapus cluster `sample-cluster` dengan snapshot akhir. Operasi gagal jika ada setiap instans yang terkait dengan klaster atau jika perlindungan penghapusan diaktifkan.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Untuk Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
AWS CLI Kode berikut menghapus cluster `sample-cluster` tanpa mengambil snapshot akhir.
Untuk Linux, macOS, atau Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Untuk Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
Output dari operasi `delete-db-cluster` adalah klaster Anda akan Anda hapus.
Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau status klaster](monitoring_docdb-cluster_status.md).
------
# Menskalakan cluster Amazon DocumentDB
Amazon DocumentDB memungkinkan Anda untuk menskalakan penyimpanan dan melakukan komputasi dalam klaster Anda berdasarkan kebutuhan Anda. Bagian ini menjelaskan bagaimana Anda dapat menggunakan penskalaan untuk penyimpanan, penskalaan untuk instans, dan penskalaan untuk pembacaan guna mengelola performa dan penskalaan untuk klaster dan instans Amazon DocumentDB.
**Topics**
+ [Penskalaan penyimpanan](#db-cluster-manage-scaling-storage)
+ [Penskalaan instans](#db-cluster-manage-scaling-instance)
+ [Penskalaan baca](#db-cluster-manage-scaling-reads)
+ [Tulis penskalaan](#db-cluster-manage-scaling-writes)
## Penskalaan penyimpanan
Penyimpanan Amazon DocumentDB secara otomatis diskalakan dengan data dalam volume klaster Anda. Seiring pertumbuhan data Anda, penyimpanan volume cluster Anda tumbuh dalam peningkatan 10 GiB, hingga 128 TiB.
## Penskalaan instans
Anda dapat menskalakan klaster Amazon DocumentDB sesuai kebutuhan dengan memodifikasi kelas instans untuk setiap instans dalam klaster. Amazon DocumentDB mendukung beberapa kelas instans yang dioptimalkan untuk Amazon DocumentDB.
Untuk informasi selengkapnya, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md).
## Penskalaan baca
Anda dapat mencapai penskalaan baca untuk klaster Amazon DocumentDB dengan membuat hingga 15 replika Amazon DocumentDB dalam klaster. Setiap replika Amazon DocumentDB menghasilkan data yang sama dari volume klaster dengan sedikit penundaan replika—biasanya kurang dari 100 milidetik setelah instans utama menulis pembaruan. Saat lalu lintas baca meningkat, Anda dapat membuat replika Amazon DocumentDB tambahan dan terhubung langsung ke sana untuk mendistribusikan beban baca pada klaster Anda. Replika Amazon DocumentDB tidak harus dari kelas instans DB yang sama dengan instans utama.
Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md).
Untuk membaca penskalaan dengan Amazon DocumentDB, Anda sebaiknya membuat sambungan ke klaster Anda sebagai set replika dan mendistribusikan pembacaan ke instans replika menggunakan kemampuan preferensi baca bawaan driver Anda. Untuk informasi selengkapnya, lihat [Menghubungkan ke Amazon DocumentDB sebagai set replika](connect-to-replica-set.md).
## Tulis penskalaan
Anda dapat menskalakan kapasitas tulis pada klaster Amazon DocumentDB Anda dengan meningkatkan ukuran instans utama klaster Anda. Bagian ini menyediakan dua metode untuk menskalakan instans utama klaster Anda berdasarkan kebutuhan. Opsi pertama berupaya meminimalkan dampak aplikasi tetapi membutuhkan lebih banyak langkah untuk menyelesaikannya. Opsi kedua mengoptimalkan kesederhanaan karena memiliki langkah yang lebih sedikit, tetapi dilengkapi dengan tradeoff yang memiliki dampak yang lebih potensial untuk aplikasi Anda.
Bergantung pada aplikasi Anda, Anda bisa memilih pendekatan apa di bawah ini yang terbaik untuk Anda. Untuk informasi selengkapnya tentang ukuran dan biaya instans yang tersedia, lihat halaman [Harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
1. **Optimalkan ketersediaan dan performa tinggi** — Jika Anda terhubung ke klaster Anda di [mode set replika](connect-to-replica-set.md) (disarankan), Anda dapat menggunakan proses berikut untuk meminimalkan dampak aplikasi Anda saat menskalakan instans primer Anda. Metode ini meminimalkan dampak karena mempertahankan klaster Anda pada atau di atas ketersediaan tinggi Anda, dan target penskalaan baca ditambahkan ke klaster sebagai instans, alih-alih diperbarui pada tempatnya.
1. Tambahkan satu atau beberapa replika dari jenis instans yang lebih besar ke klaster Anda (lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md)). Semua replika sebaiknya memiliki jenis instans yang sama dengan atau lebih besar dari yang utama. Hal ini untuk menghindari pengurangan yang tidak disengaja dalam performa tulis akibat kegagalan terhadap jenis instans yang lebih kecil. Untuk sebagian besar pelanggan, ini berarti penggandaan jumlah instans sementara di klaster mereka, kemudian penghapusan replika yang lebih kecil setelah penskalaan selesai.
1. Atur tingkat failover pada semua replika baru ke prioritas nol, hal ini memastikan replika jenis instans yang lebih kecil memiliki prioritas failover tertinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control).
1. Memulai failover manual, yang akan mempromosikan salah satu replika baru menjadi instans utama. Untuk informasi selengkapnya, lihat [Menguji failover](failover.md#failover-testing).
**catatan**
Ini akan menimbulkan \$130 detik waktu henti untuk klaster Anda. Silakan buat rencana yang sesuai.
1. Hapus semua replika dengan jenis instans yang lebih kecil daripada intans utama baru Anda dari klaster.
1. Kembalikan tingkat failover semua intans ke prioritas yang sama (biasanya, ini berarti pengaturan kembali ke 1).
Sebagai contoh, anggaplah Anda memiliki klaster yang saat ini berisi tiga instans `r5.large` (satu primer dan dua replika), dan Anda ingin melakukan penskalaan ke tipe instans `r5.xlarge`. Untuk melakukannya, pertama Anda akan menambahkan tiga instans replika `r5.xlarge` ke klaster Anda, lalu tetapkan tingkat failover replika `r5.xlarge` baru ke nol. Selanjutnya, Anda akan memulai failover manual (diketahui bahwa aplikasi Anda akan mengalami \$1 30 detik waktu henti). Setelah failover selesai, Anda akan menghapus ketiga instans `r5.large` dari klaster Anda, sehingga klaster tersebut diskalakan ke instans `r5.xlarge`.
Untuk membantu mengoptimalkan biaya, instans Amazon DocumentDB ditagih dalam kenaikan satu detik, dengan biaya minimum sepuluh menit setelah perubahan status yang dapat ditagih seperti membuat, memodifikasi, atau menghapus instans. Untuk informasi selengkapnya lihat [Optimalisasi biaya](best_practices.md#best_practices-cost_optimization) dalam dokumentasi praktik terbaik.
1. **Optimalisasi untuk kesederhanaan** — Pendekatan ini dioptimalkan untuk menyederhanakan prosesnya. Cara ini tidak memperluas dan menyempitkan klaster, tetapi mungkin mengurangi kapasitas baca Anda untuk sementara.
Ada kemungkinan bahwa mengubah kelas instans replika akan menghasilkan instans yang tidak melayani permintaan untuk jangka waktu singkat, dari beberapa detik hingga kurang dari 30 detik. Jika Anda terhubung ke klaster Anda di [mode set replika](connect-to-replica-set.md) (direkomendasikan), maka ini akan mengurangi kapasitas baca Anda pada satu replika (misalnya, untuk 66% kapasitas dalam klaster 3-node, atau 75% kapasitas dalam klaster 4-node, dll) selama operasi penskalaan.
1. Skalakan salah satu contoh instans di klaster Anda. Untuk informasi selengkapnya, lihat [Mengelola kelas instance](db-instance-classes.md).
1. Tunggu sampai instans tersedia (lihat[Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md)).
**catatan**
Ini akan menimbulkan \$130 detik waktu henti untuk klaster Anda. Silakan buat rencana yang sesuai.
1. Lanjutkan menjalankan langkah 1 dan 2 sampai semua instans replika telah diskalakan, satu per satu.
1. Memulai failover manual. Ini akan mempromosikan salah satu replika menjadi instans utama. Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md).
**catatan**
Tindakan ini akan menyebabkan waktu henti hingga 30 detik untuk klaster Anda, tetapi seringkali membutuhkan waktu lebih singkat. Silakan buat rencana yang sesuai.
1. Skalakan instans primer sebelumnya (sekarang replika).
# Mengkloning volume untuk cluster Amazon DocumentDB
Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat cluster baru yang menggunakan volume cluster Amazon DocumentDB yang sama dan memiliki data yang sama dengan aslinya. Prosesnya dirancang agar cepat dan hemat biaya. Klaster baru dengan volume data terkaitnya dikenal sebagai *Klon*. Membuat klon lebih cepat dan lebih hemat ruang daripada menyalin data secara fisik menggunakan teknik lain, seperti memulihkan snapshot.
Amazon DocumentDB mendukung pembuatan klon yang disediakan Amazon DocumentDB dari klaster Amazon DocumentDB yang disediakan. Saat Anda membuat klon menggunakan konfigurasi penyebaran yang berbeda dari sumbernya, klon dibuat menggunakan versi terbaru dari mesin Amazon DocumentDB sumber.
Saat Anda membuat klon dari kluster Amazon DocumentDB Anda, klon dibuat AWS di akun Anda—akun yang sama yang memiliki cluster Amazon DocumentDB sumber.
**Topics**
+ [Ikhtisar kloning Amazon DocumentDB](#db-cloning-overview)
+ [Keterbatasan kloning Amazon DocumentDB](#db-cloning-limitations)
+ [Cara kerja kloning Amazon DocumentDB](#db-how-db-cloning-works)
+ [Membuat klon Amazon DocumentDB](#db-creating-db-clone)
## Ikhtisar kloning Amazon DocumentDB
Amazon DocumentDB menggunakan protokol untuk *copy-on-write membuat klon*. Mekanisme ini menggunakan ruang tambahan minimal untuk membuat klon awal. Saat klon pertama kali dibuat, Amazon DocumentDB menyimpan satu salinan data yang digunakan oleh cluster DB sumber dan cluster Amazon DocumentDB baru (kloning). Penyimpanan tambahan dialokasikan hanya ketika perubahan dilakukan pada data (pada volume penyimpanan Amazon DocumentDB) oleh cluster Amazon DocumentDB sumber atau klon klon Amazon DocumentDB. Untuk mempelajari lebih lanjut tentang copy-on-write protokol, lihat[Cara kerja kloning Amazon DocumentDB](#db-how-db-cloning-works).
Kloning Amazon DocumentDB sangat berguna untuk menyiapkan lingkungan pengujian dengan cepat menggunakan data produksi Anda, tanpa risiko kerusakan data. Anda dapat menggunakan klon untuk berbagai jenis aplikasi, seperti berikut:
+ Bereksperimen dengan potensi perubahan (misalnya, perubahan skema dan perubahan grup parameter) untuk menilai semua dampak.
+ Menjalankan operasi sarat beban kerja, seperti mengekspor data atau menjalankan kueri analitis.
+ Membuat salinan dari klaster DB produksi Anda untuk pengembangan, pengujian, atau tujuan lainnya.
Anda dapat membuat lebih dari satu klon dari cluster Amazon DocumentDB yang sama. Anda juga dapat membuat beberapa klon dari klon lain.
Setelah membuat klon Amazon DocumentDB, Anda dapat mengonfigurasi instans Amazon DocumentDB secara berbeda dari cluster Amazon DocumentDB sumber. Misalnya, Anda mungkin tidak memerlukan klon untuk tujuan pengembangan agar memenuhi persyaratan ketersediaan tinggi yang sama dengan klaster Amazon DocumentDB produksi sumber. Dalam hal ini, Anda dapat mengonfigurasi klon dengan satu instans Amazon DocumentDB daripada beberapa instans DB yang digunakan oleh cluster Amazon DocumentDB.
Setelah selesai menggunakan klon untuk pengujian, pengembangan, atau tujuan lainnya, Anda dapat menghapusnya.
## Keterbatasan kloning Amazon DocumentDB
Amazon DocumentDB; kloning saat ini memiliki batasan sebagai berikut:
+ Anda dapat membuat klon sebanyak yang Anda inginkan, hingga jumlah maksimum klaster DB yang diizinkan di Wilayah AWS. Namun, setelah Anda membuat 15 klon, klon berikutnya adalah salinan lengkap. Operasi kloning bertindak seperti point-in-time pemulihan.
+ Anda tidak dapat membuat klon di AWS Wilayah yang berbeda dari cluster Amazon DocumentDB sumber.
+ Anda tidak dapat membuat klon dari cluster Amazon DocumentDB yang tidak memiliki instans DB. Anda hanya dapat mengkloning cluster Amazon DocumentDB yang memiliki setidaknya satu instans DB.
+ Anda dapat membuat klon di cloud pribadi virtual (VPC) yang berbeda dari klaster Amazon DocumentDB. Jika Anda melakukannya, subnet VPCs harus dipetakan ke Availability Zones yang sama.
## Cara kerja kloning Amazon DocumentDB
Kloning Amazon DocumentDB bekerja pada lapisan penyimpanan cluster Amazon DocumentDB. Ini menggunakan *copy-on-write*protokol yang cepat dan hemat ruang dalam hal media tahan lama yang mendasarinya yang mendukung volume penyimpanan Amazon DocumentDB. Anda dapat mempelajari lebih lanjut tentang volume klaster Amazon DocumentDB di. [Mengelola cluster Amazon DocumentDB](db-clusters.md)
**Topics**
+ [Memahami copy-on-write protokol](#db-copy-on-write-protocol)
+ [Menghapus volume klaster sumber](#db-deleting-source-cluster-volume)
### Memahami copy-on-write protokol
Cluster Amazon DocumentDB menyimpan data di halaman dalam volume penyimpanan Amazon DocumentDB yang mendasarinya.
Misalnya, dalam diagram berikut Anda dapat menemukan cluster Amazon DocumentDB (A) yang memiliki empat halaman data, 1, 2, 3, dan 4. Bayangkan bahwa klon, B, dibuat dari cluster Amazon DocumentDB. Saat klon dibuat, tidak ada data yang disalin. Sebaliknya, klon menunjuk ke kumpulan halaman yang sama dengan cluster Amazon DocumentDB sumber.
![\[Volume cluster Amazon DocumentDB dengan 4 halaman untuk cluster sumber, A, dan klon, B\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Saat klon dibuat, tidak ada penyimpanan tambahan yang biasanya diperlukan. copy-on-writeProtokol menggunakan segmen yang sama pada media penyimpanan fisik sebagai segmen sumber. Penyimpanan tambahan hanya diperlukan jika kapasitas segmen sumber tidak cukup untuk seluruh segmen klon. Jika demikian, segmen sumber disalin ke perangkat fisik lain.
Dalam diagram berikut, Anda dapat menemukan contoh copy-on-write protokol yang sedang beraksi menggunakan cluster A yang sama dan klonnya, B, seperti yang ditunjukkan sebelumnya. Katakanlah Anda membuat perubahan pada klaster Amazon DocumentDB (A) yang menghasilkan perubahan pada data yang disimpan di halaman 1. Alih-alih menulis ke halaman asli 1, Amazon DocumentDB membuat halaman baru 1 [A]. Volume cluster Amazon DocumentDB untuk cluster (A) sekarang menunjuk ke halaman 1 [A], 2, 3, dan 4, sedangkan klon (B) masih mereferensikan halaman asli.
![\[Volume cluster DB sumber Amazon DocumentDB dan klonnya, keduanya dengan perubahan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
Pada klon, perubahan dibuat pada halaman 4 di volume penyimpanan. Alih-alih menulis ke halaman asli 4, Amazon DocumentDB membuat halaman baru, 4 [B]. Klon sekarang menunjuk ke halaman 1, 2, 3, dan halaman 4[B], sementara klaster (A) terus menunjuk ke 1[A], 2, 3, dan 4.
![\[Volume cluster DB sumber Amazon DocumentDB dan klonnya, keduanya dengan perubahan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
Karena semakin banyak perubahan terjadi dari waktu ke waktu di volume cluster Amazon DocumentDB sumber dan klon, lebih banyak penyimpanan diperlukan untuk menangkap dan menyimpan perubahan.
### Menghapus volume klaster sumber
Saat Anda menghapus volume klaster sumber yang memiliki satu atau beberapa klon yang berkaitan dengannya, klon ini tidak akan terpengaruh. Klon terus menunjuk ke halaman yang sebelumnya dimiliki oleh volume klaster sumber.
## Membuat klon Amazon DocumentDB
Anda dapat membuat klon di AWS akun yang sama dengan cluster Amazon DocumentDB sumber. Untuk melakukannya, Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI dan prosedur berikut.
Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat klon klon Amazon DocumentDB yang disediakan dari klon Amazon DocumentDB yang disediakan.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menjelaskan cara mengkloning cluster Amazon DocumentDB menggunakan. Konsol Manajemen AWS
Membuat klon menggunakan Konsol Manajemen AWS hasil di cluster Amazon DocumentDB dengan satu instance Amazon DocumentDB.
Instruksi ini berlaku untuk cluster DB yang dimiliki oleh AWS akun yang sama yang membuat klon. Cluster DB harus dimiliki oleh AWS akun yang sama karena kloning lintas akun tidak didukung di Amazon DocumentDB.
**Untuk membuat tiruan dari cluster DB yang dimiliki oleh AWS akun Anda menggunakan Konsol Manajemen AWS**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**.
1. **Pilih klaster Amazon DocumentDB Anda dari daftar, dan **untuk** Tindakan, pilih Buat klon.**
![\[Membuat klon dimulai dengan memilih klaster Amazon DocumentDB Anda.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Halaman Create clone terbuka, di mana Anda dapat mengonfigurasi **pengenal Cluster** dan **kelas Instance**, dan opsi lain untuk klon klon Amazon DocumentDB.
1. Di bagian **Pengaturan**, lakukan hal berikut:
1. Untuk **pengidentifikasi Cluster**, masukkan nama yang ingin Anda berikan ke klaster Amazon DocumentDB kloning Anda.
1. Untuk **konfigurasi Instance**, pilih **class Instance** yang sesuai untuk klaster Amazon DocumentDB kloning Anda.
![\[Membuat klon dimulai dengan memilih klaster Amazon DocumentDB Anda dan menentukan ukuran instans DB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Untuk **pengaturan Jaringan**, pilih **grup Subnet** untuk kasus penggunaan Anda dan grup keamanan VPC terkait.
1. Untuk **E ncryption-at-rest**, jika cluster sumber (cluster yang sedang dikloning) mengaktifkan enkripsi, klaster kloning juga harus mengaktifkan enkripsi. Jika skenario ini benar, maka opsi **Enable encryption** berwarna abu-abu (dinonaktifkan) tetapi dengan pilihan **Enable encryption** yang dipilih. Sebaliknya, jika cluster sumber tidak mengaktifkan enkripsi, opsi **Enable encryption** tersedia dan Anda dapat memilih untuk mengaktifkan atau menonaktifkan enkripsi.
![\[Tentukan pengaturan jaringan dan enkripsi untuk klon klon Amazon DocumentDB Anda.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Selesaikan konfigurasi klon cluster baru dengan memilih jenis log yang akan diekspor (opsional), memasukkan port tertentu yang digunakan untuk terhubung ke cluster, dan mengaktifkan perlindungan dari penghapusan cluster secara tidak sengaja (diaktifkan secara default).
![\[Selesaikan konfigurasi klon baru dengan memilih jenis log yang akan diekspor secara opsional, port tertentu yang digunakan untuk terhubung ke cluster, dan formulir perlindungan secara tidak sengaja menghapus cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Selesai memasukkan semua pengaturan untuk klon klon Amazon DocumentDB Anda. Untuk mempelajari selengkapnya tentang setelan cluster dan instans Amazon DocumentDB, lihat. [Mengelola cluster Amazon DocumentDB](db-clusters.md)
1. Pilih **Buat klon untuk meluncurkan klon** Amazon DocumentDB dari klaster Amazon DocumentDB pilihan Anda.
Saat klon dibuat, klon tersebut terdaftar dengan kluster Amazon DocumentDB Anda yang lain di **bagian** Database konsol dan menampilkan statusnya saat ini. Klon Anda siap digunakan ketika statusnya **Tersedia**.
------
#### [ Using the AWS CLI ]
Menggunakan AWS CLI untuk mengkloning cluster Amazon DocumentDB Anda melibatkan beberapa langkah.
`restore-db-cluster-to-point-in-time` AWS CLI Perintah yang Anda gunakan menghasilkan klaster Amazon DocumentDB kosong dengan 0 instance Amazon DocumentDB. Artinya, perintah hanya mengembalikan cluster Amazon DocumentDB, bukan instance DB untuk cluster itu. Anda melakukannya secara terpisah setelah klon tersedia. Dua langkah dalam proses ini adalah sebagai berikut:
1. Buat klon dengan menggunakan perintah [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Parameter yang Anda gunakan dengan perintah ini mengontrol jenis kapasitas dan detail lain dari klaster Amazon DocumentDB kosong (klon) yang sedang dibuat.
1. Buat instance Amazon DocumentDB untuk klon dengan menggunakan perintah [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI untuk membuat ulang instans Amazon DocumentDB di cluster Amazon DocumentDB yang dipulihkan.
Perintah berikut mengasumsikan bahwa AWS CLI diatur dengan AWS Wilayah Anda sebagai default. Dengan pendekatan ini, Anda tidak perlu meneruskan nama `--region` di setiap perintah. Untuk informasi selengkapnya, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Anda juga dapat menentukan `--region` di setiap perintah CLI selanjutnya.
**Topics**
**Membuat klon**
Parameter tertentu yang Anda teruskan ke perintah CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` akan bervariasi. Apa yang Anda lewati tergantung pada jenis klon yang ingin Anda buat.
Gunakan prosedur berikut untuk membuat klon Amazon DocumentDB yang disediakan dari klaster Amazon DocumentDB yang disediakan.
**Untuk membuat tiruan dari mode mesin yang sama dengan sumber cluster Amazon DocumentDB**
+ Gunakan perintah CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` dan tentukan nilai untuk parameter berikut:
+ `--db-cluster-identifier` – Pilih nama yang bermakna untuk klon anda. Anda memberi nama klon saat Anda menggunakan perintah [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI.
+ `--restore-type` – Gunakan `copy-on-write` untuk membuat klon dari klaster DB sumber. Tanpa parameter ini, `restore-db-cluster-to-point-in-time` mengembalikan cluster Amazon DocumentDB daripada membuat klon. Default untuk `restore-type` adalah`full-copy`.
+ `--source-db-cluster-identifier`— Gunakan nama cluster Amazon DocumentDB sumber yang ingin Anda kloning.
+ `--use-latest-restorable-time` – Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon. Parameter ini diperlukan untuk`restore-type copy-on-write`, bagaimanapun, Anda tidak dapat menggunakan `restore-to-time parameter` dengan itu.
Contoh berikut membuat klon bernama `my-clone` dari klaster bernama `my-source-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Untuk Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
Perintah tersebut mengembalikan objek JSON yang berisi rincian dari klon. Periksa untuk memastikan bahwa klaster DB yang Anda kloning tersedia sebelum mencoba membuat instans DB untuk klon Anda. Untuk informasi selengkapnya, lihat Memeriksa status dan mendapatkan detail klon di bawah ini:
**Memeriksa status dan mendapatkan detail klon**
Anda dapat menggunakan perintah berikut untuk memeriksa status klaster DB kosong yang baru dibuat.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Atau Anda dapat memperoleh status dan nilai-nilai lain yang Anda butuhkan untuk membuat instance DB untuk klon Anda dengan menggunakan AWS CLI kueri berikut:
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Untuk Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Kueri ini menghasilkan output yang serupa dengan berikut ini:
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Membuat instance Amazon DocumentDB untuk klon Anda**
Gunakan perintah [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI untuk membuat instance DB untuk klon Anda.
`--db-instance-class`Parameter ini digunakan hanya untuk klaster Amazon DocumentDB yang disediakan.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Untuk Windows:
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Parameter yang akan digunakan untuk kloning**
Tabel berikut merangkum berbagai parameter yang digunakan `restore-db-cluster-to-point-in-time` untuk mengkloning cluster Amazon DocumentDB.
| Parameter | Deskripsi |
| --- | --- |
| --source-db-cluster-identifier | Gunakan nama cluster Amazon DocumentDB sumber yang ingin Anda kloning. |
| --db-cluster-identifier | Gunakan parameter ini untuk memilih nama yang bermakna untuk klon anda. Anda menamai klon Anda dengan perintah ` restore-db-cluster-to-point-in-time`. Kemudian, Anda meneruskan nama ini ke perintah `create-db-instance`. |
| --restore-type | Tentukan `copy-on-write` sebagai `--restore-type` untuk membuat klon dari cluster DB sumber daripada memulihkan sumber Amazon DocumentDB cluster. |
| --use-latest-restorable-time | Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon. |
------
# Memahami toleransi kesalahan klaster Amazon DocumentDB
Klaster Amazon DocumentDB menurut desainnya toleran terhadap kesalahan. Setiap volume klaster mencakup beberapa Availability Zone dalam satu Wilayah AWS, dan setiap Availability Zone berisi salinan data volume cluster. Dengan fungsionalitas ini, klaster Anda dapat menoleransi kegagalan Availability Zone tanpa kehilangan data dan hanya gangguan layanan singkat.
Jika instans utama dalam sebuah klaster gagal, Amazon DocumentDB secara otomatis melakukan failover ke instans utama baru dengan salah satu dari dua cara berikut:
+ Dengan mempromosikan replika Amazon DocumentDB yang ada ke instans utama baru yang dipilih berdasarkan pengaturan Tingkat Promosi dari setiap replika, lalu membuat pengganti untuk instans primer sebelumnya. Failover untuk instans replika biasanya membutuhkan waktu kurang dari 30 detik. Operasi baca dan tulis mungkin mengalami gangguan singkat selama periode ini. Untuk meningkatkan ketersediaan klaster Anda, kami sarankan Anda membuat setidaknya satu replika Amazon DocumentDB atau lebih di dua Availability Zone yang berbeda.
+ Dengan membuat instans primer baru. Ini hanya terjadi jika Anda tidak memiliki instans replika di klaster Anda dan penyelesaiannya dapat memakan waktu beberapa menit.
Jika klaster memiliki satu atau beberapa replika Amazon DocumentDB, replika Amazon DocumentDB akan dipromosikan ke instans primer selama peristiwa kegagalan. Peristiwa failover mengakibatkan interupsi singkat, selama operasi baca dan tulis gagal dengan pengecualian. Namun, layanan biasanya dipulihkan dalam waktu kurang dari 120 detik, dan sering kali kurang dari 60 detik. Untuk meningkatkan ketersediaan klaster Anda, kami sarankan Anda membuat setidaknya satu replika Amazon DocumentDB atau lebih di dua Availability Zone yang berbeda.
Anda dapat membuat urutan tertentu agar replika Amazon DocumentDB Anda dipromosikan ke instans primer setelah kegagalan dengan menetapkan prioritas pada setiap replika. Prioritas berkisar dari 0 untuk prioritas tertinggi hingga 15 untuk prioritas terendah. Jika instans primer gagal, replika Amazon DocumentDB dengan prioritas tertinggi akan dipromosikan ke instans primer baru. Anda dapat mengubah prioritas replika Amazon DocumentDB kapan saja. Memodifikasi prioritas tidak memicu failover. Anda dapat menggunakan operasi `modify-db-instance` dengan parameter `--promotion-tier`. Untuk informasi lebih lanjut tentang menyesuaikan prioritas failover instans, lihat [Failover Amazon DocumentDB](failover.md).
Lebih dari satu replika Amazon DocumentDB dapat berbagi prioritas yang sama, dan menghasilkan tingkat promosi. Jika dua replika Amazon DocumentDB atau lebih berbagi prioritas yang sama, maka replika dengan ukuran terbesar akan dipromosikan menjadi yang primer. Jika dua replika Amazon DocumentDB atau lebih memiliki prioritas dan ukuran yang sama, replika arbitrer di tingkat promosi yang sama akan dipromosikan.
Jika klaster tidak berisi replika Amazon DocumentDB, instans primer akan dibuat ulang selama peristiwa kegagalan. Peristiwa failover mengakibatkan gangguan di mana selama operasi baca dan tulis gagal dengan pengecualian. Layanan dipulihkan ketika instans primer baru dibuat, yang biasanya memakan waktu kurang dari 10 menit. Mempromosikan replika Amazon DocumentDB ke instans utama jauh lebih cepat daripada membuat instans utama baru.