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.
Actualización más reciente 2022-11-08 GMT+08:00

Consulta de todas las versiones de la API

Función

Esta API se utiliza para consultar todas las versiones de Nova disponibles.

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 microversión 2.27, se ha soportado el nuevo encabezado de microversión OpenStack-API-Version.

URI

GET /

Solicitud

No hay

Respuesta

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

Tabla 1 Parámetros de respuesta

Parámetro

Tipo

Descripción

versions

Object

Especifica las versiones de la API. Para más detalles, consulte Tabla 2.

Tabla 2 Descripción del campo versions

Parámetro

Tipo

Descripción

id

string

Especifica el ID de versión.

links

Object

Especifica los vínculos de acceso directo para las versiones. Para más detalles, consulte Tabla 3.

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á.

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.

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.

Tabla 3 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.

Ejemplo de la solicitud

GET https://{endpoint}/

Ejemplo de la respuesta

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