Consulta de informações de versões da API
Função
Esta API é usada para consultar informações de versões da API.
Solicitação
- Exemplo de solicitação
GET https://{endpoint}/
Resposta
- Descrição do parâmetro
Parâmetro
Tipo
Descrição
versions
Array of objects
As versões da API. Para obter detalhes, consulte Parâmetros no campo versions.
- Parâmetros no campo versions
Parâmetro
Tipo
Descrição
min_version
String
A microversão mínima suportada. Se esta versão não suportar microversões, o valor é uma cadeia vazia.
media-types
Array of objects
O tipo de mensagem de solicitação da versão da API. Para obter detalhes, consulte Parâmetros no campo media-types.
links
Array of objects
O URI da versão da API. Para obter detalhes, consulte Parâmetros no campo links.
id
String
O ID da versão da API.
updated
String
A última vez em que a versão da API foi atualizada.
Formato da hora: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
version
String
A microversão máxima suportada. Se esta versão não suportar microversões, o valor é uma cadeia vazia.
status
String
O status da versão da API. O valor pode ser o seguinte:- CURRENT: as APIs personalizadas do EVS fornecem várias versões. Para as APIs que oferecem as mesmas funções, é recomendável usar as APIs v2.
- SUPPORTED: indica uma versão anterior que ainda é suportada.
- DEPRECATED: indica uma versão preterida que pode ser excluída posteriormente.
- Parâmetros no campo media-types
Parâmetro
Tipo
Descrição
type
String
O tipo de resposta.
base
String
O tipo de texto.
- Parâmetros no campo links
Parâmetro
Tipo
Descrição
rel
String
A descrição do nome de domínio.
href
String
O nome do domínio.
type
String
O tipo de resposta.
- Exemplo de resposta
{ "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 erro
Consulte Códigos de erro.