Assured Workloads API . folders . locations . dbFrameworkComplianceReports . dbControlComplianceSummaries

close()

Close httplib2 connections.

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists the compliance summaries of the controls in a framework compliance report.

Args:
  parent: string, Required. The framework compliance report to list control compliance summaries for. Formats: * `organizations/{organization}/locations/{location}/dbFrameworkComplianceReports/{db_framework_compliance_report}` * `folders/{folder}/locations/{location}/dbFrameworkComplianceReports/{db_framework_compliance_report}` * `projects/{project}/locations/{location}/dbFrameworkComplianceReports/{db_framework_compliance_report}` (required)
  filter: string, Optional. A filter expression that restricts the results. The syntax follows [AIP-160](https://google.aip.dev/160). Supported fields are `framework_deployment`, `framework_name`, `framework_revision` (the major revision ID of the framework), and `end_time`. The `end_time` field accepts a single equality comparison with an [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) timestamp, for example `end_time = "2026-01-01T00:00:00Z"`. Only findings that were updated at or after this time are counted.
  pageSize: integer, Optional. The requested page size. The server might return fewer items than requested. If unspecified, the default page size is 50. The maximum value is 1000.
  pageToken: string, Optional. A token that identifies the page of results that the server should return. Pass the `next_page_token` value from a previous result.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The response message for ListDbControlComplianceSummaries.
  "dbControlComplianceSummaries": [ # The list of control compliance summaries.
    { # A summary of the compliance status of a control in a framework compliance report.
      "cloudControlReports": [ # The list of cloud control reports.
        { # The cloud control report.
          "categories": [ # The list of categories for the cloud control.
            "A String",
          ],
          "cloudControl": "A String", # The name of the cloud control.
          "cloudControlAssessmentDetails": { # The cloud control assessment details for non-manual cloud controls. # The details of a cloud control assessment.
            "evaluationState": "A String", # Output only. The evaluation status of the cloud control.
            "findingsCount": 42, # The number of findings for the cloud control.
            "orgPolicyFindingCount": "A String", # Output only. Number of organization policy findings for the cloud control.
            "resourceFindingCount": "A String", # Output only. Number of resource findings for the cloud control.
          },
          "cloudControlDeployment": "A String", # The name of the cloud control deployment.
          "cloudControlType": "A String", # The type of the cloud control.
          "description": "A String", # The description of the cloud control.
          "displayName": "A String", # The display name of the cloud control.
          "enforcementMode": "A String", # The enforcement mode of the cloud control.
          "findingCategory": "A String", # The category of the finding.
          "findingSeverity": "A String", # The severity of the finding.
          "frameworkMajorRevisionIds": [ # The major revision IDs of the frameworks that the cloud control belongs to.
            "A String",
          ],
          "majorRevisionId": "A String", # The major revision ID of the cloud control.
          "manualCloudControlAssessmentDetails": { # The details for a manual cloud control assessment. # The details of a manual cloud control assessment.
            "manualCloudControlGuide": [ # The guide for assessing a cloud control manually.
              "A String",
            ],
          },
          "minorRevisionId": "A String", # The minor revision ID of the cloud control.
          "rules": [ # The list of rules that correspond to the cloud control.
            { # A rule in the cloud control.
              "celExpression": { # A Common Expression Language (CEL) expression that's used to create a rule. # The rule's logic expression in Common Expression Language (CEL).
                "expression": "A String", # Required. The logical expression in CEL. The maximum length of the condition is 1000 characters. For more information, see [CEL expression](https://cloud.google.com/security-command-center/docs/compliance-manager-write-cel-expressions).
                "resourceTypesValues": { # A list of strings for the parameter value. # The resource instance types on which this expression is defined. The format is `/`. For example: `compute.googleapis.com/Instance`
                  "values": [ # Required. The strings in the list.
                    "A String",
                  ],
                },
              },
              "description": "A String", # Optional. The rule description. The maximum length is 2000 characters.
              "ruleActionTypes": [ # Required. The functionality that's enabled by the rule.
                "A String",
              ],
            },
          ],
          "similarControls": [ # The list of similar controls.
            { # The similar controls.
              "controlId": "A String", # The ID of the control.
              "framework": "A String", # The name of the framework.
            },
          ],
        },
      ],
      "complianceFrameworks": [ # The list of compliance frameworks that the control belongs to.
        "A String",
      ],
      "control": "A String", # The name of the control.
      "controlResponsibilityType": "A String", # The responsibility type for the control.
      "description": "A String", # The description of the control.
      "displayName": "A String", # The display name of the control.
      "isFakeControl": True or False, # Whether the control is a fake control. Fake controls are created and mapped to cloud controls that don't belong to a control group.
      "name": "A String", # Identifier. The resource name of the control compliance summary. Format: `organizations/{organization}/locations/{location}/dbFrameworkComplianceReports/{db_framework_compliance_report}/dbControlComplianceSummaries/{db_control_compliance_summary}`
      "orgPolicyFindingCount": "A String", # Output only. Number of organization policy findings for this control.
      "overallEvaluationState": "A String", # Output only. The overall evaluation status of the control.
      "resourceFindingCount": "A String", # Output only. Number of resource findings for this control.
      "similarControls": [ # The list of similar controls.
        { # The similar controls.
          "controlId": "A String", # The ID of the control.
          "framework": "A String", # The name of the framework.
        },
      ],
      "totalFindingsCount": 42, # The total number of findings for the control.
    },
  ],
  "nextPageToken": "A String", # Output only. A token that can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.
}

list_next(previous_request, previous_response)

Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.