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/ Elastic Cloud Server/ Referência de API/ As API da Nova do OpenStack/ Consulta de versão da API/ Consulta de uma versão de API especificada
Atualizado em 2025-08-25 GMT+08:00
Ver PDF
Compartilhar

Consulta de uma versão de API especificada

Descrição da Função

Esta API é usada para consultar as informações de uma versão especificada.

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 versão 2.27, o novo cabeçalho microversion OpenStack-API-Version tem sido suportado.

    Se o cabeçalho da solicitação OpenStack-API-Version for usado, a versão estará no formato de "compute microversion".

    Por exemplo, se a key estiver definida como OpenStack-API-Version, defina o value para compute 2.27.

URI

GET /{api_version}

Tabela 1 descreve os parâmetros no URI.
Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

api_version

Sim

Especifica uma versão da API, como V2.

Solicitação

Nenhum

Resposta

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

Tabela 2 Parâmetros de resposta

Parâmetro

Tipo

Descrição

versions

Object

Especifica as versões. Para mais detalhes, consulte Tabela 3.
Tabela 3 descrição do campo versions

Parâmetro

Tipo

Descrição

id

string

Especifica a ID da versão.

links

Object

Especifica os links para recursos. Para obter mais informações, consulte a documentação do OpenStack.

Para mais detalhes, consulte Tabela 4.

media-types

Object

Especifica os tipos de mídia. Para mais detalhes, consulte Tabela 5.

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.

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.

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.
Tabela 4 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.
Tabela 5 descrição do campo media-types

Parâmetro

Tipo

Descrição

base

string

Especifica o tipo básico.

type

string

Especifica o tipo de mídia.

Exemplo de solicitação

GET https://{endpoint}/v2

Exemplo de resposta

{
 "version": {
  "min_version": "",
  "media-types": [{
   "type": "application/vnd.openstack.compute+json;version=2",
   "base": "application/json"
  }],
  "links": [{
   "rel": "self",
   "href": "https://ecs.service.domain.com:443/v2/"
  },
  {
   "rel": "describedby",
   "href": "http://docs.openstack.org/",
   "type": "text/html"
  }],
  "id": "v2.0",
  "updated": "1999-02-20T11:33:21Z",
  "version": "",
  "status": "SUPPORTED"
 }
}

Valores retornados

Consulte Valores retornados para solicitações gerais.

Tópico principal: Consulta de versão da API