更新时间:2024-04-16 GMT+08:00

查询镜像支持的OS列表

功能介绍

查询当前区域弹性云服务器的OS兼容性列表。

URI

GET /v1/cloudimages/os_version

表1 查询参数

参数

是否必选

参数类型

描述

tag

String

OS的标签。

根据标签值可以过滤查询指定特性的OS信息。取值范围:

  • bms:表示该镜像支持BMS的os_version列表。
  • uefi:支持UEFI启动方式的os_version列表。

不带tag查询条件则默认查询当前region支持的所有的OS列表。

请求消息

  • 请求参数

请求示例

  • 查询当前region支持的OS列表
    GET https://{Endpoint}/v1/cloudimages/os_version
  • 根据过滤条件查询OS列表
    GET https://{Endpoint}/v1/cloudimages/os_version?tag=kvm&tag=uefi

响应消息

  • 响应参数

    参数

    参数类型

    描述

    [数组]

    Array of objects

    详情请参见表2

    表2 [数组]字段说明

    参数

    参数类型

    描述

    platform

    String

    操作系统平台。

    version_list

    Array of objects

    返回的操作系统详情。

    具体请参见表3

    表3 [数组].version_list字段数据结构说明

    参数

    参数类型

    描述

    platform

    String

    操作系统平台。

    os_version_key

    String

    操作系统key值。

    默认取os_version的值为key值。

    os_version

    String

    操作系统完整信息。

    os_bit

    Integer

    操作系统的位数。

    os_type

    String

    操作系统的类型。

  • 响应样例
    STATUS CODE 200
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    [
        {
            "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

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参见错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。