Consulta de información de una versión de API

Función

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

URI

• Formato de URI

  GET /{api_version}

• Descripción del parámetro

  Parámetro	Tipo	Descripción
  api_version	String	Versión de API de destino. El valor puede ser v1 o v2.

Solicitud

• Ejemplo de la solicitud

  GET https://{endpoint}/v2

Respuesta

• Descripción del parámetro

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

• Parámetros en el campo versions

  Parámetro	Tipo	Descripción
  min_version	String	La microversión mínima soportada. Si esta versión no admite microversiones, el valor es una cadena vacía.
  media-types	Array of objects	Tipo de mensaje de solicitud de la versión de 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 API. Para obtener más detalles, consulte Parámetros en el campo de enlaces.
  id	String	El ID de la versión de API.
  updated	String	La última vez que se actualizó la versión de API. Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
  version	String	La microversión máxima soportada. 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 varias versiones. Para las API que ofrecen las mismas funciones, se recomienda utilizar las API v2. SUPPORTED: indica una versión anterior que todavía es compatible. DEPRECATED: indica una versión obsoleta que puede eliminarse más tarde.

• 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 la 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/v2"
                  }
              ], 
              "id": "v2.0", 
              "updated": "2014-06-28T12:20:21Z", 
              "version": "", 
              "status": "SUPPORTED"
          }
      ]
  }

Códigos de error

Véase Códigos de error.