文档首页> 云硬盘 EVS> API参考> Cinder API> API版本查询> 查询API接口的版本信息
更新时间:2024-01-02 GMT+08:00
分享

查询API接口的版本信息

功能介绍

查询接口的指定版本信息。

调用方法

请参见如何调用API

URI

GET /{version}

表1 路径参数

参数

是否必选

参数类型

描述

version

String

查询的目标版本号。 取值为:v1、v2、v3。

枚举值:

  • v1

  • v2

  • v3

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

versions

Array of Versions objects

版本信息。

表4 Versions

参数

参数类型

描述

id

String

接口版本的ID

links

Array of Link objects

接口版本信息的URI描述信息

media-types

Array of MediaTypes objects

接口版本的请求消息类型信息

min_version

String

接口版本的最小版本号

status

String

接口版本的状态

updated

String

接口版本更新时间

version

String

接口版本的版本号信息

表6 MediaTypes

参数

参数类型

描述

base

String

文本类型

type

String

返回类型

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息。

表8 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

GET https://{endpoint}/{version}

https://{endpoint}/{version}

响应示例

状态码: 200

版本号详情列表。

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

状态码: 400

Bad Request

{
  "error" : {
    "code" : "string",
    "message" : "string"
  }
}

状态码

状态码

描述

200

版本号详情列表。

400

Bad Request

错误码

请参见错误码

分享:

    相关文档

    相关产品