

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á.

# CreateDBClusterParameterGroup
<a name="API_CreateDBClusterParameterGroup"></a>

Cria um novo grupo de parâmetros de cluster.

Os parâmetros em um grupo de parâmetros do cluster aplicam-se a todas as instâncias em um cluster.

Um grupo de parâmetros de cluster é inicialmente criado com os parâmetros padrão para o mecanismo de banco de dados usado pelas instâncias no cluster. No Amazon DocumentDB, você não pode fazer modificações diretamente no grupo de parâmetros do cluster `default.docdb3.6`, Se o seu cluster do Amazon DocumentDB estiver usando o grupo de parâmetros padrão do cluster e você quiser modificar um valor nele, deverá primeiro [ criar um novo grupo de parâmetros ](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-create.html) ou [ copiar um grupo de parâmetros existente](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-copy.html), modificá-lo e, em seguida, aplicar o grupo de parâmetros modificado ao seu cluster. Para que o novo grupo de parâmetros do cluster e as configurações entrem em vigor, você deverá reiniciar as instâncias de banco de dados no cluster sem failover. Para obter mais informações, consulte [Modificar grupos de parâmetros do cluster do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-modify.html). 

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

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

 ** DBClusterParameterGroupName **   
O nome do grupo de parâmetros de cluster.  
Restrições:  
+ Não deve corresponder ao nome de um `DBClusterParameterGroup` existente.
Esse valor é armazenado como uma string em minúsculas.
Tipo: String  
Obrigatório: Sim

 ** DBParameterGroupFamily **   
O nome da família de grupos de parâmetros de cluster.  
Tipo: String  
Obrigatório: Sim

 ** Description **   
A descrição do grupo de parâmetros de cluster.  
Tipo: String  
Obrigatório: Sim

 **Tags.Tag.N**   
As tags a serem atribuídas ao grupo de parâmetros do cluster.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Obrigatório: não

## Elementos de Resposta
<a name="API_CreateDBClusterParameterGroup_ResponseElements"></a>

O elemento a seguir é retornado pelo serviço.

 ** DBClusterParameterGroup **   
Informações detalhadas sobre o grupo de parâmetros de cluster.   
Tipo: objeto [DBClusterParameterGroup](API_DBClusterParameterGroup.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** DBParameterGroupAlreadyExists **   
Já existe um grupo de parâmetros com o mesmo nome.  
Código de status HTTP: 400

 ** DBParameterGroupQuotaExceeded **   
Esta solicitação faria com que você excedesse o número permitido de grupos de parâmetros.  
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateDBClusterParameterGroup_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/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 