文档首页/ 镜像服务 IMS/ API参考/ OpenStack原生API/ 查询API版本信息（OpenStack原生）/ 查询指定版本信息（OpenStack原生）
更新时间：2025-09-23 GMT+08:00
查看PDF
分享

查询指定版本信息（OpenStack原生）

功能介绍

查询指定版本API的信息，包括该版本API的兼容性、域名信息等。

URI

GET /{version}

参数说明请参见表1。

表1 参数说明

参数

是否必选

参数类型

描述

version

是

String

API版本号。例如：v2.0

请求消息

请求参数

无

请求示例

查询指定版本API的信息。

GET https://{Endpoint}/v2.0

响应消息

  • 响应参数

    参数

    参数类型

    描述

    versions

    Array of objects

    版本信息。

    详情请参见表2。
    表2 versions字段说明

    参数

    参数类型

    描述

    status

    String

    接口状态。

    取值范围：

    • CURRENT: 这是使用的API的首选版本。
    • SUPPORTED : 这是一个较老的，但仍然支持的API版本。
    • DEPRECATED: 一个被废弃的API版本，该版本将被删除。

    id

    String

    接口ID。

    links

    Array of objects

    自描述信息。

    详情请参见表3。
    表3 versions.links字段说明

    参数

    参数类型

    描述

    href

    String

    域名。

    rel

    String

    域名描述。
  • 响应样例 
    STATUS CODE 300
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
    		 
    {
    "versions": [
        {
            "status": "SUPPORTED",
            "id": "v2.0",
            "links": [
                {
                    "href": "https://image.az1.dc1.domainname.com/v2/",
                    "rel": "self"
                }
            ]
        }
    ]
}

返回值

  • 正常

    300

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

相关文档