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.
Atualizado em 2022-11-08 GMT+08:00

Consulta de todas as versões da API

Função

Esta API é usada para consultar todas as versões disponíveis do Nova.

Para suportar a extensão de função, as API Nova podem ser distinguidas por versão. Existem dois tipos de versões:

  • Versão principal: URL independente
  • Microversão: Usado pelo cabeçalho da solicitação HTTP X-OpenStack-Nova-API-Version. Desde a microversão 2.27, o novo cabeçalho de microversão OpenStack-API-Version tem sido suportado.

URI

GET /

Solicitação

Nenhum

Resposta

A tabela a seguir descreve os parâmetros de resposta.

Tabela 1 Parâmetros de resposta

Parâmetro

Tipo

Descrição

versions

Object

Especifica as versões da API. Para mais detalhes, consulte Tabela 2.

Tabela 2 descrição do campo versions

Parâmetro

Tipo

Descrição

id

string

Especifica a ID da versão.

links

Object

Especifica links de atalho para versões. Para mais detalhes, consulte Tabela 3.

min_version

string

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

status

string

Especifica o status da versão da API. Os valores possíveis são os seguintes:

  • CURRENT: Esta é a versão preferida da API.
  • SUPPORTED: Esta é a versão antiga da API que ainda é suportada.
  • DEPRECATED: Esta é a versão da API obsoleta que será removida.

version

string

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

updated

string

O valor desse parâmetro varia de acordo com a versão da API.

Se a versão da API for 2.0, o valor será 2011-01-21T11:33:21Z. Se a versão da API for 2.1, o valor será 2013-07-23T11:33:21Z.

Tabela 3 descrição do campo links

Parâmetro

Tipo

Descrição

href

string

Especifica os links dos recursos correspondentes.

rel

string

  • self: Um self link contém um link versionado para o recurso. Use esses links quando o link for seguido imediatamente.
  • bookmark: Um link de favorito fornece um link permanente para um recurso que é apropriado para armazenamento de longo prazo.
  • alternate: Um link alternativo pode conter uma representação alternativa do recurso.

    Por exemplo, uma imagem de computação do OpenStack pode ter uma representação alternativa no serviço de imagem do OpenStack.

Exemplo de solicitação

GET https://{endpoint}/

Exemplo de resposta

{
 "versions": [{
  "links": [{
   "rel": "self",
   "href": "https://ecs.service.domain.com:443/v2/"
  }],
  "id": "v2.0",
  "updated": "2001-09-21T12:33:21Z",
  "status": "SUPPORTED"
 }]
}

Valores retornados

Consulte Valores retornados para solicitações gerais.