Consulta de componentes - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeClusterAddonsVersion para consultar los componentes instalados en un clúster específico de Container Service for Kubernetes (ACK).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente código de ejemplo de la operación para diferentes SDKs.

Sintaxis de la solicitud

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

Parámetros de la solicitud

Tabla 1. Parámetros de ruta de la solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
ClusterId	String	Sí	c82e6987e2961451182edacd74faf****	ID del clúster de ACK que desea consultar.

Sintaxis de la respuesta

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 de la respuesta

Tabla 2. Parámetros del cuerpo de la respuesta

Parámetro	Tipo	Ejemplo	Descripción
	Map		Parámetros del cuerpo de la respuesta.
	Object		Detalles del componente.
component_name	String	ack-node-problem-detector	Nombre del componente.
version	String	1.2.1	Versión actual del componente. Nota Si el valor de `version` no está vacío, indica que el componente está instalado.
next_version	String	1.2.1	Versión a la que se puede actualizar el componente.
changed	String	false	Indica si el componente se actualizó. Valores válidos: `true`: El componente se actualizó. `false`: El componente no se actualizó.
can_upgrade	Boolean	false	Indica si el componente admite actualizaciones. Valores válidos: `true`: El componente admite actualizaciones. `false`: El componente no admite actualizaciones.
policy	String	overwrite	Política de actualización del componente. `overwrite`: Las configuraciones del componente de la versión más reciente sobrescriben las de la versión actual. Valor predeterminado: `overwrite`.
ready_to_upgrade	String	false	Indica si el componente cumple con las condiciones de actualización. Valores válidos: `true`: El componente cumple con las condiciones de actualización. `false`: El componente no cumple con las condiciones de actualización.
exist	Boolean	true	Indica si el componente se puede instalar en el clúster de ACK especificado. Valores válidos: `true`: El componente se puede instalar en el clúster. `false`: El componente no se puede instalar en el clúster.
required	Boolean	false	Indica si el componente es obligatorio en el clúster de ACK especificado. Valores válidos: `true`: El componente es obligatorio en el clúster. `false`: El componente no es obligatorio en el clúster.
message	String	A plug-in that detects exceptions and reports them to the Kubernetes event center.	Información adicional sobre si el componente admite actualizaciones.
value	String	npd:\n # Custom monitor definitions to add to Node Problem Detector ****	Configuración personalizada de parámetros. Al instalar un componente, puede personalizar la configuración de sus parámetros.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.