

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengelola instans Amazon DocumentDB
<a name="db-instances"></a>

Topik berikut memberikan informasi untuk membantu Anda mengelola instans Amazon DocumentDB Anda. Topik-topik tersebut menyertakan detail tentang kelas dan status instans, serta cara membuat, menghapus, dan memodifikasi instans.

**Topics**
+ [Menentukan status instans](#db-instance-status)
+ [Siklus hidup instans](db-instance-life-cycle.md)
+ [Mengelola kelas instance](db-instance-classes.md)
+ [NVMecontoh -didukung](db-instance-nvme.md)

## Menentukan status instans
<a name="db-instance-status"></a>

Untuk melihat status instans yang valid, artinya, dan cara menentukan status instans Anda, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md).

# Siklus hidup instance Amazon DocumentDB
<a name="db-instance-life-cycle"></a>

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
<a name="db-instance-add"></a>

------
#### [ 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: <cluster-name>**, 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:<accountID>:key/sample-key",
           "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
           "CACertificateIdentifier": "rds-ca-2019",
           "PromotionTier": 2,
           "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>: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
<a name="db-instance-view-details"></a>

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
<a name="db-instance-modify"></a>

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: <instance-name>**, 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
<a name="db-instance-reboot"></a>

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:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>: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
<a name="db-instance-delete"></a>

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?** <instance-name> — Masukkan frasa **hapus seluruh klaster** ke dalam bidang untuk mengonfirmasi penghapusan.

   1. Jika Anda tidak menghapus instans terakhir di klaster Anda:
      + **Hapus contoh?** <instance-name> — 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:<accountID>:key/sample-key",
           "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
           "CACertificateIdentifier": "rds-ca-2019",
           "PromotionTier": 1,
           "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>: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
<a name="db-instance-delete-deletion-protection"></a>

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). 

# Mengelola kelas instance
<a name="db-instance-classes"></a>

Kelas instans menentukan komputasi dan kapasitas memori dari instans Amazon DocumentDB (dengan kompatibilitas MongoDB). Kelas instans yang Anda butuhkan tergantung pada kebutuhan daya dan memori pemrosesan Anda. 

