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/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de instâncias de banco de dados/ Execução de um switchover principal/secundário em uma instância de conjunto de réplicas
Atualizado em 2023-05-06 GMT+08:00

Execução de um switchover principal/secundário em uma instância de conjunto de réplicas

Descrição da API

Essa API é usada para executar uma alternância primária/secundária em uma instância do conjunto de réplicas.

Restrições

  • Esta API suporta apenas conjuntos de réplicas do DDS.
  • Esta operação não pode ser executada em instâncias congeladas ou anormais.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/switchover

  • Exemplo de URI

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/switchover

Solicitações

Descrição do parâmetro

Tabela 1 Parâmetros de solicitação

Nome

Tipo

IN

Obrigatório

Descrição

x-auth-token

string

header

Sim

Token do usuário

project_id

string

path

Sim

ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

string

path

Sim

ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

Respostas

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    job_id

    String

    Sim

    A ID da tarefa.

  • Exemplo de resposta
    {
        "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5"
    }

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.