ecb040c177
PUT /v2/cache/{image_id} returns HTTP 200 response code to user but as per
proposal it should be HTTP 202. This change returns HTTP 202 response to
user.
Closes-Bug: #1971521
Change-Id: I6a875a38bef5beafe352ab3320f3fd199db89aa1
103 lines
1.5 KiB
ReStructuredText
103 lines
1.5 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
Cache Manage
|
|
************
|
|
|
|
List and manage the cache.
|
|
|
|
|
|
Query cache status
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/cache
|
|
|
|
Lists all images in cache or queue.
|
|
*(Since Image API v2.14)*
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 400, 401, 403
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
No request parameters.
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: cache-manage-parameters.yaml
|
|
|
|
- cached_images: cached_images
|
|
- queued_images: queued_images
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/cache-list-response.json
|
|
:language: json
|
|
|
|
|
|
Queue image
|
|
~~~~~~~~~~~
|
|
|
|
.. rest_method:: PUT /v2/cache/{image_id}
|
|
|
|
Queues image for caching.
|
|
*(Since Image API v2.14)*
|
|
|
|
Normal response codes: 202
|
|
|
|
Error response codes: 400, 401, 403, 404
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: images-parameters.yaml
|
|
|
|
- image_id: image_id-in-path
|
|
|
|
|
|
Delete image from cache
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: DELETE /v2/cache/{image_id}
|
|
|
|
Deletes a image from cache.
|
|
*(Since Image API v2.14)*
|
|
|
|
Normal response codes: 204
|
|
|
|
Error response codes: 400, 401, 403, 404
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: images-parameters.yaml
|
|
|
|
- image_id: image_id-in-path
|
|
|
|
|
|
Clear images from cache
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: DELETE /v2/cache
|
|
|
|
Clears the cache and its queue.
|
|
*(Since Image API v2.14)*
|
|
|
|
Normal response codes: 204
|
|
|
|
Error response codes: 400, 401, 403
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: images-parameters.yaml
|
|
|
|
- x-image-cache-clear-target: cache-clear-header
|