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
<a name="API_CreateCluster"></a>

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
<a name="API_CreateCluster_RequestSyntax"></a>

```
{
   "ACLName": "string",
   "AutoMinorVersionUpgrade": boolean,
   "ClusterName": "string",
   "DataTiering": boolean,
   "Description": "string",
   "Engine": "string",
   "EngineVersion": "string",
   "IpDiscovery": "string",
   "KmsKeyId": "string",
   "MaintenanceWindow": "string",
   "MultiRegionClusterName": "string",
   "NetworkType": "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
<a name="API_CreateCluster_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [ACLName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ACLName"></a>
Nom de la liste de contrôle d'accès à associer au cluster.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1.  
Modèle : `[a-zA-Z][a-zA-Z0-9\-]*`   
Obligatoire : oui

 ** [AutoMinorVersionUpgrade](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-AutoMinorVersionUpgrade"></a>
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](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ClusterName"></a>
Nom du cluster. Cette valeur doit être unique car elle sert également d'identifiant de cluster. Cette valeur est stockée sous la forme d’une chaîne en minuscules.  
Type : Chaîne  
Obligatoire : oui

 ** [DataTiering](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-DataTiering"></a>
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](https://docs.aws.amazon.com/memorydb/latest/devguide/data-tiering.html).  
Type : booléen  
Obligatoire : non

 ** [Description](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Description"></a>
Description facultative du cluster.  
Type : chaîne  
Obligatoire : non

 ** [Engine](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Engine"></a>
Nom du moteur à utiliser pour le cluster.  
Type : chaîne  
Obligatoire : non

 ** [EngineVersion](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-EngineVersion"></a>
Numéro de version du moteur Redis OSS à utiliser pour le cluster.  
Type : chaîne  
Obligatoire : non

 ** [IpDiscovery](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-IpDiscovery"></a>
Le mécanisme de découverte des adresses IP pour le protocole de découverte du cluster. Les valeurs valides sont « ipv4 » ou « ipv6 ». Lorsqu'elles sont définies sur « ipv4 », les fonctions de découverte de clusters telles que les emplacements de cluster, les partitions de cluster et les nœuds de cluster renvoient les IPv4 adresses des nœuds de cluster. Lorsqu'elles sont définies sur « ipv6 », les fonctions de découverte du cluster renvoient IPv6 les adresses des nœuds du cluster. La valeur doit être compatible avec le NetworkType paramètre. Si ce n'est pas spécifié, la valeur par défaut est « ipv4 ».  
Type : Chaîne  
Valeurs valides : `ipv4 | ipv6`   
Obligatoire : non

 ** [KmsKeyId](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-KmsKeyId"></a>
ID de la clé KMS utilisée pour chiffrer le cluster.  
Type : chaîne  
Obligatoire : non

 ** [MaintenanceWindow](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-MaintenanceWindow"></a>
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 `ddd` sont :  
+  `sun` 
+  `mon` 
+  `tue` 
+  `wed` 
+  `thu` 
+  `fri` 
+  `sat` 
Exemple : `sun:23:00-mon:01:30`   
Type : chaîne  
Obligatoire : non

 ** [MultiRegionClusterName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-MultiRegionClusterName"></a>
Nom du cluster multirégional à créer.  
Type : chaîne  
Obligatoire : non

 ** [NetworkType](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NetworkType"></a>
Spécifie le type d'adresse IP du cluster. Les valeurs valides sont « ipv4 », « ipv6 » ou « dual\$1stack ». Lorsqu'il est défini sur « ipv4 », le cluster ne sera accessible que via IPv4 des adresses. Lorsqu'il est défini sur « ipv6 », le cluster ne sera accessible que via IPv6 des adresses. Lorsqu'il est défini sur « dual\$1stack », le cluster sera accessible via les deux IPv4 adresses. IPv6 Si ce n'est pas spécifié, la valeur par défaut est « ipv4 ».  
Type : Chaîne  
Valeurs valides : `ipv4 | ipv6 | dual_stack`   
Obligatoire : non

 ** [NodeType](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NodeType"></a>
La capacité de calcul et de mémoire des nœuds du cluster.  
Type : Chaîne  
Obligatoire : oui

 ** [NumReplicasPerShard](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NumReplicasPerShard"></a>
Le nombre de réplicas à appliquer à chaque partition. La valeur par défaut est 1. Le maximum est de 5.   
Type : Integer  
Obligatoire : non

 ** [NumShards](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NumShards"></a>
Le nombre de partitions que le cluster contiendra. La valeur par défaut est 1.   
Type : Integer  
Obligatoire : non

 ** [ParameterGroupName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ParameterGroupName"></a>
Nom du groupe de paramètres associé au cluster.  
Type : chaîne  
Obligatoire : non

 ** [Port](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Port"></a>
Numéro de port sur lequel chacun des nœuds accepte les connexions.  
Type : Integer  
Obligatoire : non

 ** [SecurityGroupIds](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SecurityGroupIds"></a>
Liste de noms de groupe de sécurité à associer à ce cluster.  
Type : tableau de chaînes  
Obligatoire : non

 ** [SnapshotArns](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotArns"></a>
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](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotName"></a>
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](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotRetentionLimit"></a>
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 : Integer  
Obligatoire : non

 ** [SnapshotWindow](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotWindow"></a>
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](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnsTopicArn"></a>
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](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SubnetGroupName"></a>
Le nom du groupe de sous-réseaux à utiliser pour le cluster.  
Type : chaîne  
Obligatoire : non

 ** [Tags](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Tags"></a>
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](API_Tag.md)  
Membres du tableau : nombre maximum de 200 éléments.  
Obligatoire : non

 ** [TLSEnabled](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-TLSEnabled"></a>
Indicateur permettant d'activer le chiffrement en transit sur le cluster.  
Type : booléen  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateCluster_ResponseSyntax"></a>

```
{
   "Cluster": { 
      "ACLName": "string",
      "ARN": "string",
      "AutoMinorVersionUpgrade": boolean,
      "AvailabilityMode": "string",
      "ClusterEndpoint": { 
         "Address": "string",
         "Port": number
      },
      "DataTiering": "string",
      "Description": "string",
      "Engine": "string",
      "EnginePatchVersion": "string",
      "EngineVersion": "string",
      "IpDiscovery": "string",
      "KmsKeyId": "string",
      "MaintenanceWindow": "string",
      "MultiRegionClusterName": "string",
      "Name": "string",
      "NetworkType": "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
<a name="API_CreateCluster_ResponseElements"></a>

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.

 ** [Cluster](#API_CreateCluster_ResponseSyntax) **   <a name="MemoryDB-CreateCluster-response-Cluster"></a>
Le cluster nouvellement créé.  
Type : objet [Cluster](API_Cluster.md)

## Erreurs
<a name="API_CreateCluster_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** 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

## Voir aussi
<a name="API_CreateCluster_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CreateCluster)