文档首页/ 镜像服务 IMS/ API参考/ API/ 镜像/ 查询镜像支持的OS列表
更新时间：2024-06-24 GMT+08:00
查看PDF
分享

查询镜像支持的OS列表

功能介绍

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

华为云不再提供Windows操作系统类型的镜像，该接口不再支持Windows镜像的查询。

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

    服务不可用。
父主题： 镜像