manila/api-ref/source/scheduler-stats.inc
Daniel Gonzalez 3e86e3deac Migrate API reference into tree
The API Documentation team has requires [1] that
projects maintain their api-reference in-tree and
build it to the developer.openstack.org website.

This version of the API reference uses os-api-ref
and compiles API documentation close to that of
the OpenStack compute service (nova).

Co-Authored-By: Goutham Pacha Ravi <gouthamr@netapp.com>

[0] http://lists.openstack.org/pipermail/openstack-dev/2016-May/093765.html

Implements: bp move-manila-api-reference-in-tree
Change-Id: I67bb3354162d6e0e00fa2788edde864cc14920ee
2016-07-25 15:55:00 +00:00

103 lines
2.6 KiB
ReStructuredText

.. -*- rst -*-
===============================
Scheduler Stats - Storage Pools
===============================
An administrator can list all back-end storage pools that are known
to the scheduler service.
List back-end storage pools
===========================
.. rest_method:: GET /v2/{tenant_id}/scheduler-stats/pools?pool={pool_name}&host={host_name}&backend={backend_name}&capabilities={capabilities}
Lists all back-end storage pools. If search options are provided, the pool
list that is returned is filtered with these options.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Request
-------
.. rest_parameters:: parameters.yaml
- tenant_id: tenant_id_1
- pool: pool_1
- host: host_9
- backend: backend_1
- capabilities: capabilities_1
Response parameters
-------------------
.. rest_parameters:: parameters.yaml
- backend: backend
- host: host_4
- pool: pool
- name: name_11
Response example
----------------
.. literalinclude:: samples/pools-list-response.json
:language: javascript
List back-end storage pools with details
========================================
.. rest_method:: GET /v2/{tenant_id}/scheduler-stats/pools/detail?pool={pool_name}&host={host_name}&backend={backend_name}&capabilities={capabilities}
Lists all back-end storage pools with details. If search options are provided,
the pool list that is returned is filtered with these options.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Request
-------
.. rest_parameters:: parameters.yaml
- tenant_id: tenant_id_1
- pool: pool_1
- host: host_9
- backend: backend_1
- capabilities: capabilities_1
Response parameters
-------------------
.. rest_parameters:: parameters.yaml
- backend: backend
- host: host_4
- pool: pool
- name: name_11
- capabilities: capabilities_1
- qos: qos
- consistency_group_support: consistency_group_support
- timestamp: timestamp
- share_backend_name: share_backend_name
- server_pools_mapping: server_pools_mapping
- driver_handles_share_servers: driver_handles_share_servers
- driver_version: driver_version
- total_capacity_gb: total_capacity_gb
- free_capacity_gb: free_capacity_gb
- reserved_percentage: reserved_percentage
- pools: pools
- vendor_name: vendor_name
- snapshot_support: snapshot_support_2
- replication_type: replication_type
- storage_protocol: storage_protocol
Response example
----------------
.. literalinclude:: samples/pools-list-detailed-response.json
:language: javascript