查询接口的版本信息

功能介绍

查询API接口的版本信息。

URI

• URI格式

  GET /{api_version}

• 参数说明

  参数	参数类型	描述
  api_version	String	查询的目标版本号。

请求消息

• 请求样例：

  GET https://{endpoint}/v2

响应消息

• 响应参数

  参数	参数类型	描述
  versions	Array of objects	接口版本信息列表，请参见•versions参数说明。

• versions参数说明

  参数	参数类型	描述
  min_version	String	接口版本支持的最小微版本号。若该版本不支持微版本，则为空字符串。
  media-types	Array of objects	接口版本的请求消息类型信息，请参见•media-types参数说明。
  links	Array of objects	接口版本信息的URI描述信息，请参见•links参数说明。
  id	String	接口版本的ID。
  updated	String	接口版本更新时间。 时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
  version	String	接口版本支持的最大微版本号。若该版本不支持微版本，则为空字符串。
  status	String	接口版本的状态。存在以下状态： CURRENT：EVS自定义API提供了多个版本。在接口功能相同的情况下，推荐您优先使用v2接口。 SUPPORTED：表示为老版本，但是现在还在继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。

• media-types参数说明

  参数	参数类型	描述
  type	String	返回类型
  base	String	文本类型

• links参数说明

  参数	参数类型	描述
  rel	String	域名的描述
  href	String	域名
  type	String	返回类型

• 响应样例

  {
      "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"
          }
      ]
  }

状态码

• 正常

  200

错误码

请参考错误码。