Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Consulta de la versión de API/ Consultar una versión especificada de API

Actualización más reciente 2022-11-08 GMT+08:00

Consultar una versión especificada de API

Descripción de funciones

Esta API se utiliza para consultar la información de una versión especificada.

Para admitir la extensión de funciones, las API de Nova se pueden distinguir por versión. Hay dos tipos de versiones:

Versión principal: URL independiente
Microversión: Utilizado por el encabezado de solicitud HTTP X-OpenStack-Nova-API-Version. Desde la versión 2.27, se ha soportado el nuevo encabezado de microversión OpenStack-API-Version.

Si se utiliza el encabezado de solicitud OpenStack-API-Version, la versión tiene el formato de "compute microversion".

Por ejemplo, si key está establecida en OpenStack-API-Version, establezca value a compute 2.27.

URI

GET /{api_version}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
api_version	Yes	Especifica una versión de API, como V2.

Solicitud

No hay

Respuesta

En la siguiente tabla se describen los parámetros de respuesta.

**Tabla 2** Parámetros de respuesta
Parámetro	Tipo	Descripción
versions	Object	Especifica las versiones. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **versions**
Parámetro	Tipo	Descripción
id	string	Especifica el ID de versión.
links	Object	Especifica los vínculos a los recursos. Para obtener más información, consulte la documentación del OpenStack. Para más detalles, consulte Tabla 4.
media-types	Object	Especifica los tipos de medios. Para más detalles, consulte Tabla 5.
min_version	string	Especifica la microversión. Si las API de esta versión admiten microversiones, establezca este parámetro en la microversión mínima admitida. Si la microversión no es compatible, deje este parámetro en blanco.
status	string	Especifica el estado de la versión de la API. Los valores posibles son los siguientes: CURRENT: Esta es la versión preferida de la API. SUPPORTED: Esta es la versión antigua de la API que todavía es compatible. DEPRECATED: Esta es la versión obsoleta de la API que se eliminará.
updated	string	El valor de este parámetro varía según la versión de la API. Si la versión de la API es 2.0, el valor es 2011-01-21T11:33:21Z. Si la versión de la API es 2.1, el valor es 2013-07-23T11:33:21Z.
version	string	Especifica la microversión. Si las API de esta versión admiten microversiones, establezca este parámetro en la microversión máxima admitida. Si la microversión no es compatible, deje este parámetro en blanco.

**Tabla 4** Descripción del campo **links**
Parámetro	Tipo	Descripción
href	string	Especifica los vínculos de los recursos correspondientes.
rel	string	self: Un enlace propio contiene un enlace versionado al recurso. Utilice estos enlaces cuando el enlace se siga inmediatamente. bookmark: un enlace de marcador proporciona un enlace permanente a un recurso que es apropiado para almacenamiento a largo plazo. alternate: un enlace alternativo puede contener una representación alternativa del recurso. Por ejemplo, una imagen de cómputo OpenStack podría tener una representación alternativa en el servicio de imagen OpenStack.

**Tabla 5** Descripción del campo **media-types**
Parámetro	Tipo	Descripción
base	string	Especifica el tipo básico.
type	string	Especifica el tipo de medio.

Ejemplo de la solicitud

GET https://{endpoint}/v2

Ejemplo de la respuesta

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