镜像服务版本

API 版本

GET
/versions

列出 API 版本

列出此部署支持的所有镜像服务 API 版本信息,包括 URI。

正常响应代码:200

请求

没有请求参数。

响应示例

{
    "versions": [
        {
            "id": "v2.17",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "CURRENT"
        },
        {
            "id": "v2.16",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.15",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.14",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
         {
            "id": "v2.13",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.12",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
         {
            "id": "v2.11",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.10",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.9",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.8",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.7",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.6",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.5",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.4",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.3",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.2",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.1",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.0",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        }
    ]
}
GET
/

列出 API 版本

列出此部署支持的所有镜像服务 API 版本信息,包括 URI。

正常响应代码:300

请求

没有请求参数。

响应示例

{
    "versions": [
        {
            "id": "v2.17",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "CURRENT"
        },
        {
            "id": "v2.16",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.15",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.14",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
         {
            "id": "v2.13",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.12",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
         {
            "id": "v2.11",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.10",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.9",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.8",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.7",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.6",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.5",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.4",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.3",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.2",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.1",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        },
        {
            "id": "v2.0",
            "links": [
                {
                    "href": "http://glance.openstack.example.org/v2/",
                    "rel": "self"
                }
            ],
            "status": "SUPPORTED"
        }
    ]
}

版本历史

2024.2 (Dalmatian) 变更

  • 版本 2.17 是 CURRENT

  • 版本 2.16 是 SUPPORTED

  • 版本 2.15 是 SUPPORTED

  • 版本 2.14 是 SUPPORTED

  • 版本 2.13 是 SUPPORTED

Zed 变更

  • 版本 2.16 是 CURRENT

  • 版本 2.15 是 SUPPORTED

  • 版本 2.14 是 SUPPORTED

  • 版本 2.13 是 SUPPORTED

Yoga 变更

  • 版本 2.15 是 CURRENT

  • 版本 2.14 是 SUPPORTED

  • 版本 2.13 是 SUPPORTED

  • 版本 2.12 是 SUPPORTED

Wallaby 变更

  • 版本 2.12 是 CURRENT

  • 版本 2.11 是 SUPPORTED

  • 版本 2.10 是 SUPPORTED

Victoria 变更

  • 版本 2.11 是 CURRENT

  • 版本 2.10 是 SUPPORTED

  • 版本 2.9 是 SUPPORTED

Ussuri 变更

  • 版本 2.10 是 CURRENT

  • 版本 2.9 是 SUPPORTED

  • 版本 2.8 是 SUPPORTED

Train 变更

  • 版本 2.9 是 CURRENT

  • 版本 2.8 是 SUPPORTED

  • 版本 2.7 是 SUPPORTED

Rocky 变更

  • 版本 2.8 是 EXPERIMENTAL

  • 版本 2.7 是 CURRENT

  • 版本 1.1 已删除

  • 版本 1.0 已删除

Queens 变更

  • 版本 2.6 是 CURRENT

  • 版本 2.5 是 SUPPORTED

Pike 变更

  • 版本 2.6 是 EXPERIMENTAL

Ocata 变更

  • 版本 2.5 是 CURRENT

  • 版本 2.4 是 SUPPORTED

Newton 变更

  • 版本 2.4 是 CURRENT

  • 版本 2.3 是 SUPPORTED

  • 版本 1.1 已弃用

  • 版本 1.0 已弃用

Kilo 变更

  • 版本 2.3 是 CURRENT

  • 版本 1.1 是 SUPPORTED

Havana 变更

  • 版本 2.2 是 CURRENT

  • 版本 2.1 是 SUPPORTED

Grizzly 变更

  • 版本 2.1 是 CURRENT

  • 版本 2.0 是 SUPPORTED

Folsom 变更

  • 版本 2.0 是 CURRENT

Diablo 变更

  • 版本 1.1 是 CURRENT

  • 版本 1.0 是 SUPPORTED

Bexar 变更

  • 版本 1.0 是 CURRENT

v1 API 发生了什么?

镜像服务 API 版本 1 在 OpenStack Newton 版本中已弃用,并在 Rocky 版本的开发周期中移除。包含镜像服务 API v1 的最后一个 OpenStack 版本是 Queens 版本。

镜像服务 API 参考的源代码包含在 OpenStack Glance 源代码仓库中。版本 1 参考的文件不再位于当前开发分支中,但它们可能仍然存在于仓库中的稳定分支中。

如果您想查阅镜像服务 API 版本 1 参考,您可以从仓库中签出稳定分支,在本地构建它,并使用网络浏览器阅读生成的 HTML 文件。

构建 API 参考

您需要在您的系统上安装以下内容

  • python

  • git

  • tox

然后

  1. 前往 GitHub 上的 Glance 仓库镜像:https://github.com/openstack/glance

  2. 将仓库克隆到您的本地系统。

  3. 签出 glance 的 stable/queens 分支。

  4. 从根目录,使用 tox 构建 api-reference

    tox -e api-ref

  5. 镜像服务 API 参考的 HTML 版本将位于 api-ref/build/html 目录中。使用您的浏览器打开该目录中的 index.html 文件,您就可以浏览 API 参考了。