Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Aktualisieren einer Amazon MQ-Broker-Engine-Version
Amazon MQ stellt regelmäßig neue Broker-Engine-Versionen für alle unterstützten Broker-Engine-Typen bereit. Neue Engine-Versionen beinhalten Sicherheitspatches, Bugfixes und andere Verbesserungen der Broker-Engine.
Amazon MQ organisiert Versionsnummern gemäß der semantischen Versionsspezifikation als. `X.Y.Z` `X`Bezeichnet in Amazon MQ MQ-Implementierungen die Hauptversion, `Y` steht für die Nebenversion und `Z` gibt die Patch-Versionsnummer an. Amazon MQ unterstützt zwei Arten von Upgrades:
+ **Hauptversions-Upgrade**: Tritt auf, wenn sich die Versionsnummern der Haupt-Engine ändern. Beispielsweise wird ein Upgrade von RabbitMQ Version **3.13** auf Version **4.2** als Hauptversions-Upgrade betrachtet.
+ **Unterversion-Upgrade**: Tritt auf, wenn sich nur die Versionsnummer der Neben-Engine ändert. Zum Beispiel ein Upgrade von Version 3. **11** auf Version 3. **12** wird als geringfügiges Versionsupgrade betrachtet.
Sie können Ihren Broker jederzeit manuell auf die nächste unterstützte Haupt- oder Nebenversion aktualisieren. Amazon MQ verwaltet das Upgrade auf die neueste unterstützte Patch-Version für alle Broker während des geplanten [Wartungsfensters.](maintaining-brokers.md) Sowohl manuelle als auch automatische Versionsupgrades erfolgen während des geplanten Wartungsfensters oder nach dem [Neustart Ihres Brokers](amazon-mq-rebooting-broker.md). Amazon MQ aktualisiert Ihren Broker auf die nächste Nebenversion, wenn der Support für die aktuelle Nebenversion ausläuft.
## Manuelles Upgraden der Engine-Version
Sie können die Engine-Version eines Brokers mithilfe der AWS-Managementkonsole, der oder der AWS CLI Amazon MQ MQ-API aktualisieren.
### AWS-Managementkonsole
**Um die Engine-Version eines Brokers zu aktualisieren, verwenden Sie den AWS-Managementkonsole**
1. Klicken Sie auf der Seite Broker-Details auf **Edit**.
1. UNDER**Technische Daten**, für**-Broker-Engine-Version**Wählen Sie in der Dropdown-Liste die neue Versionsnummer .
1. Scrollen Sie ans Seitenende und wählen Sie**Änderungen im Zeitplan**.
1. Klicken Sie auf der**Änderungen für Broker**-Seite, für**Wann Änderungen angewendet werden**Wählen Sie eine der folgenden Optionen .
+ Wählen Sie **Nach dem nächsten Neustart**, wenn Sie möchten, dass Amazon MQ das Versions-Upgrade während des nächsten geplanten Wartungsfensters abschliesst.
+ Wählen Sie **Sofort**, wenn Sie den Broker neu starten und die Engine-Version sofort aktualisieren möchten.
**Wichtig**
Single-Instance-Broker sind während des Neustarts offline. Bei Cluster-Brokern ist jeweils nur ein Knoten ausgefallen, während der Broker neu gestartet wird.
1. Wählen Sie **Anwenden**, um die Anwendung der Änderungen abzuschließen.
### AWS CLI
**Um die Engine-Version eines Brokers zu aktualisieren, verwenden Sie AWS CLI**
1. Verwenden Sie den [Update-Broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html)-CLI-Befehl und spezifizieren Sie die folgenden Parameter wie im Beispiel dargestellt an.
+ `--broker-id` - Die eindeutige ID, die Amazon MQ für die Broker-Instance generiert. Sie können die ID von Ihrem Broker ARN analysieren. Beispielsweise angesichts der folgenden ARN,`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, wäre die Broker-ID`b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`.
+ `--engine-version`— Die Engine-Versionsnummer für die Broker-Engine, auf die das Upgrade durchgeführt wird.
```
aws mq update-broker --broker-id {{broker-id}} --engine-version {{version-number}}
```
1. (Optional) Verwenden Sie den CLI-Befehl [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html), um Ihren Broker neu zu starten, wenn Sie die Engine-Version sofort aktualisieren möchten.
```
aws mq reboot-broker --broker-id {{broker-id}}
```
Wenn Sie Ihren Broker nicht neu starten und die Änderungen sofort anwenden möchten, aktualisiert Amazon MQ den Broker während des nächsten geplanten Wartungsfensters.
**Wichtig**
Single-Instance-Broker sind während des Neustarts offline. Bei Cluster-Brokern ist jeweils nur ein Knoten ausgefallen, während der Broker neu gestartet wird.
### Amazon MQ-API
**So upgraden Sie die Engine-Version eines Brokers über die Amazon MQ-API:**
1. Verwenden Sie die API-Operation [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker). Geben Sie `broker-id` an als Pfadparameter. In den folgenden Beispielen wird von einem Broker in der `us-west-2`Region ausgegangen. Weitere Informationen zu den verfügbaren Amazon-MQ-Endpunkten finden Sie unter [Amazon-MQ-Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) in der *Allgemeine AWS-Referenz*
```
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}}
```
Verwenden Sie `engineVersion` in der Anforderungs-Nutzlast, um die Versionsnummer für den Broker anzugeben, auf den ein Upgrade durchgeführt werden soll.
```
{
"engineVersion": "{{engine-version-number}}"
}
```
1. (Optional) Verwenden Sie den [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API-Vorgang, um Ihren Broker neu zu starten, wenn Sie die Engine-Version sofort aktualisieren möchten. `broker-id`ist als Pfadparameter angegeben.
```
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}}
```
Wenn Sie Ihren Broker nicht neu starten und die Änderungen sofort anwenden möchten, aktualisiert Amazon MQ den Broker während des nächsten geplanten Wartungsfensters.
**Wichtig**
Single-Instance-Broker sind während des Neustarts offline. Bei Cluster-Brokern ist jeweils nur ein Knoten ausgefallen, während der Broker neu gestartet wird.