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 Sie die Konfiguration eines Amazon MSK-Clusters
Um die Konfiguration eines Clusters aktualisieren zu können, sorgen Sie dafür, dass sich der Cluster im Status `ACTIVE` befindet. Sie müssen außerdem sicherstellen, dass die Anzahl der Partitionen pro Broker in Ihrem MSK-Cluster unter den in [Passen Sie die Größe Ihres Clusters an: Anzahl der Partitionen pro Standard-Broker](bestpractices.md#partitions-per-broker) beschriebenen Grenzwerten liegt. Sie können die Konfiguration eines Clusters, der diese Grenzwerte überschreitet, nicht aktualisieren.
Informationen zur MSK-Konfiguration, einschließlich der Erstellung einer benutzerdefinierten Konfiguration, der Eigenschaften, die Sie aktualisieren können, und was passiert, wenn Sie die Konfiguration eines vorhandenen Clusters aktualisieren, finden Sie unter [Bereitgestellte Amazon MSK-Konfiguration](msk-configuration.md).
**Topics**
+ [Verfügbarkeit des Brokers bei Konfigurationsupdates](#update-config-cluster-availability)
+ [Aktualisierung der Konfiguration eines Clusters mithilfe des AWS CLI](#update-config-cli)
+ [Aktualisieren Sie die Konfiguration eines Amazon MSK-Clusters mithilfe der API](#update-config-api)
## Verfügbarkeit des Brokers bei Konfigurationsupdates
Amazon MSK gewährleistet während der meisten Updates der Cluster-Konfiguration eine hohe Verfügbarkeit. Amazon MSK führt ein fortlaufendes Update durch, bei dem jeweils ein Broker aktualisiert wird. Während dieses Vorgangs bleibt der Cluster verfügbar, obwohl einzelne Broker neu gestartet werden, sobald ihre Konfigurationen aktualisiert werden. Bei einigen Konfigurationsänderungen müssen jedoch möglicherweise alle Broker gleichzeitig aktualisiert werden, was zu einem kurzen clusterweiten Ausfall führen kann. Weitere Informationen zu den Auswirkungen auf die Verfügbarkeit von Brokern bei Updates finden Sie unter. [Bereitgestellte Amazon MSK-Konfiguration](msk-configuration.md)
Bevor Sie Produktionscluster aktualisieren, empfehlen wir Ihnen, Ihre Konfigurationsänderungen in einer Umgebung außerhalb der Produktionsumgebung zu testen und Updates während Ihrer Wartungsfenster zu planen.
Wenn beim Upgrade Ihres MSK-Clusters Probleme auftreten, finden Sie weitere Informationen unter [Wie behebe ich Probleme beim Upgrade meines Amazon MSK-Clusters](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues)?
## Aktualisierung der Konfiguration eines Clusters mithilfe des AWS CLI
1. Kopieren Sie das folgende JSON und speichern Sie es in einer Datei. Benennen Sie die Datei `configuration-info.json`. *ConfigurationArn*Ersetzen Sie durch den Amazon-Ressourcennamen (ARN) der Konfiguration, die Sie für die Aktualisierung des Clusters verwenden möchten. Die ARN-Zeichenfolge muss in Anführungszeichen im folgenden JSON erfolgen.
*Configuration-Revision*Ersetzen Sie durch die Version der Konfiguration, die Sie verwenden möchten. Konfigurationsrevisionen sind Ganzzahlen, die bei `1` beginnen. Diese Ganzzahl darf im folgenden JSON nicht von Anführungszeichen umgeben sein.
```
{
"Arn": ConfigurationArn,
"Revision": Configuration-Revision
}
```
1. Führen Sie den folgenden Befehl aus und *ClusterArn* ersetzen Sie ihn durch den ARN, den Sie bei der Erstellung Ihres Clusters erhalten haben. Wenn Ihnen der ARN für Ihren Cluster nicht vorliegt, finden Sie ihn, indem Sie alle Cluster auflisten. Weitere Informationen finden Sie unter [Amazon MSK-Cluster auflisten](msk-list-clusters.md).
*Path-to-Config-Info-File*Ersetzen Sie durch den Pfad zu Ihrer Konfigurationsinformationsdatei. Wenn Sie der Datei, die Sie im vorherigen Schritt erstellt `configuration-info.json` und im aktuellen Verzeichnis gespeichert haben, einen Namen gegeben haben, dann *Path-to-Config-Info-File* ist es`configuration-info.json`.
*Current-Cluster-Version*Durch die aktuelle Version des Clusters ersetzen.
**Wichtig**
Cluster-Versionen sind keine einfachen Ganzzahlen. Verwenden Sie den Befehl [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operation oder [describe-cluster, um die aktuelle Version des Clusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI zu finden. `KTVPDKIKX0DER` ist ein Beispiel für eine Version.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Nachfolgend finden Sie ein Beispiel für der Verwendung dieses Befehls.
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
Die Ausgabe dieses `update-cluster-configuration`-Befehls sieht wie das folgende JSON-Beispiel aus.
```
{
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}
```
1. Um das Ergebnis des `update-cluster-configuration` Vorgangs zu erhalten, führen Sie den folgenden Befehl aus und *ClusterOperationArn* ersetzen Sie ihn durch den ARN, den Sie in der Ausgabe des `update-cluster-configuration` Befehls erhalten haben.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
Die Ausgabe dieses `describe-cluster-operation`-Befehls sieht wie das folgende JSON-Beispiel aus.
```
{
"ClusterOperationInfo": {
"ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"CreationTime": "2019-06-20T21:08:57.735Z",
"OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
"OperationState": "UPDATE_COMPLETE",
"OperationType": "UPDATE_CLUSTER_CONFIGURATION",
"SourceClusterInfo": {},
"TargetClusterInfo": {
"ConfigurationInfo": {
"Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
"Revision": 1
}
}
}
}
```
In dieser Ausgabe hat `OperationType` den Wert „`UPDATE_CLUSTER_CONFIGURATION`“. Wenn `OperationState` den Wert „`UPDATE_IN_PROGRESS`“ aufweist, warten Sie eine Weile, bevor Sie den `describe-cluster-operation`-Befehl erneut ausführen.
## Aktualisieren Sie die Konfiguration eines Amazon MSK-Clusters mithilfe der API
Informationen zur Verwendung der API zur Aktualisierung der Konfiguration eines Amazon MSK-Clusters finden Sie unter [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration).