glance/api-ref/source/v2/tasks-schemas.inc
bria4010 011235fb2f WADL to RST migration (part 2 - tasks)
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 tasks part of the Images v2 API reference.

Change-Id: I02ea9052c00c069a03c58b17893a5e93828e172d
2016-06-29 12:29:01 -04:00

73 lines
1.3 KiB
ReStructuredText

.. -*- rst -*-
Task Schemas
************
Gets a JSON-schema document that represents an individual task and a
list of tasks.
.. _tasks-schema:
Show tasks schema
~~~~~~~~~~~~~~~~~
.. rest_method:: GET /v2/schemas/tasks
*(Since Images v2.2)*
Shows a JSON schema document that represents a list of *tasks*.
An tasks list entity is a container of entities containing abbreviated
information about individual tasks.
The following schema is solely an example. Consider only the
response to the API call as authoritative.
Normal response codes: 200
Error response codes: 401
Request
-------
This operation has no request parameters and does not accept a request body.
Response Example
----------------
.. literalinclude:: samples/schemas-tasks-list-response.json
:language: json
.. _task-schema:
Show task schema
~~~~~~~~~~~~~~~~
.. rest_method:: GET /v2/schemas/task
*(Since Images v2.2)*
Shows a JSON schema document that represents an *task* 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: 401
Request
-------
This operation has no request parameters and does not accept a request body.
Response Example
----------------
.. literalinclude:: samples/schemas-task-show-response.json
:language: json