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

Queries policy activities on GCP resources.

Args:
  parent: string, Required. The container resource on which to execute the request. Acceptable formats: `projects/[PROJECT_ID|PROJECT_NUMBER]/locations/[LOCATION]/activityTypes/[ACTIVITY_TYPE]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ (required)
  filter: string, Optional. Optional filter expression to restrict the activities returned. Supported filters are: - service_account_last_authn.full_resource_name {=} - service_account_key_last_authn.full_resource_name {=} 
  pageSize: integer, Optional. The maximum number of results to return from this request. Max limit is 1000. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.
  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response to the `QueryActivity` method.
  "activities": [ # The set of activities that match the filter included in the request.
    { # Represents Activity on a GCP resource over specific observation period.
      "activity": { # A struct of custom fields to explain the activity.
        "a_key": "", # Properties of the object.
      },
      "activityType": "A String", # The type of the activity.
      "fullResourceName": "A String", # The full resource name that identifies the resource. For examples of full resource names for Google Cloud services, see https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
      "observationPeriod": { # Represents data observation period. # The data observation period to build the activity.
        "endTime": "A String", # The observation end time.
        "startTime": "A String", # The observation start time.
      },
    },
  ],
  "nextPageToken": "A String", # If there might be more results than those appearing in this response, then `nextPageToken` is included. To get the next set of results, call this method again using the value of `nextPageToken` as `pageToken`.
}

query_next()

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.

Policy Analyzer API . projects . locations . activityTypes . activities

Instance Methods

Method Details