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.
# Upgrade eines Amazon MQ-Broker-Instance-Typs
**Wichtig**
`mq.m7g.x`Instances sind nur für Amazon MQ für RabbitMQ-Broker verfügbar. Amazon MQ for ActiveMQ-Broker verwenden nur Instances. `mq.m5.x`
Die kombinierte Beschreibung der Broker-Instance-Klasse (`m7g`) und der Größe (`large`) wird als Broker-Instance-Typ bezeichnet (z. B.). `mq.m7g.large` Bei der Auswahl eines Instance-Typs ist es wichtig, Faktoren zu berücksichtigen, die sich auf die Leistung des Brokers auswirken:
+ die Anzahl der Clients und Warteschlangen
+ die Menge der gesendeten Nachrichten
+ Nachrichten, die im Speicher aufbewahrt werden
+ redundante Nachrichten
Kleinere Broker-Instance-Typen (`mq.m7g.medium`) werden nur zum Testen der Anwendungsleistung empfohlen. Wir empfehlen größere Broker-Instance-Typen (`mq.m7g.large `und höher) für die Produktion von Clients und Warteschlangen, hohen Durchsatz, Nachrichten im Speicher und redundante Nachrichten.
Wir empfehlen ein Upgrade auf einen größeren Instance-Typ (d. h. von `micro` bis`large`), wenn Sie Leistungsprobleme haben oder wenn Sie von einer Test- zu einer Produktionsumgebung wechseln. Um Ihren Instance-Typ zu aktualisieren, können Sie die AWS-Managementkonsole AWS CLI, oder die Amazon MQ MQ-API verwenden.
## AWS-Managementkonsole
**Gehen Sie wie folgt vor, um mithilfe der AWS-Managementkonsole auf einen größeren Instance-Typ umzusteigen:**
1. Melden Sie sich bei der [Amazon MQ-Konsole](https://console.aws.amazon.com/amazon-mq/) an.
1. Wählen Sie im linken Navigationsbereich die Option **Broker**, un dann in der Liste den Broker aus, den Sie upgraden möchten.
1. Klicken Sie auf der Seite Broker-Details auf **Edit**.
1. Wählen Sie unter **Spezifikationen** für **Broker-Instanztyp** den neuen Instanztyp aus der Dropdownliste aus.
1. Wählen Sie unten auf der Seite die Option **Änderungen planen** aus.
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 Amazon MQ das Upgrade während des nächsten geplanten Wartungsfensters abschließen soll.
+ Wählen Sie **Sofort**, wenn Sie den Broker neu starten und den Instance-Typ 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 den Instanztyp eines Brokers zu aktualisieren, verwenden Sie den AWS CLI**
1. Verwenden Sie den CLI-Befehl [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) und geben Sie die folgenden Parameter an, wie im Beispiel gezeigt.
+ `--broker-id` - Die eindeutige ID, die Amazon MQ für die Broker-Instance generiert.
+ `--host-instance-type`— Die Engine-Versionsnummer für die Broker-Engine, auf die das Upgrade durchgeführt wird.
```
aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
```
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 den Instance-Typ 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
**Um den Instance-Typ eines Brokers mithilfe der Amazon MQ MQ-API zu aktualisieren**
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 verfügbaren Amazon MQ MQ-Endpunkten finden Sie unter [Amazon MQ MQ-Endpunkte und](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) Kontingente 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}}
```
Geben Sie `host-instance-type` in der Payload der Anfrage den Instance-Typ an, auf den der Broker das Upgrade durchführen soll.
```
{
"host-instance-type": "{{host-instance-type}}"
}
```
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.