As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Cria um novo cluster multirregional.

## Sintaxe da solicitação
<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
}
```

## Parâmetros da solicitação
<a name="API_CreateMultiRegionCluster_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [Description](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-Description"></a>
Uma descrição para o cluster multirregional.  
Tipo: string  
Obrigatório: não

 ** [Engine](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-Engine"></a>
O nome do mecanismo a ser usado para o cluster multirregional.  
Tipo: string  
Obrigatório: não

 ** [EngineVersion](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-EngineVersion"></a>
A versão do mecanismo a ser usada para o cluster multirregional.  
Tipo: string  
Obrigatório: não

 ** [MultiRegionClusterNameSuffix](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-MultiRegionClusterNameSuffix"></a>
Um sufixo a ser adicionado ao nome do cluster multirregional. O Amazon MemoryDB aplica automaticamente um prefixo ao nome do cluster multirregional quando ele é criado. Cada região da Amazônia tem seu próprio prefixo. Por exemplo, um nome de cluster multirregional criado na região US-West-1 começará com “virxk”, junto com o nome do sufixo que você fornecer. O sufixo garante a exclusividade do nome do cluster multirregional em várias regiões. Esse valor é armazenado como uma string em minúsculas.  
Tipo: String  
Obrigatório: Sim

 ** [MultiRegionParameterGroupName](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-MultiRegionParameterGroupName"></a>
O nome do grupo de parâmetros multirregionais a ser associado ao cluster.  
Tipo: string  
Obrigatório: não

 ** [NodeType](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-NodeType"></a>
O tipo de nó a ser usado para o cluster multirregional.  
Tipo: String  
Obrigatório: Sim

 ** [NumShards](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-NumShards"></a>
O número de fragmentos do cluster multirregional.  
Tipo: inteiro  
Obrigatório: não

 ** [Tags](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-Tags"></a>
Uma lista de tags a serem aplicadas ao cluster multirregional.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número máximo de 200 itens.  
Obrigatório: não

 ** [TLSEnabled](#API_CreateMultiRegionCluster_RequestSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-request-TLSEnabled"></a>
Se a criptografia TLS deve ser ativada para o cluster multirregional.  
Tipo: booliano  
Obrigatório: não

## Sintaxe da resposta
<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
   }
}
```

## Elementos de resposta
<a name="API_CreateMultiRegionCluster_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [MultiRegionCluster](#API_CreateMultiRegionCluster_ResponseSyntax) **   <a name="MemoryDB-CreateMultiRegionCluster-response-MultiRegionCluster"></a>
Detalhes sobre o cluster multirregional recém-criado.  
Tipo: objeto [MultiRegionCluster](API_MultiRegionCluster.md)

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

Para obter informações sobre os erros comuns que são comuns em todas ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** ClusterQuotaForCustomerExceededFault **   
  
Código de status HTTP: 400

 ** InvalidParameterCombinationException **   
  
Código de status HTTP: 400

 ** InvalidParameterValueException **   
  
Código de status HTTP: 400

 ** MultiRegionClusterAlreadyExistsFault **   
Já existe um cluster multirregional com o nome especificado.  
Código de status HTTP: 400

 ** MultiRegionParameterGroupNotFoundFault **   
O grupo de parâmetros multirregionais especificado não existe.  
Código de status HTTP: 400

 ** TagQuotaPerResourceExceeded **   
  
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateMultiRegionCluster_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CreateMultiRegionCluster) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CreateMultiRegionCluster)