Atualização do patch do banco de dados

Descrição da API

Essa API é usada para atualizar a versão do patch do banco de dados.

Restrições

Esta API não está disponível para instâncias congeladas ou anormais.

Essa API não estará disponível se houver nós de instância anormais.

Veja o campo patch_available no resultado retornado pela API para consultar detalhes da instância e verifique se uma atualização de versão secundária é suportada.

Realize um upgrade durante as horas fora de pico.

URI

• Formato de URI

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-upgrade

• Exemplo de URI
  https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/db-upgrade

  Tabela 1 Parâmetros de solicitação

  Nome	Obrigatório	Tipo	Descrição
  project_id	Sim	String	O 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	Sim	String	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.

Solicitações

• Parâmetros de solicitação

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

  Nome	Obrigatório	Tipo	Descrição
  x-auth-token	Sim	String	Token do usuário.

  Tabela 3 Parâmetros de corpo de solicitação

  Nome	Obrigatório	Tipo	Descrição
  upgrade_mode	Não	String	Modo de atualização. Se este parâmetro for definido como minimized_interrupt_time, o menor tempo de interrupção é preferido. Nesse modo, a atualização tem pouco impacto nos serviços. Se este parâmetro for definido como minimized_upgrade_time, o menor tempo de atualização é preferido. O valor padrão é minimized_interrupt_time.

• Exemplo de solicitação

  Exemplo de atualização da versão de patch do banco de dados de uma instância de conjunto de réplicas

  POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/db-upgrade { "upgrade_mode" : "minimized_interrupt_time" }

Respostas

• Descrição do parâmetro

  Tabela 4 Parâmetros de corpo da resposta

  Nome	Tipo	Descrição
  job_id	String	ID da tarefa.

• Exemplo de resposta

  { "job_id" : "55e166d2-83ad-425f-b887-3503de03dc9b" }

Código de status

Para mais detalhes, consulte Código de status.

Código de erro

Para mais detalhes, consulte Código de erro.