Definitions Update remediations

Author: cibot

alsdkdefs/apis/remediations/assets_query.v1.yaml

@@ -422,6 +422,7 @@ paths:
       - $ref: 'parameters.yaml#/ParamReturnCount'
       - $ref: 'parameters.yaml#/ParamReduce'
       - $ref: 'parameters.yaml#/ParamQFields'
+      - $ref: 'parameters.yaml#/ParamSummarizeAssets'
       - $ref: 'parameters.yaml#/ParamFilter'
       - $ref: 'parameters.yaml#/ParamFilterRelationship'
       - $ref: 'parameters.yaml#/ParamRelatedProperties'
@@ -620,6 +621,7 @@ paths:
       - $ref: 'parameters.yaml#/ParamReturnCount'
       - $ref: 'parameters.yaml#/ParamReduce'
       - $ref: 'parameters.yaml#/ParamQFields'
+      - $ref: 'parameters.yaml#/ParamSummarizeAssets'
       - $ref: 'parameters.yaml#/ParamFilter'
       - $ref: 'parameters.yaml#/ParamFilterRelationship'
       - $ref: 'parameters.yaml#/ParamRelatedProperties'

alsdkdefs/apis/remediations/parameters.yaml

@@ -96,9 +96,17 @@ ParamQFields:
   in: query
   name: qfields
   description: |-
-    Optional comma-separated list of fields to be returned as part of the objects. `key`, `type`
-    and `deployment_id` are always returned. Both `&qfields=object.field` and `&qfields=field`
-    are acceptable; in the latter case all objects will be filtered.
+    Optional comma-separated list of fields to be returned as part of the objects. When qfields is used, 
+    All objects will always and only return `key`, `type` and `deployment_id` unless additional fields are 
+    specified. To request a field, Both `&qfields=object.field` and `&qfields=field` are acceptable; in 
+    the latter case all objects will be filtered with the requested field.
+ParamSummarizeAssets:
+  schema:
+    type: boolean
+  in: query
+  name: summarize_assets
+  description: |-
+    Callers should pass summarize_assets=true to pass back the asset type's summary properties. Can be used in combination with qfields.
 ParamFilter:
   schema:
     type: object