Todos os produtos
Search
Central de documentação

:Consultar o status de atualização de um cluster

Última atualização: Jul 08, 2026

Chame a operação GetUpgradeStatus para consultar o status de atualização de um cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente exemplos de código da operação para diferentes SDKs.

Sintaxe da solicitação

GET /api/v2/clusters/ClusterId/upgrade/status HTTP/1.1 
Content-Type:application/json

Parâmetros da solicitação

Tabela 1. Parâmetros de caminho da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

ClusterId

String

Sim

c106f377e16f34eb1808d6b9362c9****

ID do cluster a ser gerenciado.

Sintaxe da resposta

HTTP/1.1 200
Content-Type:application/json
{
  "error_message" : "String",
  "precheck_report_id" : "String",
  "status" : "String",
  "upgrade_step" : "String",
  "upgrade_task" : {
    "status" : "String",
    "message" : "String"
  }
}

Parâmetros da resposta

Tabela 2. Parâmetros do corpo da resposta
ParâmetroTipoExemploDescrição
error_messageStringsujeito ao retorno real

Mensagem de erro retornada durante a atualização.

precheck_report_idStringbe4c8eb72de94d459ea7ace7c811d119

ID do relatório de pré-verificação.

statusStringrunning

Status da atualização. Valores válidos:

  • success: atualização concluída com êxito.
  • fail: falha na atualização.
  • pause: atualização pausada.
  • running: atualização em andamento.
upgrade_stepStringprechecking

Fase atual da atualização. Valores válidos:

  • not_start: atualização não iniciada.
  • prechecking: pré-verificação em andamento.
  • upgrading: atualização em andamento.
  • pause: atualização pausada.
  • success: atualização concluída com êxito.
upgrade_taskObject

Detalhes da tarefa de atualização.

statusStringrunning

Status da tarefa de atualização. Valores válidos:

  • running: tarefa de atualização em execução.
  • Success: tarefa de atualização executada com êxito.
  • Failed: falha na tarefa de atualização.
messageStringsujeito ao retorno real

Descrição da tarefa de atualização.

Exemplos

Exemplos de solicitações

GET /api/v2/clusters/c106f377e16f34eb1808d6b9362c9****/upgrade/status HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetUpgradeStatusResponse>
    <error_message>subject to actual return</error_message>
    <precheck_report_id>be4c8eb72de94d459ea7ace7c811d119</precheck_report_id>
    <status>running</status>
    <upgrade_step>prechecking</upgrade_step>
    <upgrade_task>
        <status>running</status>
        <message>subject to actual return</message>
    </upgrade_task>
</GetUpgradeStatusResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "error_message" : "subject to actual return",
  "precheck_report_id" : "be4c8eb72de94d459ea7ace7c811d119",
  "status" : "running",
  "upgrade_step" : "prechecking",
  "upgrade_task" : {
    "status" : "running",
    "message" : "subject to actual return"
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.