DescribeKubernetesVersionMetadata - Container Service for Kubernetes

Consulte les détails des versions de Kubernetes, y compris les informations de version, les dates de publication, les dates d'expiration, les systèmes d'exploitation compatibles et les environnements d'exécution pris en charge.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cs:DescribeKubernetesVersionMetadata

get

*Toutes les ressources.

*

Aucune

Syntaxe de la requête

GET /api/v1/metadata/versions HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Region	string	Oui	L'identifiant de la région dans laquelle le cluster est déployé.	cn-beijing
ClusterType	string	Oui	Le type de cluster. Valeurs valides : `Kubernetes` : cluster dédié ACK. `ManagedKubernetes` : cluster managé ACK, y compris les clusters ACK Pro, les clusters ACK de base, les clusters ACK Serverless Pro, les clusters ACK Serverless de base, les clusters ACK Edge Pro et les clusters ACK Edge de base.	Kubernetes
KubernetesVersion	string	Non	La version de Kubernetes du cluster. Cette version est cohérente avec la version de référence de la communauté Kubernetes. Nous vous recommandons de sélectionner la version la plus récente. Si vous ne spécifiez pas ce paramètre, la version la plus récente est utilisée par défaut. Pour plus d'informations sur les versions de Kubernetes prises en charge par ACK, consultez Présentation des versions de Kubernetes.	1.32.1-aliyun.1
Profile	string	Non	Le profil de cluster. Valeurs valides : `Default` : cluster pour les scénarios non-edge. `Edge` : cluster pour les scénarios edge. `Serverless` : cluster ASK. Valeur par défaut : `Default`.	Default
runtime	string	Non	Le type d'environnement d'exécution. Vous pouvez spécifier un type d'environnement d'exécution pour filtrer les images système prises en charge par l'environnement d'exécution. Valeurs valides : `docker` : environnement d'exécution Docker. `containerd` : environnement d'exécution containerd. `Sandboxed-Container.runv` : conteneur sandboxé. Si vous spécifiez un type d'environnement d'exécution, le système renvoie les versions d'image prises en charge par l'environnement d'exécution spécifié. Si vous ne spécifiez pas de type d'environnement d'exécution, le système renvoie toutes les images par défaut.	containerd
Mode	string	Non	Le mode de requête. Valeurs valides : `supported` : versions prises en charge. `creatable` : versions disponibles pour la création de cluster. Si vous spécifiez KubernetesVersion, le système ignore le mode de requête. Si vous ne spécifiez pas de mode de requête, le système renvoie les versions disponibles pour la création de cluster par défaut.	supported
QueryUpgradableVersion	boolean	Non	Indique si les versions éligibles à la mise à niveau de la version du cluster doivent être interrogées. Ce paramètre prend effet uniquement lorsque le paramètre KubernetesVersion est spécifié. Valeurs valides : true : interroge les versions éligibles à la mise à niveau. false : n'interroge pas les versions éligibles à la mise à niveau.	1.30.1-aliyun.1

Éléments de réponse

Élément	Type	Description	Exemple
	array	La liste des détails des versions de cluster.
	array<object>	The version details.
capabilities	object	Les fonctionnalités de la version de Kubernetes.	{ "AnyAZ": true, "ChargeType": "PostPaid" }
images	array<object>	La liste des images système.
	object	The image details.
image_id	string	The image ID.	aliyun_3_x64_20G_alibase_20241218.vhd
image_name	string	The image name.	Alibaba Cloud Linux 3.2104
platform	string	The operating system platform. Valid values: `AliyunLinux` `CentOS` `Windows` `WindowsCore`	AliyunLinux
os_version	string	The image version.	3.2104
image_type	string	The operating system distribution type. Use this field to specify the operating system for nodes. Valid values: `CentOS` `AliyunLinux` `AliyunLinux Qboot` `AliyunLinuxUEFI` `AliyunLinux3` `Windows` `WindowsCore` `AliyunLinux3Arm64` `ContainerOS`	AliyunLinux3
os_type	string	The operating system type. Examples: `Windows` `Linux`	Linux
image_category	string	The image category. Some valid values: `system`: public images. `self`: your custom images. `others`: public images from other users. `marketplace`: Alibaba Cloud Marketplace images.	system
architecture	string	The image architecture.	x86_64
meta_data	object	Les métadonnées de la version de Kubernetes.	{ "KubernetesVersion": "1.31.1-aliyun.1", "SubClass": "default", "ServiceCIDR": "" }
runtimes	array	The container runtime configurations.
	runtime	The container runtime configurations.
version	string	The Kubernetes version released by ACK. For more information about versions, see Overview of Kubernetes version releases.	1.31.1-aliyun.1
release_date	string	The release time of the Kubernetes version. The time is in ISO 8601 format and includes time zone information.	2025-01-30T00:00:00Z
expiration_date	string	The expiration time of the Kubernetes version. The time is in ISO 8601 format and includes time zone information.	2026-01-30T00:00:00Z
creatable	boolean	Indique si la version de Kubernetes peut être créée.	true
upgradable_versions	array	La liste des versions éligibles à la mise à niveau.
	string	The upgradable version.	1.32.1-aliyun.1

Exemples

JSON format

[
  {
    "capabilities": {
      "AnyAZ": true,
      "ChargeType": "PostPaid"
    },
    "images": [
      {
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "image_name": "Alibaba Cloud Linux 3.2104",
        "platform": "AliyunLinux",
        "os_version": "3.2104",
        "image_type": "AliyunLinux3",
        "os_type": "Linux",
        "image_category": "system",
        "architecture": "x86_64"
      }
    ],
    "meta_data": {
      "KubernetesVersion": "1.31.1-aliyun.1",
      "SubClass": "default",
      "ServiceCIDR": ""
    },
    "runtimes": [
      {
        "name": "containerd",
        "version": "1.6.20"
      }
    ],
    "version": "1.31.1-aliyun.1",
    "release_date": "2025-01-30T00:00:00Z",
    "expiration_date": "2026-01-30T00:00:00Z",
    "creatable": true,
    "upgradable_versions": [
      "1.32.1-aliyun.1"
    ]
  }
]

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.