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.
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: