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á.
# CreateGlobalCluster
Cria um cluster global do Amazon DocumentDB que pode abranger vários Regiões da AWS. O cluster global contém um cluster primário com capacidade de leitura e gravação, e até 10 clusters secundários somente de leitura. Clusters globais usam replicação rápida, baseada em armazenamento entre regiões com latências de menos de um segundo e infraestrutura dedicada sem impacto no desempenho da sua workload.
É possível criar um banco de dados global inicialmente vazio e, em seguida, adicionar um cluster primário e um secundário. Ou pode especificar um cluster existente durante a operação de criação, para que esse cluster torne-se o primário do cluster global.
**nota**
Essa ação se aplica somente aos clusters do Amazon DocumentDB.
## Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md).
** GlobalClusterIdentifier **
O identificador de cluster do novo cluster global.
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
** DatabaseName **
O nome para o seu banco de dados, com até 64 caracteres alfanuméricos. Se um nome não for fornecido, o Amazon DocumentDB não criará um banco de dados no cluster global que você estiver criando.
Tipo: string
Obrigatório: não
** DeletionProtection **
A configuração de proteção contra exclusão para o novo cluster global. O cluster global não pode ser excluído quando a proteção contra exclusão estiver habilitada.
Tipo: booleano
Obrigatório: não
** Engine **
O nome do mecanismo de banco de dados a ser usado para esse cluster.
Tipo: string
Obrigatório: não
** EngineVersion **
A versão do mecanismo do cluster global.
Tipo: string
Obrigatório: não
** SourceDBClusterIdentifier **
O nome do recurso da Amazon (ARN) a ser usado como o cluster primário do cluster global. Esse parâmetro é opcional.
Tipo: string
Obrigatório: não
** StorageEncrypted **
A configuração de criptografia de armazenamento para o novo cluster global.
Tipo: booliano
Obrigatório: Não
## Elementos de Resposta
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
Para obter informações sobre os erros comuns a todas ações, consulte [Erros comuns](CommonErrors.md).
** DBClusterNotFoundFault **
`DBClusterIdentifier` não se refere a um cluster existente.
Código de status HTTP: 404
** GlobalClusterAlreadyExistsFault **
O `GlobalClusterIdentifier` já existe. Escolha um novo identificador de cluster global (nome exclusivo) para criar um novo cluster global.
Código de status HTTP: 400
** GlobalClusterQuotaExceededFault **
O número de clusters globais para essa conta já atingiu no máximo permitido.
Código de status HTTP: 400
** InvalidDBClusterStateFault **
O cluster não está em um estado válido.
Código de Status HTTP: 400
## Consulte também
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/CreateGlobalCluster)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateGlobalCluster)