Interroger les composants - - Centre de documentation Alibaba Cloud

Appelez l'opération DescribeClusterAddonsVersion pour interroger les composants installés dans un cluster Container Service for Kubernetes (ACK) spécifique.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Syntaxe de la requête

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

Paramètres de requête

Tableau 1. Paramètres de chemin de requête
Paramètre	Type	Obligatoire	Exemple	Description
ClusterId	String	Oui	c82e6987e2961451182edacd74faf****	L'ID du cluster ACK à interroger.

Syntaxe de la réponse

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"
  }
}

Paramètres de réponse

Tableau 2. Paramètres du corps de la réponse
Paramètre	Type	Exemple	Description
	Map		Paramètres du corps de la réponse.
	Object		Détails du composant.
component_name	String	ack-node-problem-detector	Nom du composant.
version	String	1.2.1	Version actuelle du composant. Remarque Si la valeur de `version` n'est pas vide, le composant est installé.
next_version	String	1.2.1	Version vers laquelle le composant peut être mis à niveau.
changed	String	false	Indique si le composant a été mis à niveau. Valeurs valides : `true` : Le composant a été mis à niveau. `false` : Le composant n'a pas été mis à niveau.
can_upgrade	Boolean	false	Indique si le composant est éligible à la mise à niveau. Valeurs valides : `true` : Le composant est éligible à la mise à niveau. `false` : Le composant n'est pas éligible à la mise à niveau.
policy	String	overwrite	Stratégie de mise à niveau du composant. `overwrite` : Les configurations du composant de la nouvelle version remplacent celles de la version actuelle. Valeur par défaut : `overwrite`.
ready_to_upgrade	String	false	Indique si le composant remplit les conditions de mise à niveau. Valeurs valides : `true` : Le composant remplit les conditions de mise à niveau. `false` : Le composant ne remplit pas les conditions de mise à niveau.
exist	Boolean	true	Indique si le composant peut être installé dans le cluster ACK spécifié. Valeurs valides : `true` : Le composant peut être installé dans le cluster. `false` : Le composant ne peut pas être installé dans le cluster.
required	Boolean	false	Indique si le composant est obligatoire dans le cluster ACK spécifié. Valeurs valides : `true` : Le composant est obligatoire dans le cluster. `false` : Le composant n'est pas obligatoire dans le cluster.
message	String	A plug-in that detects exceptions and reports them to the Kubernetes event center.	Informations supplémentaires sur l'éligibilité du composant à la mise à niveau.
value	String	npd:\n # Custom monitor definitions to add to Node Problem Detector ****	Paramètre personnalisé. Lors de l'installation d'un composant, vous pouvez personnaliser ses paramètres.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format 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"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.