華為云計(jì)算 云知識(shí) 彈性云服務(wù)器查詢指定API版本信息NovaShowVersion
彈性云服務(wù)器查詢指定API版本信息NovaShowVersion
時(shí)間: 2023-07-24 09:55:59
猜你想看：
實(shí)時(shí)語音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

功能介紹

返回指定版本的信息。

為了支持功能不斷擴(kuò)展，Nova API支持版本號(hào)區(qū)分。Nova中有兩種形式的版本號(hào)：

  • "主版本號(hào)": 具有獨(dú)立的url。
  • "微版本號(hào)": 通過Http請(qǐng)求頭X-OpenStack-Nova-API-Version來使用，從 2.27 版本開始支持新的微版本頭：OpenStack-API-Version。

    如果使用OpenStack-API-Version的請(qǐng)求頭，version對(duì)應(yīng)的value取值格式為 compute 微版本號(hào)。

    例如：key為OpenStack-API-Version的時(shí)候value需要填compute 2.27。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /{api_version}

參數(shù)說明請(qǐng)參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

api_version

是

API版本號(hào)。例如: v2

請(qǐng)求消息

無

響應(yīng)消息

響應(yīng)參數(shù)如表2所示。

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

參數(shù)

參數(shù)類型

描述

versions

Object

指定版本信息，詳情請(qǐng)參見表3。
表3 versions字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

string

所討論的版本的通用名稱。僅僅是信息性的，它沒有真正的語義。

links

Object

鏈接到資源的問題。有關(guān)更多信息，請(qǐng)參見OpenStack Documentation。

詳情請(qǐng)參見表4。

media-types

Object

媒體類型。詳情請(qǐng)參見表5。

min_version

string
  • 如果API的這個(gè)版本支持微版本，則支持最小的微版本。
  • 如果不支持微版本，這將是空字符串。

status

string

API版本的狀態(tài)：

  • CURRENT這是使用的API的首選版本；
  • SUPPORTED：這是一個(gè)較老的，但仍然支持的API版本；
  • DEPRECATED：一個(gè)被廢棄的API版本，該版本將被刪除

updated

string

一個(gè)有特定值的字符串。API版本為2.0時(shí)，值為2011-01-21T11:33:21Z ，API版本是2.1時(shí)，值為2013-07-23T11:33:21Z。

version

string
  • 如果API的這個(gè)版本支持微版本，則支持最大的微版本。
  • 如果不支持微版本，這將是空字符串。
表4 links字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

href

string

相應(yīng)資源的鏈接。

rel

string
  • self：自助鏈接包含版本鏈接的資源。立即鏈接后使用這些鏈接。
  • bookmark：書簽鏈接提供了一個(gè)永久資源的永久鏈接，該鏈接適合于長期存儲(chǔ)。
  • alternate：備用鏈接可以包含資源的替換表示形式。例如，OpenStack計(jì)算映像可能在OpenStack映像服務(wù)中有一個(gè)替代表示。
表5 media-types字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

base

string

基礎(chǔ)類型。

type

string

媒體類型。

請(qǐng)求示例

查詢指定API的版本信息。

GET https://{endpoint}/v2

響應(yīng)示例

{
 "version": {
  "min_version": "",
  "media-types": [{
   "type": "application/vnd.openstack.compute+json;version=2",
   "base": "application/json"
  }],
  "links": [{
   "rel": "self",
   "href": "https://ecs.service.domain.com:443/v2/"
  },
  {
   "rel": "describedby",
   "href": "http://docs.openstack.org/",
   "type": "text/html"
  }],
  "id": "v2.0",
  "updated": "1999-02-20T11:33:21Z",
  "version": "",
  "status": "SUPPORTED"
 }
}

返回值

請(qǐng)參考通用請(qǐng)求返回值。

彈性云服務(wù)器查詢指定API版本信息NovaShowVersion

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！