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á.
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 de 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 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
Erros
Para obter informações sobre os erros comuns a todas ações, consulte Erros comuns.
- DBClusterNotFoundFault
-
DBClusterIdentifiernão se refere a um cluster existente.Código de status HTTP: 404
- GlobalClusterAlreadyExistsFault
-
O
GlobalClusterIdentifierjá 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:
