glance/api-ref/source/v2/images-tags.inc
bria4010 c028c2d23e WADL to RST migration (part 2 - images)
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
2016-07-18 17:52:40 -04:00

53 lines
803 B
ReStructuredText

.. -*- rst -*-
Image tags
**********
Adds and deletes image tags.
Image tags may also be modfied by the :ref:`v2-image-update` call.
Add image tag
~~~~~~~~~~~~~
.. rest_method:: PUT /v2/images/{image_id}/tags/{tag}
Adds a tag to an image.
*(Since Image API v2.0)*
Normal response codes: 204
Error response codes: 400, 401, 403, 404, 413
Request
-------
.. rest_parameters:: images-parameters.yaml
- image_id: image_id-in-path
- tag: tag-in-path
Delete image tag
~~~~~~~~~~~~~~~~
.. rest_method:: DELETE /v2/images/{image_id}/tags/{tag}
Deletes a tag from an image.
*(Since Image API v2.0)*
Normal response codes: 204
Error response codes: 400, 401, 403, 404
Request
-------
.. rest_parameters:: images-parameters.yaml
- image_id: image_id-in-path
- tag: tag-in-path