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. DocumentDBFullAccess Kebijakan 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**.
**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 vCPU yang 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 dikaitkan 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, 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**.
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, outputnya 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**.
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).
------