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

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"
 }
}