Api-ref: add 'all_tenants' API query option

Cinder REST API allows one to use a special query parameter
named "all_tenants" to list resources from all projects (tenants)
through the REST API:

`/v3/{project_id}/volumes/detail?all_tenants=1`

However, this option is hardly documented anywhere besides
`/v3/{project_id}/volumes/summary`. So add them.

Change-Id: Ia9cc9e20c3b333a054c90f07e952b61dfad8529e
Closes-Bug: #1743800

api-ref/source/v2/consistencygroups-v2.inc

@@ -31,6 +31,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key
    - sort_dir: sort_dir
    - limit: limit
@@ -209,6 +210,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key
    - sort_dir: sort_dir
    - limit: limit

api-ref/source/v2/ext-backups.inc

@@ -54,6 +54,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key
    - sort_dir: sort_dir
    - limit: limit
@@ -270,6 +271,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key
    - sort_dir: sort_dir
    - limit: limit

api-ref/source/v2/os-cgsnapshots-v2.inc

@@ -81,6 +81,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters
@@ -118,6 +119,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters

api-ref/source/v2/os-vol-transfer-v2.inc

@@ -110,6 +110,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters
@@ -204,6 +205,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 Response Parameters
 -------------------

api-ref/source/v2/volumes-v2-snapshots.inc

@@ -51,6 +51,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters
@@ -137,6 +138,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key
    - sort_dir: sort_dir
    - limit: limit

api-ref/source/v2/volumes-v2-volumes.inc

@@ -76,6 +76,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -247,6 +248,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset

api-ref/source/v3/attachments.inc

@@ -98,6 +98,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -145,6 +146,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset

api-ref/source/v3/consistencygroups-v3.inc

@@ -31,6 +31,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - marker: marker
@@ -213,6 +214,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - marker: marker

api-ref/source/v3/ext-backups.inc

@@ -58,6 +58,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -334,6 +335,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - marker: marker

api-ref/source/v3/group-snapshots.inc

@@ -90,6 +90,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key_group_snapshot
    - sort_dir: sort_dir_group_snapshot
    - limit: limit_group_snapshot
@@ -137,6 +138,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort_key: sort_key_group_snapshot
    - sort_dir: sort_dir_group_snapshot
    - limit: limit_group_snapshot

api-ref/source/v3/groups.inc

@@ -37,6 +37,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -213,6 +214,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset

api-ref/source/v3/os-cgsnapshots-v3.inc

@@ -82,6 +82,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters
@@ -120,6 +121,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters

api-ref/source/v3/os-vol-transfer-v3.inc

@@ -111,6 +111,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 
 Response Parameters
@@ -205,6 +206,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
 
 Response Parameters
 -------------------

api-ref/source/v3/volumes-v3-snapshots.inc

@@ -55,6 +55,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -162,6 +163,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset

api-ref/source/v3/volumes-v3-volumes.inc

@@ -82,6 +82,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -260,6 +261,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
+   - all_tenants: all-tenants
    - sort: sort
    - limit: limit
    - offset: offset
@@ -717,7 +719,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - project_id: project_id_path
-   - all_tenants: all_tenants
+   - all_tenants: all-tenants
 
 Response Parameters
 -------------------