Amazon DocumentDB mendukung keluarga kelas instans R4, R5, R6G, R8G, T3, dan T4G. Kelas-kelas ini adalah kelas instans generasi saat ini yang dioptimalkan untuk aplikasi yang memakan memori. Untuk spesifikasi pada kelas-kelas ini, lihat [Spesifikasi kelas instans](#db-instance-class-specs). 

**Topics**
+ [Menentukan kelas instance](#db-instance-class-determining)
+ [Mengubah kelas instance](#db-instance-class-changing)
+ [Kelas instance yang didukung berdasarkan wilayah](#db-instance-classes-by-region)
+ [Spesifikasi kelas instans](#db-instance-class-specs)

## Menentukan kelas instance
<a name="db-instance-class-determining"></a>

Untuk menentukan kelas sebuah instance, Anda dapat menggunakan Konsol Manajemen AWS atau `describe-db-instances` AWS CLI operasi.

------
#### [ Using the Konsol Manajemen AWS ]

Untuk menentukan kelas instans bagi instans klaster Anda, selesaikan langkah-langkah berikut di 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 **untuk menemukan instans yang Anda minati. 
**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 yang menunjukkan bagaimana sebuah instance bersarang di bawah cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png)

1. Dalam daftar instans, perluas klaster untuk menemukan instans Anda minati. Temukan instans yang Anda inginkan. Kemudian, lihat pada kolom **Ukuran** dari baris instans untuk melihat kelas instansnya.

   Pada gambar berikut, kelas instans untuk instans `robo3t` adalah `db.r5.4xlarge`.  
![\[Daftar contoh dalam tabel Clusters dengan kolom Ukuran yang menunjukkan jenis instance.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/instance-class.png)

------
#### [ Using the AWS CLI ]

Untuk menentukan kelas instance menggunakan AWS CLI, gunakan `describe-db-instances` operasi dengan parameter berikut.
+ **--db-instance-identifier**— Opsional. Menentukan instans yang ingin Anda temukan kelas instansnya. Jika parameter ini dihilangkan, `describe-db-instances` mengembalikan deskripsi hingga 100 instans Anda.
+ **--query** — Opsional. Menentukan anggota instans untuk disertakan dalam hasil. Jika parameter ini dihilangkan, semua anggota instans dikembalikan.

**Example**  
Contoh berikut menemukan nama dan kelas instans untuk instans `sample-instance-1`.  
Untuk Linux, macOS, atau Unix:  

```
aws docdb describe-db-instances \
    --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
    --db-instance-identifier sample-instance-1
```
Untuk Windows:  

```
aws docdb describe-db-instances ^
    --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
    --db-instance-identifier sample-instance-1
```
Output dari operasi ini terlihat seperti berikut.  

```
[
    [
        "sample-instance-1",
        "db.r5.large"
    ]
```

**Example**  
Contoh berikut menemukan nama dan kelas instans hingga 100 instans Amazon DocumentDB.  
Untuk Linux, macOS, atau Unix:  

```
aws docdb describe-db-instances \
    --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
    --filter Name=engine,Values=docdb
```
Untuk Windows:  

```
aws docdb describe-db-instances ^
    --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
    --filter Name=engine,Values=docdb
```
Output dari operasi ini terlihat seperti berikut.  

```
[
    [
        "sample-instance-1",
        "db.r5.large"
    ],
    [
        "sample-instance-2",
        "db.r5.large"
    ],
    [
        "sample-instance-3",
        "db.r5.4xlarge"
    ],
    [
        "sample-instance-4",
        "db.r5.4xlarge"
    ]
]
```

Untuk informasi selengkapnya, lihat [Menjelaskan instans Amazon DocumentDB](db-instance-view-details.md). 

------

## Mengubah kelas instance
<a name="db-instance-class-changing"></a>

Anda dapat mengubah kelas instance instance Anda menggunakan Konsol Manajemen AWS atau AWS CLI. Untuk informasi selengkapnya, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md). 

## Kelas instance yang didukung berdasarkan wilayah
<a name="db-instance-classes-by-region"></a>

Amazon DocumentDB mendukung kelas instans berikut:
+ `R8G`—Generasi terbaru dari instans yang dioptimalkan memori yang didukung oleh prosesor AWS Graviton4 berbasis ARM yang memberikan kinerja hingga 30% lebih baik dibandingkan instans R6G.
+ `R6G`—Instans yang dioptimalkan untuk memori yang didukung oleh prosesor AWS Graviton2 berbasis ARM yang memberikan kinerja hingga 30% lebih baik dibandingkan instans R5 dengan biaya 5% lebih murah.
+ `R6GD`—Instans R6G yang dioptimalkan memori dengan penyimpanan Solid-State Drive (SSDNVMe) berbasis memori non-volatile express () lokal untuk data sementara.
+ `R5`—Instans yang dioptimalkan untuk memori yang memberikan kinerja hingga 100% lebih baik dibandingkan instans R4 dengan biaya instans yang sama.
+ `R4` — Generasi sebelumnya dari instans dengan memori yang dioptimalkan.
+ `T4G`—Jenis instans tujuan umum burstable berbiaya rendah generasi terbaru yang ditenagai oleh prosesor AWS Graviton2 berbasis ARM yang memberikan tingkat kinerja CPU dasar, memberikan kinerja harga hingga 35% lebih baik dibandingkan instans T3 dan ideal untuk menjalankan aplikasi dengan penggunaan CPU moderat yang mengalami lonjakan sementara dalam penggunaan.
+ `T3`—Jenis instans tujuan umum burstable dengan biaya rendah yang memberikan tingkat kinerja CPU dasar dengan kemampuan untuk meningkatkan penggunaan CPU kapan saja selama diperlukan.

Untuk spesifikasi mendetail tentang kelas instans, lihat [Spesifikasi kelas instans](#db-instance-class-specs). 

**catatan**  
Penyimpanan I/O-Optimized hanya tersedia pada engine versi 5.0 dan 8.0 (cluster berbasis instance).

Sebuah kelas instans tertentu mungkin atau mungkin tidak didukung di Wilayah tertentu. Tabel berikut menentukan kelas instans yang didukung oleh Amazon DocumentDB di setiap Wilayah.


**Kelas instans yang didukung berdasarkan Wilayah**  

|  | Kelas Instans | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Nirserver | 
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | 
| AS Timur (Ohio) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | 
| US East (N. Virginia) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | 
| US West (Oregon) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | 
| Africa (Cape Town) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Amerika Selatan (Sao Paulo) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Hong Kong) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Hyderabad) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Malaysia) |  |  | Didukung |  |  | Didukung | Didukung |  | 
| Asia Pasifik (Mumbai) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Osaka) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung |  | 
| Asia Pasifik (Seoul) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pacific (Sydney) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Jakarta) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung |  | 
| Asia Pacific (Melbourne) |  |  | Didukung | Didukung |  | Didukung | Didukung |  | 
| Asia Pacific (Singapore) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Asia Pasifik (Thailand) |  |  | Didukung |  |  | Didukung | Didukung |  | 
| Asia Pacific (Tokyo) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Kanada (Pusat) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Eropa (Frankfurt) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Europe (Zurich) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung |  | 
| Eropa (Irlandia) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | 
| Eropa (London) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Europe (Milan) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Eropa (Paris) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Eropa (Spanyol) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Eropa (Stockholm) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung |  | 
| Meksiko (Tengah) |  |  | Didukung |  |  | Didukung | Didukung |  | 
| Timur Tengah (UAE) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Tiongkok (Beijing) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Tiongkok (Ningxia) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| Israel (Tel Aviv) |  |  | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| AWS GovCloud (AS-Barat) | Didukung | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 
| AWS GovCloud (AS-Timur) |  | Didukung | Didukung | Didukung |  | Didukung | Didukung | Didukung | 

