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

Commit 9a10739

Browse files
yoshi-automationyoshi-automation
authored
docs: expand parent field format, and BigQuery sampling options. Also 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
1 parent dbf5e01 commit 9a10739

39 files changed

+2518
-652
lines changed

‎google-cloud-dlp/src/main/java/com/google/cloud/dlp/v2/DlpServiceClient.java‎

Lines changed: 603 additions & 151 deletions
Large diffs are not rendered by default.

‎proto-google-cloud-dlp-v2/src/main/java/com/google/privacy/dlp/v2/BigQueryOptions.java‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
172172
* <pre>
173173
* How to sample rows if not all rows are scanned. Meaningful only when used
174174
* in conjunction with either rows_limit or rows_limit_percent. If not
175-
* specified, scanning would start from the top.
175+
* specified, rows are scanned in the order BigQuery reads them.
176176
* </pre>
177177
*
178178
* Protobuf enum {@code google.privacy.dlp.v2.BigQueryOptions.SampleMethod}
@@ -184,7 +184,9 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
184184
*
185185
*
186186
* <pre>
187-
* Scan from the top (default).
187+
* Scan groups of rows in the order BigQuery provides (default). Multiple
188+
* groups of rows may be scanned in parallel, so results may not appear in
189+
* the same order the rows are read.
188190
* </pre>
189191
*
190192
* <code>TOP = 1;</code>
@@ -194,7 +196,7 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
194196
*
195197
*
196198
* <pre>
197-
* Randomly pick the row to start scanning. The scanned rows are contiguous.
199+
* Randomly pick groups of rows to scan.
198200
* </pre>
199201
*
200202
* <code>RANDOM_START = 2;</code>
@@ -209,7 +211,9 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
209211
*
210212
*
211213
* <pre>
212-
* Scan from the top (default).
214+
* Scan groups of rows in the order BigQuery provides (default). Multiple
215+
* groups of rows may be scanned in parallel, so results may not appear in
216+
* the same order the rows are read.
213217
* </pre>
214218
*
215219
* <code>TOP = 1;</code>
@@ -219,7 +223,7 @@ public enum SampleMethod implements com.google.protobuf.ProtocolMessageEnum {
219223
*
220224
*
221225
* <pre>
222-
* Randomly pick the row to start scanning. The scanned rows are contiguous.
226+
* Randomly pick groups of rows to scan.
223227
* </pre>
224228
*
225229
* <code>RANDOM_START = 2;</code>

‎proto-google-cloud-dlp-v2/src/main/java/com/google/privacy/dlp/v2/CreateDeidentifyTemplateRequest.java‎

Lines changed: 105 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -151,10 +151,21 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
151151
*
152152
* <pre>
153153
* Required. Parent resource name.
154-
* - Format:projects/[PROJECT-ID]
155-
* - Format:organizations/[ORGANIZATION-ID]
156-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
157-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
154+
* The format of this value varies depending on the scope of the request
155+
* (project or organization) and whether you have [specified a processing
156+
* location](/dlp/docs/specifying-location):
157+
* + Projects scope, location specified:&lt;br/&gt;
158+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
159+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
160+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
161+
* + Organizations scope, location specified:&lt;br/&gt;
162+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
163+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
164+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
165+
* The following example `parent` string specifies a parent project with the
166+
* identifier `example-project`, and specifies the `europe-west3` location
167+
* for processing data:
168+
* parent=projects/example-project/locations/europe-west3
158169
* </pre>
159170
*
160171
* <code>
@@ -180,10 +191,21 @@ public java.lang.String getParent() {
180191
*
181192
* <pre>
182193
* Required. Parent resource name.
183-
* - Format:projects/[PROJECT-ID]
184-
* - Format:organizations/[ORGANIZATION-ID]
185-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
186-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
194+
* The format of this value varies depending on the scope of the request
195+
* (project or organization) and whether you have [specified a processing
196+
* location](/dlp/docs/specifying-location):
197+
* + Projects scope, location specified:&lt;br/&gt;
198+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
199+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
200+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
201+
* + Organizations scope, location specified:&lt;br/&gt;
202+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
203+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
204+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
205+
* The following example `parent` string specifies a parent project with the
206+
* identifier `example-project`, and specifies the `europe-west3` location
207+
* for processing data:
208+
* parent=projects/example-project/locations/europe-west3
187209
* </pre>
188210
*
189211
* <code>
@@ -748,10 +770,21 @@ public Builder mergeFrom(
748770
*
749771
* <pre>
750772
* Required. Parent resource name.
751-
* - Format:projects/[PROJECT-ID]
752-
* - Format:organizations/[ORGANIZATION-ID]
753-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
754-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
773+
* The format of this value varies depending on the scope of the request
774+
* (project or organization) and whether you have [specified a processing
775+
* location](/dlp/docs/specifying-location):
776+
* + Projects scope, location specified:&lt;br/&gt;
777+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
778+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
779+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
780+
* + Organizations scope, location specified:&lt;br/&gt;
781+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
782+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
783+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
784+
* The following example `parent` string specifies a parent project with the
785+
* identifier `example-project`, and specifies the `europe-west3` location
786+
* for processing data:
787+
* parent=projects/example-project/locations/europe-west3
755788
* </pre>
756789
*
757790
* <code>
@@ -776,10 +809,21 @@ public java.lang.String getParent() {
776809
*
777810
* <pre>
778811
* Required. Parent resource name.
779-
* - Format:projects/[PROJECT-ID]
780-
* - Format:organizations/[ORGANIZATION-ID]
781-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
782-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
812+
* The format of this value varies depending on the scope of the request
813+
* (project or organization) and whether you have [specified a processing
814+
* location](/dlp/docs/specifying-location):
815+
* + Projects scope, location specified:&lt;br/&gt;
816+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
817+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
818+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
819+
* + Organizations scope, location specified:&lt;br/&gt;
820+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
821+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
822+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
823+
* The following example `parent` string specifies a parent project with the
824+
* identifier `example-project`, and specifies the `europe-west3` location
825+
* for processing data:
826+
* parent=projects/example-project/locations/europe-west3
783827
* </pre>
784828
*
785829
* <code>
@@ -804,10 +848,21 @@ public com.google.protobuf.ByteString getParentBytes() {
804848
*
805849
* <pre>
806850
* Required. Parent resource name.
807-
* - Format:projects/[PROJECT-ID]
808-
* - Format:organizations/[ORGANIZATION-ID]
809-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
810-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
851+
* The format of this value varies depending on the scope of the request
852+
* (project or organization) and whether you have [specified a processing
853+
* location](/dlp/docs/specifying-location):
854+
* + Projects scope, location specified:&lt;br/&gt;
855+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
856+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
857+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
858+
* + Organizations scope, location specified:&lt;br/&gt;
859+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
860+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
861+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
862+
* The following example `parent` string specifies a parent project with the
863+
* identifier `example-project`, and specifies the `europe-west3` location
864+
* for processing data:
865+
* parent=projects/example-project/locations/europe-west3
811866
* </pre>
812867
*
813868
* <code>
@@ -831,10 +886,21 @@ public Builder setParent(java.lang.String value) {
831886
*
832887
* <pre>
833888
* Required. Parent resource name.
834-
* - Format:projects/[PROJECT-ID]
835-
* - Format:organizations/[ORGANIZATION-ID]
836-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
837-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
889+
* The format of this value varies depending on the scope of the request
890+
* (project or organization) and whether you have [specified a processing
891+
* location](/dlp/docs/specifying-location):
892+
* + Projects scope, location specified:&lt;br/&gt;
893+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
894+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
895+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
896+
* + Organizations scope, location specified:&lt;br/&gt;
897+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
898+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
899+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
900+
* The following example `parent` string specifies a parent project with the
901+
* identifier `example-project`, and specifies the `europe-west3` location
902+
* for processing data:
903+
* parent=projects/example-project/locations/europe-west3
838904
* </pre>
839905
*
840906
* <code>
@@ -854,10 +920,21 @@ public Builder clearParent() {
854920
*
855921
* <pre>
856922
* Required. Parent resource name.
857-
* - Format:projects/[PROJECT-ID]
858-
* - Format:organizations/[ORGANIZATION-ID]
859-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
860-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
923+
* The format of this value varies depending on the scope of the request
924+
* (project or organization) and whether you have [specified a processing
925+
* location](/dlp/docs/specifying-location):
926+
* + Projects scope, location specified:&lt;br/&gt;
927+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
928+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
929+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
930+
* + Organizations scope, location specified:&lt;br/&gt;
931+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
932+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
933+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
934+
* The following example `parent` string specifies a parent project with the
935+
* identifier `example-project`, and specifies the `europe-west3` location
936+
* for processing data:
937+
* parent=projects/example-project/locations/europe-west3
861938
* </pre>
862939
*
863940
* <code>

‎proto-google-cloud-dlp-v2/src/main/java/com/google/privacy/dlp/v2/CreateDeidentifyTemplateRequestOrBuilder.java‎

Lines changed: 30 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,21 @@ public interface CreateDeidentifyTemplateRequestOrBuilder
2828
*
2929
* <pre>
3030
* Required. Parent resource name.
31-
* - Format:projects/[PROJECT-ID]
32-
* - Format:organizations/[ORGANIZATION-ID]
33-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
34-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
31+
* The format of this value varies depending on the scope of the request
32+
* (project or organization) and whether you have [specified a processing
33+
* location](/dlp/docs/specifying-location):
34+
* + Projects scope, location specified:&lt;br/&gt;
35+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
36+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
37+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
38+
* + Organizations scope, location specified:&lt;br/&gt;
39+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
40+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
41+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
42+
* The following example `parent` string specifies a parent project with the
43+
* identifier `example-project`, and specifies the `europe-west3` location
44+
* for processing data:
45+
* parent=projects/example-project/locations/europe-west3
3546
* </pre>
3647
*
3748
* <code>
@@ -46,10 +57,21 @@ public interface CreateDeidentifyTemplateRequestOrBuilder
4657
*
4758
* <pre>
4859
* Required. Parent resource name.
49-
* - Format:projects/[PROJECT-ID]
50-
* - Format:organizations/[ORGANIZATION-ID]
51-
* - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
52-
* - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
60+
* The format of this value varies depending on the scope of the request
61+
* (project or organization) and whether you have [specified a processing
62+
* location](/dlp/docs/specifying-location):
63+
* + Projects scope, location specified:&lt;br/&gt;
64+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
65+
* + Projects scope, no location specified (defaults to global):&lt;br/&gt;
66+
* `projects/`&lt;var&gt;PROJECT_ID&lt;/var&gt;
67+
* + Organizations scope, location specified:&lt;br/&gt;
68+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;`/locations/`&lt;var&gt;LOCATION_ID&lt;/var&gt;
69+
* + Organizations scope, no location specified (defaults to global):&lt;br/&gt;
70+
* `organizations/`&lt;var&gt;ORG_ID&lt;/var&gt;
71+
* The following example `parent` string specifies a parent project with the
72+
* identifier `example-project`, and specifies the `europe-west3` location
73+
* for processing data:
74+
* parent=projects/example-project/locations/europe-west3
5375
* </pre>
5476
*
5577
* <code>

0 commit comments

Comments
 (0)