Method: folders.locations.frameworkAudits.list

Lists the framework audits for a given organization, folder, or project.

HTTP request

GET https://cloudsecuritycompliance.googleapis.com/v1/{parent=folders/*/locations/*}/frameworkAudits

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource where the framework audits are listed.

Supported formats are the following:

  • organizations/{organization_id}/locations/{location}
  • folders/{folder_id}/locations/{location}
  • projects/{projectId}/locations/{location}

Query parameters

Parameters
pageSize

integer

Optional. The maximum number of framework audits to return. The service might return fewer audits than this value. If unspecified, a maximum of 10 framework audits are returned. The maximum value is 50; values above 50 are limited to 50.
pageToken

string

Optional. The nextPageToken value that's returned from a previous list request, if any.
filter

string

Optional. The filters to apply to the framework audits. Supported filters are complianceFramework, complianceState, createTime, and framework_audit_name. If the filter is invalid, an invalid argument error is returned. For syntax details, see [AIP-160][https://google.aip.dev/160].

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListFrameworkAuditsResponse.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • cloudsecuritycompliance.frameworkAudits.list

For more information, see the IAM documentation.