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/ TaurusDB/ Referência de API/ APIs (recomendadas)/ Gerenciamento de instâncias/ Alteração da prioridade de failover de uma réplica de leitura
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Alteração da prioridade de failover de uma réplica de leitura

Função

Essa API é usada para alterar a prioridade de failover de uma réplica de leitura. Antes de chamar essa API:

URI

PUT /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/priority

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância.

node_id

Sim

String

ID do nó.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Para obter o valor, chame a API para obtenção de um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

Content-Type

Sim

String

Tipo de conteúdo.

Valor: application/json

X-Language

Não

String

Linguagem.
Tabela 3 Parâmetro do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

priority

Sim

String

Prioridade de failover.

O valor pode ser -1 ou qualquer número entre 1 e 16. Se o valor for um número positivo, um valor menor indicará uma prioridade mais alta. Esta prioridade determina a ordem na qual as réplicas de leitura são promovidas durante a recuperação de uma falha no nó primário. Réplicas de leitura com a mesma prioridade têm a mesma probabilidade de serem promovidas para o novo nó primário. Se o valor for -1, a réplica de leitura não participará de um failover. Depois que a prioridade de uma réplica de leitura for definida como -1, verifique se uma instância de AZ única ainda tem pelo menos uma réplica de leitura ou se os nós restantes de uma instância entre AZs estão em AZs diferentes.

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetro do corpo da resposta

Parâmetro

Tipo

Descrição

job_id

String

ID do fluxo de trabalho.

Código de status: 400

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Alteração da prioridade de failover de réplica de leitura para 2

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/61a4ea66210545909d74a05c27a7179ein07//nodes/ss62c18799854a919bab633874c159dfno01/priority

{
  "priority" : 2
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "job_id" : "b054f3e1-64f8-4219-ad48-f9ac494c6983"
}

Código de status

Código de status

Descrição

200

Bem-sucedido.

400

Erro do cliente.

500

Erro no servidor.

Código de erro

Para obter detalhes, consulte Códigos de erro.

Tópico principal: Gerenciamento de instâncias