Consulta de información de versiones de API
Función
Esta API se utiliza para consultar información de las versiones de API.
Método de invocación
Para obtener más información, consulte Invocación a las API.
URI
GET /
Parámetros de solicitud
No hay
Parámetros de respuesta
Código de estado: 300
Parámetro | Tipo | Descripción |
|---|---|---|
versions | Array of Versions objects | Información sobre la versión. |
Parámetro | Tipo | Descripción |
|---|---|---|
id | String | ID de versión de API. |
links | Array of Link objects | El URI de la versión de API. |
media-types | Array of MediaTypes objects | El tipo de mensaje de solicitud de la versión de API. |
min_version | String | La versión mínima de API. |
status | String | El estado de la versión de la API. |
updated | String | La última vez que se actualizó la versión de API. |
version | String | El número de versión de la API. |
Parámetro | Tipo | Descripción |
|---|---|---|
href | String | El enlace de acceso directo correspondiente. |
rel | String | El nombre del marcador de enlace de acceso directo. Valor predeterminado: next |
Código de estado: 400
Parámetro | Tipo | Descripción |
|---|---|---|
error | Error object | El mensaje de error devuelto si se produce un error. |
Parámetro | Tipo | Descripción |
|---|---|---|
code | String | El código de error devuelto si se produce un error. Para obtener más detalles sobre los códigos de error y sus significados, consulte Códigos de errores. |
message | String | El mensaje de error devuelto si se produce un error. |
Ejemplo de solicitudes
GET https://{endpoint}/
https://{endpoint}/ Ejemplo de respuestas
Código de estado: 300
Se devuelven los detalles de las versiones de API.
{
"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ódigo de estado: 400
Error en la solicitud
{
"error" : {
"code" : "string",
"message" : "string"
}
} Códigos de estado
Código de estado | Descripción |
|---|---|
300 | Se devuelven los detalles de las versiones de API. |
400 | Error en la solicitud |
Códigos de error
Consulte Códigos de error.
