DescribeKubernetesVersionMetadata - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte a documentação de parâmetros de requisição comuns.

Sintaxe da requisição

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

Parâmetros da requisição

Parâmetro	Tipo	Posição	Obrigatório	Exemplo	Descrição
Region	String	Query	Yes	cn-beijing	ID da região do cluster.
ClusterType	String	Query	Yes	Kubernetes	Tipo de cluster. Valores válidos: `Kubernetes`: cluster dedicado do ACK `ManagedKubernetes`: cluster gerenciado do ACK `ExternalKubernetes`: cluster registrado
KubernetesVersion	String	Query	No	1.26.3-aliyun.1	Versão do Kubernetes do cluster. As versões compatíveis com o ACK são as mesmas do Kubernetes open source. Recomendamos especificar a versão mais recente. Se este parâmetro não for especificado, o sistema usará a versão mais recente. É possível criar clusters ACK das duas versões mais recentes do Kubernetes no console do ACK. Para criar clusters de outras versões, chame a operação específica da API do ACK. Para mais detalhes sobre as versões compatíveis, consulte Notas de lançamento das versões do Kubernetes.
Profile	String	Query	No	Default	Cenário de uso dos clusters. Valores válidos: `Default`: cenários sem computação de borda `Edge`: cenários de computação de borda `Serverless`: cenários que exigem clusters serverless Kubernetes (ASK) Valor padrão: `Default`
runtime	String	Query	No	containerd	Tipo de runtime de contêiner desejado. Especifique um tipo de runtime para consultar apenas imagens de SO compatíveis. Valores válidos: `docker`: Docker `containerd`: containerd `Sandboxed-Container.runv`: Sandboxed-Container Ao especificar um tipo de runtime, apenas as imagens de SO compatíveis com esse runtime são retornadas. Caso contrário, todas as imagens de SO serão retornadas.
Mode	String	Query	No	supported	Modo de consulta. Valores válidos: `supported`: consulta as versões do Kubernetes compatíveis. `creatable`: consulta as versões do Kubernetes disponíveis para criação de clusters. Se você especificar `KubernetesVersion`, este parâmetro será ignorado. Sem a definição de um modo de consulta, o sistema retorna as versões do Kubernetes aptas para criação de clusters.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
	Array of Kubernetes versions		Versões do Kubernetes.
capabilities	Map		Recursos da versão do Kubernetes.
images	Array of Kubernetes images		Imagens de SO.
image_id	String	centos_7_9_x64_20G_alibase_20221129.vhd	ID da imagem.
image_name	String	CentOS 7.9	Nome da imagem.
platform	String	CentOS	Plataforma do SO. Valores válidos: `AliyunLinux` `CentOS` `Windows` `WindowsCore`
os_version	String	7.9	Versão da imagem.
image_type	String	CentOS	Tipo de distribuição de SO desejado. Recomendamos usar este parâmetro para definir o SO do nó. Valores válidos: `CentOS` `AliyunLinux` `AliyunLinux Qboot` `AliyunLinuxUEFI` `AliyunLinux3` `Windows` `WindowsCore` `AliyunLinux3Arm64` `ContainerOS`
os_type	String	Linux	Tipo do sistema operacional. Exemplos: `Windows` `Linux`
image_category	String	system	Tipo da imagem. Exemplos: `system`: imagem pública `self`: imagem personalizada `others`: imagem compartilhada de outra conta Alibaba Cloud `marketplace`: imagem do marketplace de imagens
architecture	String	x86_64	Arquitetura da imagem.
meta_data	Map		Metadados da versão do Kubernetes.
runtimes	Array of runtime		Runtimes de contêiner compatíveis.
version	String	1.26.3-aliyun.1	Versão do Kubernetes compatível com o ACK. Para mais informações, consulte Notas de lançamento das versões do Kubernetes.
release_date	String	2023-04-30T00:00:00Z	Data de lançamento da versão do Kubernetes.
expiration_date	String	2025-04-30T00:00:00Z	Data de expiração da versão do Kubernetes.
creatable	Boolean	true	Indica se a versão do Kubernetes pode ser usada para criar clusters.

Exemplos

Exemplos de requisições

GET /api/v1/metadata/versions?Region=cn-beijing&ClusterType=Kubernetes&KubernetesVersion=1.26.3-aliyun.1&Profile=Default&runtime=containerd&Mode=supported HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeKubernetesVersionMetadataResponse>
    <images>
        <image_id>centos_7_9_x64_20G_alibase_20221129.vhd</image_id>
        <image_name>CentOS 7.9</image_name>
        <platform>CentOS</platform>
        <os_version>7.9</os_version>
        <image_type>CentOS</image_type>
        <os_type>Linux</os_type>
        <image_category/>
        <architecture>x86_64</architecture>
    </images>
    <runtimes>
        <name>containerd</name>
        <version>1.6.20</version>
    </runtimes>
    <version>1.26.3-aliyun.1</version>
    <release_date>2023-04-30T00:00:00Z</release_date>
    <expiration_date>2025-04-30T00:00:00Z</expiration_date>
    <creatable>true</creatable>
</DescribeKubernetesVersionMetadataResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

[ {
  "images" : [ {
    "image_id" : "centos_7_9_x64_20G_alibase_20221129.vhd",
    "image_name" : "CentOS 7.9",
    "platform" : "CentOS",
    "os_version" : "7.9",
    "image_type" : "CentOS",
    "os_type" : "Linux",
    "image_category" : "",
    "architecture" : "x86_64"
  } ],
  "runtimes" : [ {
    "name" : "containerd",
    "version" : "1.6.20"
  } ],
  "version" : "1.26.3-aliyun.1",
  "release_date" : "2023-04-30T00:00:00Z",
  "expiration_date" : "2025-04-30T00:00:00Z",
  "creatable" : true
} ]

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.