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.
CreateCluster
Erstellt einen Cluster. Auf allen Knoten im Cluster wird dieselbe protokollkonforme Engine-Software ausgeführt.
Anforderungssyntax
{
"ACLName": "string",
"AutoMinorVersionUpgrade": boolean,
"ClusterName": "string",
"DataTiering": boolean,
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"NodeType": "string",
"NumReplicasPerShard": number,
"NumShards": number,
"ParameterGroupName": "string",
"Port": number,
"SecurityGroupIds": [ "string" ],
"SnapshotArns": [ "string" ],
"SnapshotName": "string",
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SubnetGroupName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TLSEnabled": boolean
}Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.
Die Anfrage akzeptiert die folgenden Daten im Format. JSON
- ACLName
-
Der Name der Zugriffskontrollliste, die dem Cluster zugeordnet werden soll.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen.
Pattern:
[a-zA-Z][a-zA-Z0-9\-]*Erforderlich: Ja
- AutoMinorVersionUpgrade
-
Wenn dieser Wert auf „true“ gesetzt ist, erhält der Cluster nach dem Start automatisch kleinere Engine-Versionsupgrades.
Typ: Boolesch
Erforderlich: Nein
- ClusterName
-
Der Name des Clusters Dieser Wert muss eindeutig sein, da er auch als Cluster-ID dient.
Typ: Zeichenfolge
Erforderlich: Ja
- DataTiering
-
Ermöglicht Daten-Tiering. Daten-Tiering wird nur für Cluster mit R6gd-Knotentyp unterstützt. Dieser Parameter muss gesetzt werden, wenn R6GD-Knoten verwendet werden. Weitere Informationen finden Sie unter Daten-Tiering.
Typ: Boolesch
Erforderlich: Nein
- Description
-
Eine optionale Beschreibung des Clusters.
Typ: Zeichenfolge
Erforderlich: Nein
- Engine
-
Der Name der Engine, die für den Cluster verwendet werden soll.
Typ: Zeichenfolge
Erforderlich: Nein
- EngineVersion
-
Die Versionsnummer der OSS Redis-Engine, die für den Cluster verwendet werden soll.
Typ: Zeichenfolge
Erforderlich: Nein
- KmsKeyId
-
Die ID des KMS Schlüssels, der zur Verschlüsselung des Clusters verwendet wurde.
Typ: Zeichenfolge
Erforderlich: Nein
- MaintenanceWindow
-
Dies gibt den wöchentlichen Zeitraum, in dem die Wartung der Cluster ausgeführt wird. Sie wird als Bereich im Format ddd:hh24:mi-ddd:hh24:mi (24-Stunden-Uhr) angegeben. UTC Das minimale Wartungszeitfenster ist ein Zeitraum von 60 Minuten.
Gültige Werte für
dddsind:-
sun -
mon -
tue -
wed -
thu -
fri -
sat
Beispiel:
sun:23:00-mon:01:30Typ: Zeichenfolge
Erforderlich: Nein
-
- MultiRegionClusterName
-
Der Name des Clusters mit mehreren Regionen, der erstellt werden soll.
Typ: Zeichenfolge
Erforderlich: Nein
- NodeType
-
Die Rechen- und Speicherkapazität der Knoten im Cluster.
Typ: Zeichenfolge
Erforderlich: Ja
- NumReplicasPerShard
-
Die Anzahl der Replikate, die auf jeden Shard angewendet werden sollen. Der Standardwert lautet 1. Das Maximum ist 5.
Typ: Ganzzahl
Erforderlich: Nein
- NumShards
-
Die Anzahl der Shards, die der Cluster enthalten wird. Der Standardwert lautet 1.
Typ: Ganzzahl
Erforderlich: Nein
- ParameterGroupName
-
Der Name der Parametergruppe, die dem Cluster zugeordnet ist.
Typ: Zeichenfolge
Erforderlich: Nein
- Port
-
Die Portnummer, auf der jeder der Knoten Verbindungen akzeptiert.
Typ: Ganzzahl
Erforderlich: Nein
- SecurityGroupIds
-
Eine Liste der Sicherheitsgruppennamen, die diesem Cluster zugeordnet werden sollen.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
- SnapshotArns
-
Eine Liste von Amazon-Ressourcennamen (ARN), die die in Amazon S3 gespeicherten RDB Snapshot-Dateien eindeutig identifizieren. Die Snapshot-Dateien werden verwendet, um den neuen Cluster zu füllen. Der Amazon S3 S3-Objektname in der ARN darf keine Kommas enthalten.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
- SnapshotName
-
Der Name eines Snapshots, aus dem Daten im neuen Cluster wiederhergestellt werden sollen. Der Snapshot-Status ändert sich in Wiederherstellen, während der neue Cluster erstellt wird.
Typ: Zeichenfolge
Erforderlich: Nein
- SnapshotRetentionLimit
-
Die Anzahl der Tage, für die MemoryDB automatische Snapshots aufbewahrt, bevor sie gelöscht werden. Wenn Sie beispielsweise den Wert 5 festlegen SnapshotRetentionLimit , wird ein Snapshot, der heute aufgenommen wurde, für 5 Tage aufbewahrt, bevor er gelöscht wird.
Typ: Ganzzahl
Erforderlich: Nein
- SnapshotWindow
-
Der tägliche Zeitraum (inUTC), in dem MemoryDB beginnt, täglich einen Snapshot Ihres Shards zu erstellen.
Beispiel: 05:00-09:00
Wenn Sie diesen Parameter nicht angeben, wählt MemoryDB automatisch einen geeigneten Zeitraum.
Typ: Zeichenfolge
Erforderlich: Nein
- SnsTopicArn
-
Der Amazon-Ressourcenname (ARN) des Amazon Simple Notification Service (SNS) -Themas, an das Benachrichtigungen gesendet werden.
Typ: Zeichenfolge
Erforderlich: Nein
- SubnetGroupName
-
Der Name der Subnetzgruppe, die für den Cluster verwendet werden soll.
Typ: Zeichenfolge
Erforderlich: Nein
- Tags
-
Eine Liste von Tags, die dieser Ressource hinzugefügt werden sollen. Tags sind kommagetrennte Schlüssel/Werte-Paare (z.B. Key=myKey, Value=myKeyValue). Sie können mehrere Tags wie folgt hinzufügen: Key=myKey, Value= Key=, Value= myKeyValue Value. mySecondKey mySecondKey
Typ: Array von Tag-Objekten
Array-Mitglieder: Maximale Anzahl von 200 Elementen.
Erforderlich: Nein
- TLSEnabled
-
Ein Flag, um die Verschlüsselung bei der Übertragung auf dem Cluster zu aktivieren.
Typ: Boolesch
Erforderlich: Nein
Antwortsyntax
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "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 Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- ACLNotFoundFault
-
HTTPStatuscode: 400
- ClusterAlreadyExistsFault
-
HTTPStatuscode: 400
- ClusterQuotaForCustomerExceededFault
-
HTTPStatuscode: 400
- InsufficientClusterCapacityFault
-
HTTPStatuscode: 400
- InvalidACLStateFault
-
HTTPStatuscode: 400
- InvalidCredentialsException
-
HTTPStatuscode: 400
- InvalidMultiRegionClusterStateFault
-
Der angeforderte Vorgang kann auf dem Multiregion-Cluster in seinem aktuellen Status nicht ausgeführt werden.
HTTPStatuscode: 400
- InvalidParameterCombinationException
-
HTTPStatuscode: 400
- InvalidParameterValueException
-
HTTPStatuscode: 400
- InvalidVPCNetworkStateFault
-
HTTPStatuscode: 400
- MultiRegionClusterNotFoundFault
-
Der angegebene Cluster mit mehreren Regionen ist nicht vorhanden.
HTTPStatuscode: 400
- NodeQuotaForClusterExceededFault
-
HTTPStatuscode: 400
- NodeQuotaForCustomerExceededFault
-
HTTPStatuscode: 400
- ParameterGroupNotFoundFault
-
HTTPStatuscode: 400
- ServiceLinkedRoleNotFoundFault
-
HTTPStatuscode: 400
- ShardsPerClusterQuotaExceededFault
-
HTTPStatuscode: 400
- SubnetGroupNotFoundFault
-
HTTPStatuscode: 400
- TagQuotaPerResourceExceeded
-
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
