Merge "update api-ref for admin tenant filter."

api-ref/source/instances.inc

@@ -92,6 +92,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
+  - all_tenants: all_tenants
   - fields: fields
 
 Response
@@ -126,6 +127,8 @@ forbidden(403)
 Request
 -------
 
+  - all_tenants: all_tenants
+
 Response
 --------
 

api-ref/source/parameters.yaml

@@ -35,6 +35,13 @@ type_uuid_path:
   type: string
 
 # variables in query
+all_tenants:
+  description: |
+    Specify the ``all_tenants=1`` query parameter to list all instances
+    for all projects. By default this is only allowed by admin users.
+  in: query
+  required: false
+  type: integer
 fields:
   description: |
     One or more fields to be returned in the response.