Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siklus hidup instance Amazon DocumentDB
Siklus hidup dari instans Amazon DocumentDB termasuk menciptakan, memodifikasi, memelihara dan meningkatkan, melakukan backup dan pemulihan, mem-boot ulang, dan menghapus instans. Bagian ini menyediakan informasi tentang cara menyelesaikan proses ini.
**Topics**
+ [Menambahkan sebuah instance](db-instance-add.md)
+ [Menjelaskan contoh](db-instance-view-details.md)
+ [Memodifikasi sebuah instance](db-instance-modify.md)
+ [Mem-boot ulang sebuah instance](db-instance-reboot.md)
+ [Menghapus sebuah instans](db-instance-delete.md)
Anda dapat membuat instance Amazon DocumentDB baru menggunakan Konsol Manajemen AWS atau. AWS CLI Untuk menambahkan instans ke klaster, klaster harus dalam status *tersedia*. Anda tidak dapat menambahkan instans ke klaster yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu sampai klaster *tersedia*, kemudian tambahkan instans. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md).
**catatan**
Jika Anda membuat klaster Amazon DocumentDB menggunakan konsol, sebuah instans secara otomatis dibuat untuk Anda pada saat yang sama. Jika Anda ingin membuat instans tambahan, gunakan salah satu prosedur berikut.
# Menambahkan instance Amazon DocumentDB ke klaster
------
#### [ Using the Konsol Manajemen AWS ]
Gunakan prosedur berikut untuk membuat instans untuk klaster Anda menggunakan konsol 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. Untuk memilih klaster yang ingin Anda tambahi instans, pilih tombol di sebelah kiri nama klaster.
1. Pilih **Tindakan**, dan kemudian pilih **Tambahkan instans**.
1. Di halaman **Tambahkan instans ke: **, ulangi langkah berikut untuk setiap instans yang ingin Anda tambahkan ke klaster. Anda dapat memiliki hingga 15.
1. **Pengidentifikasi instans** — Anda dapat memasukkan pengidentifikasi unik untuk instans ini atau mengizinkan Amazon DocumentDB menyediakan pengidentifikasi instans berdasarkan pengidentifikasi klaster.
Kendala penamaan instans:
+ 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 instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
1. **Kelas instans** — Dari daftar tarik-turun, pilih tipe instans yang Anda inginkan untuk instans ini.
1. **Tingkat promosi** — Dari daftar tarik-turun, pilih tingkat promosi untuk instans Anda atau pilih *Tidak ada preferensi* guna mengizinkan Amazon DocumentDB untuk mengatur tingkat promosi untuk instans Anda. Angka yang lebih rendah berarti prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control).
1. Untuk menambahkan lebih banyak instans, pilih **Tambahkan instans tambahan** dan ulangi langkah a, b, dan c.
1. Selesaikan operasi.
+ Untuk menambahkan instans ke klaster Anda, pilih **Buat**.
+ Untuk membatalkan operasi, pilih **Batal**.
Dibutuhkan beberapa menit untuk membuat sebuah instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau status instans](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Gunakan `create-db-instance` AWS CLI operasi dengan parameter berikut untuk membuat instance utama untuk cluster Anda.
+ **--db-instance-class** — Diperlukan. Kapasitas komputasi dan memori instans, misalnya, `db.m4.large`. Tidak semua kelas instans tersedia di semua Wilayah AWS.
+ **--db-instance-identifier** — Diperlukan. Sebuah string yang mengidentifikasi instans.
Kendala Penamaan Instans:
+ 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 instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
+ **--engine** — Diperlukan. Harus berupa `docdb`.
+ **--availability-zone** — Opsional. Availability Zone tempat Anda ingin membuat instans ini. Gunakan parameter ini untuk menemukan instans Anda di Availability Zone yang berbeda untuk meningkatkan toleransi kesalahan. Untuk informasi selengkapnya, lihat [Amazon DocumentDB Ketersediaan dan replikasi tinggi](replication.md).
+ **--promotion-tier** — Opsional. Tingkat prioritas failover untuk instans ini. Harus antara 0 dan 15 dengan angka yang lebih rendah menjadi prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control).
1. **Pertama, tentukan Availability Zone tempat Anda dapat membuat instance Anda.**
Jika Anda ingin menentukan Availability Zone sebelum membuat instans, jalankan perintah berikut untuk menentukan Availability Zone mana yang tersedia untuk klaster Amazon DocumentDB Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Output dari operasi ini terlihat seperti berikut.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **Kedua, tentukan kelas instance apa yang dapat Anda buat di Wilayah Anda.**
Untuk menentukan kelas instans mana yang tersedia untuk Anda di Wilayah Anda, jalankan perintah berikut. Dari output, pilih kelas instans untuk instans yang ingin Anda tambahkan ke klaster Amazon DocumentDB Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Untuk Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Output dari operasi ini terlihat seperti berikut.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Terakhir, tambahkan instance ke cluster Amazon DocumentDB Anda.**
Untuk menambahkan instans ke klaster Amazon DocumentDB Anda, jalankan perintah berikut..
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Untuk Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
Dibutuhkan beberapa menit untuk membuat instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Menjelaskan instans Amazon DocumentDB
Anda dapat menggunakan Amazon DocumentDB Management Console atau AWS CLI untuk melihat detail seperti titik akhir koneksi, VPCs grup keamanan, otoritas sertifikat, dan grup parameter yang berkaitan dengan instans Amazon DocumentDB Anda.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk melihat detail instans Anda menggunakan Konsol Manajemen AWS, ikuti langkah-langkah di bawah ini.
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. Dalam daftar instans, pilih nama instans yang ingin Anda lihat detailnya. Informasi tentang instans diatur ke dalam pengelompokan berikut:
+ **Ringkasan** — Informasi umum tentang instans, termasuk versi mesin, kelas, status, dan setiap pemeliharaan tertunda.
+ **Konektivitas & Keamanan** — Bagian **Hubungkan** berisi daftar titik akhir koneksi untuk membuat sambungan ke instans ini dengan mongo shell atau dengan aplikasi. Bagian **Grup Keamanan** terdiri atas daftar grup keamanan yang terkait dengan instans ini dan ID VPC serta deskripsinya.
+ **Konfigurasi** — Bagian **Detail** berisi daftar konfigurasi dan status instans, termasuk Amazon Resource Name (ARN), titik akhir, peran, kelas, dan otoritas sertifikat instans. Ini juga berisi daftar pengaturan keamanan dan jaringan, serta informasi backup instans. Bagian **Detail klaster** berisi daftar detail klaster tempat instans ini berada. Bagian **Instans klaster** berisi daftar semua instans yang dimiliki klaster Anda dengan masing-masing peran instans dan status grup parameter klaster.
**catatan**
Anda dapat memodifikasi klaster yang terkait dengan instans Anda dengan memilih **Modifikasi** di samping header **Detail klaster**. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
+ **Monitoring** —Metrik CloudWatch Log untuk contoh ini. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md).
+ **Peristiwa & tag** — Bagian **Peristiwa terbaru** berisi daftar peristiwa terbaru untuk instans 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. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Untuk melihat detail instance 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_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.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.
1. **Daftar semua instance Amazon DocumentDB.**
AWS CLI Kode berikut mencantumkan detail untuk semua instance Amazon DocumentDB di suatu wilayah.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Untuk Windows:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Cantumkan semua detail untuk instance Amazon DocumentDB tertentu**
Kode berikut mengeluarkan daftar detail untuk `sample-cluster-instance`. Termasuk parameter `--db-instance-identifier` dengan nama instans membatasi output ke informasi pada instans tertentu.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Untuk Windows:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 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).
------
# Mem-boot ulang instans Amazon DocumentDB
Terkadang, Anda mungkin perlu mem-boot ulang instans Amazon DocumentDB Anda, biasanya karena alasan pemeliharaan. Jika Anda melakukan perubahan tertentu, seperti mengubah grup parameter klaster yang terkait dengan klaster, Anda harus mem-boot ulang instans di klaster agar perubahan diterapkan. Anda dapat me-reboot instance tertentu menggunakan Konsol Manajemen AWS atau AWS CLI.
Mem-boot ulang instans akan memulai ulang layanan mesin basis data. Mem-boot ulang menyebabkan pemadaman sementara, selama status instans diatur ke `rebooting`. Peristiwa Amazon DocumentDB dibuat saat boot ulang selesai.
Mem-boot ulang instans tidak mengakibatkan failover. Untuk melakukan failover cluster Amazon DocumentDB, Konsol Manajemen AWS gunakan atau operasinya. AWS CLI `failover-db-cluster` Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md).
Anda tidak dapat mem-boot ulang instans Anda jika tidak berada dalam status *tersedia*. Basis data Anda dapat tidak tersedia karena beberapa alasan, seperti modifikasi yang diminta sebelumnya, atau tindakan jendela pemeliharaan. Untuk informasi lebih lanjut tentang status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut mem-boot ulang instans yang Anda tentukan 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. 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 boot ulang.
1. Pilih **Tindakan**, pilih **Boot ulang**, lalu pilih **Boot ulang** untuk mengonfirmasi boot ulang Anda.
Diperlukan waktu beberapa menit agar instans di-boot ulang. 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 mem-boot ulang instans Amazon DocumentDB, gunakan operasi `reboot-db-instance` dengan parameter `--db-instance-identifier`. Parameter ini menentukan pengidentifikasi untuk instans yang akan di-boot ulang.
Kode berikut mem-boot ulang instans `sample-instance`.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Untuk Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
Output dari operasi ini terlihat seperti berikut.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
Diperlukan waktu beberapa menit agar instans di-boot ulang. 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).
------
# Menghapus instans Amazon DocumentDB
Anda dapat menghapus instans Amazon DocumentDB Anda menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Untuk menghapus sebuah instans, instans harus dalam status *tersedia*. Anda tidak dapat menghapus instans yang dihentikan. Jika klaster Amazon DocumentDB yang berisi instans Anda berhenti, pertama mulai klaster, tunggu instans menjadi *tersedia*, dan kemudian hapus instans tersebut. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md).
**catatan**
Amazon DocumentDB menyimpan semua data Anda dalam volume klaster. Data tetap ada dalam volume klaster tersebut, meskipun Anda menghapus semua instans dari klaster Anda. Jika Anda perlu mengakses data lagi, Anda dapat menambahkan instans ke klaster kapan saja dan melanjutkan dari bagian terakhir yang Anda tinggalkan.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut menghapus instans 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. 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 hapus.
1. Pilih **Tindakan**, lalu pilih **Hapus**.
1. Jika Anda menghapus instans terakhir di klaster Anda:
+ **Buat snapshot cluster akhir?** — Pilih **Ya** jika Anda ingin membuat snapshot akhir sebelum klaster dihapus. Jika tidak, pilih **Tidak**.
+ **Nama snapshot akhir** — Jika Anda memilih untuk membuat snapshot akhir, masukkan pengidentifikasi snapshot klaster dari snapshot klaster baru yang dibuat.
+ **Hapus contoh?** — Masukkan frasa **hapus seluruh klaster** ke dalam bidang untuk mengonfirmasi penghapusan.
1. Jika Anda tidak menghapus instans terakhir di klaster Anda:
+ **Hapus contoh?** — Masukkan frasa **hapus saya** ke dalam bidang untuk mengonfirmasi penghapusan.
1. Pilih **Hapus** untuk menghapus instans.
Diperlukan beberapa menit untuk menghapus instans. Untuk memantau status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Prosedur berikut menghapus instans Amazon DocumentDB dengan menggunakan AWS CLI.
1. **Pertama, tentukan berapa banyak instance yang ada di cluster Amazon DocumentDB Anda:**
Untuk menentukan berapa banyak instans di klaster Anda, jalankan perintah `describe-db-clusters`, sebagai berikut.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
Output dari operasi ini terlihat seperti berikut.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Jika ada lebih dari satu instance di cluster Amazon DocumentDB Anda:**
Untuk menghapus instans Amazon DocumentDB tertentu, gunakan perintah `delete-db-instance` dengan parameter `--db-instance-identifier`, seperti yang ditunjukkan di bawah ini. Diperlukan beberapa menit untuk menghapus instans. Untuk memantau status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
Output dari operasi ini akan terlihat seperti berikut.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **Jika instance yang ingin Anda hapus adalah instance terakhir di cluster Amazon DocumentDB Anda:**
Jika Anda menghapus instans terakhir di klaster Amazon DocumentDB, Anda juga menghapus klaster tersebut serta snapshot otomatis dan backup terus menerus yang terkait dengan klaster tersebut.
Untuk menghapus instans terakhir di klaster Anda, Anda dapat menghapus klaster dan secara opsional membuat snapshot akhir. Untuk informasi selengkapnya, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
------
## Perlindungan penghapusan
Menghapus instans terakhir dari klaster Amazon DocumentDB juga akan menghapus klaster tersebut, serta snapshot otomatis dan backup terus menerus yang terkait dengan klaster tersebut. Amazon DocumentDB memberlakukan perlindungan penghapusan untuk klaster apakah Anda melakukan operasi penghapusan menggunakan atau. Konsol Manajemen AWS 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. Lihat informasi yang lebih lengkap di [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).