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

# ModifyGlobalCluster
<a name="API_ModifyGlobalCluster"></a>

Modificar uma configuração de um cluster do Amazon DocumentDB global. É possível alterar um ou mais parâmetros de configuração (por exemplo: proteção contra exclusão) ou o identificador global do cluster especificando esses parâmetros e os novos valores na solicitação.

**nota**  
Essa ação se aplica somente aos clusters do Amazon DocumentDB.

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

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

 ** GlobalClusterIdentifier **   
O identificador do cluster global que está sendo modificado. Este parâmetro não diferencia maiúsculas de minúsculas.  
Restrições:  
+ Deve ser o identificador de um cluster existente.
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[A-Za-z][0-9A-Za-z-:._]*`   
Obrigatório: Sim

 ** DeletionProtection **   
Indica se o cluster global tem a proteção contra exclusão habilitada. O cluster global não pode ser excluído quando a proteção contra exclusão estiver habilitada.   
Tipo: booleano  
Obrigatório: não

 ** NewGlobalClusterIdentifier **   
O novo identificador de um cluster global quando você modifica um cluster global. Esse valor é armazenado como uma string em minúsculas.  
+ Deve conter de 1 a 63 caracteres, incluindo letras, números ou hífens

  O primeiro caractere deve ser uma letra

  Não pode terminar com um hífen nem conter dois hifens consecutivos
Exemplo: `my-cluster2`   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[A-Za-z][0-9A-Za-z-:._]*`   
Obrigatório: Não

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

O elemento a seguir é retornado pelo serviço.

 ** GlobalCluster **   
Um tipo de dado que representa um cluster global do Amazon DocumentDB.  
Tipo: objeto [GlobalCluster](API_GlobalCluster.md)

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

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

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` não se refere a um cluster global existente.  
Código de status HTTP: 404

 ** InvalidGlobalClusterStateFault **   
A operação solicitada não pode ser executada enquanto o cluster estiver nesse estado.  
Código de Status HTTP: 400

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