Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Relational Database Service> Referência de API> API v3 (recomendada)> Gerenciamento de instâncias de banco de dados> Alteração manual de instâncias de banco de dados primárias/em espera

Atualizado em 2023-05-05 GMT+08:00

Ver PDF

Alteração manual de instâncias de banco de dados primárias/em espera

Função

Essa API é usada para alterar manualmente instâncias de banco de dados primárias/em espera conforme necessário.

Antes de chamar uma API, você precisa entender a API em Autenticação.

Restrições

Esta API é compatível com MySQL e PostgreSQL.
Esta API é compatível apenas com instâncias de banco de dados primárias/em espera.
As instâncias de banco de dados primárias/em espera não podem ser alternadas manualmente se estiverem em qualquer um dos seguintes status:
- Para MySQL e PostgreSQL: criação, reinicialização, atualização, alteração de classe de instância, restauração, alteração de porta ou criação de conta de banco de dados
- Para MySQL: exclusão da conta do banco de dados
A alteração primária/em espera não altera o endereço IP flutuante da instância.

URI

Formato de URI
PUT /v3/{project_id}/instances/{instance_id}/failover

Descrição do parâmetro

**Tabela 1** Descrição do parâmetro
Nome	Obrigatório	Descrição
project_id	Sim	Especifica o ID do projeto de um locatário em uma região. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id	Sim	Especifica o ID da instância de banco de dados.

Solicitação

Descrição do parâmetro

**Tabela 2** Descrição do parâmetro
Nome	Obrigatório	Tipo	Descrição
force	Não	Boolean	Se executar uma comutação primária/em espera forçada. Por padrão, esse parâmetro é deixado em branco, indicando que a alteração não é executada forçadamente. true: uma alteração forçada é executada. false: nenhuma alteração forçada é executada.

Exemplo
PUT https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/failover

Exemplo de solicitação
```
{}
```
Ou
```
{
"force":true
}
```

Resposta

Resposta normal

Nome	Descrição
workflowId	Indica o ID do fluxo de trabalho.
instanceId	Indica o ID da instância de banco de dados.
nodeId	Indica o ID do nó.

Exemplo de resposta normal

{
    "workflowId":"072beb09-0573-40bf-bfe8-4be5cec9e85a",
    "instanceId":"794c38e5309344818f4b33b86ebce9b4in03",
    "nodeId":"b94ba815747040f1b0d641cd13364a06no03"
}