DescribeClusterAddonsUpgradeStatus - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Sintaxe da requisição

GET /clusters/[ClusterId]/components/upgradestatus?componentIds=["String"] HTTP/1.1 
Content-Type:application/json

Parâmetros da requisição

Tabela 1. Parâmetros de caminho da requisição
Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
ClusterId	String	Sim	c23421cfa74454bc8b37163fd19af****	ID do cluster ACK.

Tabela 2. Parâmetros de consulta da requisição
Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
componentIds	Array of String	Não	metric-server	Nomes dos componentes a serem consultados.

Sintaxe da resposta

HTTP/1.1 200
Content-Type:application/json
{
  "key" : {
    "addon_info" : {
      "component_name" : "String",
      "version" : "String",
      "ready_to_upgrade" : "String"
    },
    "tasks" : {
      "created_at" : "String",
      "finished_at" : "String",
      "status" : "String",
      "is_canceled" : Boolean
    }
  }
}

Parâmetros da resposta

Tabela 3. Parâmetros do corpo da resposta
Parâmetro	Tipo	Exemplo	Descrição
	Map		Dados retornados.
	object		Detalhes do status de atualização dos componentes consultados.
addon_info	object		Informações sobre o componente.
component_name	String	cloud-controller-manager	Nome do componente.
version	String	v1.9.3.340-g9830b58-aliyun	Versão atual do componente.
ready_to_upgrade	String	true	Indica se o componente pode ser atualizado. Valores válidos: `true`: O componente pode ser atualizado. `false`: O componente não pode ser atualizado.
tasks	object		Detalhes da tarefa de atualização.
created_at	String	2020-12-28T17:00:50Z	Horário de início da tarefa.
finished_at	String	2020-12-28T17:05:36Z	Horário de término da tarefa.
status	String	Success	Estado da tarefa de atualização. Valores válidos: `Upgrading`: Atualização em andamento. `Success`: Atualização concluída com sucesso. `Failed`: Falha na atualização. `Running`: Instalação da atualização em andamento. `Paused`: Atualização pausada. `Canceled`: Atualização cancelada.
is_canceled	Boolean	false	Indica se a tarefa de atualização foi cancelada. Valores válidos: `true`: A tarefa de atualização foi cancelada. `false`: A tarefa de atualização não foi cancelada.

Exemplos

Exemplos de requisições

GET /clusters/[ClusterId]/components/upgradestatus?componentIds=["metric-server"] HTTP/1.1 
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

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

<cloud-controller-manager>
    <tasks>
        <created_at>2020-12-28T17:01:55Z</created_at>
        <finished_at>2020-12-28T17:05:11Z</finished_at>
        <is_canceled>false</is_canceled>
        <status>Success</status>
    </tasks>
    <addon_info>
        <component_name>cloud-controller-manager</component_name>
        <version>v1.9.3.340-g9830b58-aliyun</version>
        <ready_to_upgrade>true</ready_to_upgrade>
    </addon_info>
</cloud-controller-manager>
<metric-server>
    <tasks>
        <created_at>2020-12-28T17:00:32Z</created_at>
        <finished_at>2020-12-28T17:05:54Z</finished_at>
        <is_canceled>false</is_canceled>
        <status>Success</status>
    </tasks>
    <addon_info>
        <component_name>metric-server</component_name>
        <version/>
        <ready_to_upgrade>true</ready_to_upgrade>
    </addon_info>
</metric-server>

Formato JSON

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

{
  "cloud-controller-manager" : {
    "tasks" : {
      "created_at" : "2020-12-28T17:01:55Z",
      "finished_at" : "2020-12-28T17:05:11Z",
      "is_canceled" : false,
      "status" : "Success"
    },
    "addon_info" : {
      "component_name" : "cloud-controller-manager",
      "version" : "v1.9.3.340-g9830b58-aliyun",
      "ready_to_upgrade" : "true"
    }
  },
  "metric-server" : {
    "tasks" : {
      "created_at" : "2020-12-28T17:00:32Z",
      "finished_at" : "2020-12-28T17:05:54Z",
      "is_canceled" : false,
      "status" : "Success"
    },
    "addon_info" : {
      "component_name" : "metric-server",
      "version" : "",
      "ready_to_upgrade" : "true"
    }
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.