華為云計(jì)算 云知識(shí) 查詢指定版本號(hào)詳情ShowVersion
查詢指定版本號(hào)詳情ShowVersion

 

功能介紹

查詢本服務(wù)的接口目標(biāo)版本號(hào)詳情。

調(diào)試

您可以在API Explorer中直接運(yùn)行調(diào)試該接口。

URI

GET /{api_version}

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
表1 參數(shù)說(shuō)明

名稱

是否必選

參數(shù)類型

說(shuō)明

api_version

String

目標(biāo)版本號(hào)。

獲取版本號(hào)請(qǐng)參考獲取接口版本號(hào)列表。

請(qǐng)求消息

  • 請(qǐng)求參數(shù)

    無(wú)

  • 請(qǐng)求樣例

    本示例展示了查詢v1版本API的版本信息。

    GET https://{endpoint}/v1

響應(yīng)消息

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

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

參數(shù)名稱

類型

說(shuō)明

version

Object

描述version 相關(guān)對(duì)象的列表。

id

String

版本ID(版本號(hào)),如v1。

links

Array

API的URL地址,詳細(xì)信息請(qǐng)參考表3。

version

String

該版本API支持的最大微版本。

status

String

版本狀態(tài),為如下3種:

CURRENT:表示該版本為當(dāng)前推薦使用的版本。

SUPPORTED:表示為老版本,目前還在繼續(xù)維護(hù)。

DEPRECATED:表示為廢棄版本,已不再維護(hù),存在后續(xù)刪除的可能。

updated

String

版本發(fā)布時(shí)間。

時(shí)間格式:UTC YYYY-MM-DDTHH:MM:SS

min_version

String

該版本API 支持的最小微版本。

links參數(shù)信息

links參數(shù)信息說(shuō)明如表3所示。
表3 參數(shù)說(shuō)明

參數(shù)名

參數(shù)類型

說(shuō)明

rel

String

鏈接的描述。

href

String

版本號(hào)查詢鏈接。

  • 響應(yīng)樣例
    {
        "version": {
                "min_version": "", 
                 "links": [
                    {
                        "rel": "self", 
                        "href": "https://dss.localdomain.com/v1"
                    }
                ], 
                "id": "v1", 
                "updated": "2014-06-28T12:20:21Z", 
                "version": "", 
                "status": "CURRENT"
            }
    }

返回值

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