Method: projects.locations.fileStoreDataProfiles.list

Lists file store data profiles for an organization.

HTTP request


The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

Authorization requires the following IAM permission on the specified resource parent:

  • dlp.fileStoreProfiles.list

Query parameters

Parameters
pageToken

string

Optional. Page token to continue retrieval.

pageSize

integer

Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy

string

Optional. Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • projectId asc
  • name
  • sensitivityLevel desc

Supported fields are:

  • projectId: The Google Cloud project ID.
  • sensitivityLevel: How sensitive the data in a table is, at most.
  • dataRiskLevel: How much risk is associated with this data.
  • profileLastGenerated: When the profile was last updated in epoch seconds.
  • lastModified: The last time the resource was modified.
  • resourceVisibility: Visibility restriction for this resource.
  • name: The name of the profile.
  • createTime: The time the file store was first created.
filter

string

Optional. Allows filtering.

Supported syntax:

  • Filter expressions are made up of one or more restrictions.
  • Restrictions can be combined by AND or OR logical operators. A sequence of restrictions implicitly uses AND.
  • A restriction has the form of {field} {operator} {value}.
  • Supported fields/values:
    • projectId - The Google Cloud project ID.
    • fileStorePath - The path like "gs://bucket".
    • dataSourceType - The profile's data source type, like "google/storage/bucket".
    • data_storage_location - The location where the file store's data is stored, like "us-central1".
    • sensitivityLevel - HIGH|MODERATE|LOW
    • dataRiskLevel - HIGH|MODERATE|LOW
    • resourceVisibility: PUBLIC|RESTRICTED
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • projectId = 12345 AND status_code = 1
  • projectId = 12345 AND sensitivityLevel = HIGH
  • projectId = 12345 AND resourceVisibility = PUBLIC
  • fileStorePath = "gs://mybucket"

The length of this field should be no more than 500 characters.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.