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.