Files
cloudkitty/doc/source/api-reference/v2/dataframes/dataframes.inc
Justin Ferrieu a81c01d6e2 Add a v2 API endpoint to retrieve DataFrame objects
A new endpoint has been made available to admin users or
scope owners on ``GET /v2/dataframes``. This will allow
end users to retrieve DataFrames in the form of JSON objects
from the CloudKitty storage backend.

Documentation and unit tests are included in this commit.

Change-Id: I784da5565d040f565945fa93d86dcef11faa72f9
2019-09-13 10:04:01 +02:00

86 lines
1.4 KiB
HTML

===================
Dataframes endpoint
===================
Add dataframes into the storage backend
=======================================
Add dataframes into the storage backend.
.. rest_method:: POST /v2/dataframes
.. rest_parameters:: dataframes/dataframes_parameters.yml
- dataframes: dataframes_body
Request Example
---------------
In the body:
.. literalinclude:: ./api_samples/dataframes/dataframes_post.json
:language: javascript
Status codes
------------
.. rest_status_code:: success http_status.yml
- 204
.. rest_status_code:: error http_status.yml
- 400
- 401
- 403
- 405
Response
--------
No content is to be returned.
Get dataframes from the storage backend
============================================
Get dataframes from the storage backend.
.. rest_method:: GET /v2/dataframes
.. rest_parameters:: dataframes/dataframes_parameters.yml
- limit: limit
- offset: offset
- begin: begin
- end: end
- filters: filters
Status codes
------------
.. rest_status_code:: success http_status.yml
- 200
.. rest_status_code:: error http_status.yml
- 400
- 401
- 403
- 405
Response
--------
.. rest_parameters:: dataframes/dataframes_parameters.yml
- total: total_resp
- dataframes: dataframes_resp
Response Example
----------------
.. literalinclude:: ./api_samples/dataframes/dataframes_get.json
:language: javascript