Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Cloud Container Engine/Referência de API/APIs/Versões de API/Obtenção de versões da API
Atualizado em 2024-09-10 GMT+08:00
Ver PDF
Compartilhar

Obtenção de versões da API

Função

Essa API é usada para consultar a lista de versões de API suportadas pelo CCE.

URI

GET /

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de status: 200

Tabela 1 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

versions

Array of APIVersionDetail objects

Lista de versões da API.

Tabela 2 APIVersionDetail

Parâmetro

Tipo

Descrição

id

String

ID da versão de API. Exemplo: v3

links

Array of APIVersionLink objects

URL da versão da API.

min_version

String

Microversão. Se as APIs desta versão suportarem microversões, defina este parâmetro como a microversão mínima suportada. Se nenhuma microversão não for suportada, deixe este parâmetro em branco.

status

String

Status da versão da API. Valores possíveis:

  • CURRENT: versão preferida da API

  • SUPPORTED: versão anterior da API que ainda é suportada

  • DEPRECATED: versão da API descartada que será excluída

updated

String

Hora em que a API foi lançada (UTC). Por exemplo, se a versão da API for v3, o valor será '2018-09-15 00:00:00Z'.

version

String

Microversão. Se as API desta versão suportarem microversões, defina este parâmetro para a microversão máxima suportada. Se nenhuma microversão não for suportada, deixe este parâmetro em branco.

Tabela 3 APIVersionLink

Parâmetro

Tipo

Descrição

href

String

URL da versão da API.

rel

String

Atributos do link. self: um self link contém um link versionado para o recurso. Use esses links imediatamente após a vinculação.

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

A lista de versões da API foi consultada com êxito.

{
  "versions" : [ {
    "id" : "v3",
    "links" : [ {
      "href" : "https://cce.region.***.com/v3",
      "rel" : "self"
    } ],
    "min_version" : "",
    "status" : "CURRENT",
    "updated" : "2018-09-15 00:00:00Z",
    "version" : ""
  } ]
}

Códigos de status

Código de status

Descrição

200

A lista de versões da API foi consultada com êxito.

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Versões de API