UpdateCluster - Amazon MemoryDB

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

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

Anforderungssyntax

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

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ACLName

Die Zugriffskontrollliste, die dem Cluster zugeordnet ist

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1.

Pattern: [a-zA-Z][a-zA-Z0-9\-]*

Required: No

ClusterName

Der Name des zu aktualisierenden Clusters

Typ: Zeichenfolge

Erforderlich: Ja

Description

Die Beschreibung des zu aktualisierenden Clusters

Typ: Zeichenfolge

Required: No

EngineVersion

Die aktualisierte Version der Engine, die auf den Knoten ausgeführt werden soll. Sie können auf eine neuere Engine-Version upgraden. Sie können jedoch nicht zu einer früheren Engine-Version wechseln. Wenn Sie eine frühere Engine-Version verwenden möchten, müssen Sie den vorhandenen Cluster löschen und mit der früheren Engine-Version neu erstellen.

Typ: Zeichenfolge

Required: No

MaintenanceWindow

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

Required: No

NodeType

Ein gültiger Knotentyp, auf den Sie diesen Cluster nach oben oder unten skalieren möchten.

Typ: Zeichenfolge

Required: No

ParameterGroupName

Der Name der zu aktualisierenden Parameter-Gruppe

Typ: Zeichenfolge

Required: No

ReplicaConfiguration

Die Anzahl der Replikate, die sich in jedem Shard befinden werden

Typ: ReplicaConfigurationRequest Objekt

Required: No

SecurityGroupIds

Das SecurityGroupIds zu aktualisierende

Typ: Zeichenfolge-Array

Required: No

ShardConfiguration

Die Anzahl der Shards im Cluster

Typ: ShardConfigurationRequest Objekt

Required: No

SnapshotRetentionLimit

Die Anzahl der Tage, für MemoryDB automatische Cluster-Snapshots behält, bevor sie gelöscht werden. Wenn Sie zum Beispiel SnapshotRetentionLimit auf 5 festlegen, wird ein Snapshot, der heute gemacht wurde, 5 Tage behalten, bevor er gelöscht wird.

Typ: Ganzzahl

Required: No

SnapshotWindow

Der tägliche Zeitbereich (in UTC) innerhalb dessen MemoryDB beginnt, tägliche Snapshots Ihres Clusters zu erstellen.

Typ: Zeichenfolge

Required: No

SnsTopicArn

Das SNS-Thema-ARN soll aktualisiert werden

Typ: Zeichenfolge

Required: No

SnsTopicStatus

Der Status des Amazon SNS Benachrichtigungsthemas. Benachrichtigungen werden nur gesendet, wenn der Status aktiv ist.

Typ: Zeichenfolge

Erforderlich: Nein

Antwortsyntax

{ "Cluster": { "ACLName": "string", "ARN": "string", "AutoMinorVersionUpgrade": boolean, "AvailabilityMode": "string", "ClusterEndpoint": { "Address": "string", "Port": number }, "DataTiering": "string", "Description": "string", "EnginePatchVersion": "string", "EngineVersion": "string", "KmsKeyId": "string", "MaintenanceWindow": "string", "Name": "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

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

Der aktualisierte Cluster

Typ: Cluster Objekt

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

ACLNotFoundFault

HTTP Status Code: 400

ClusterNotFoundFault

HTTP Status Code: 400

ClusterQuotaForCustomerExceededFault

HTTP Status Code: 400

InvalidACLStateFault

HTTP Status Code: 400

InvalidClusterStateFault

HTTP Status Code: 400

InvalidKMSKeyFault

HTTP Status Code: 400

InvalidNodeStateFault

HTTP Status Code: 400

InvalidParameterCombinationException

HTTP Status Code: 400

InvalidParameterValueException

HTTP Status Code: 400

InvalidVPCNetworkStateFault

HTTP Status Code: 400

NodeQuotaForClusterExceededFault

HTTP Status Code: 400

NodeQuotaForCustomerExceededFault

HTTP Status Code: 400

NoOperationFault

HTTP Status Code: 400

ParameterGroupNotFoundFault

HTTP Status Code: 400

ServiceLinkedRoleNotFoundFault

HTTP Status Code: 400

ShardsPerClusterQuotaExceededFault

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: