Definitions Update remediations

Author: cibot

alsdkdefs/apis/remediations/examples.yaml

@@ -3540,41 +3540,74 @@ FullAssetGroupTopologyPreviewExample:
           created_on: 1427317669194
           group_membership: IN
           key: "/aws/us-east-1"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
+            image:
+              in: 1
+              not_in: 0
+            subnet:
+              in: 1
+              not_in: 0
+            vpc:
+              in: 1
+              not_in: 0
           threat_level: 3
           threatiness: 22
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/us-west-2:
           created_on: 1589381951438
           group_membership: NOT_IN
           key: "/aws/us-west-2"
+          membership_counts:
+            image:
+              in: 1
+              not_in: 0
           threat_level: 0
           threatiness: 0
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/eu-west-1:
           created_on: 1589381951438
           group_membership: EXCLUDED
           key: "/aws/eu-west-1"
+          membership_counts:
+            vpc:
+              in: 0
+              not_in: 1
           threat_level: 0
           threatiness: 0
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:subnet:/aws/us-east-1/subnet/subnet-1a-web:
           created_on: 1427317669627
           group_membership: IN
           key: "/aws/us-east-1/subnet/subnet-1a-web"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
           threat_level: 2
           threatiness: 8
           type: subnet
         814C2911-09BB-1005-9916-7831C1BAC182:vpc:/aws/us-east-1/vpc/vpc-1:
           created_on: 1427317669270
           group_membership: IN
           key: "/aws/us-east-1/vpc/vpc-1"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
+            subnet:
+              in: 1
+              not_in: 0
           threat_level: 3
           threatiness: 22
           type: vpc
         814C2911-09BB-1005-9916-7831C1BAC182:vpc:/aws/eu-west-1/vpc/vpc-2:
           created_on: 1427317669270
           group_membership: EXCLUDED
           key: "/aws/eu-west-1/vpc/vpc-2"
+          membership_counts: {}
           threat_level: 3
           threatiness: 22
           type: vpc
@@ -3621,34 +3654,60 @@ HostAssetGroupTopologyPreviewExample:
           created_on: 1427317669194
           group_membership: IN
           key: "/aws/us-east-1"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
+            subnet:
+              in: 1
+              not_in: 0
+            vpc:
+              in: 1
+              not_in: 0
           threat_level: 3
           threatiness: 22
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/us-west-2:
           created_on: 1589381951438
           group_membership: NOT_IN
           key: "/aws/us-west-2"
+          membership_counts: {}
           threat_level: 0
           threatiness: 0
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/eu-west-1:
           created_on: 1589381951438
           group_membership: EXCLUDED
           key: "/aws/eu-west-1"
+          membership_counts:
+            vpc:
+              in: 0
+              not_in: 1
           threat_level: 0
           threatiness: 0
           type: region
         814C2911-09BB-1005-9916-7831C1BAC182:subnet:/aws/us-east-1/subnet/subnet-1a-web:
           created_on: 1427317669627
           group_membership: IN
           key: "/aws/us-east-1/subnet/subnet-1a-web"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
           threat_level: 2
           threatiness: 8
           type: subnet
         814C2911-09BB-1005-9916-7831C1BAC182:vpc:/aws/us-east-1/vpc/vpc-1:
           created_on: 1427317669270
           group_membership: IN
           key: "/aws/us-east-1/vpc/vpc-1"
+          membership_counts:
+            host:
+              in: 1
+              not_in: 0
+            subnet:
+              in: 1
+              not_in: 0
           threat_level: 3
           threatiness: 22
           type: vpc

alsdkdefs/apis/remediations/schemas.yaml

@@ -466,8 +466,11 @@ TopologyPreviewResponse:
             An object containing all of the asset details for asset references in the
             `topology.assets`. The object keys are asset
             references produced by colon-joining deployment ID, asset type and asset key, e.g.,
-            `814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/us-east-1`. All assets are decorated with a
-            `group_membership` property that must be consulted to determine membership in the group. Possible values are described below:
+            `814C2911-09BB-1005-9916-7831C1BAC182:region:/aws/us-east-1`.
+
+            All assets are decorated with a few additional properties:
+
+            1. A `group_membership` property that must be consulted to determine membership in the group. Possible values are described below:
 
             `IN` - The asset is included in the group by scope definition.
 
@@ -479,6 +482,11 @@ TopologyPreviewResponse:
             `EXCLUDED` - The asset is excluded from the group by scope definition.
 
             `NOT_IN` - The asset does not meet all criteria for inclusion in the group by scope definition, but is not explicitly excluded.
+
+            2. A `membership_counts` object containing keys of asset types and an object value of `in` and `not_in` counts for topological child types.
+            If an asset has no topological children but is of a type that could have topological children (e.g. a region that
+            currently does not have any declared vpcs yet), the membership_counts object may be an empty object `{}`.
+
         rows:
           type: integer
           description: The count of rows in the `topology.assets` array.