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 |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
base |
String |
El tipo de texto. |
|
type |
String |
El tipo de retorno. |
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.
