Consulta de información de versiones de API

Función

Esta API se utiliza para consultar información de versiones de API.

URI

• Formato de URI

  GET /

Solicitud

• Ejemplo de solicitud

  GET https://{endpoint}/

Respuesta

• Descripción de parámetros

  Parámetro	Tipo	Descripción
  versions	Array of objects	Las versiones de la API. Para obtener más información, consulte Parámetros en el campo versions.

• Parámetros en el campo versions

  Parámetro	Tipo	Descripción
  min_version	String	La microversión mínima admitida. Si esta versión no admite microversiones, el valor es una cadena vacía.
  media-types	Array of objects	El tipo de mensaje de solicitud de la versión de la API. Para obtener más información, consulte Parámetros en el campo media-types.
  links	Array of objects	El URI de la versión de la API. Para obtener más información, consulte Parámetros en el campo links.
  id	String	El ID de la versión de la API.
  updated	String	La última vez que se actualizó la versión de la API. Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
  version	String	La microversión máxima admitida. Si esta versión no admite microversiones, el valor es una cadena vacía.
  status	String	El estado de la versión de la API. El valor puede ser el siguiente: CURRENT: Las API personalizadas de EVS proporcionan múltiples versiones. Para las API que ofrecen las mismas funciones, se recomienda utilizar las API v2. SUPPORTED: indica una versión anterior que todavía se admite. DEPRECATED: indica una versión obsoleta que puede eliminarse más adelante.

• Parámetros en el campo media-types

  Parámetro	Tipo	Descripción
  type	String	El tipo de respuesta.
  base	String	El tipo de texto.

• Parámetros en el campo links

  Parámetro	Tipo	Descripción
  rel	String	La descripción del nombre de dominio.
  href	String	El nombre de dominio.
  type	String	El tipo de respuesta.

• Ejemplo de respuesta

  {
      "versions": [
          {
              "min_version": "", 
              "media-types": [
                  {
                      "type": "application/vnd.openstack.volume+json;version=1", 
                      "base": "application/json"
                  }, 
                  {
                      "type": "application/vnd.openstack.volume+xml;version=1", 
                      "base": "application/xml"
                  }
              ], 
              "links": [
                  {
                      "rel": "describedby", 
                      "href": "http://docs.openstack.org/", 
                      "type": "text/html"
                  }, 
                  {
                      "rel": "self", 
                      "href": "https://evs.localdomain.com/v1"
                  }
              ], 
              "id": "v1.0", 
              "updated": "2014-06-28T12:20:21Z", 
              "version": "", 
              "status": "SUPPORTED"
          }, 
          {
              "min_version": "", 
              "media-types": [
                  {
                      "type": "application/vnd.openstack.volume+json;version=1", 
                      "base": "application/json"
                  }, 
                  {
                      "type": "application/vnd.openstack.volume+xml;version=1", 
                      "base": "application/xml"
                  }
              ], 
              "links": [
                  {
                      "rel": "describedby", 
                      "href": "http://docs.openstack.org/", 
                      "type": "text/html"
                  }, 
                  {
                      "rel": "self", 
                      "href": "https://evs.localdomain.com/v2"
                  }
              ], 
              "id": "v2.0", 
              "updated": "2014-06-28T12:20:21Z", 
              "version": "", 
              "status": "SUPPORTED"
          }, 
          {
              "min_version": "3.0", 
              "media-types": [
                  {
                      "type": "application/vnd.openstack.volume+json;version=1", 
                      "base": "application/json"
                  }, 
                  {
                      "type": "application/vnd.openstack.volume+xml;version=1", 
                      "base": "application/xml"
                  }
              ], 
              "links": [
                  {
                      "rel": "describedby", 
                      "href": "http://docs.openstack.org/", 
                      "type": "text/html"
                  }, 
                  {
                      "rel": "self", 
                      "href": "https://evs.localdomain.com/v3"
                  }
              ], 
              "id": "v3.0", 
              "updated": "2016-02-08T12:20:21Z", 
              "version": "3.0", 
              "status": "CURRENT"
          }
      ]
  }

Códigos de estado

• Normal

  300

Códigos de error

Consulte Códigos de error.