Merge "Update cluster policies API doc"

api-ref/source/cluster_policies.inc

@@ -34,6 +34,8 @@ Request Parameters
   - OpenStack-API-Version: microversion
   - cluster_id: cluster_id_url
   - enabled: enabled_query
+  - policy_name: name_query
+  - policy_type: type_query
   - sort: sort
 
 Response Parameters

api-ref/source/clusters.inc

@@ -40,6 +40,8 @@ Request Parameters
   - name: name_query
   - status: status_query
 
+The sorting key is ``enabled``.
+
 Response Parameters
 -------------------
 

api-ref/source/parameters.yaml

@@ -176,7 +176,8 @@ name_query:
   type: string
   in: query
   description: |
-    Filters the response by the ``name`` property of the object.
+    Filters the response by the specified ``name`` property of the object,
+    such as ``policy_name`` or ``name`` property of cluster.
 
 oid_query:
   type: string
@@ -261,7 +262,9 @@ type_query:
   type: string
   in: query
   description: |
-    Filters the response by the ``type`` property of the object.
+    Filters the response by the specified ``type`` property of the object,
+    such as ``policy_type`` property of cluster-policy binding object or
+    ``type`` property of policy object.
 
 user_query:
   type: UUID

api-ref/source/policies.inc

@@ -40,6 +40,9 @@ Request Parameters
   - name: name_query
   - type: type_query
 
+The sorting keys include ``name``, ``type``, ``created_at`` and
+``udpated_at``.
+
 Response Parameters
 -------------------