華為云計算 云知識 查詢API接口的版本信息ShowVersion
查詢API接口的版本信息ShowVersion

 

功能介紹

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

URI

GET /{version}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

version

String

查詢的目標(biāo)版本號。 取值為:v1、v2、v3。

枚舉值:

  • v1

  • v2

  • v3

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

versions

Array of Versions objects

版本信息。

表4 Versions

參數(shù)

參數(shù)類型

描述

id

String

接口版本的ID

links

Array of Link objects

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

media-types

Array of MediaTypes objects

接口版本的請求消息類型信息

min_version

String

接口版本的最小版本號

status

String

接口版本的狀態(tài)

updated

String

接口版本更新時間

version

String

接口版本的版本號信息

表6 MediaTypes

參數(shù)

參數(shù)類型

描述

base

String

文本類型

type

String

返回類型

狀態(tài)碼: 400

表7 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯誤時,返回的錯誤信息。

表8 Error

參數(shù)

參數(shù)類型

描述

code

String

出現(xiàn)錯誤時,返回的錯誤碼。錯誤碼和其對應(yīng)的含義請參考錯誤碼說明。

message

String

出現(xiàn)錯誤時,返回的錯誤消息。

請求示例

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

https://{endpoint}/{version}

響應(yīng)示例

狀態(tài)碼: 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"
  } ]
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

200

版本號詳情列表。

400

Bad Request

錯誤碼

請參見錯誤碼。