## Spesifikasi kelas instans
<a name="db-instance-class-specs"></a>

Tabel berikut memberikan rincian kelas instans Amazon DocumentDB, termasuk jenis instance yang didukung di setiap kelas. Anda dapat menemukan penjelasan untuk setiap kolom tabel di bawah tabel.


| Kelas instans | vCPU1 | Memori (GiB) 2 | NVMe Cache berjenjang SSD (GiB) 3 | Maks. temp. penyimpanan (GiB) 4 | Bandwidth dasar/burst (Gbps) 5 | Mesin Pendukung 6 | 
| --- | --- | --- | --- | --- | --- | --- | 
| R8G - Kelas Instance yang Dioptimalkan Memori Generasi Saat Ini berdasarkan Graviton4 R8G adalah keluarga instans terbaru (Graviton4), hanya tersedia pada versi mesin 5.0 dan 8.0. Ukuran db.r8g.24xlarge dan db.r8g.48xlarge belum tersedia. | 
| db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 dan 8.0.0 | 
| db.r8g.xlarge | 4 | 32 | - | 60 | 1.875/12,5 | 5.0.0 dan 8.0.0 | 
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 dan 8.0.0 | 
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 dan 8.0.0 | 
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 dan 8.0.0 | 
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 dan 8.0.0 | 
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 dan 8.0.0 | 
| R6G - Kelas Instance yang Dioptimalkan Memori Generasi Saat Ini berdasarkan Graviton2 | 
| db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0, dan 8.0.0 | 
| R6GD - Kelas Instance yang NVMe didukung Generasi Saat Ini berdasarkan Graviton2 | 
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 dan 8.0.0 | 
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2.5/10 | 5.0.0 dan 8.0.0 | 
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5.0/10 | 5.0.0 dan 8.0.0 | 
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 dan 8.0.0 | 
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 dan 8.0.0 | 
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 dan 8.0.0 | 
| R5 - Kelas Instance Dioptimalkan Memori Generasi Sebelumnya | 
| db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
| R4 - Kelas Instance Dioptimalkan Memori Generasi Sebelumnya Instans R4 hanya didukung pada engine versi 3.6. Perhatikan bahwa Amazon DocumentDB 3.6 mencapai akhir dukungan standar pada 30 Maret 2026. Extended Support (berbayar) tersedia hingga Maret 2029. | 
| db.r4.large | 2 | 15.25 | - | 30 | 0,75/10 | 3.6.0 saja | 
| db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | 3.6.0 saja | 
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | 3.6.0 saja | 
| db.r4.4xlarge | 16 | 122 | - | 240 | 5.0 /10 | 3.6.0 saja | 
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 3.6.0 saja | 
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 3.6.0 saja | 
| T4G — Kelas Instans Kinerja Burstable Generasi Terbaru berdasarkan Graviton2 Instans seri-T berjalan dalam mode burst CPU Tidak Terbatas. Penggunaan burst di luar baseline ditagih ekstra. Tidak didukung untuk Global Cluster. | 
| db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0, dan 8.0.0 | 
| T3 — Kelas Instans Kinerja Burstable Generasi Sebelumnya | 
| db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-instance-classes.html)  | 

# NVMecontoh -didukung
<a name="db-instance-nvme"></a>

NVMeInstans yang didukung menawarkan kinerja kueri hingga 7x lebih cepat untuk aplikasi dengan kumpulan data besar yang melebihi memori instans biasa. Instans ini memanfaatkan penyimpanan Solid-State Drive (SSDNVMe) berbasis memori non-volatile lokal yang tersedia pada instans r6gd untuk menyimpan data sementara, mengurangi akses penyimpanan berbasis jaringan, dan meningkatkan latensi dan throughput baca.

