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.

# UpdateCluster
<a name="API_UpdateCluster"></a>

Ändert die Einstellungen für einen Cluster. Sie können diesen Vorgang verwenden, um eine oder mehrere Clusterkonfigurationseinstellungen zu ändern, indem Sie die Einstellungen und die neuen Werte angeben.

## Anforderungssyntax
<a name="API_UpdateCluster_RequestSyntax"></a>

```
{
   "ACLName": "string",
   "ClusterName": "string",
   "Description": "string",
   "Engine": "string",
   "EngineVersion": "string",
   "IpDiscovery": "string",
   "MaintenanceWindow": "string",
   "NodeType": "string",
   "ParameterGroupName": "string",
   "ReplicaConfiguration": { 
      "ReplicaCount": number
   },
   "SecurityGroupIds": [ "string" ],
   "ShardConfiguration": { 
      "ShardCount": number
   },
   "SnapshotRetentionLimit": number,
   "SnapshotWindow": "string",
   "SnsTopicArn": "string",
   "SnsTopicStatus": "string"
}
```

## Anforderungsparameter
<a name="API_UpdateCluster_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ACLName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ACLName"></a>
Die Zugriffskontrollliste, die dem Cluster zugeordnet ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen.  
Pattern: `[a-zA-Z][a-zA-Z0-9\-]*`   
Erforderlich: Nein

 ** [ClusterName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ClusterName"></a>
Der Name des zu aktualisierenden Clusters.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [Description](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Description"></a>
Die Beschreibung des zu aktualisierenden Clusters.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [Engine](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Engine"></a>
Der Name der Engine, die für den Cluster verwendet werden soll.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [EngineVersion](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-EngineVersion"></a>
Die aktualisierte Version der Engine, die auf den Knoten ausgeführt werden soll. Sie können ein Upgrade auf eine neuere Engine-Version durchführen, aber Sie können kein Downgrade auf eine frühere Engine-Version durchführen. Wenn Sie eine frühere Engine-Version verwenden möchten, müssen Sie den vorhandenen Cluster löschen und ihn mit der früheren Engine-Version neu erstellen.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [IpDiscovery](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-IpDiscovery"></a>
Der Mechanismus zum Ermitteln von IP-Adressen für das Cluster Discovery Protocol. Gültige Werte sind 'ipv4' oder 'ipv6'. Wenn diese Option auf 'ipv4' gesetzt ist, geben Clustererkennungsfunktionen wie Cluster-Steckplätze, Cluster-Shards und Clusterknoten Adressen für Clusterknoten zurück. IPv4 Wenn die Einstellung auf 'ipv6' gesetzt ist, geben die Clustererkennungsfunktionen IPv6 Adressen für Clusterknoten zurück. Der Wert muss mit dem NetworkType Parameter kompatibel sein. Wenn nicht angegeben, ist die Standardeinstellung 'ipv4'.  
Typ: Zeichenfolge  
Zulässige Werte: `ipv4 | ipv6`   
Erforderlich: Nein

 ** [MaintenanceWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-MaintenanceWindow"></a>
Dies gibt den wöchentlichen Zeitraum, in dem die Wartung der Cluster ausgeführt wird. Es wird als Bereich im Format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC) angegeben. Das minimale Wartungszeitfenster ist ein Zeitraum von 60 Minuten.  
Gültige Werte für `ddd` sind:  
+  `sun` 
+  `mon` 
+  `tue` 
+  `wed` 
+  `thu` 
+  `fri` 
+  `sat` 
Beispiel: `sun:23:00-mon:01:30`   
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [NodeType](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-NodeType"></a>
Ein gültiger Knotentyp, auf den Sie diesen Cluster hoch- oder herunterskalieren möchten.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [ParameterGroupName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ParameterGroupName"></a>
Der Name der zu aktualisierenden Parametergruppe.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [ReplicaConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ReplicaConfiguration"></a>
Die Anzahl der Replikate, die sich in jedem Shard befinden werden.  
Typ: [ReplicaConfigurationRequest](API_ReplicaConfigurationRequest.md) Objekt  
Erforderlich: Nein

 ** [SecurityGroupIds](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SecurityGroupIds"></a>
Die zu aktualisierenden SecurityGroupIds .  
Typ: Zeichenfolgen-Array  
Erforderlich: Nein

 ** [ShardConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ShardConfiguration"></a>
Die Anzahl der Shards im Cluster.  
Typ: [ShardConfigurationRequest](API_ShardConfigurationRequest.md) Objekt  
Erforderlich: Nein

 ** [SnapshotRetentionLimit](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotRetentionLimit"></a>
Die Anzahl der Tage, für die MemoryDB automatische Cluster-Snapshots aufbewahrt, bevor sie gelöscht werden. Wenn Sie beispielsweise den Wert SnapshotRetentionLimit auf 5 festlegen, wird ein Snapshot, der heute aufgenommen wurde, für 5 Tage aufbewahrt, bevor er gelöscht wird.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [SnapshotWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotWindow"></a>
Der tägliche Zeitraum (in UTC), in dem MemoryDB beginnt, täglich einen Snapshot Ihres Clusters zu erstellen.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [SnsTopicArn](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicArn"></a>
Das zu aktualisierende SNS-Thema ARN.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [SnsTopicStatus](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicStatus"></a>
Der Status des Amazon SNS SNS-Benachrichtigungsthemas. Benachrichtigungen werden nur gesendet, wenn der Status aktiv ist.  
Typ: Zeichenfolge  
Erforderlich: Nein

## Antwortsyntax
<a name="API_UpdateCluster_ResponseSyntax"></a>

```
{
   "Cluster": { 
      "ACLName": "string",
      "ARN": "string",
      "AutoMinorVersionUpgrade": boolean,
      "AvailabilityMode": "string",
      "ClusterEndpoint": { 
         "Address": "string",
         "Port": number
      },
      "DataTiering": "string",
      "Description": "string",
      "Engine": "string",
      "EnginePatchVersion": "string",
      "EngineVersion": "string",
      "IpDiscovery": "string",
      "KmsKeyId": "string",
      "MaintenanceWindow": "string",
      "MultiRegionClusterName": "string",
      "Name": "string",
      "NetworkType": "string",
      "NodeType": "string",
      "NumberOfShards": number,
      "ParameterGroupName": "string",
      "ParameterGroupStatus": "string",
      "PendingUpdates": { 
         "ACLs": { 
            "ACLToApply": "string"
         },
         "Resharding": { 
            "SlotMigration": { 
               "ProgressPercentage": number
            }
         },
         "ServiceUpdates": [ 
            { 
               "ServiceUpdateName": "string",
               "Status": "string"
            }
         ]
      },
      "SecurityGroups": [ 
         { 
            "SecurityGroupId": "string",
            "Status": "string"
         }
      ],
      "Shards": [ 
         { 
            "Name": "string",
            "Nodes": [ 
               { 
                  "AvailabilityZone": "string",
                  "CreateTime": number,
                  "Endpoint": { 
                     "Address": "string",
                     "Port": number
                  },
                  "Name": "string",
                  "Status": "string"
               }
            ],
            "NumberOfNodes": number,
            "Slots": "string",
            "Status": "string"
         }
      ],
      "SnapshotRetentionLimit": number,
      "SnapshotWindow": "string",
      "SnsTopicArn": "string",
      "SnsTopicStatus": "string",
      "Status": "string",
      "SubnetGroupName": "string",
      "TLSEnabled": boolean
   }
}
```

## Antwortelemente
<a name="API_UpdateCluster_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [Cluster](#API_UpdateCluster_ResponseSyntax) **   <a name="MemoryDB-UpdateCluster-response-Cluster"></a>
Der aktualisierte Cluster.  
Typ: [Cluster](API_Cluster.md) Objekt

## Fehler
<a name="API_UpdateCluster_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** ACLNotFoundFault **   
  
HTTP-Statuscode: 400

 ** ClusterNotFoundFault **   
  
HTTP-Statuscode: 400

 ** ClusterQuotaForCustomerExceededFault **   
  
HTTP-Statuscode: 400

 ** InvalidACLStateFault **   
  
HTTP-Statuscode: 400

 ** InvalidClusterStateFault **   
  
HTTP-Statuscode: 400

 ** InvalidKMSKeyFault **   
  
HTTP-Statuscode: 400

 ** InvalidNodeStateFault **   
  
HTTP-Statuscode: 400

 ** InvalidParameterCombinationException **   
  
HTTP-Statuscode: 400

 ** InvalidParameterValueException **   
  
HTTP-Statuscode: 400

 ** InvalidVPCNetworkStateFault **   
  
HTTP-Statuscode: 400

 ** NodeQuotaForClusterExceededFault **   
  
HTTP-Statuscode: 400

 ** NodeQuotaForCustomerExceededFault **   
  
HTTP-Statuscode: 400

 ** NoOperationFault **   
  
HTTP-Statuscode: 400

 ** ParameterGroupNotFoundFault **   
  
HTTP-Statuscode: 400

 ** ServiceLinkedRoleNotFoundFault **   
  
HTTP-Statuscode: 400

 ** ShardsPerClusterQuotaExceededFault **   
  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_UpdateCluster_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/UpdateCluster)