DescribeKubernetesVersionMetadata - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Consulta as informações detalhadas sobre versões do Kubernetes, incluindo o número da versão, data de lançamento, data de expiração, sistemas operacionais compatíveis e runtime.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:DescribeKubernetesVersionMetadata

get

*All Resource

*

Nenhuma

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Region	string	Sim	O ID da região do cluster.	cn-beijing
ClusterType	string	Sim	O tipo de cluster que você deseja usar. Valores válidos: `Kubernetes`: cluster dedicado ACK. `ManagedKubernetes`: cluster gerenciado ACK. Os clusters gerenciados ACK incluem clusters ACK Pro, clusters ACK Basic, clusters ACK Serverless Pro, clusters ACK Serverless Basic, clusters ACK Edge Pro e clusters ACK Edge Basic. `ExternalKubernetes`: cluster registrado.	Kubernetes
KubernetesVersion	string	Não	A versão do Kubernetes do cluster. As versões do Kubernetes suportadas pelo ACK são as mesmas versões do Kubernetes suportadas pelo Kubernetes open source. Recomenda-se especificar a versão mais recente do Kubernetes. Se você não configurar este parâmetro, a versão mais recente do Kubernetes será usada. Para mais informações sobre as versões do Kubernetes suportadas pelo ACK, consulte Notas de lançamento para versões do Kubernetes.	1.32.1-aliyun.1
Profile	string	Não	O cenário de uso dos clusters. Valores válidos: `Default`: cenários de computação não edge `Edge`: cenários de computação edge `Serverless`: cenários serverless. Valor padrão: `Default`.	Default
runtime	string	Não	O tipo de runtime de contêiner que você deseja usar. Você pode especificar um tipo de runtime para consultar apenas imagens de SO que suportam o tipo de runtime. Valores válidos: `docker`: Docker `containerd`: containerd `Sandboxed-Container.runv`: Sandboxed-Container Se você especificar um tipo de runtime, apenas as imagens de SO que suportam o tipo de runtime especificado serão retornadas. Caso contrário, todas as imagens de SO serão retornadas.	containerd
Mode	string	Não	O modo de consulta. Valores válidos: `supported`: consulta todas as versões do Kubernetes suportadas. `creatable`: consulta apenas as versões do Kubernetes de clusters que você pode criar. Se você especificar `KubernetesVersion`, este parâmetro não terá efeito. Se você não especificar um modo de consulta, as versões do Kubernetes de clusters que você pode criar serão retornadas.	supported
QueryUpgradableVersion	boolean	Não	Especifica se devem ser consultadas as versões do Kubernetes disponíveis para atualização. Este parâmetro tem efeito apenas quando o parâmetro KubernetesVersion é especificado. true: consulta as versões do Kubernetes disponíveis para atualização. false: não consulta as versões do Kubernetes disponíveis para atualização.	1.30.1-aliyun.1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	array	Os detalhes da versão do Kubernetes consultada.
	array<object>	Os detalhes da versão do Kubernetes.
capabilities	object	Recursos da versão do Kubernetes consultada.	{ "AnyAZ": true, "ChargeType": "PostPaid" }
images	array<object>	As imagens de SO retornadas.
	object	Os detalhes da imagem.
image_id	string	O ID da imagem.	aliyun_3_x64_20G_alibase_20241218.vhd
image_name	string	O nome da imagem.	Alibaba Cloud Linux 3.2104
platform	string	A plataforma do SO. Valores válidos: `AliyunLinux` `CentOS` `Windows` `WindowsCore`	AliyunLinux
os_version	string	A versão da imagem.	3.2104
image_type	string	O tipo de distribuição do sistema operacional que você deseja usar. Recomenda-se usar este parâmetro para especificar o sistema operacional do nó. Valores válidos: `CentOS` `AliyunLinux` `AliyunLinux Qboot` `AliyunLinuxUEFI` `AliyunLinux3` `Windows` `WindowsCore` `AliyunLinux3Arm64` `ContainerOS`	AliyunLinux3
os_type	string	O tipo de SO. Exemplos: `Windows` `Linux`	Linux
image_category	string	O tipo de imagem. Valores válidos: `system`: imagem pública `self`: imagem personalizada `others`: imagem compartilhada de outras contas Alibaba Cloud `marketplace`: imagem do marketplace	system
architecture	string	A arquitetura da imagem.	x86_64
meta_data	object	Os metadados da versão do Kubernetes.	{ "KubernetesVersion": "1.31.1-aliyun.1", "SubClass": "default", "ServiceCIDR": "" }
runtimes	array	As configurações de runtime de contêiner.
	runtime	As configurações de runtime de contêiner.
version	string	A versão do Kubernetes suportada pelo ACK. Para mais informações, consulte Notas de lançamento para versões do Kubernetes.	1.31.1-aliyun.1
release_date	string	A data de lançamento da versão do Kubernetes.	2025-01-30T00:00:00Z
expiration_date	string	A data de expiração da versão do Kubernetes.	2026-01-30T00:00:00Z
creatable	boolean	Indica se você pode criar clusters que executam a versão do Kubernetes.	true
upgradable_versions	array	A lista de versões do Kubernetes disponíveis para atualização.
	string	A versão do Kubernetes disponível para atualização.	1.32.1-aliyun.1

Exemplos

Resposta de sucesso

JSON formato

[
  {
    "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"
    ]
  }
]

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.