Ruang SSD lokal dibagi menjadi dua bagian:
+ **Cache berjenjang** — Sekitar 73% dari SSD lokal dialokasikan sebagai cache database, memungkinkan sistem untuk menyimpan hingga lima kali lebih banyak halaman database daripada memori utama saja. SSD lokal bertindak sebagai cache tingkat kedua, sedangkan cache buffer dalam memori yang ada tetap menjadi cache tingkat pertama. Kueri hanya mengakses penyimpanan eksternal jika cache buffer dan cache SSD mengalami kehilangan.
+ **Penyimpanan sementara** — 27% sisanya dicadangkan untuk penyimpanan file sementara yang tidak persisten, digunakan untuk kueri kompleks yang melibatkan jenis atau operasi intensif sumber daya seperti pembuatan indeks. Pada instans reguler, ruang sementara berada di volume Amazon Elastic Block Store (EBS). Penyimpanan sementara yang dihosting secara lokal pada SSD mengurangi latensi kueri yang melibatkan jenis hingga dua kali dan mempercepat operasi intensif sumber daya seperti pembuatan indeks.

Rincian mengenai jenis instans NVMe yang didukung dan spesifikasinya dapat ditemukan di. [Spesifikasi kelas instans](db-instance-classes.md#db-instance-class-specs)

**Topics**
+ [Kasus penggunaan yang disarankan untuk NVMe instance yang didukung](#nvme-use-cases)
+ [Menggunakan instans NVMe yang didukung dengan Amazon DocumentDB](#using-nvme)
+ [Memantau NVMe instans yang didukung](#monitoring-nvme)

## Kasus penggunaan yang disarankan untuk NVMe instance yang didukung
<a name="nvme-use-cases"></a>

Sebaiknya gunakan instans NVMe yang didukung dalam skenario berikut:
+ **Beban kerja baca-berat - Jika beban** kerja Anda padat baca, dan kumpulan data Anda lebih besar dari cache buffer, ditunjukkan oleh `ReadIOPS` metrik rendah `BufferCacheHitRatio` dan tinggi, instans yang didukung dapat memberikan manfaat kinerja. NVMe
+ **Beban kerja pembaruan-berat** - Jika beban kerja Anda padat pembaruan, dan pengumpulan sampah tidak dapat mengikuti karena latensi baca pada penyimpanan jaringan, instans yang didukung dapat membantu mengurangi masalah. NVMe

NVMeinstans yang didukung dapat menguntungkan berbagai kasus penggunaan, termasuk:
+ **Aplikasi skala internet — Aplikasi** seperti pemrosesan pembayaran, penagihan, dan e-commerce dengan Perjanjian Tingkat Layanan (SLAs) kinerja yang ketat dapat memanfaatkan keunggulan kinerja instans yang didukung. NVMe
+ **Dasbor pelaporan real-time** — Dasbor yang menjalankan ratusan kueri untuk pengumpulan metrik/data dapat memanfaatkan latensi rendah dan throughput tinggi dari instans yang didukung. NVMe
+ **Aplikasi AI generatif** — Aplikasi yang menggunakan pencarian vektor untuk menemukan tetangga yang tepat atau terdekat di jutaan penyematan vektor dapat memanfaatkan kinerja tinggi instance yang didukung. NVMe

## Menggunakan instans NVMe yang didukung dengan Amazon DocumentDB
<a name="using-nvme"></a>

Untuk menggunakan instance NVMe Amazon DocumentDB yang didukung:
+ Buat klaster Amazon DocumentDB dan tambahkan salah satu kelas instans yang didukung NVMe. Untuk informasi selengkapnya, lihat [Membuat cluster Amazon DocumentDB](db-cluster-create.md).
+ Atau, ubah cluster Amazon DocumentDB yang ada untuk menggunakan salah satu kelas instans yang didukung NVMe. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).

Untuk memeriksa ketersediaan instans yang NVMe didukung di berbagai AWS Wilayah, lihat. [Kelas instance yang didukung berdasarkan wilayah](db-instance-classes.md#db-instance-classes-by-region)

Jika Anda ingin beralih kembali dari instance NVMe -backed ke instance biasa, ubah class instance database instance Amazon DocumentDB Anda ke kelas instance serupa tanpa penyimpanan. NVMe Misalnya, jika kelas instance Anda saat ini adalah 'db.r6gd.4xlarge', pilih 'db.r6g.4xlarge' untuk beralih kembali. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).

## Memantau NVMe instans yang didukung
<a name="monitoring-nvme"></a>

Selain metrik instans reguler yang tersedia di Amazon CloudWatch, instans yang NVMe didukung memancarkan metrik tambahan khusus untuk penyimpanan SSD NVMe berbasis, IOPS, dan throughput. 

```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```

Untuk informasi selengkapnya tentang metrik ini, lihat [NVMemetrik instance yang didukung](cloud_watch.md#nvme-metrics)