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_elastic_UpdateCluster"></a>

Ändert einen elastischen Cluster. Dazu gehören die Aktualisierung von Admin-Benutzername/Passwort, die Aktualisierung der API-Version und die Einrichtung eines Backup-Fensters und eines Wartungsfensters

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

```
PUT /cluster/clusterArn HTTP/1.1
Content-type: application/json

{
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "vpcSecurityGroupIds": [ "string" ]
}
```

## URI-Anfrageparameter
<a name="API_elastic_UpdateCluster_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [clusterArn](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-uri-clusterArn"></a>
Die ARN-ID des elastischen Clusters.  
Erforderlich: Ja

## Anforderungstext
<a name="API_elastic_UpdateCluster_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [adminUserPassword](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-adminUserPassword"></a>
Das dem Elastic Cluster-Administrator zugeordnete Passwort. Dieses Passwort kann alle druckbaren ASCII-Zeichen, außer Schrägstrich (/), doppeltes Anführungszeichen (") oder das "At"-Zeichen (@), enthalten.  
 *Einschränkungen*: Muss zwischen 8 und 100 Zeichen enthalten.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [authType](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-authType"></a>
Der Authentifizierungstyp, der verwendet wird, um zu bestimmen, wo das für den Zugriff auf den Elastic Cluster verwendete Passwort abgerufen werden soll. Gültige Typen sind `PLAIN_TEXT` oder`SECRET_ARN`.  
Typ: Zeichenfolge  
Zulässige Werte: `PLAIN_TEXT | SECRET_ARN`   
Erforderlich: Nein

 ** [backupRetentionPeriod](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-backupRetentionPeriod"></a>
Die Anzahl der Tage, für die automatische Snapshots aufbewahrt werden.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [clientToken](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-clientToken"></a>
Das Client-Token für den Elastic Cluster.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [preferredBackupWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredBackupWindow"></a>
Der tägliche Zeitraum, in dem automatische Backups erstellt werden, wenn automatische Backups aktiviert sind, wie durch den festgelegt`backupRetentionPeriod`.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [preferredMaintenanceWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredMaintenanceWindow"></a>
Der wöchentliche Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time).  
 *Format*: `ddd:hh24:mi-ddd:hh24:mi`   
 *Standard*: Ein 30-Minuten-Fenster, das nach dem Zufallsprinzip aus einem Zeitblock von jeweils AWS-Region 8 Stunden ausgewählt wird und an einem zufälligen Wochentag stattfindet.  
 *Gültige Tage*: Mo, Di, Mi, Do, Fr, Sa, So  
 *Einschränkungen*: mindestens 30-Minuten-Zeitfenster.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [shardCapacity](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCapacity"></a>
Die Anzahl von v, die jedem elastischen Cluster-Shard CPUs zugewiesen ist. Das Maximum ist 64. Zulässige Werte sind 2, 4, 8, 16, 32, 64.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [shardCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCount"></a>
Die Anzahl der Shards, die dem elastischen Cluster zugewiesen sind. Das Maximum ist 32.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [shardInstanceCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardInstanceCount"></a>
Die Anzahl der Replikatinstanzen, die für alle Shards im Elastic Cluster gelten. Ein `shardInstanceCount` Wert von 1 bedeutet, dass es eine Writer-Instance gibt, und alle weiteren Instances sind Replikate, die für Lesevorgänge und zur Verbesserung der Verfügbarkeit verwendet werden können.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [subnetIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-subnetIds"></a>
Das Amazon EC2-Subnetz IDs für den Elastic Cluster.  
Typ: Zeichenfolgen-Array  
Erforderlich: Nein

 ** [vpcSecurityGroupIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-vpcSecurityGroupIds"></a>
Eine Liste von EC2-VPC-Sicherheitsgruppen, die dem Elastic Cluster zugeordnet werden sollen.  
Typ: Zeichenfolgen-Array  
Erforderlich: Nein

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

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Antwortelemente
<a name="API_elastic_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_elastic_UpdateCluster_ResponseSyntax) **   <a name="documentdb-elastic_UpdateCluster-response-cluster"></a>
Gibt Informationen über den aktualisierten Elastic Cluster zurück.  
Typ: [Cluster](API_elastic_Cluster.md) Objekt

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

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

 ** AccessDeniedException **   
Eine Ausnahme, die auftritt, wenn nicht genügend Berechtigungen zum Ausführen einer Aktion vorhanden sind.    
 ** message **   
Eine Fehlermeldung, die erklärt, warum der Zugriff verweigert wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Es gab einen Zugriffskonflikt.    
 ** resourceId **   
Die ID der Ressource, bei der ein Zugriffskonflikt aufgetreten ist.  
 ** resourceType **   
Der Typ der Ressource, bei der ein Zugriffskonflikt aufgetreten ist.
HTTP-Statuscode: 409

 ** InternalServerException **   
Es ist ein interner Serverfehler aufgetreten.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Die angegebene Ressource konnte nicht gefunden werden.    
 ** message **   
Eine Fehlermeldung, die den Fehler beschreibt.  
 ** resourceId **   
Die ID der Ressource, die nicht gefunden werden konnte.  
 ** resourceType **   
Der Typ der Ressource, die nicht gefunden werden konnte.
HTTP-Statuscode: 404

 ** ThrottlingException **   
ThrottlingException wird ausgelöst, wenn die Anfrage aufgrund einer Anforderungsdrosselung abgelehnt wurde.    
 ** retryAfterSeconds **   
Die Anzahl der Sekunden, die gewartet werden muss, bevor der Vorgang erneut versucht wird.
HTTP-Statuscode: 429

 ** ValidationException **   
Eine Struktur, die eine Validierungsausnahme definiert.    
 ** fieldList **   
Eine Liste der Felder, in denen die Validierungsausnahme aufgetreten ist.  
 ** message **   
Eine Fehlermeldung, die die Validierungsausnahme beschreibt.  
 ** reason **   
Der Grund, warum die Validierungsausnahme aufgetreten ist (einer von `unknownOperation` `cannotParse``fieldValidationFailed`,, oder`other`).
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_elastic_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/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/UpdateCluster)