Consultar componentes - : Central de Documentação do Alibaba Cloud

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 /clusters/ClusterId/components/version 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	c82e6987e2961451182edacd74faf****	ID do cluster ACK a ser consultado.

Sintaxe da resposta

HTTP/1.1 200
Content-Type:application/json
{
  "key" : {
    "component_name" : "String",
    "version" : "String",
    "next_version" : "String",
    "changed" : "String",
    "can_upgrade" : Boolean,
    "policy" : "String",
    "ready_to_upgrade" : "String",
    "exist" : Boolean,
    "required" : Boolean,
    "message" : "String",
    "value" : "String"
  }
}

Parâmetros da resposta

Tabela 2. Parâmetros do corpo da resposta
Parâmetro	Tipo	Exemplo	Descrição
	Map		Parâmetros do corpo da resposta.
	Object		Detalhes do componente.
component_name	String	ack-node-problem-detector	Nome do componente.
version	String	1.2.1	Versão atual do componente. Nota Se o valor de `version` não estiver vazio, o componente está instalado.
next_version	String	1.2.1	Versão disponível para atualização do componente.
changed	String	false	Indica se o componente foi atualizado. Valores válidos: `true`: O componente foi atualizado. `false`: O componente não foi atualizado.
can_upgrade	Boolean	false	Indica se o componente permite atualização. Valores válidos: `true`: O componente permite atualização. `false`: O componente não permite atualização.
policy	String	overwrite	Política de atualização do componente. `overwrite`: As configurações da versão mais recente substituem as da versão atual. Valor padrão: `overwrite`.
ready_to_upgrade	String	false	Indica se o componente atende às condições de atualização. Valores válidos: `true`: O componente atende às condições de atualização. `false`: O componente não atende às condições de atualização.
exist	Boolean	true	Indica se é possível instale o componente no cluster ACK especificado. Valores válidos: `true`: É possível instale o componente no cluster. `false`: Não é possível instale o componente no cluster.
required	Boolean	false	Indica se o componente é obrigatório no cluster ACK especificado. Valores válidos: `true`: O componente é obrigatório no cluster. `false`: O componente não é obrigatório no cluster.
message	String	Um plug-in que detecta exceções e as relata ao centro de eventos do Kubernetes.	Informações adicionais sobre a possibilidade de atualização do componente.
value	String	npd:\n # Custom monitor definitions to add to Node Problem Detector ****	Definição personalizada de parâmetros. Durante a instalação de um componente, personalize as configurações de parâmetros conforme necessário.

Exemplos

Exemplos de solicitações

GET /clusters/c82e6987e2961451182edacd74faf****/components/version HTTP/1.1 
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

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

<ack-node-problem-detector>
    <exist>true</exist>
    <component_name>ack-node-problem-detector</component_name>
    <can_upgrade>false</can_upgrade>
    <ready_to_upgrade>false</ready_to_upgrade>
    <message>A plug-in that detects node exceptions and reports them to the Kubernetes event center.</message>
    <version>1.2.1</version>
    <value>npd:
  # Custom monitor definitions to add to Node Problem Detector ****</value>
    <required>false</required>
    <next_version>1.2.1</next_version>
    <changed>false</changed>
    <policy>overwrite</policy>
</ack-node-problem-detector>

Formato JSON

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

{
  "ack-node-problem-detector" : {
    "exist" : "true",
    "component_name" : "ack-node-problem-detector",
    "can_upgrade" : "false",
    "ready_to_upgrade" : "false",
    "message" : "A plug-in that detects node exceptions and reports them to the Kubernetes event center.",
    "version" : "1.2.1",
    "value" : "npd:\n  # Custom monitor definitions to add to Node Problem Detector ****",
    "required" : "false",
    "next_version" : "1.2.1",
    "changed" : "false",
    "policy" : "overwrite"
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.