diff --git a/google/privacy/dlp/v2/dlp.proto b/google/privacy/dlp/v2/dlp.proto
index 781ac1c4..05738301 100644
--- a/google/privacy/dlp/v2/dlp.proto
+++ b/google/privacy/dlp/v2/dlp.proto
@@ -1154,9 +1154,21 @@ message RedactImageRequest {
Color redaction_color = 3;
}
- // The parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ // Parent resource name.
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [(google.api.resource_reference) = {
child_type: "dlp.googleapis.com/DlpContent"
}];
@@ -1207,8 +1219,20 @@ message RedactImageResponse {
// Request to de-identify a list of items.
message DeidentifyContentRequest {
// Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [(google.api.resource_reference) = {
child_type: "dlp.googleapis.com/DlpContent"
}];
@@ -1255,9 +1279,21 @@ message DeidentifyContentResponse {
// Request to re-identify an item.
message ReidentifyContentRequest {
- // Required. The parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ // Required. Parent resource name.
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -1292,10 +1328,11 @@ message ReidentifyContentRequest {
// Template to use. References an instance of `DeidentifyTemplate`.
// Any configuration directly specified in `reidentify_config` or
- // `inspect_config` will override those set in the template. Singular fields
- // that are set in this request will replace their corresponding fields in the
- // template. Repeated fields are appended. Singular sub-messages and groups
- // are recursively merged.
+ // `inspect_config` will override those set in the template. The
+ // `DeidentifyTemplate` used must include only reversible transformations.
+ // Singular fields that are set in this request will replace their
+ // corresponding fields in the template. Repeated fields are appended.
+ // Singular sub-messages and groups are recursively merged.
string reidentify_template_name = 6;
// Deprecated. This field has no effect.
@@ -1314,8 +1351,20 @@ message ReidentifyContentResponse {
// Request to search for potentially sensitive info in a ContentItem.
message InspectContentRequest {
// Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [(google.api.resource_reference) = {
child_type: "dlp.googleapis.com/DlpContent"
}];
@@ -1484,7 +1533,10 @@ message InfoTypeDescription {
// Request for the list of infoTypes.
message ListInfoTypesRequest {
// The parent resource name.
- // - Format:locations/[LOCATION-ID]
+ //
+ // The format of this value is as follows:
+ //
+ // locations/LOCATION_ID
string parent = 4;
// BCP-47 language code for localized infoType friendly
@@ -2490,6 +2542,9 @@ message CryptoReplaceFfxFpeConfig {
// Number of characters must be in the range [2, 95].
// This must be encoded as ASCII.
// The order of characters does not matter.
+ // The full list of allowed characters is:
+ // 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
+ // ~`!@#$%^&*()_-+={[}]|\:;"'<,>.?/
string custom_alphabet = 5;
// The native way to select the alphabet. Must be in the range [2, 95].
@@ -3075,10 +3130,25 @@ message Action {
// Request message for CreateInspectTemplate.
message CreateInspectTemplateRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3134,10 +3204,25 @@ message GetInspectTemplateRequest {
// Request message for ListInspectTemplates.
message ListInspectTemplatesRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3198,8 +3283,20 @@ message DeleteInspectTemplateRequest {
// Request message for CreateJobTrigger.
message CreateJobTriggerRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3267,8 +3364,20 @@ message GetJobTriggerRequest {
// Storage.
message CreateDlpJobRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3298,8 +3407,20 @@ message CreateDlpJobRequest {
// Request message for ListJobTriggers.
message ListJobTriggersRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3485,8 +3606,20 @@ message GetDlpJobRequest {
// The request message for listing DLP jobs.
message ListDlpJobsRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on whether you have [specified a
+ // processing location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 4 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3597,10 +3730,25 @@ message DeleteDlpJobRequest {
// Request message for CreateDeidentifyTemplate.
message CreateDeidentifyTemplateRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3656,10 +3804,25 @@ message GetDeidentifyTemplateRequest {
// Request message for ListDeidentifyTemplates.
message ListDeidentifyTemplatesRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3836,10 +3999,25 @@ message StoredInfoType {
// Request message for CreateStoredInfoType.
message CreateStoredInfoTypeRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@@ -3897,10 +4075,25 @@ message GetStoredInfoTypeRequest {
// Request message for ListStoredInfoTypes.
message ListStoredInfoTypesRequest {
// Required. Parent resource name.
- // - Format:projects/[PROJECT-ID]
- // - Format:organizations/[ORGANIZATION-ID]
- // - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
- // - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
+ //
+ // The format of this value varies depending on the scope of the request
+ // (project or organization) and whether you have [specified a processing
+ // location](/dlp/docs/specifying-location):
+ //
+ // + Projects scope, location specified:
+ // `projects/`PROJECT_ID`/locations/`LOCATION_ID
+ // + Projects scope, no location specified (defaults to global):
+ // `projects/`PROJECT_ID
+ // + Organizations scope, location specified:
+ // `organizations/`ORG_ID`/locations/`LOCATION_ID
+ // + Organizations scope, no location specified (defaults to global):
+ // `organizations/`ORG_ID
+ //
+ // The following example `parent` string specifies a parent project with the
+ // identifier `example-project`, and specifies the `europe-west3` location
+ // for processing data:
+ //
+ // parent=projects/example-project/locations/europe-west3
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
diff --git a/google/privacy/dlp/v2/storage.proto b/google/privacy/dlp/v2/storage.proto
index b25cf4fe..9098ab32 100644
--- a/google/privacy/dlp/v2/storage.proto
+++ b/google/privacy/dlp/v2/storage.proto
@@ -33,8 +33,8 @@ message InfoType {
// Name of the information type. Either a name of your choosing when
// creating a CustomInfoType, or one of the names listed
// at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- // a built-in type. InfoType names should conform to the pattern
- // `[a-zA-Z0-9_]{1,64}`.
+ // a built-in type. When sending Cloud DLP results to Data Catalog, infoType
+ // names should conform to the pattern `[A-Za-z0-9$-_]{1,64}`.
string name = 1;
}
@@ -425,14 +425,16 @@ message CloudStoragePath {
message BigQueryOptions {
// How to sample rows if not all rows are scanned. Meaningful only when used
// in conjunction with either rows_limit or rows_limit_percent. If not
- // specified, scanning would start from the top.
+ // specified, rows are scanned in the order BigQuery reads them.
enum SampleMethod {
SAMPLE_METHOD_UNSPECIFIED = 0;
- // Scan from the top (default).
+ // Scan groups of rows in the order BigQuery provides (default). Multiple
+ // groups of rows may be scanned in parallel, so results may not appear in
+ // the same order the rows are read.
TOP = 1;
- // Randomly pick the row to start scanning. The scanned rows are contiguous.
+ // Randomly pick groups of rows to scan.
RANDOM_START = 2;
}