Skip to content
This repository has been archived by the owner on Sep 27, 2023. It is now read-only.

Commit

Permalink
docs: expand parent field format, and BigQuery sampling options. Also…
Browse files Browse the repository at this point in the history 
… describing which transformations are allowed for ReidentifyContent API calls, and the custom alphabet allowed for format-preserving encryption (FPE). (#266)

This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/d0ce2df9-8f3a-4426-8c51-a99c5488fe81/targets

- [ ] To automatically regenerate this PR, check this box.

PiperOrigin-RevId: 329758805
Source-Link: googleapis/googleapis@1ee015d
  • Loading branch information
@yoshi-automation
yoshi-automation authored Sep 9, 2020
1 parent dbf5e01 commit 9a10739
Show file tree
Hide file tree
Showing 39 changed files with 2,518 additions and 652 deletions.
754 changes: 603 additions & 151 deletions google-cloud-dlp/src/main/java/com/google/cloud/dlp/v2/DlpServiceClient.java
View file

Large diffs are not rendered by default.

14 changes: 9 additions & 5 deletions proto-google-cloud-dlp-v2/src/main/java/com/google/privacy/dlp/v2/BigQueryOptions.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -172,7 +172,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
* <pre>
* 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.
* </pre>
*
* Protobuf enum {@code google.privacy.dlp.v2.BigQueryOptions.SampleMethod}
Expand All @@ -184,7 +184,9 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* 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.
* </pre>
*
* <code>TOP = 1;</code>
Expand All @@ -194,7 +196,7 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Randomly pick the row to start scanning. The scanned rows are contiguous.
* Randomly pick groups of rows to scan.
* </pre>
*
* <code>RANDOM_START = 2;</code>
Expand All @@ -209,7 +211,9 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* 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.
* </pre>
*
* <code>TOP = 1;</code>
Expand All @@ -219,7 +223,7 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Randomly pick the row to start scanning. The scanned rows are contiguous.
* Randomly pick groups of rows to scan.
* </pre>
*
* <code>RANDOM_START = 2;</code>
Expand Down
133 changes: 105 additions & 28 deletions ...cloud-dlp-v2/src/main/java/com/google/privacy/dlp/v2/CreateDeidentifyTemplateRequest.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -151,10 +151,21 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -180,10 +191,21 @@ public java.lang.String getParent() {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand Down Expand Up @@ -748,10 +770,21 @@ public Builder mergeFrom(
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -776,10 +809,21 @@ public java.lang.String getParent() {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -804,10 +848,21 @@ public com.google.protobuf.ByteString getParentBytes() {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -831,10 +886,21 @@ public Builder setParent(java.lang.String value) {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -854,10 +920,21 @@ public Builder clearParent() {
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand Down
38 changes: 30 additions & 8 deletions ...-v2/src/main/java/com/google/privacy/dlp/v2/CreateDeidentifyTemplateRequestOrBuilder.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,21 @@ public interface CreateDeidentifyTemplateRequestOrBuilder
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand All @@ -46,10 +57,21 @@ public interface CreateDeidentifyTemplateRequestOrBuilder
*
* <pre>
* 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:&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
* + Organizations scope, location specified:&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
* 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
* </pre>
*
* <code>
Expand Down
Loading

0 comments on commit 9a10739

Please sign in to comment.