Todos os produtos
Search
Central de documentação

Hologres:PrepareUpgrade

Última atualização: Jun 28, 2026

Prepara uma instância para uma atualização executando uma avaliação pré-atualização. Você pode atualizar a instância somente se a avaliação for aprovada. Se falhar, entre em contato com o suporte técnico para uma atualização manual.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /api/v1/instances/{instanceId}/upgrade/prepare HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

instanceId

string

Não

O ID da instância.

hgpostcn-cn-nwy3e6yxxx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região.

cn-shenzhen

body

object

Não

O corpo da solicitação.

version

string

Não

A versão de destino para a atualização. Chame a operação ListUpgradeReleaseVersion para obter uma lista de versões disponíveis.

r5.0.0

dryRun

boolean

Não

Este parâmetro está obsoleto.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A estrutura de dados da resposta.

RequestId

string

O ID da solicitação.

77B97AFB-7C9D-50FF-A72D-F13FD73E49D8

Data

object

Os parâmetros de resposta.

Success

boolean

Indica se a tarefa de preparação foi iniciada com sucesso.

true

FailReason

string

O motivo da falha da tarefa de preparação.

null

ReasonKey

string

Uma chave que identifica o motivo da falha.

null

Success

boolean

Indica se a chamada da API foi bem-sucedida. Isso não indica o resultado da preparação para a atualização.

true

ErrorCode

string

O código de erro retornado se a solicitação falhar.

null

ErrorMessage

string

A mensagem de erro retornada se a solicitação falhar.

null

HttpStatusCode

string

O código de status HTTP.

200

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "77B97AFB-7C9D-50FF-A72D-F13FD73E49D8",
  "Data": {
    "Success": true,
    "FailReason": "null\n",
    "ReasonKey": "null"
  },
  "Success": true,
  "ErrorCode": "null",
  "ErrorMessage": "null",
  "HttpStatusCode": "200"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.