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á.
SwitchoverGlobalCluster
Alterna o cluster secundário especificado do Amazon DocumentDB para ser o novo cluster primário do Amazon DocumentDB no cluster de banco de dados global.
Parâmetros de Solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
- GlobalClusterIdentifier
-
O identificador do cluster de banco de dados global do Amazon DocumentDB para alternar. O identificador é a chave exclusiva atribuída pelo usuário quando o cluster é criado. Em outras palavras, é o nome do cluster global. Este parâmetro não diferencia maiúsculas de minúsculas.
Restrições:
-
Deve ser o identificador de um cluster global existente (banco de dados global do Amazon DocumentDB).
-
Tamanho mínimo de 1. Comprimento máximo de 255.
Padrão:
[A-Za-z][0-9A-Za-z-:._]*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-:._]*Exigido: Sim
-
- TargetDbClusterIdentifier
-
O identificador do cluster secundário do Amazon DocumentDB a ser promovido ao novo primário do cluster de banco de dados global. Use o nome do recurso da Amazon (ARN) para o identificador para que o Amazon DocumentDB possa localizar o cluster em sua região AWS.
Restrições:
-
Deve ser o identificador de um cluster secundário existente.
-
Tamanho mínimo de 1. Comprimento máximo de 255.
Padrão:
[A-Za-z][0-9A-Za-z-:._]*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-:._]*Exigido: Sim
-
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
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifiernão se refere a um cluster global existente.Código de Status HTTP: 404
- InvalidDBClusterStateFault
-
O cluster não está em um estado válido.
Código de Status HTTP: 400
- 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
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
