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

Consulta as informações detalhadas sobre as 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 do ACK. `ManagedKubernetes`: cluster gerenciado do ACK. Os clusters gerenciados do 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 de código aberto. Recomendamos que você especifique 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 obter mais informações sobre as versões do Kubernetes suportadas pelo ACK, consulte Notas de lançamento das versões do Kubernetes.	1.32.1-aliyun.1
Profile	string	Não	O cenário em que os clusters são usados. Valores válidos: `Default`: cenários de computação que não sejam de borda `Edge`: cenários de computação de borda `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 as imagens de sistema operacional 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 sistema operacional que suportam o tipo de runtime especificado serão retornadas. Caso contrário, todas as imagens de sistema operacional serão retornadas.	containerd
Mode	string	Não	O modo de consulta. Valores válidos: `supported`: consulta todas as versões suportadas do Kubernetes. `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ções. Este parâmetro só tem efeito quando o parâmetro KubernetesVersion é especificado. true: consulta as versões do Kubernetes disponíveis para atualizações. false: não consulta as versões do Kubernetes disponíveis para atualizações.	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	Os recursos da versão do Kubernetes consultada.	{ "AnyAZ": true, "ChargeType": "PostPaid" }
images	array<object>	As imagens de sistema operacional 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 sistema operacional. Você pode obter o ID do terminal chamando uma das seguintes operações: `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. Recomendamos que você use este parâmetro para especificar o sistema operacional do nó. Você pode obter o ID do terminal chamando uma das seguintes operações: `CentOS` `AliyunLinux` `AliyunLinux Qboot` `AliyunLinuxUEFI` `AliyunLinux3` `Windows` `WindowsCore` `AliyunLinux3Arm64` `ContainerOS`	AliyunLinux3
os_type	string	O tipo de sistema operacional. 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 da 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 obter mais informações, consulte Notas de lançamento das 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ções.
	string	A versão do Kubernetes disponível para atualizações.	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.