華為云計(jì)算 云知識(shí) 查詢鏡像支持的OS列表ListOsVersions
查詢鏡像支持的OS列表ListOsVersions

 

功能介紹

查詢當(dāng)前區(qū)域彈性 云服務(wù)器 的OS兼容性列表。

調(diào)試

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

URI

GET /v1/cloudimages/os_version

表1 查詢參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tag

String

OS的標(biāo)簽。

根據(jù)標(biāo)簽值可以過(guò)濾查詢指定特性的OS信息。取值范圍:

  • bms:表示該 鏡像 支持BMS的os_version列表。
  • uefi:支持UEFI啟動(dòng)方式的os_version列表。
  • arm:顯示基于arm架構(gòu)的os_version列表。
  • x86:顯示基于x86架構(gòu)的os_version列表。

不帶tag查詢條件則默認(rèn)查詢當(dāng)前region支持的所有的OS列表。

請(qǐng)求消息

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

    無(wú)

請(qǐng)求示例

  • 查詢當(dāng)前region支持的OS列表
    GET https://{Endpoint}/v1/cloudimages/os_version
  • 根據(jù)過(guò)濾條件查詢OS列表
    GET https://{Endpoint}/v1/cloudimages/os_version?tag=kvm&tag=uefi

響應(yīng)消息

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

    參數(shù)

    參數(shù)類型

    描述

    [數(shù)組]

    Array of objects

    詳情請(qǐng)參見(jiàn)表2。

    表2 [數(shù)組]字段說(shuō)明

    參數(shù)

    參數(shù)類型

    描述

    platform

    String

    操作系統(tǒng)平臺(tái)。

    version_list

    Array of objects

    返回的操作系統(tǒng)詳情。

    具體請(qǐng)參見(jiàn)表3。

    表3 [數(shù)組].version_list字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

    參數(shù)

    參數(shù)類型

    描述

    platform

    String

    操作系統(tǒng)平臺(tái)。

    os_version_key

    String

    操作系統(tǒng)key值。

    默認(rèn)取os_version的值為key值。

    os_version

    String

    操作系統(tǒng)完整信息。

    os_bit

    Integer

    操作系統(tǒng)的位數(shù)。

    os_type

    String

    操作系統(tǒng)的類型。

  • 響應(yīng)樣例
    STATUS CODE 200
    [
        {
            "platform": "SUSE",
            "version_list": [
                {
                    "platform": "SUSE",
                    "os_version_key": "SUSE Linux Enterprise Server 15 64bit",
                    "os_version": "SUSE Linux Enterprise Server 15 64bit",
                    "os_bit": 64,
                    "os_type": "Linux"
                },
                {
                    "platform": "SUSE",
                    "os_version_key": "SUSE Linux Enterprise Server 12 SP3 64bit",
                    "os_version": "SUSE Linux Enterprise Server 12 SP3 64bit",
                    "os_bit": 64,
                    "os_type": "Linux"
                }
            ]
        },
        {
            "platform": "Other",
            "version_list": [
                {
                    "platform": "Other",
                    "os_version_key": "Other(32 bit)",
                    "os_version": "Other(32 bit)",
                    "os_bit": 32,
                    "os_type": "Linux"
                }
            ]
        }
    ]
    

返回值

  • 正常

    200

  • 異常

    返回值

    說(shuō)明

    400 Bad Request

    請(qǐng)求錯(cuò)誤,具體返回錯(cuò)誤碼請(qǐng)參見(jiàn)錯(cuò)誤碼。

    401 Unauthorized

    鑒權(quán)失敗。

    403 Forbidden

    沒(méi)有操作權(quán)限。

    404 Not Found

    找不到資源。

    500 Internal Server Error

    服務(wù)內(nèi)部錯(cuò)誤。

    503 Service Unavailable

    服務(wù)不可用。