Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memodifikasi instance Amazon DocumentDB
Anda dapat memodifikasi instans Amazon DocumentDB Anda menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Untuk memodifikasi sebuah instans, instans harus dalam status *tersedia*. Anda tidak dapat memodifikasi instans yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu hingga instans *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 ]
Untuk memodifikasi instans Amazon DocumentDB tertentu menggunakan konsol, selesaikan langkah berikut.
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. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah.
![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png)
1. Centang kotak di sebelah kiri instans yang ingin Anda modifikasi.
1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**.
1. Di panel **Modifikasi instans: **, buat perubahan yang Anda inginkan. Anda dapat membuat perubahan berikut:
+ **Spesifikasi instans** — Pengidentifikasi dan kelas instans. Kendala penamaan pengidentifikasi instans:
+ **Instance identifier** — Masukkan nama yang unik untuk semua instans yang dimiliki oleh Anda Akun AWS di wilayah saat ini. Pengidentifikasi instans harus berisi [1-63] karakter alfanumerik atau tanda hubung, memiliki huruf sebagai karakter pertama, dan tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berturut-turut.
+ **Kelas instans** — Dari menu tarik-turun, pilih kelas instans untuk instans Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat [Mengelola kelas instance](db-instance-classes.md).
+ **Otoritas sertifikat** — Sertifikat server untuk instans ini. Untuk informasi selengkapnya, lihat [Memperbarui sertifikat Amazon DocumentDB TLS](ca_cert_rotation.md).
+ **Failover** — Selama failover, instans dengan tingkat promosi tertinggi akan dipromosikan ke primer. Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md).
+ **Pemeliharaan** — Jendela pemeliharaan di mana modifikasi atau patch yang tertunda diterapkan ke instans di klaster.
1. Setelah selesai, pilih **Lanjutkan** untuk melihat ringkasan perubahan Anda.
1. Setelah memverifikasi perubahan Anda, Anda dapat menerapkannya segera atau selama jendela pemeliharaan berikutnya di bawah **Penjadwalan modifikasi**. Pilih **Modifikasi instans** untuk menyimpan perubahan Anda. Atau, Anda dapat memilih **Batal** untuk membuang perubahan Anda.
Diperlukan beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Untuk memodifikasi instans Amazon DocumentDB tertentu menggunakan AWS CLI, gunakan dengan parameter `modify-db-instance` berikut. Untuk informasi selengkapnya, lihat [Memodifikasi DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). Kode berikut memodifikasi kelas instans menjadi `db.r5.large` untuk instans `sample-instance`.
**Parameter**
+ **--db-instance-identifier** — Diperlukan. Pengidentifikasi untuk instans yang akan dimodifikasi.
+ **--db-instance-class** — Opsional. Kapasitas komputasi dan memori baru dari instans; misalnya, `db.r5.large`. Tidak semua kelas instans tersedia di semua Wilayah AWS. Jika Anda memodifikasi kelas instans, pemadaman terjadi selama perubahan. Perubahan diterapkan selama jendela pemeliharaan berikutnya, kecuali `ApplyImmediately` ditentukan sebagai true untuk permintaan ini.
+ **--apply-immediately** atau **--no-apply-immediately** — Opsional. Menentukan apakah modifikasi ini harus diterapkan segera atau menunggu hingga jendela pemeliharaan berikutnya. Jika parameter ini dihilangkan, modifikasi dilakukan selama jendela pemeliharaan berikutnya.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Untuk Windows:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
Diperlukan beberapa menit agar modifikasi Anda diterapkan. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan Konsol Manajemen AWS atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
------