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.

# CreateMultiRegionCluster
<a name="API_CreateMultiRegionCluster"></a>

Crée un nouveau cluster multirégional.

## Syntaxe de la requête
<a name="API_CreateMultiRegionCluster_RequestSyntax"></a>

```
{
   "Description": "string",
   "Engine": "string",
   "EngineVersion": "string",
   "MultiRegionClusterNameSuffix": "string",
   "MultiRegionParameterGroupName": "string",
   "NodeType": "string",
   "NumShards": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TLSEnabled": boolean
}
```

## Paramètres de demande
<a name="API_CreateMultiRegionCluster_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.

 ** [Description](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-Description"></a>
Description du cluster multirégional.  
Type : chaîne  
Obligatoire : non

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

 ** [EngineVersion](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-EngineVersion"></a>
Version du moteur à utiliser pour le cluster multirégional.  
Type : chaîne  
Obligatoire : non

 ** [MultiRegionClusterNameSuffix](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-MultiRegionClusterNameSuffix"></a>
Suffixe à ajouter au nom du cluster multirégional. Amazon MemoryDB applique automatiquement un préfixe au nom du cluster multirégional lors de sa création. Chaque région Amazon possède son propre préfixe. Par exemple, le nom d'un cluster multirégional créé dans la région US-West-1 commencera par « virxk », avec le nom du suffixe que vous fournissez. Le suffixe garantit l'unicité du nom du cluster multirégional dans plusieurs régions. Cette valeur est stockée sous la forme d’une chaîne en minuscules.  
Type : Chaîne  
Obligatoire : oui

 ** [MultiRegionParameterGroupName](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-MultiRegionParameterGroupName"></a>
Nom du groupe de paramètres multirégional à associer au cluster.  
Type : chaîne  
Obligatoire : non

 ** [NodeType](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-NodeType"></a>
Type de nœud à utiliser pour le cluster multirégional.  
Type : Chaîne  
Obligatoire : oui

 ** [NumShards](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-NumShards"></a>
Le nombre de partitions pour le cluster multirégional.  
Type : Integer  
Obligatoire : non

 ** [Tags](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-Tags"></a>
Liste de balises à appliquer au cluster multirégional.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre maximum de 200 éléments.  
Obligatoire : non

 ** [TLSEnabled](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-TLSEnabled"></a>
S'il faut activer le chiffrement TLS pour le cluster multirégional.  
Type : booléen  
Obligatoire : non

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

```
{
   "MultiRegionCluster": { 
      "ARN": "string",
      "Clusters": [ 
         { 
            "ARN": "string",
            "ClusterName": "string",
            "Region": "string",
            "Status": "string"
         }
      ],
      "Description": "string",
      "Engine": "string",
      "EngineVersion": "string",
      "MultiRegionClusterName": "string",
      "MultiRegionParameterGroupName": "string",
      "NodeType": "string",
      "NumberOfShards": number,
      "Status": "string",
      "TLSEnabled": boolean
   }
}
```

## Eléments de réponse
<a name="API_CreateMultiRegionCluster_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.

 ** [MultiRegionCluster](#API_CreateMultiRegionCluster_ResponseSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-response-MultiRegionCluster"></a>
Informations sur le cluster multirégional nouvellement créé.  
Type : objet [MultiRegionCluster](API_MultiRegionCluster.md)

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

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

 ** ClusterQuotaForCustomerExceededFault **   
  
Code d’état HTTP : 400

 ** InvalidParameterCombinationException **   
  
Code d’état HTTP : 400

 ** InvalidParameterValueException **   
  
Code d’état HTTP : 400

 ** MultiRegionClusterAlreadyExistsFault **   
Un cluster multirégional portant le nom spécifié existe déjà.  
Code d’état HTTP : 400

 ** MultiRegionParameterGroupNotFoundFault **   
Le groupe de paramètres multirégional spécifié n'existe pas.  
Code d’état HTTP : 400

 ** TagQuotaPerResourceExceeded **   
  
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateMultiRegionCluster_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/CreateMultiRegionCluster) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CreateMultiRegionCluster)