华为云服务器查询API版本信息列表_云淘科技

功能介绍

返回Nova当前所有可用的版本。

为了支持功能不断扩展,Nova API支持版本号区分。Nova中有两种形式的版本号:

“主版本号”: 具有独立的url。
“微版本号”: 通过Http请求头X-OpenStack-Nova-API-Version来使用,从 2.27 版本开始支持新的微版本头:OpenStack-API-Version。

调试

您可以在API Explorer中调试该接口。

URI

GET /

请求消息

响应消息

响应参数如表1所示。

表1 响应参数

参数

参数类型

描述

versions

Object

API版本信息列表,详情请参见表2。

表2 versions字段数据结构说明

参数

参数类型

描述

id

string

所讨论的版本的通用名称,仅仅是信息性的,它没有真正的语义。

links

Object

版本相关标记快捷链接信息,详情请参见表3。

min_version

string

如果API的这个版本支持微版本,则支持最小的微版本。
如果不支持微版本,这将是空字符串。

status

string

API版本的状态。

CURRENT,这是使用的API的首选版本
SUPPORTED,这是一个较老的,但仍然支持的API版本。
DEPRECATED,一个被废弃的API版本,该版本将被删除。

version

string

如果API的这个版本支持微版本,则支持最大的微版本。
如果不支持微版本,这将是空字符串。

updated

string

一个有特定值的字符串。

API版本为2.0时,值为2011-01-21T11:33:21Z,API版本是2.1时,值为 2013-07-23T11:33:21Z。

表3 links字段数据结构说明

参数

参数类型

描述

href

string

相应资源的链接。

rel

string

self:自助链接包含版本链接的资源。立即链接后使用这些链接。
bookmark:书签链接提供了一个永久资源的永久链接,该链接适合于长期存储。
alternate:备用链接可以包含资源的替换表示形式。

例如,OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。

请求示例

查询API支持版本信息列表。

GET https://{endpoint}/

响应示例

{
 "versions": [{
  "links": [{
   "rel": "self",
   "href": "https://ecs.service.domain.com:443/v2/"
  }],
  "id": "v2.0",
  "updated": "2001-09-21T12:33:21Z",
  "status": "SUPPORTED"
 }]
}

返回值

请参考通用请求返回值。

父主题: 查询API版本信息

内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家