c028c2d23e
This brings the Images API Reference to the glance tree as part of the effort described here: https://wiki.openstack.org/wiki/Documentation/Migrate#API_Reference_Plan This patch contains the content of the Images v2 API reference converted to RST. The content has been corrected where I noticed divergences with reality (which actually happened a lot, so this patch contains a lot of revisions). Tasks and metadefs are submitted as separate patches. Change-Id: If69c469da7f28f090a2286ec0b115d9bcaac4fbf Closes-Bug: #1550457 Closes-Bug: #1589264 Closes-Bug: #1592715
139 lines
2.6 KiB
ReStructuredText
139 lines
2.6 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
.. note: You can get a 400 on a GET if you pass a request body
|
|
(see router.py)
|
|
|
|
Image Schemas
|
|
*************
|
|
|
|
Gets a JSON-schema document that represents the various entities talked
|
|
about by the Images v2 API.
|
|
|
|
.. _images-schema:
|
|
|
|
Show images schema
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/schemas/images
|
|
|
|
*(Since Images v2.0)*
|
|
|
|
Shows a JSON schema document that represents an *images* entity.
|
|
|
|
An images entity is a container of image entities.
|
|
|
|
The following schema is solely an example. Consider only the
|
|
response to the API call as authoritative.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 400, 401
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
This operation has no request parameters and does not accept a request body.
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/schemas-images-list-response.json
|
|
:language: json
|
|
|
|
.. _image-schema:
|
|
|
|
Show image schema
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/schemas/image
|
|
|
|
*(Since Images v2.0)*
|
|
|
|
Shows a JSON schema document that represents an *image* entity.
|
|
|
|
The following schema is solely an example. Consider only the
|
|
response to the API call as authoritative.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 400, 401
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
This operation has no request parameters and does not accept a request body.
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/schemas-image-show-response.json
|
|
:language: json
|
|
|
|
.. _image-members-schema:
|
|
|
|
Show image members schema
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/schemas/members
|
|
|
|
*(Since Images v2.1)*
|
|
|
|
Shows a JSON schema document that represents an *image members* entity.
|
|
|
|
An image members entity is a container of image member entities.
|
|
|
|
The following schema is solely an example. Consider only the
|
|
response to the API call as authoritative.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 400, 401
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
This operation has no request parameters and does not accept a request body.
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/schemas-image-members-list-response.json
|
|
:language: json
|
|
|
|
.. _image-member-schema:
|
|
|
|
Show image member schema
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/schemas/member
|
|
|
|
*(Since Images v2.1)*
|
|
|
|
Shows a JSON schema document that represents an *image member* entity.
|
|
|
|
The following schema is solely an example. Consider only the
|
|
response to the API call as authoritative.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 400, 401
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
This operation has no request parameters and does not accept a request body.
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/schemas-image-member-show-response.json
|
|
:language: json
|