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

# Melakukan pembaruan tambalan ke versi mesin cluster
<a name="db-cluster-version-upgrade"></a>

Di bagian ini, kami akan menjelaskan cara menerapkan pembaruan tambalan menggunakan Konsol Manajemen AWS atau. AWS CLI Pembaruan patch adalah pembaruan dalam versi mesin yang sama (misalnya, memperbarui versi mesin 3.6 ke versi mesin 3.6 yang lebih baru). Anda dapat memperbaruinya segera atau selama jendela pemeliharaan berikutnya pada klaster Anda. Untuk menentukan apakah mesin Anda memerlukan pembaruan, lihat [Menentukan pemeliharaan yang tertunda](db-cluster-determine-pending-maintenance.md). Silakan dicatat bahwa ketika Anda menerapkan pembaruan, klaster Anda akan mengalami waktu henti selama beberapa saat.

**catatan**  
Jika Anda mencoba untuk meng-upgrade dari versi mesin utama ke yang lain, seperti 3.6 ke 5.0, lihat salah satu [Peningkatan versi utama Amazon DocumentDB di tempat](docdb-mvu.md) atau[Memutakhirkan cluster Amazon DocumentDB Anda menggunakan AWS Database Migration Service](docdb-migration.versions.md). Upgrade versi utama di tempat hanya mendukung docdb 5.0 sebagai versi mesin target.

Ada dua persyaratan konfigurasi untuk mendapatkan pembaruan patch terbaru untuk sebuah versi mesin pada suatu klaster:
+ Status klaster harus *tersedia*.
+ Klaster harus menjalankan versi mesin sebelumnya.

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

Prosedur berikut menerapkan pembaruan patch untuk versi mesin pada klaster dengan menggunakan konsol. Anda memiliki pilihan untuk memperbarui segera atau selama jendela pemeliharaan berikutnya pada klaster Anda.

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. Pada panel navigasi, silakan pilih **Klaster**. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda tingkatkan. Status klaster harus *tersedia*.
**Tip**  
Jika panel navigasi tidak terlihat di sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.

1. Dari menu **Tindakan**, pilih salah satu dari berikut ini. Opsi menu ini dapat dipilih hanya jika klaster yang Anda pilih tidak menjalankan versi mesin terbaru.  
![\[Gambar: Tindakan Pembaruan Amazon DocumentDB\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + **Tingkatkan sekarang**—Segera memulai proses peningkatan. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.
   + **Tingkatkan pada jendela berikutnya**—Memulai proses peningkatan selama jendela pemeliharaan berikutnya pada klaster. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.

1. Jika jendela konfirmasi terbuka, pilih salah satu hal berikut:
   + **Meningkatkan**—Untuk meningkatkan klaster Anda ke versi mesin terbaru sesuai dengan jadwal yang dipilih pada langkah sebelumnya.
   + **Batalkan**—Untuk membatalkan peningkatan mesin klaster dan melanjutkan dengan versi mesin saat ini pada klaster.

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

Anda dapat menerapkan pembaruan tambalan ke cluster Anda menggunakan AWS CLI dan `apply-pending-maintenance-action` operasi dengan parameter berikut.

**Parameter**
+ **--resource-identifier**—Diperlukan. ARN dari klaster Amazon DocumentDB yang akan Anda tingkatkan.
+ **--apply-action**—Diperlukan. Nilai berikut diizinkan. Untuk meningkatkan versi mesin klaster Anda, gunakan `db-upgrade`.
  + **db-upgrade**
  + **system-update**
+ **--opt-in-type**—Diperlukan. Nilai berikut diizinkan.
  + `immediate`—Terapkan tindakan pemeliharaan segera.
  + `next-maintenance`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya.
  + `undo-opt-in`—Membatalkan permintaan keikutsertaan `next-maintenance` yang ada.

**Example**  
Patch contoh berikut memperbarui versi mesin `sample-cluster` ke versi 4.0.0.  
Untuk Linux, macOS, atau Unix:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate
```
Untuk Windows:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate
```
Output dari operasi ini terlihat seperti berikut ini.  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------