Image Service Versions¶
API versions¶
Lists information about all Image service API versions supported by this deployment, including the URIs.
Normal response codes: 200
Request¶
There are no request parameters.
Response Example¶
{
"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"
}
]
}
Lists information about all Image service API versions supported by this deployment, including the URIs.
Normal response codes: 300
Request¶
There are no request parameters.
Response Example¶
{
"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"
}
]
}
Version History¶
2024.2 (Dalmatian) changes
version 2.17 is CURRENT
version 2.16 is SUPPORTED
version 2.15 is SUPPORTED
version 2.14 is SUPPORTED
version 2.13 is SUPPORTED
Zed changes
version 2.16 is CURRENT
version 2.15 is SUPPORTED
version 2.14 is SUPPORTED
version 2.13 is SUPPORTED
Yoga changes
version 2.15 is CURRENT
version 2.14 is SUPPORTED
version 2.13 is SUPPORTED
version 2.12 is SUPPORTED
Wallaby changes
version 2.12 is CURRENT
version 2.11 is SUPPORTED
version 2.10 is SUPPORTED
Victoria changes
version 2.11 is CURRENT
version 2.10 is SUPPORTED
version 2.9 is SUPPORTED
Ussuri changes
version 2.10 is CURRENT
version 2.9 is SUPPORTED
version 2.8 is SUPPORTED
Train changes
version 2.9 is CURRENT
version 2.8 is SUPPORTED
version 2.7 is SUPPORTED
Rocky changes
version 2.8 is EXPERIMENTAL
version 2.7 is CURRENT
version 1.1 is DELETED
version 1.0 is DELETED
Queens changes
version 2.6 is CURRENT
version 2.5 is SUPPORTED
Pike changes
version 2.6 is EXPERIMENTAL
Ocata changes
version 2.5 is CURRENT
version 2.4 is SUPPORTED
Newton changes
version 2.4 is CURRENT
version 2.3 is SUPPORTED
version 1.1 is DEPRECATED
version 1.0 is DEPRECATED
Kilo changes
version 2.3 is CURRENT
version 1.1 is SUPPORTED
Havana changes
version 2.2 is CURRENT
version 2.1 is SUPPORTED
Grizzly changes
version 2.1 is CURRENT
version 2.0 is SUPPORTED
Folsom changes
version 2.0 is CURRENT
Diablo changes
version 1.1 is CURRENT
version 1.0 is SUPPORTED
Bexar changes
version 1.0 is CURRENT
What happened to the v1 API?¶
The Image Service API version 1 was DEPRECATED in the OpenStack Newton release and removed during the development cycle for the Rocky release. The last OpenStack release containing the Image Service API v1 was the Queens release.
The source files for the Image Service API Reference are contained in the OpenStack Glance source code repository. The files for the version 1 reference are no longer in the current development branch, but they may still be found in the stable branches in the repository.
If you would like to consult the Image Service API version 1 Reference, you can check out a stable branch from the repository, build it locally, and use a web browser to read the generated HTML files.
Building the API Reference¶
You’ll need to have the following installed on your system:
python
git
tox
Then:
Go to the Glance repository mirror on GitHub: https://github.com/openstack/glance
Clone the repository to your local system.
Checkout the stable/queens branch of glance.
From the root directory, use tox to build the api-reference:
tox -e api-refThe HTML version of the Image Service API Reference will be located in the
api-ref/build/htmldirectory. Use your browser to open theindex.htmlfile in that directory and you’ll be able to browse the API Reference.
