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, além de clusters secundários somente para 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.
Você pode 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.
- GlobalClusterIdentifier
-
O identificador de cluster do novo cluster global.
Tipo: string
Restrições de tamanho: tamanho mínimo 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: sequência
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: sequência
Obrigatório: não
- EngineVersion
-
A versão do mecanismo do cluster global.
Tipo: sequência
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: sequência
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
Erros
Para obter informações sobre os erros comuns que todas as ações retornam, consulte Erros comuns.
- 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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: