Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
CreateCluster
Créez un cluster. Tous les nœuds du cluster exécutent le même logiciel moteur conforme au protocole.
Syntaxe de la requête
{
"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
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- ACLName
-
Nom de la liste de contrôle d'accès à associer au cluster.
Type : String
Contraintes de longueur : longueur minimum de 1.
Modèle :
[a-zA-Z][a-zA-Z0-9\-]*Obligatoire : oui
- AutoMinorVersionUpgrade
-
Lorsqu'il est défini sur true, le cluster reçoit automatiquement les mises à niveau mineures des versions du moteur après le lancement.
Type : booléen
Obligatoire : non
- ClusterName
-
Nom du cluster. Cette valeur doit être unique car elle sert également d'identifiant de cluster.
Type : String
Obligatoire : oui
- DataTiering
-
Active la hiérarchisation des données. La hiérarchisation des données n'est prise en charge que pour les clusters utilisant le type de nœud r6gd. Ce paramètre doit être défini lors de l'utilisation de nœuds r6gd. Pour plus d’informations, consultez la rubrique Hiérarchisation des données.
Type : booléen
Obligatoire : non
- Description
-
Description facultative du cluster.
Type : chaîne
Obligatoire : non
- Engine
-
Nom du moteur à utiliser pour le cluster.
Type : chaîne
Obligatoire : non
- EngineVersion
-
Numéro de version du moteur Redis OSS à utiliser pour le cluster.
Type : chaîne
Obligatoire : non
- KmsKeyId
-
ID de la clé KMS utilisée pour chiffrer le cluster.
Type : chaîne
Obligatoire : non
- MaintenanceWindow
-
Indique la plage de temps hebdomadaire au cours de laquelle la maintenance sur le cluster est effectuée. Elle est spécifiée en tant que plage au format jjj:hh24:mi-jjjj:hh24:mi (24 H UTC). La fenêtre de maintenance minimale est une période de 60 minutes.
Les valeurs valides pour
dddsont :-
sun -
mon -
tue -
wed -
thu -
fri -
sat
Exemple :
sun:23:00-mon:01:30Type : chaîne
Obligatoire : non
-
- MultiRegionClusterName
-
Nom du cluster multirégional à créer.
Type : chaîne
Obligatoire : non
- NodeType
-
La capacité de calcul et de mémoire des nœuds du cluster.
Type : String
Obligatoire : oui
- NumReplicasPerShard
-
Le nombre de réplicas à appliquer à chaque partition. La valeur par défaut est 1. Le maximum est de 5.
Type : entier
Obligatoire : non
- NumShards
-
Le nombre de partitions que le cluster contiendra. La valeur par défaut est 1.
Type : entier
Obligatoire : non
- ParameterGroupName
-
Nom du groupe de paramètres associé au cluster.
Type : chaîne
Obligatoire : non
- Port
-
Le numéro de port sur lequel chacun des nœuds accepte les connexions.
Type : entier
Obligatoire : non
- SecurityGroupIds
-
Liste de noms de groupe de sécurité à associer à ce cluster.
Type : tableau de chaînes
Obligatoire : non
- SnapshotArns
-
Une liste de noms Amazon Resource Name (ARN) qui identifient de façon unique les fichiers d'instantané RDB stockés dans Amazon S3. Les fichiers de capture d'écran sont utilisés pour remplir le nouveau cluster. Le nom de l'objet Amazon S3 dans l'ARN ne peut pas contenir de virgules.
Type : tableau de chaînes
Obligatoire : non
- SnapshotName
-
Nom d'un instantané à partir duquel restaurer les données dans le nouveau cluster. L'état du snapshot passe à la restauration lors de la création du nouveau cluster.
Type : chaîne
Obligatoire : non
- SnapshotRetentionLimit
-
Nombre de jours pendant lesquels MemoryDB conserve les instantanés automatiques avant de les supprimer. Par exemple, si vous définissez SnapshotRetentionLimit la valeur 5, un instantané pris aujourd'hui est conservé pendant 5 jours avant d'être supprimé.
Type : entier
Obligatoire : non
- SnapshotWindow
-
La plage horaire quotidienne (en UTC) pendant laquelle MemoryDB commence à prendre un instantané quotidien de votre partition.
Exemple : 05:00-09:00
Si vous ne spécifiez pas ce paramètre, MemoryDB choisit automatiquement une plage de temps appropriée.
Type : chaîne
Obligatoire : non
- SnsTopicArn
-
L'Amazon Resource Name (ARN) de la rubrique Amazon Simple Notification Service (SNS) à laquelle les notifications sont envoyées.
Type : chaîne
Obligatoire : non
- SubnetGroupName
-
Le nom du groupe de sous-réseaux à utiliser pour le cluster.
Type : chaîne
Obligatoire : non
- Tags
-
Liste des balises à ajouter à cette ressource. Les balises sont des paires clé et valeur séparées par des virgules (par exemple Key=MyKey, Value=). myKeyValue Vous pouvez inclure plusieurs balises comme indiqué ci-dessous : Key=MyKey, Value= Key=, Value= myKeyValue Value. mySecondKey mySecondKey
Type : tableau d’objets Tag
Membres du tableau : nombre maximum de 200 éléments.
Obligatoire : non
- TLSEnabled
-
Indicateur permettant d'activer le chiffrement en transit sur le cluster.
Type : booléen
Obligatoire : non
Syntaxe de la réponse
{
"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
}
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- ACLNotFoundFault
-
Code d’état HTTP : 400
- ClusterAlreadyExistsFault
-
Code d’état HTTP : 400
- ClusterQuotaForCustomerExceededFault
-
Code d’état HTTP : 400
- InsufficientClusterCapacityFault
-
Code d’état HTTP : 400
- InvalidACLStateFault
-
Code d’état HTTP : 400
- InvalidCredentialsException
-
Code d’état HTTP : 400
- InvalidMultiRegionClusterStateFault
-
L'opération demandée ne peut pas être effectuée sur le cluster multirégional dans son état actuel.
Code d’état HTTP : 400
- InvalidParameterCombinationException
-
Code d’état HTTP : 400
- InvalidParameterValueException
-
Code d’état HTTP : 400
- InvalidVPCNetworkStateFault
-
Code d’état HTTP : 400
- MultiRegionClusterNotFoundFault
-
Le cluster multirégional spécifié n'existe pas.
Code d’état HTTP : 400
- NodeQuotaForClusterExceededFault
-
Code d’état HTTP : 400
- NodeQuotaForCustomerExceededFault
-
Code d’état HTTP : 400
- ParameterGroupNotFoundFault
-
Code d’état HTTP : 400
- ServiceLinkedRoleNotFoundFault
-
Code d’état HTTP : 400
- ShardsPerClusterQuotaExceededFault
-
Code d’état HTTP : 400
- SubnetGroupNotFoundFault
-
Code d’état HTTP : 400
- TagQuotaPerResourceExceeded
-
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
