Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola cluster elastis Amazon DocumentDB
Untuk mengelola cluster elastis Amazon DocumentDB, Anda harus memiliki kebijakan IAM dengan izin bidang kontrol Amazon DocumentDB yang sesuai. Izin ini memungkinkan Anda untuk membuat, memodifikasi, dan menghapus cluster. Kebijakan DBFull Akses Dokumen Amazon menyediakan semua izin yang diperlukan untuk mengelola klaster elastis Amazon DocumentDB.
Topik berikut menunjukkan cara melakukan berbagai tugas saat bekerja dengan cluster elastis Amazon DocumentDB.
**Topics**
+ [Memodifikasi konfigurasi cluster elastis](#elastic-modify)
+ [Memantau cluster elastis](#elastic-monitor)
+ [Menghapus cluster elastis](#elastic-delete)
+ [Mengelola snapshot cluster elastis](elastic-manage-snapshots.md)
+ [Menghentikan dan memulai cluster elastis Amazon DocumentDB](elastic-cluster-stop-start.md)
+ [Mempertahankan cluster elastis Amazon DocumentDB](elastic-cluster-maintenance.md)
## Memodifikasi konfigurasi cluster elastis
Pada bagian ini kami menjelaskan cara memodifikasi cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
Penggunaan utama memodifikasi cluster adalah untuk menskalakan pecahan dengan meningkatkan atau mengurangi kapasitas komputasi shard count shard. and/or
------
#### [ Using the Konsol Manajemen AWS ]
Untuk memodifikasi konfigurasi cluster elastis menggunakan Konsol Manajemen AWS:
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Pada panel navigasi, silakan pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih nama cluster yang ingin Anda ubah di kolom **pengenal Cluster**.
1. Pilih **Ubah**.
1. Edit bidang yang ingin diubah lalu pilih **Modify cluster**.
![\[Formulir yang menampilkan opsi konfigurasi, pemeliharaan, otentikasi, dan pengaturan jaringan yang dapat dimodifikasi, dengan tombol Modify cluster di sudut kanan bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**catatan**
Atau, Anda dapat mengakses dialog **Modify cluster** dengan membuka halaman **Clusters**, mencentang kotak di sebelah cluster Anda, memilih **Actions**, lalu **Modify**.
------
#### [ Using the AWS CLI ]
Untuk memodifikasi konfigurasi cluster elastis menggunakan AWS CLI, gunakan `update-cluster` operasi dengan parameter berikut:
+ **--cluster-arn**—Wajib. Pengidentifikasi ARN dari cluster yang ingin Anda modifikasi.
+ **--shard-capacity**—Opsional. Jumlah v yang CPUs ditetapkan untuk setiap pecahan. Maksimal adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.
+ **--shard-count**—Opsional. Jumlah pecahan yang ditugaskan ke cluster. Maksimal 32.
+ **--shard-instance**-Hitung—opsional. Jumlah contoh replika yang diterapkan ke semua pecahan di cluster ini. Maksimal adalah 16.
+ **--auth-type**—Opsional. Jenis otentikasi yang digunakan untuk menentukan di mana untuk mengambil password yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah `PLAIN_TEXT` atau`SECRET_ARN`.
+ **--admin-user-password**—Opsional. Kata sandi yang terkait dengan pengguna admin.
+ **--vpc-security-group-ids**—Opsional. Konfigurasikan daftar grup keamanan Amazon EC2 dan Amazon Virtual Private Cloud (VPC) untuk diasosiasikan dengan klaster ini.
+ **--preferred-maintenance-window**—Opsional. Konfigurasikan rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, di Universal Coordinated Time (UTC)
Formatnya adalah:`ddd:hh24:mi-ddd:hh24:mi`. Hari yang berlaku (ddd): Senin, Sel, Rabu, Kam, Jum, Sabtu, Minggu
Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk setiap Wilayah Amazon Web Services, yang terjadi pada hari acak dalam seminggu.
Jendela minimal 30 menit.
+ **--subnet-ids**—Opsional. Konfigurasikan ID subnet jaringan.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic update-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--shard-capacity 8 \
--shard-count 4 \
--shard-instance-count 3 \
--admin-user-password testPassword \
--vpc-security-group-ids ec-65f40350 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Untuk Windows:
```
aws docdb-elastic update-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--shard-capacity 8 ^
--shard-count 4 ^
--shard-instance-count 3 ^
--admin-user-password testPassword ^
--vpc-security-group-ids ec-65f40350 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
Untuk memantau status cluster elastis setelah modifikasi Anda, lihat Memantau cluster elastis.
## Memantau cluster elastis
Pada bagian ini, kami menjelaskan cara memantau cluster elastis Anda, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk memantau konfigurasi cluster elastis menggunakan Konsol Manajemen AWS:
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Pada panel navigasi, silakan pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih nama cluster yang ingin Anda pantau di kolom **pengenal Cluster**.
1. Pilih tab **Pemantauan**.
![\[Informasi ringkasan cluster elastis ditampilkan di tab Monitoring.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Sejumlah grafik dari Amazon CloudWatch ditampilkan untuk kategori pemantauan berikut:
+ Pemanfaatan Sumber Daya
+ Throughput
+ Operasi
+ Sistem
Anda juga dapat mengakses Amazon CloudWatch melalui Konsol Manajemen AWS untuk mengatur lingkungan pemantauan Anda sendiri untuk cluster elastis Anda.
------
#### [ Using the AWS CLI ]
Untuk memantau konfigurasi cluster elastis tertentu menggunakan AWS CLI, gunakan `get-cluster` operasi dengan parameter berikut:
+ **--cluster-arn**—Wajib. Pengidentifikasi ARN dari cluster yang Anda inginkan informasinya.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic get-cluster \
--cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Untuk Windows:
```
aws docdb-elastic get-cluster ^
--cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Output dari operasi ini terlihat seperti berikut:
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Untuk informasi selengkapnya, lihat `DescribeClusterSnapshot` di Referensi API Manajemen Sumber Daya Amazon DocumentDB.
Untuk melihat rincian semua cluster elastis menggunakan AWS CLI, gunakan `list-clusters` operasi dengan parameter berikut:
+ **--next-token**—Opsional. Jika jumlah item output (`--max-results`) lebih sedikit dari jumlah total item yang dikembalikan oleh panggilan API yang mendasarinya, output akan menyertakan perintah `NextToken` yang dapat Anda teruskan ke perintah berikutnya untuk mengambil set item berikutnya.
+ **--max-results**—Opsional. Jumlah total item yang akan dikembalikan dalam output perintah. Jika lebih banyak hasil yang ada daripada `max-results` nilai yang ditentukan, token pagination (`next-token`) disertakan dalam respons sehingga hasil yang tersisa dapat diambil.
+ Default: 100
+ Minimum 20, maksimum 100
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic list-clusters \
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
--max-results 2
```
Untuk Windows:
```
aws docdb-elastic list-clusters ^
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
--max-results 2
```
Output dari operasi ini terlihat seperti berikut:
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Menghapus cluster elastis
Pada bagian ini kami menjelaskan cara menghapus cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk menghapus konfigurasi cluster elastis menggunakan Konsol Manajemen AWS:
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Pada panel navigasi, silakan pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Dalam tabel daftar cluster, pilih kotak centang di sebelah kiri nama cluster yang ingin Anda hapus lalu pilih **Tindakan**. Dari menu pilihan menurun, pilih **Hapus**.
1. Di cluster **elastis Delete “cluster-name”?** kotak dialog, pilih **Hapus**.
![\[Hapus kotak dialog, dengan tombol Delete di sudut kanan bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau Status Cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Untuk menghapus cluster elastis menggunakan AWS CLI, gunakan `delete-cluster` operasi dengan parameter berikut:
+ **--cluster-arn**—Wajib. Pengidentifikasi ARN dari cluster yang ingin Anda hapus.
+ **--no-skip-final-backup**—Opsional. Jika Anda menginginkan cadangan akhir, Anda harus menyertakan parameter ini dengan nama untuk cadangan akhir. Anda harus menyertakan `--final-backup-identifier` atau `--skip-final-backup`.
+ **--skip-final-backup**—Opsional. Gunakan parameter ini hanya jika Anda tidak ingin mengambil cadangan akhir sebelum menghapus klaster Anda. Pengaturan default adalah untuk mengambil snapshot akhir.
Contoh AWS CLI kode berikut menghapus cluster dengan ARN arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster dengan cadangan akhir.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri..
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Untuk Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Contoh AWS CLI kode berikut menghapus cluster dengan ARN arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster tanpa mengambil cadangan akhir.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--skip-final-backup \
```
Untuk Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--skip-final-backup ^
```
Output dari `delete-cluster` operasi adalah tampilan cluster yang Anda hapus.
Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau Status Cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
# Mengelola snapshot cluster elastis
Snapshot manual dapat diambil setelah cluster elastis dibuat. Pencadangan otomatis dibuat saat snapshot cluster elastis dibuat.
**catatan**
Cluster elastis Anda harus dalam `Available` keadaan agar snapshot manual diambil.
Bagian ini menjelaskan bagaimana Anda dapat membuat, melihat, memulihkan dari, dan menghapus snapshot cluster elastis.
Topik berikut menunjukkan cara melakukan berbagai tugas saat bekerja dengan snapshot cluster elastis Amazon DocumentDB.
**Topics**
+ [Membuat snapshot cluster elastis manual](#elastic-create-snapshot)
+ [Melihat snapshot cluster elastis](#elastic-view-snapshot)
+ [Memulihkan cluster elastis dari snapshot](#elastic-restore-snapshot)
+ [Menyalin snapshot cluster elastis](#elastic-copy-snapshot)
+ [Menghapus snapshot cluster elastis](#elastic-delete-snapshot)
+ [Mengelola cadangan otomatis snapshot cluster elastis](#elastic-auto-snapshot)
## Membuat snapshot cluster elastis manual
Pada bagian ini kami menjelaskan cara membuat snapshot cluster elastis manual, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membuat snapshot cluster elastis manual menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pada halaman **Snapshot**, pilih **Buat**.
1. Pada halaman **Create cluster snapshot**, di bidang **Cluster identifier**, pilih cluster elastis Anda dari daftar drop-down.
Di bidang **pengenal Snapshot**, masukkan pengenal unik untuk cluster elastis Anda.
Pilih **Buat**.
![\[Diagram: cluster elastis membuat snapshot\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**catatan**
Atau, Anda dapat mengakses dialog **Buat snapshot cluster** dengan membuka halaman **Clusters**, mencentang kotak di sebelah cluster Anda, lalu memilih **Tindakan**, lalu **Ambil** snapshot.
Snapshot cluster elastis Anda sekarang sedang disediakan. Ini bisa memakan waktu hingga beberapa menit untuk menyelesaikannya. Anda dapat melihat dan memulihkan dari snapshot Anda ketika status ditampilkan seperti `Available` dalam daftar **Snapshots**.
------
#### [ Using the AWS CLI ]
Untuk membuat snapshot cluster elastis manual menggunakan AWS CLI, gunakan `create-cluster-snapshot` operasi dengan parameter berikut:
+ **--snapshot-name**—Wajib. Nama snapshot cluster yang ingin Anda buat.
+ **--cluster-arn**—Wajib. Pengidentifikasi ARN dari cluster yang ingin Anda buat snapshot.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Untuk Windows:
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## Melihat snapshot cluster elastis
Pada bagian ini kami menjelaskan cara melihat informasi snapshot cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk melihat informasi tentang snapshot cluster elastis tertentu menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pada halaman **Snapshots**, pilih snapshot Anda dari daftar dengan mengklik nama di kolom pengenal **Snapshot**.
1. Lihat informasi snapshot Anda di **Detail**.
![\[Diagram: snapshot tampilan cluster elastis\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
Untuk melihat informasi tentang snapshot cluster elastis tertentu menggunakan AWS CLI, gunakan `get-cluster-snapshot` operasi dengan parameter berikut:
+ **--snapshot-arn**—Wajib. Pengidentifikasi ARN dari snapshot yang Anda inginkan informasinya.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Untuk Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Untuk melihat informasi tentang snapshot cluster elastis tertentu menggunakan AWS CLI, gunakan `get-cluster-snapshot` operasi dengan parameter berikut:
+ **--snapshot-arn**—Wajib. Pengidentifikasi ARN dari snapshot yang Anda inginkan informasinya.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Untuk Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Untuk melihat informasi tentang semua snapshot cluster elastis menggunakan AWS CLI, gunakan `list-cluster-snapshots` operasi dengan parameter berikut:
+ **--snapshot-type**—Opsional. Jenis snapshot klaster untuk dikembalikan. Anda dapat menentukan salah satu nilai berikut:
+ `automated`- Kembalikan semua snapshot cluster yang Amazon DocumentDB telah secara otomatis dibuat untuk akun Anda. AWS
+ `manual`- Kembalikan semua snapshot cluster yang telah Anda buat secara manual untuk AWS akun Anda.
+ `shared`- Kembalikan semua snapshot cluster manual yang telah dibagikan ke AWS akun Anda.
+ `public` - Mengembalikan semua snapshot klaster yang telah ditandai sebagai publik.
+ **--next-token**—Opsional. Token pagination opsional yang disediakan oleh permintaan sebelumnya. Jika parameter ini ditentukan, respons hanya mencakup catatan di luar token ini, hingga nilai yang ditentukan oleh`max-results`.
+ **--max-results**—Opsional. Jumlah maksimum hasil untuk dimasukkan dalam respons. Jika lebih banyak hasil yang ada daripada `max-results` nilai yang ditentukan, token pagination (`next-token`) disertakan dalam respons sehingga hasil yang tersisa dapat diambil.
+ Default: 100
+ Minimum 20, maksimum 100
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
Untuk Windows:
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## Memulihkan cluster elastis dari snapshot
Pada bagian ini kami menjelaskan cara mengembalikan cluster elastis dari snapshot, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk mengembalikan cluster elastis dari snapshot menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih tombol di sebelah kiri snapshot, yang ingin Anda gunakan untuk memulihkan cluster, di kolom **pengenal Snapshot**.
1. Pilih **Tindakan**, lalu **Pulihkan**.
![\[Diagram: pemulihan cluster elastis dari snapshot\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. Pada halaman **Restore snapshot**, masukkan nama untuk cluster baru di kolom **Cluster identifier**.
**catatan**
Untuk restorasi snapshot manual, Anda harus membuat cluster baru.
1. Di bidang **Virtual Private Cloud (VPC)**, pilih VPC dari daftar drop-down.
1. Untuk grup **keamanan **Subnet** dan VPC**, Anda dapat menggunakan default atau memilih tiga subnet pilihan Anda dan hingga tiga grup keamanan VPC (minimal satu).
1. Jika Anda puas dengan konfigurasi klaster, pilih **Pulihkan klaster** dan tunggu sementara klaster Anda dipulihkan.
------
#### [ Using the AWS CLI ]
Untuk mengembalikan cluster elastis dari snapshot menggunakan AWS CLI, gunakan `restore-cluster-from-snapshot` operasi dengan parameter berikut:
+ **--cluster-name**—Wajib. Nama cluster elastis saat ini seperti yang dimasukkan selama pembuatan atau terakhir dimodifikasi.
+ **--snapshot-arn**—Wajib. Pengidentifikasi ARN dari snapshot yang digunakan untuk memulihkan cluster.
+ **--vpc-security-group-ids**—Opsional. Satu atau beberapa grup keamanan Amazon EC2 dan Amazon Virtual Private Cloud (VPC) untuk diasosiasikan dengan cluster.
+ **--kms-key-id**—Opsional. Konfigurasikan pengidentifikasi kunci KMS untuk cluster terenkripsi.
Pengidentifikasi kunci KMS adalah Amazon Resource Name (ARN) untuk kunci enkripsi. AWS KMS Jika Anda membuat cluster menggunakan akun Amazon Web Services yang sama yang memiliki kunci enkripsi KMS yang digunakan untuk mengenkripsi cluster baru, Anda dapat menggunakan alias kunci KMS alih-alih ARN untuk kunci enkripsi KMS.
Jika kunci enkripsi tidak ditentukan KmsKeyId dan jika `StorageEncrypted` parameternya benar, Amazon DocumentDB menggunakan kunci enkripsi default Anda.
+ **--subnet-ids**—Opsional. Id subnet jaringan.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri..
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Untuk Windows:
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## Menyalin snapshot cluster elastis
Di Amazon DocumentDB, Anda dapat menyalin snapshot cluster elastis manual dan otomatis dalam wilayah yang sama dan dalam akun yang sama. Pada bagian ini kami menjelaskan cara menyalin snapshot cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk menyalin snapshot cluster elastis menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih tombol di sebelah kiri snapshot, yang ingin Anda salin, di kolom **pengenal Snapshot**.
1. Pilih **Tindakan**, lalu **Salin**.
![\[Diagram: snapshot salinan cluster elastis\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. Untuk **pengenal snapshot baru**, masukkan nama snapshot baru.
1. Untuk **Copy Tags**, centang kotak jika Anda ingin menyalin semua tag dari snapshot cluster elastis sumber ke snapshot cluster elastis target.
1. Untuk **Enkripsi**, pilih kunci AWS KMS default atau kunci KMS yang Anda pilih. Opsi kedua memungkinkan Anda untuk memilih kunci KMS yang sudah Anda buat atau memungkinkan Anda membuat yang baru.
1. Pilih **Salin snapshot** saat selesai.
------
#### [ Using the AWS CLI ]
Untuk menyalin snapshot cluster elastis menggunakan AWS CLI, gunakan `copy-cluster-snapshot` operasi dengan parameter berikut:
+ **‐‐source-db-cluster-snapshot-identifier**—Wajib. Pengidentifikasi snapshot cluster elastis yang ada sedang disalin. Snapshot cluster elastis harus ada dan berada dalam keadaan tersedia. Parameter ini tidak peka huruf besar kecil.
+ **‐‐target-db-cluster-snapshot-identifier**—Wajib. Pengidentifikasi snapshot cluster elastis baru untuk dibuat dari snapshot cluster yang ada. Parameter ini tidak peka huruf besar kecil.
Kendala nama snapshot target:
+ Tidak dapat berupa nama snapshot yang sudah ada.
+ 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.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
Untuk Windows:
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## Menghapus snapshot cluster elastis
Pada bagian ini kami menjelaskan cara menghapus snapshot cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk mengembalikan cluster elastis dari snapshot menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Di panel navigasi, pilih **Snapshot**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih tombol di sebelah kiri snapshot, yang ingin Anda gunakan untuk memulihkan cluster, di kolom **pengenal Snapshot**.
1. Pilih **Actions** (Tindakan), lalu **Delete** (Hapus).
![\[Diagram: snapshot hapus cluster elastis\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. **Pada dialog **Hapus snapshot “snapshot-name”, pilih** Hapus.**
------
#### [ Using the AWS CLI ]
Untuk menghapus snapshot cluster elastis menggunakan AWS CLI, gunakan `delete-cluster-snapshot` operasi dengan parameter berikut:
+ **--snapshot-arn**—Wajib. Pengidentifikasi ARN dari snapshot yang digunakan untuk memulihkan cluster.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri..
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Untuk Windows:
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## Mengelola cadangan otomatis snapshot cluster elastis
Amazon DocumentDB mengambil snapshot harian dari cluster elastis Anda. Anda dapat menentukan jendela cadangan pilihan dan periode retensi cadangan dalam konfigurasi snapshot cluster elastis baru atau yang sudah ada. Pada bagian ini kami menjelaskan cara mengatur parameter cadangan otomatis dalam snapshot cluster elastis, menggunakan Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk mengatur cadangan otomatis untuk snapshot cluster elastis baru menggunakan: Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.
1. Pada panel navigasi, silakan pilih **Klaster**.
**Tip**
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.
1. Pilih tombol di sebelah kiri cluster, yang ingin Anda ubah pengaturan cadangan, di kolom **pengenal Cluster**.
1. Pilih **Tindakan**, lalu **Ubah**.
1. Di bagian **Backup**, edit bidang sesuai dengan kebutuhan cadangan Anda.
![\[Cuplikan layar dari panel Backup menampilkan langkah-langkah untuk mengkonfigurasi jendela backup klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-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. Pilih **Pilih jendela** jika Anda ingin mengonfigurasi waktu dan durasi saat cadangan dibuat.
**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.
**Durasi**—Dalam daftar, pilih jumlah jam yang akan dialokasikan untuk membuat cadangan otomatis.
1. Pilih **Tidak ada preferensi** jika Anda ingin Amazon DocumentDB memilih waktu dan durasi saat backup dibuat.
1. Pilih **Modify cluster** saat selesai.
------
#### [ Using the AWS CLI ]
Untuk mengatur cadangan otomatis untuk snapshot cluster elastis baru menggunakan AWS CLI, gunakan `create-cluster-snapshot` operasi dengan parameter berikut:
+ **--preferred-backup-window**—Opsional. Rentang waktu harian yang disukai selama pencadangan otomatis dibuat. Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing. Wilayah AWS
Batas:
+ Harus dalam format `hh24:mi-hh24:mi`.
+ Harus dalam Waktu Universal Terkoordinasi (UTC).
+ Tidak boleh bertentangan dengan jendela pemeliharaan yang diinginkan.
+ Harus setidaknya 30 menit.
+ **--backup-retention-period**—Opsional. Jumlah hari cadangan otomatis dipertahankan. Nilai default adalah 1.
Batas:
+ Harus menentukan nilai minimum 1.
+ Rentang adalah dari 1 hingga 35.
**catatan**
Pencadangan otomatis hanya dilakukan saat klaster berada dalam keadaan 'aktif'.
**catatan**
Anda juga dapat memodifikasi `preferred-backup-window` dan `backup-retention-period` parameter cluster elastis yang ada menggunakan `aws docdb-elastic update-cluster` perintah.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
`create-cluster`Contoh berikut membuat *sample-cluster* cluster elastis Amazon DocumentDB dengan periode retensi untuk pencadangan otomatis hari, dan jendela *7* pencadangan pilihan. *18:00-18:30 UTC*
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
Untuk Windows:
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# Menghentikan dan memulai cluster elastis Amazon DocumentDB
Menghentikan dan memulai cluster elastis Amazon DocumentDB dapat membantu Anda mengelola biaya untuk lingkungan pengembangan dan pengujian. Alih-alih membuat dan menghapus cluster elastis setiap kali Anda menggunakan Amazon DocumentDB, Anda dapat menghentikan sementara klaster Anda saat tidak diperlukan. Anda kemudian dapat memulainya lagi ketika Anda melanjutkan pengujian Anda.
**Topics**
+ [Ikhtisar menghentikan dan memulai cluster elastis](#elastic-cluster-stop-start-overview)
+ [Operasi yang dapat Anda lakukan pada cluster elastis yang berhenti](#elastic-cluster-stopped-operations)
## Ikhtisar menghentikan dan memulai cluster elastis
Selama periode di mana Anda tidak memerlukan cluster elastis Amazon DocumentDB, Anda dapat menghentikan klaster. Anda lalu dapat memulai klaster lagi kapan saja Anda memerlukannya. Memulai dan menghentikan menyederhanakan proses penyiapan dan pembongkaran untuk cluster elastis yang digunakan untuk pengembangan, pengujian, atau aktivitas serupa yang tidak memerlukan ketersediaan berkelanjutan. Anda dapat berhenti dan memulai cluster elastis menggunakan Konsol Manajemen AWS atau AWS CLI dengan satu tindakan.
Sementara cluster elastis Anda dihentikan, volume penyimpanan cluster tetap tidak berubah. Anda hanya dikenakan biaya untuk penyimpanan, snapshot manual, dan penyimpanan cadangan otomatis dalam jendela penyimpanan yang Anda tentukan. Amazon DocumentDB secara otomatis memulai cluster elastis Anda setelah tujuh hari sehingga tidak ketinggalan pembaruan pemeliharaan yang diperlukan. Ketika cluster Anda dimulai setelah tujuh hari, Anda akan mulai dikenakan biaya untuk penggunaan cluster elastis lagi. Saat klaster dihentikan, Anda tidak dapat melakukan kueri volume penyimpanan karena kueri mengharuskan klaster dalam status tersedia.
Ketika cluster elastis Amazon DocumentDB dihentikan, cluster tidak dapat dimodifikasi dengan cara apa pun. Ini termasuk menghapus cluster.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menunjukkan kepada Anda cara menghentikan gugus elastis dalam keadaan tersedia, atau memulai gugus elastis yang berhenti.
**Untuk menghentikan atau memulai cluster elastis 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.
![\[Sebuah cluster dari daftar Clusters, dengan kotak centang yang dipilih di sebelah kiri nama cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-list-ec.png)
1. Pilih **Tindakan**, lalu pilih tindakan yang ingin Anda lakukan pada klaster.
+ Jika Anda ingin menghentikan klaster dan klaster tersedia:
1. Pilih **Berhenti**.
![\[Daftar dropdown Actions dengan opsi Stop yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-stop.png)
1. Pada dialog konfirmasi, konfirmasikan bahwa Anda ingin menghentikan cluster elastis dengan memilih **Stop cluster**, atau untuk menjaga klaster tetap berjalan, pilih **Batal**.
![\[Dialog konfirmasi untuk menghentikan cluster, dengan tombol Cancel dan Stop cluster di bagian bawah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ Jika Anda ingin memulai klaster, dan klaster berhenti, pilih **Mulai**.
![\[Daftar dropdown Tindakan dengan opsi Mulai dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-start.png)
1. Pantau status cluster elastis. Jika Anda memulai cluster, Anda dapat melanjutkan menggunakan cluster saat cluster *tersedia*. Untuk informasi selengkapnya, lihat [Menentukan status klaster](db-cluster-status.md).
![\[Kolom status di tabel Clusters yang menunjukkan status yang tersedia dan awal.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
Contoh kode berikut menunjukkan cara menghentikan gugus elastis dalam keadaan aktif atau tersedia, atau memulai gugus elastis yang berhenti.
Untuk menghentikan cluster elastis menggunakan AWS CLI, gunakan `stop-cluster` operasi. Untuk memulai klaster yang telah dihentikan, gunakan operasi `start-cluster`. Kedua operasi menggunakan parameter `--cluster-arn`.
**Parameter:**
+ **--cluster-arn**—Diperlukan. Pengidentifikasi ARN dari cluster elastis yang ingin Anda hentikan atau mulai.
**Example — Untuk menghentikan cluster elastis menggunakan AWS CLI**
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Kode berikut menghentikan cluster elastis dengan ARN dari. `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`
Cluster elastis harus dalam keadaan aktif atau tersedia.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Untuk Windows:
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — Untuk memulai cluster elastis menggunakan AWS CLI**
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Kode berikut memulai cluster elastis dengan ARN dari. `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`
Cluster elastis saat ini harus dihentikan.
Untuk Linux, macOS, atau Unix:
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Untuk Windows:
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## Operasi yang dapat Anda lakukan pada cluster elastis yang berhenti
Anda tidak dapat mengubah konfigurasi klaster elastis Amazon DocumentDB saat cluster dihentikan. Anda harus memulai klaster sebelum melakukan tindakan administratif tersebut.
Amazon DocumentDB menerapkan pemeliharaan terjadwal apa pun ke cluster elastis Anda yang berhenti hanya setelah dimulai lagi. Setelah tujuh hari, Amazon DocumentDB secara otomatis memulai cluster elastis yang berhenti sehingga tidak tertinggal terlalu jauh dalam status pemeliharaannya. Saat cluster elastis dimulai ulang, Anda akan mulai dikenakan biaya untuk pecahan di cluster lagi.
Sementara cluster elastis dihentikan, Amazon DocumentDB tidak melakukan pencadangan otomatis apa pun juga tidak memperpanjang periode retensi cadangan.
# Mempertahankan cluster elastis Amazon DocumentDB
**Topics**
+ [Melihat tindakan pemeliharaan klaster elastis yang tertunda](#view-elastic-cluster-maintenance)
+ [Pembaruan mesin cluster elastis](#elastic-cluster-engine-updates)
+ [Pembaruan sistem operasi cluster elastis](#elastic-cluster-os-updates)
Secara berkala, Amazon DocumentDB melakukan pemeliharaan pada sumber daya cluster elastis Amazon DocumentDB. Pemeliharaan paling sering melibatkan pembaruan ke mesin database (pemeliharaan cluster elastis) atau sistem operasi dasar cluster elastis (pembaruan OS). Pembaruan mesin database adalah tambalan yang diperlukan dan mencakup perbaikan keamanan, perbaikan bug, dan penyempurnaan pada mesin database. Meskipun sebagian besar tambalan sistem operasi bersifat opsional, jika Anda tidak menerapkannya untuk sementara waktu, tambalan mungkin diperlukan dan diterapkan secara otomatis untuk menjaga postur keamanan Anda. Jadi, kami menyarankan Anda menerapkan pembaruan sistem operasi ke cluster elastis Amazon DocumentDB Anda segera setelah tersedia.
Tambalan mesin database mengharuskan Anda membuat cluster elastis Amazon DocumentDB offline untuk waktu yang singkat. Setelah tersedia, tambalan ini secara otomatis dijadwalkan untuk diterapkan selama jendela pemeliharaan terjadwal yang akan datang dari cluster elastis Amazon DocumentDB Anda.
Cluster elastis memiliki jendela perawatan masing-masing. Modifikasi cluster elastis yang telah Anda pilih untuk tidak segera diterapkan, diterapkan selama jendela pemeliharaan. Secara default, saat Anda membuat cluster elastis, Amazon DocumentDB menetapkan jendela pemeliharaan untuk cluster elastis Anda. Anda dapat memilih jendela pemeliharaan saat membuat cluster elastis. Anda juga dapat mengubah jendela pemeliharaan kapan saja agar sesuai dengan jadwal atau praktik bisnis Anda. Umumnya disarankan untuk memilih jendela pemeliharaan yang meminimalkan dampak pemeliharaan pada aplikasi Anda (misalnya, pada malam hari atau akhir pekan).
## Melihat tindakan pemeliharaan klaster elastis yang tertunda
Anda dapat melihat apakah pembaruan pemeliharaan tersedia untuk cluster elastis Anda dengan menggunakan AWS CLI.
Jika pembaruan tersedia, Anda dapat melakukan salah satu hal berikut:
+ Tunda tindakan pemeliharaan yang saat ini dijadwalkan untuk jendela pemeliharaan berikutnya (hanya untuk patch OS).
+ Terapkan tindakan pemeliharaan segera.
+ Jadwalkan tindakan pemeliharaan untuk dimulai selama periode pemeliharaan berikutnya.
+ Jadwalkan tindakan pemeliharaan untuk memulai selama jendela penerapan yang Anda pilih.
Jendela pemeliharaan menentukan kapan operasi yang tertunda dimulai, tetapi tidak membatasi total waktu pelaksanaan operasi ini.
Gunakan AWS CLI operasi berikut untuk menentukan tindakan pemeliharaan apa yang tertunda. Daftar semua tindakan pemeliharaan yang tertunda:
```
aws docdb-elastic list-pending-maintenance-actions
```
Output dari operasi ini terlihat seperti berikut (format JSON):
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
Dapatkan tindakan pemeliharaan yang tertunda (jika ada) pada yang diberikan`resourceArn`:
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
Parameter:
+ `ResourceArn`—Nama Sumber Daya Amazon DocumentDB Amazon (ARN) dari sumber daya tempat tindakan pemeliharaan tertunda berlaku.
+ `Action`—Tindakan pemeliharaan yang tertunda diterapkan ke sumber daya.
Nilai valid:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`—Jendela pemeliharaan pertama setelah tanggal ini. `NEXT_MAINTENANCE OPT_IN`diabaikan dalam kasus ini.
+ `ForcedApplyDate`—Diterapkan terlepas dari jendela pemeliharaan. `IMMEDIATE OPT_IN`diabaikan dalam kasus ini.
+ `OptInStatus`—Nilai yang menentukan jenis permintaan keikutsertaan, atau membatalkan permintaan keikutsertaan. Permintaan keikutsertaan tipe `IMMEDIATE` tidak dapat diurungkan.
Nilai valid:
+ `IMMEDIATE`—Terapkan tindakan pemeliharaan segera.
+ `NEXT_MAINTENANCE`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya untuk sumber daya.
+ `APPLY_ON`—Terapkan tindakan pemeliharaan pada tanggal penerapan yang ditentukan terlepas dari jendela pemeliharaan berikutnya untuk sumber daya.
+ `UNDO_OPT_IN`—Batalkan permintaan yang ada `NEXT_MAINTENANCE` atau `APPLY_ON` ikut serta.
+ `CurrentApplyDate`—Ditampilkan jika opt-in-type ada`APPLY_ON`.
+ `Description`—Deskripsi opsi untuk tindakan pemeliharaan.
## Pembaruan mesin cluster elastis
Dengan Amazon DocumentDB, Anda dapat memilih kapan menerapkan operasi pemeliharaan. Anda dapat memutuskan kapan Amazon DocumentDB menerapkan pembaruan menggunakan. AWS CLI
Terapkan tindakan pemeliharaan yang tertunda:
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
Parameter:
+ **--resource-arn**—Nama Sumber Daya Amazon DocumentDB Amazon (ARN) dari sumber daya tempat tindakan pemeliharaan tertunda berlaku.
+ **--apply-action**—Tindakan pemeliharaan yang tertunda untuk diterapkan ke sumber daya ini.
Nilai valid:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--opt-in-type**—Nilai yang menentukan jenis permintaan keikutsertaan, atau membatalkan permintaan keikutsertaan. Permintaan keikutsertaan tipe `IMMEDIATE` tidak dapat diurungkan.
Nilai valid:
+ `IMMEDIATE`—Terapkan tindakan pemeliharaan segera.
+ `NEXT_MAINTENANCE`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya untuk sumber daya.
+ `APPLY_ON`—Terapkan tindakan pemeliharaan pada tanggal penerapan yang ditentukan terlepas dari jendela pemeliharaan berikutnya untuk sumber daya.
+ `UNDO_OPT_IN`—Batalkan permintaan yang ada `NEXT_MAINTENANCE` atau `APPLY_ON` ikut serta.
+ **[--apply-on]**—Diperlukan jika opt-in-type ada`APPLY_ON`. Format: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Opsi ini menggunakan waktu UTC. Waktu mulai bisa kapan saja di masa depan dari minimal 30 menit dan maksimal 14 hari, atau force/apply tanggal tindakan tertunda, mana yang lebih awal. Jendela waktu mulai hingga akhir bisa minimal 30 menit hingga maksimal 8 jam.)
Output dari operasi ini terlihat seperti berikut (format JSON):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
Parameter:
+ `ResourceArn`—Nama Sumber Daya Amazon DocumentDB Amazon (ARN) dari sumber daya tempat tindakan pemeliharaan tertunda berlaku.
+ `Action`—Tindakan pemeliharaan yang tertunda diterapkan ke sumber daya.
Nilai valid:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`—Jendela pemeliharaan pertama setelah tanggal ini. `NEXT_MAINTENANCE OPT_IN`diabaikan dalam kasus ini.
+ `ForcedApplyDate`—Diterapkan terlepas dari jendela pemeliharaan. `IMMEDIATE OPT_IN`diabaikan dalam kasus ini.
+ `OptInStatus`—Nilai yang menentukan jenis permintaan keikutsertaan, atau membatalkan permintaan keikutsertaan. Permintaan keikutsertaan tipe `IMMEDIATE` tidak dapat diurungkan.
Nilai valid:
+ `IMMEDIATE`—Terapkan tindakan pemeliharaan segera.
+ `NEXT_MAINTENANCE`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya untuk sumber daya.
+ `APPLY_ON`—Terapkan tindakan pemeliharaan pada tanggal penerapan yang ditentukan terlepas dari jendela pemeliharaan berikutnya untuk sumber daya.
+ `UNDO_OPT_IN`—Batalkan permintaan yang ada `NEXT_MAINTENANCE` atau `APPLY_ON` ikut serta.
+ `CurrentApplyDate`—Ditampilkan jika opt-in-type ada`APPLY_ON`.
+ `Description`—Deskripsi opsi untuk tindakan pemeliharaan.
### Terapkan tanggal
Setiap tindakan pemeliharaan memiliki tanggal penerapan masing-masing yang dapat Anda temukan saat menjelaskan tindakan pemeliharaan yang tertunda. Saat Anda membaca output tindakan pemeliharaan yang tertunda dari AWS CLI, tiga tanggal dicantumkan:
+ `CurrentApplyDate`—Tanggal tindakan pemeliharaan akan diterapkan baik segera atau selama jendela pemeliharaan berikutnya. Jika pemeliharaannya opsional, nilai ini bisa null.
+ `ForcedApplyDate`—Tanggal saat pemeliharaan akan diterapkan secara otomatis, terlepas dari jangka waktu pemeliharaan Anda.
+ `AutoAppliedAfterDate`—Tanggal setelah pemeliharaan akan diterapkan selama jendela pemeliharaan klaster.
### Tindakan pemeliharaan yang dibuat pengguna
Sebagai pengguna DBelastic kluster Dokumen Amazon, Anda dapat memulai pembaruan pada konfigurasi kluster Anda.
**Memperbarui kata sandi utama klaster**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
Parameter:
+ **--cluster-arn**—Nama Sumber Daya Amazon DocumentDB Amazon (ARN) dari sumber daya tempat tindakan pemeliharaan akan diterapkan.
+ **[--admin-user-password]**—Kata sandi yang terkait dengan pengguna admin.
+ **[--auth-type]**—Jenis otentikasi yang digunakan untuk menentukan di mana mengambil kata sandi yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah `PLAIN_TEXT` atau`SECRET_ARN`.
+ **[--apply-method]**—Nilai yang menentukan jenis metode yang diterapkan. Nilai yang diizinkan adalah `IMMEDIATE` dan `APPLY_ON`. Default-nya adalah `IMMEDIATE`.
+ **[--apply-on]**—Diperlukan jika `apply-method` ada`APPLY_ON`. Format: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Opsi ini menggunakan waktu UTC. Waktu mulai bisa kapan saja di masa depan dari minimal 30 menit dan maksimal 14 hari. Jendela waktu mulai hingga akhir bisa minimal 30 menit hingga maksimal 8 jam.)
Output dari operasi ini terlihat seperti berikut (format JSON):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### Mengubah jendela pemeliharaan Amazon DocumentDB Anda
Waktu pemeliharaan harus jatuh pada saat penggunaan terendah dan dengan demikian mungkin perlu diubah dari waktu ke waktu. Cluster elastis Anda tidak tersedia selama waktu ini hanya jika perubahan sistem (seperti perubahan operasi penyimpanan skala) diterapkan dan memerlukan pemadaman. Ini tidak tersedia hanya untuk jumlah waktu minimum yang diperlukan untuk membuat perubahan yang diperlukan.
Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk setiap Wilayah Amazon Web Services, yang terjadi pada hari acak dalam seminggu.
Untuk mengubah jendela pemeliharaan, lihat[Memodifikasi konfigurasi cluster elastis](elastic-managing.md#elastic-modify).
## Pembaruan sistem operasi cluster elastis
Cluster elastis Amazon DocumentDB terkadang memerlukan pembaruan sistem operasi. Amazon DocumentDB meningkatkan sistem operasi ke versi yang lebih baru untuk meningkatkan kinerja database dan postur keamanan pelanggan secara keseluruhan. Pembaruan sistem operasi tidak mengubah versi mesin cluster dari cluster elastis Amazon DocumentDB.
Sebagian besar pembaruan sistem operasi untuk cluster elastis Amazon DocumentDB bersifat opsional dan tidak memiliki tanggal yang ditetapkan untuk menerapkannya. Namun, jika Anda tidak menerapkan pembaruan ini untuk sementara waktu, mereka mungkin pada akhirnya menjadi diperlukan dan diterapkan secara otomatis selama jendela pemeliharaan cluster Anda. Ini untuk membantu menjaga postur keamanan database Anda. Untuk menghindari waktu henti yang tidak terduga, sebaiknya Anda menerapkan pembaruan sistem operasi ke cluster elastis Amazon DocumentDB Anda segera setelah tersedia dan mengatur jendela pemeliharaan klaster Anda pada saat yang sesuai dengan kebutuhan bisnis Anda.