Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Meningkatkan versi mesin broker Amazon MQ
Amazon MQ secara teratur menyediakan versi mesin broker baru untuk semua jenis mesin broker yang didukung. Versi mesin baru termasuk patch keamanan, perbaikan bug, dan peningkatan mesin broker lainnya.
Amazon MQ mengatur nomor versi sesuai dengan spesifikasi versi semantik sebagai. `X.Y.Z` Dalam implementasi Amazon MQ, `X` menunjukkan versi utama, `Y` mewakili versi minor, dan `Z` menunjukkan nomor versi patch. Amazon MQ mendukung dua jenis peningkatan:
+ **Upgrade versi utama** - Terjadi ketika nomor versi mesin utama berubah. Misalnya, memutakhirkan dari RabbitMQ versi **3** .13 ke versi **4** .2 dianggap sebagai peningkatan versi utama.
+ **Peningkatan versi minor** - Terjadi ketika hanya nomor versi mesin minor yang berubah. Misalnya, memutakhirkan dari versi 3. **11** ke versi 3. **12** dianggap sebagai upgrade versi minor.
Anda dapat meningkatkan broker Anda secara manual kapan saja ke versi mayor atau minor yang didukung berikutnya. Amazon MQ mengelola peningkatan ke versi patch terbaru yang didukung untuk semua broker selama jendela [pemeliharaan](maintaining-brokers.md) terjadwal. Upgrade versi manual dan otomatis terjadi selama jendela pemeliharaan terjadwal, atau setelah Anda [me-reboot broker Anda](amazon-mq-rebooting-broker.md). Amazon MQ meningkatkan broker Anda ke versi minor berikutnya ketika versi minor saat ini mencapai akhir dukungan.
## Meningkatkan versi mesin secara manual
Anda dapat memutakhirkan versi mesin broker dengan menggunakan Konsol Manajemen AWS, API AWS CLI, atau Amazon MQ.
### Konsol Manajemen AWS
**Untuk meng-upgrade versi mesin broker dengan menggunakan Konsol Manajemen AWS**
1. Pada halaman detail broker, pilih **Edit**.
1. Di bawah **Spesifikasi**, untuk **Versi mesin broker**, pilih nomor versi baru dari daftar dropdown.
1. Gulir ke bagian bawah halaman, lalu pilih **Jadwalkan perubahan**.
1. Di halaman **Jadwalkan modifikasi broker**, untuk **Kapan menerapkan perubahan**, pilih salah satu opsi berikut.
+ Pilih **Setelah boot ulang berikutnya**, jika Anda ingin Amazon MQ untuk menyelesaikan peningkatan versi selama jendela pemeliharaan terjadwal berikutnya.
+ Pilih **Segera**, jika Anda ingin segera melakukan boot ulang broker dan meningkatkan versi mesin.
**penting**
Pialang instans tunggal sedang offline saat di-boot ulang. Untuk broker cluster, hanya satu node yang turun pada satu waktu sementara broker melakukan reboot.
1. Pilih **Terapkan** untuk menyelesaikan penerapan perubahan.
### AWS CLI
**Untuk meng-upgrade versi mesin broker dengan menggunakan AWS CLI**
1. Gunakan perintah CLI [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) dan tentukan parameter berikut, seperti yang ditampilkan dalam contoh.
+ `--broker-id` – ID unik yang dihasilkan Amazon MQ untuk broker. Anda dapat mengurai ID dari ARN broker. Misalnya, dengan ARN berikut, `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, ID broker akan menjadi `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`.
+ `--engine-version` – Nomor versi mesin untuk meningkatkan mesin broker.
```
aws mq update-broker --broker-id broker-id --engine-version version-number
```
1. (Opsional) Gunakan perintah CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) untuk me-reboot broker Anda jika Anda ingin segera memutakhirkan versi mesin.
```
aws mq reboot-broker --broker-id broker-id
```
Jika Anda tidak ingin melakukan boot ulang broker dan segera menerapkan perubahan, Amazon MQ akan meningkatkan broker selama jendela pemeliharaan terjadwal berikutnya.
**penting**
Pialang instans tunggal sedang offline saat di-boot ulang. Untuk broker cluster, hanya satu node yang turun pada satu waktu sementara broker melakukan reboot.
### API Amazon MQ
**Untuk meningkatkan versi mesin broker menggunakan API Amazon MQ**
1. Gunakan Operasi API [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker). Tentukan `broker-id` sebagai parameter jalur. Contoh berikut mengasumsikan broker di wilayah `us-west-2`. Untuk informasi selengkapnya tentang titik akhir Amazon MQ yang tersedia, lihat titik akhir dan kuota [Amazon MQ](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region). di *Referensi Umum AWS*
```
PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
Gunakan `engineVersion` dalam muatan permintaan untuk menentukan nomor versi peningkatan broker.
```
{
"engineVersion": "engine-version-number"
}
```
1. (Opsional) Gunakan operasi [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API untuk me-reboot broker Anda jika Anda ingin segera memutakhirkan versi mesin. `broker-id`ditentukan sebagai parameter jalur.
```
POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
Jika Anda tidak ingin melakukan boot ulang broker dan segera menerapkan perubahan, Amazon MQ akan meningkatkan broker selama jendela pemeliharaan terjadwal berikutnya.
**penting**
Pialang instans tunggal sedang offline saat di-boot ulang. Untuk broker cluster, hanya satu node yang turun pada satu waktu sementara broker melakukan reboot.