@google-cloud/dlp 5.8.0 → 5.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,13 @@
4
4
 
5
5
  [1]: https://www.npmjs.com/package/PACKAGE NAME?activeTab=versions
6
6
 
7
+ ## [5.9.0](https://github.com/googleapis/google-cloud-node/compare/dlp-v5.8.0...dlp-v5.9.0) (2024-08-09)
8
+
9
+
10
+ ### Features
11
+
12
+ * [dlp] add the TagResources API ([#5588](https://github.com/googleapis/google-cloud-node/issues/5588)) ([91df9a7](https://github.com/googleapis/google-cloud-node/commit/91df9a74e2f3573a3620f6641b51112ed6f3f394))
13
+
7
14
  ## [5.8.0](https://github.com/googleapis/google-cloud-node/compare/dlp-v5.7.0...dlp-v5.8.0) (2024-07-22)
8
15
 
9
16
 
@@ -160,7 +160,7 @@ service DlpService {
160
160
  rpc CreateInspectTemplate(CreateInspectTemplateRequest)
161
161
  returns (InspectTemplate) {
162
162
  option (google.api.http) = {
163
- post: "/v2/{parent=organizations/*}/inspectTemplates"
163
+ post: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
164
164
  body: "*"
165
165
  additional_bindings {
166
166
  post: "/v2/{parent=organizations/*/locations/*}/inspectTemplates"
@@ -171,7 +171,7 @@ service DlpService {
171
171
  body: "*"
172
172
  }
173
173
  additional_bindings {
174
- post: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
174
+ post: "/v2/{parent=organizations/*}/inspectTemplates"
175
175
  body: "*"
176
176
  }
177
177
  };
@@ -185,7 +185,7 @@ service DlpService {
185
185
  rpc UpdateInspectTemplate(UpdateInspectTemplateRequest)
186
186
  returns (InspectTemplate) {
187
187
  option (google.api.http) = {
188
- patch: "/v2/{name=organizations/*/inspectTemplates/*}"
188
+ patch: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
189
189
  body: "*"
190
190
  additional_bindings {
191
191
  patch: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
@@ -196,7 +196,7 @@ service DlpService {
196
196
  body: "*"
197
197
  }
198
198
  additional_bindings {
199
- patch: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
199
+ patch: "/v2/{name=organizations/*/inspectTemplates/*}"
200
200
  body: "*"
201
201
  }
202
202
  };
@@ -209,13 +209,13 @@ service DlpService {
209
209
  // to learn more.
210
210
  rpc GetInspectTemplate(GetInspectTemplateRequest) returns (InspectTemplate) {
211
211
  option (google.api.http) = {
212
- get: "/v2/{name=organizations/*/inspectTemplates/*}"
212
+ get: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
213
213
  additional_bindings {
214
214
  get: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
215
215
  }
216
216
  additional_bindings { get: "/v2/{name=projects/*/inspectTemplates/*}" }
217
217
  additional_bindings {
218
- get: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
218
+ get: "/v2/{name=organizations/*/inspectTemplates/*}"
219
219
  }
220
220
  };
221
221
  option (google.api.method_signature) = "name";
@@ -228,13 +228,13 @@ service DlpService {
228
228
  rpc ListInspectTemplates(ListInspectTemplatesRequest)
229
229
  returns (ListInspectTemplatesResponse) {
230
230
  option (google.api.http) = {
231
- get: "/v2/{parent=organizations/*}/inspectTemplates"
231
+ get: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
232
232
  additional_bindings {
233
233
  get: "/v2/{parent=organizations/*/locations/*}/inspectTemplates"
234
234
  }
235
235
  additional_bindings { get: "/v2/{parent=projects/*}/inspectTemplates" }
236
236
  additional_bindings {
237
- get: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
237
+ get: "/v2/{parent=organizations/*}/inspectTemplates"
238
238
  }
239
239
  };
240
240
  option (google.api.method_signature) = "parent";
@@ -247,13 +247,13 @@ service DlpService {
247
247
  rpc DeleteInspectTemplate(DeleteInspectTemplateRequest)
248
248
  returns (google.protobuf.Empty) {
249
249
  option (google.api.http) = {
250
- delete: "/v2/{name=organizations/*/inspectTemplates/*}"
250
+ delete: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
251
251
  additional_bindings {
252
252
  delete: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
253
253
  }
254
254
  additional_bindings { delete: "/v2/{name=projects/*/inspectTemplates/*}" }
255
255
  additional_bindings {
256
- delete: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
256
+ delete: "/v2/{name=organizations/*/inspectTemplates/*}"
257
257
  }
258
258
  };
259
259
  option (google.api.method_signature) = "name";
@@ -898,6 +898,10 @@ service DlpService {
898
898
  option (google.api.http) = {
899
899
  post: "/v2/{parent=projects/*/locations/*}/connections"
900
900
  body: "*"
901
+ additional_bindings {
902
+ post: "/v2/{parent=organizations/*/locations/*}/connections"
903
+ body: "*"
904
+ }
901
905
  };
902
906
  option (google.api.method_signature) = "parent, connection";
903
907
  }
@@ -906,15 +910,22 @@ service DlpService {
906
910
  rpc GetConnection(GetConnectionRequest) returns (Connection) {
907
911
  option (google.api.http) = {
908
912
  get: "/v2/{name=projects/*/locations/*/connections/*}"
913
+ additional_bindings {
914
+ get: "/v2/{name=organizations/*/locations/*/connections/*}"
915
+ }
909
916
  };
910
917
  option (google.api.method_signature) = "name";
911
918
  }
912
919
 
913
- // Lists Connections in a parent.
920
+ // Lists Connections in a parent. Use SearchConnections to see all connections
921
+ // within an organization.
914
922
  rpc ListConnections(ListConnectionsRequest)
915
923
  returns (ListConnectionsResponse) {
916
924
  option (google.api.http) = {
917
925
  get: "/v2/{parent=projects/*/locations/*}/connections"
926
+ additional_bindings {
927
+ get: "/v2/{parent=organizations/*/locations/*}/connections"
928
+ }
918
929
  };
919
930
  option (google.api.method_signature) = "parent";
920
931
  }
@@ -936,6 +947,9 @@ service DlpService {
936
947
  returns (google.protobuf.Empty) {
937
948
  option (google.api.http) = {
938
949
  delete: "/v2/{name=projects/*/locations/*/connections/*}"
950
+ additional_bindings {
951
+ delete: "/v2/{name=organizations/*/locations/*/connections/*}"
952
+ }
939
953
  };
940
954
  option (google.api.method_signature) = "name";
941
955
  }
@@ -945,6 +959,10 @@ service DlpService {
945
959
  option (google.api.http) = {
946
960
  patch: "/v2/{name=projects/*/locations/*/connections/*}"
947
961
  body: "*"
962
+ additional_bindings {
963
+ patch: "/v2/{name=organizations/*/locations/*/connections/*}"
964
+ body: "*"
965
+ }
948
966
  };
949
967
  option (google.api.method_signature) = "name";
950
968
  }
@@ -1567,9 +1585,9 @@ message RedactImageRequest {
1567
1585
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1568
1586
  //
1569
1587
  // + Projects scope, location specified:
1570
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1588
+ // `projects/{project_id}/locations/{location_id}`
1571
1589
  // + Projects scope, no location specified (defaults to global):
1572
- // `projects/`<var>PROJECT_ID</var>
1590
+ // `projects/{project_id}`
1573
1591
  //
1574
1592
  // The following example `parent` string specifies a parent project with the
1575
1593
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -1632,9 +1650,9 @@ message DeidentifyContentRequest {
1632
1650
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1633
1651
  //
1634
1652
  // + Projects scope, location specified:
1635
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1653
+ // `projects/{project_id}/locations/{location_id}`
1636
1654
  // + Projects scope, no location specified (defaults to global):
1637
- // `projects/`<var>PROJECT_ID</var>
1655
+ // `projects/{project_id}`
1638
1656
  //
1639
1657
  // The following example `parent` string specifies a parent project with the
1640
1658
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -1701,9 +1719,9 @@ message ReidentifyContentRequest {
1701
1719
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1702
1720
  //
1703
1721
  // + Projects scope, location specified:
1704
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1722
+ // `projects/{project_id}/locations/{location_id}`
1705
1723
  // + Projects scope, no location specified (defaults to global):
1706
- // `projects/`<var>PROJECT_ID</var>
1724
+ // `projects/{project_id}`
1707
1725
  //
1708
1726
  // The following example `parent` string specifies a parent project with the
1709
1727
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -1773,9 +1791,9 @@ message InspectContentRequest {
1773
1791
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1774
1792
  //
1775
1793
  // + Projects scope, location specified:
1776
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1794
+ // `projects/{project_id}/locations/{location_id}`
1777
1795
  // + Projects scope, no location specified (defaults to global):
1778
- // `projects/`<var>PROJECT_ID</var>
1796
+ // `projects/{project_id}`
1779
1797
  //
1780
1798
  // The following example `parent` string specifies a parent project with the
1781
1799
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -2258,7 +2276,7 @@ message ListInfoTypesRequest {
2258
2276
  //
2259
2277
  // The format of this value is as follows:
2260
2278
  //
2261
- // locations/<var>LOCATION_ID</var>
2279
+ // `locations/{location_id}`
2262
2280
  string parent = 4;
2263
2281
 
2264
2282
  // BCP-47 language code for localized infoType friendly
@@ -3357,8 +3375,7 @@ message CryptoReplaceFfxFpeConfig {
3357
3375
  // This must be encoded as ASCII.
3358
3376
  // The order of characters does not matter.
3359
3377
  // The full list of allowed characters is:
3360
- // <code>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
3361
- // ~`!@#$%^&*()_-+={[}]|\:;"'<,>.?/</code>
3378
+ // ``0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~`!@#$%^&*()_-+={[}]|\:;"'<,>.?/``
3362
3379
  string custom_alphabet = 5;
3363
3380
 
3364
3381
  // The native way to select the alphabet. Must be in the range [2, 95].
@@ -4281,13 +4298,13 @@ message CreateInspectTemplateRequest {
4281
4298
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4282
4299
  //
4283
4300
  // + Projects scope, location specified:
4284
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4301
+ // `projects/{project_id}/locations/{location_id}`
4285
4302
  // + Projects scope, no location specified (defaults to global):
4286
- // `projects/`<var>PROJECT_ID</var>
4303
+ // `projects/{project_id}`
4287
4304
  // + Organizations scope, location specified:
4288
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
4305
+ // `organizations/{org_id}/locations/{location_id}`
4289
4306
  // + Organizations scope, no location specified (defaults to global):
4290
- // `organizations/`<var>ORG_ID</var>
4307
+ // `organizations/{org_id}`
4291
4308
  //
4292
4309
  // The following example `parent` string specifies a parent project with the
4293
4310
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4355,13 +4372,13 @@ message ListInspectTemplatesRequest {
4355
4372
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4356
4373
  //
4357
4374
  // + Projects scope, location specified:
4358
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4375
+ // `projects/{project_id}/locations/{location_id}`
4359
4376
  // + Projects scope, no location specified (defaults to global):
4360
- // `projects/`<var>PROJECT_ID</var>
4377
+ // `projects/{project_id}`
4361
4378
  // + Organizations scope, location specified:
4362
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
4379
+ // `organizations/{org_id}/locations/{location_id}`
4363
4380
  // + Organizations scope, no location specified (defaults to global):
4364
- // `organizations/`<var>ORG_ID</var>
4381
+ // `organizations/{org_id}`
4365
4382
  //
4366
4383
  // The following example `parent` string specifies a parent project with the
4367
4384
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4434,9 +4451,9 @@ message CreateJobTriggerRequest {
4434
4451
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4435
4452
  //
4436
4453
  // + Projects scope, location specified:
4437
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4454
+ // `projects/{project_id}/locations/{location_id}`
4438
4455
  // + Projects scope, no location specified (defaults to global):
4439
- // `projects/`<var>PROJECT_ID</var>
4456
+ // `projects/{project_id}`
4440
4457
  //
4441
4458
  // The following example `parent` string specifies a parent project with the
4442
4459
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4507,9 +4524,9 @@ message CreateDiscoveryConfigRequest {
4507
4524
  // (project or organization):
4508
4525
  //
4509
4526
  // + Projects scope:
4510
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4527
+ // `projects/{project_id}/locations/{location_id}`
4511
4528
  // + Organizations scope:
4512
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
4529
+ // `organizations/{org_id}/locations/{location_id}`
4513
4530
  //
4514
4531
  // The following example `parent` string specifies a parent project with the
4515
4532
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4568,7 +4585,7 @@ message ListDiscoveryConfigsRequest {
4568
4585
  // Required. Parent resource name.
4569
4586
  //
4570
4587
  // The format of this value is as follows:
4571
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4588
+ // `projects/{project_id}/locations/{location_id}`
4572
4589
  //
4573
4590
  // The following example `parent` string specifies a parent project with the
4574
4591
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4638,9 +4655,9 @@ message CreateDlpJobRequest {
4638
4655
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4639
4656
  //
4640
4657
  // + Projects scope, location specified:
4641
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4658
+ // `projects/{project_id}/locations/{location_id}`
4642
4659
  // + Projects scope, no location specified (defaults to global):
4643
- // `projects/`<var>PROJECT_ID</var>
4660
+ // `projects/{project_id}`
4644
4661
  //
4645
4662
  // The following example `parent` string specifies a parent project with the
4646
4663
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4683,9 +4700,9 @@ message ListJobTriggersRequest {
4683
4700
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4684
4701
  //
4685
4702
  // + Projects scope, location specified:
4686
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
4703
+ // `projects/{project_id}/locations/{location_id}`
4687
4704
  // + Projects scope, no location specified (defaults to global):
4688
- // `projects/`<var>PROJECT_ID</var>
4705
+ // `projects/{project_id}`
4689
4706
  //
4690
4707
  // The following example `parent` string specifies a parent project with the
4691
4708
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -4794,6 +4811,18 @@ message InspectJobConfig {
4794
4811
  repeated Action actions = 4;
4795
4812
  }
4796
4813
 
4814
+ // Whether a profile being created is the first generation or an update.
4815
+ enum ProfileGeneration {
4816
+ // Unused.
4817
+ PROFILE_GENERATION_UNSPECIFIED = 0;
4818
+
4819
+ // The profile is the first profile for the resource.
4820
+ PROFILE_GENERATION_NEW = 1;
4821
+
4822
+ // The profile is an update to a previous profile.
4823
+ PROFILE_GENERATION_UPDATE = 2;
4824
+ }
4825
+
4797
4826
  // A task to execute when a data profile has been generated.
4798
4827
  message DataProfileAction {
4799
4828
  // If set, the detailed data profiles will be persisted to the location
@@ -4868,6 +4897,60 @@ message DataProfileAction {
4868
4897
  ERROR_CHANGED = 4;
4869
4898
  }
4870
4899
 
4900
+ // If set, attaches the [tags]
4901
+ // (https://cloud.google.com/resource-manager/docs/tags/tags-overview)
4902
+ // provided to profiled resources. Tags support [access
4903
+ // control](https://cloud.google.com/iam/docs/tags-access-control). You can
4904
+ // conditionally grant or deny access to a resource based on whether the
4905
+ // resource has a specific tag.
4906
+ message TagResources {
4907
+ // The tag to attach to profiles matching the condition. At most one
4908
+ // `TagCondition` can be specified per sensitivity level.
4909
+ message TagCondition {
4910
+ // The tag value to attach to resources.
4911
+ TagValue tag = 1;
4912
+
4913
+ // The type of condition on which attaching the tag will be predicated.
4914
+ oneof type {
4915
+ // Conditions attaching the tag to a resource on its profile having this
4916
+ // sensitivity score.
4917
+ SensitivityScore sensitivity_score = 2;
4918
+ }
4919
+ }
4920
+
4921
+ // A value of a tag.
4922
+ message TagValue {
4923
+ // The format of the tag value.
4924
+ oneof format {
4925
+ // The namespaced name for the tag value to attach to resources. Must be
4926
+ // in the format `{parent_id}/{tag_key_short_name}/{short_name}`, for
4927
+ // example, "123456/environment/prod".
4928
+ string namespaced_value = 1;
4929
+ }
4930
+ }
4931
+
4932
+ // The tags to associate with different conditions.
4933
+ repeated TagCondition tag_conditions = 1;
4934
+
4935
+ // The profile generations for which the tag should be attached to
4936
+ // resources. If you attach a tag to only new profiles, then if the
4937
+ // sensitivity score of a profile subsequently changes, its tag doesn't
4938
+ // change. By default, this field includes only new profiles. To include
4939
+ // both new and updated profiles for tagging, this field should explicitly
4940
+ // include both `PROFILE_GENERATION_NEW` and `PROFILE_GENERATION_UPDATE`.
4941
+ repeated ProfileGeneration profile_generations_to_tag = 2;
4942
+
4943
+ // Whether applying a tag to a resource should lower the risk of the profile
4944
+ // for that resource. For example, in conjunction with an [IAM deny
4945
+ // policy](https://cloud.google.com/iam/docs/deny-overview), you can deny
4946
+ // all principals a permission if a tag value is present, mitigating the
4947
+ // risk of the resource. This also lowers the data risk of resources at the
4948
+ // lower levels of the resource hierarchy. For example, reducing the data
4949
+ // risk of a table data profile also reduces the data risk of the
4950
+ // constituent column data profiles.
4951
+ bool lower_data_risk_to_low = 3;
4952
+ }
4953
+
4871
4954
  // Type of action to execute when a profile is generated.
4872
4955
  oneof action {
4873
4956
  // Export data profiles into a provided location.
@@ -4875,6 +4958,9 @@ message DataProfileAction {
4875
4958
 
4876
4959
  // Publish a message into the Pub/Sub topic.
4877
4960
  PubSubNotification pub_sub_notification = 2;
4961
+
4962
+ // Tags the profiled resources with the specified tag values.
4963
+ TagResources tag_resources = 8;
4878
4964
  }
4879
4965
  }
4880
4966
 
@@ -5246,6 +5332,10 @@ message DiscoveryGenerationCadence {
5246
5332
  // defined by the `InspectTemplate` change.
5247
5333
  // If not set, changing the template will not cause a data profile to update.
5248
5334
  DiscoveryInspectTemplateModifiedCadence inspect_template_modified_cadence = 3;
5335
+
5336
+ // Frequency at which profiles should be updated, regardless of whether the
5337
+ // underlying resource has changed. Defaults to never.
5338
+ DataProfileUpdateFrequency refresh_frequency = 4;
5249
5339
  }
5250
5340
 
5251
5341
  // The cadence at which to update data profiles when a table is modified.
@@ -5734,7 +5824,7 @@ message DiscoveryStartingLocation {
5734
5824
  // The ID of an organization to scan.
5735
5825
  int64 organization_id = 1;
5736
5826
 
5737
- // The ID of the folder within an organization to scan.
5827
+ // The ID of the folder within an organization to be scanned.
5738
5828
  int64 folder_id = 2;
5739
5829
  }
5740
5830
  }
@@ -5837,9 +5927,9 @@ message ListDlpJobsRequest {
5837
5927
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
5838
5928
  //
5839
5929
  // + Projects scope, location specified:
5840
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
5930
+ // `projects/{project_id}/locations/{location_id}`
5841
5931
  // + Projects scope, no location specified (defaults to global):
5842
- // `projects/`<var>PROJECT_ID</var>
5932
+ // `projects/{project_id}`
5843
5933
  //
5844
5934
  // The following example `parent` string specifies a parent project with the
5845
5935
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -5956,13 +6046,13 @@ message CreateDeidentifyTemplateRequest {
5956
6046
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
5957
6047
  //
5958
6048
  // + Projects scope, location specified:
5959
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
6049
+ // `projects/{project_id}/locations/{location_id}`
5960
6050
  // + Projects scope, no location specified (defaults to global):
5961
- // `projects/`<var>PROJECT_ID</var>
6051
+ // `projects/{project_id}`
5962
6052
  // + Organizations scope, location specified:
5963
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
6053
+ // `organizations/{org_id}/locations/{location_id}`
5964
6054
  // + Organizations scope, no location specified (defaults to global):
5965
- // `organizations/`<var>ORG_ID</var>
6055
+ // `organizations/{org_id}`
5966
6056
  //
5967
6057
  // The following example `parent` string specifies a parent project with the
5968
6058
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -6032,13 +6122,13 @@ message ListDeidentifyTemplatesRequest {
6032
6122
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6033
6123
  //
6034
6124
  // + Projects scope, location specified:
6035
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
6125
+ // `projects/{project_id}/locations/{location_id}`
6036
6126
  // + Projects scope, no location specified (defaults to global):
6037
- // `projects/`<var>PROJECT_ID</var>
6127
+ // `projects/{project_id}`
6038
6128
  // + Organizations scope, location specified:
6039
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
6129
+ // `organizations/{org_id}/locations/{location_id}`
6040
6130
  // + Organizations scope, no location specified (defaults to global):
6041
- // `organizations/`<var>ORG_ID</var>
6131
+ // `organizations/{org_id}`
6042
6132
  //
6043
6133
  // The following example `parent` string specifies a parent project with the
6044
6134
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -6229,13 +6319,13 @@ message CreateStoredInfoTypeRequest {
6229
6319
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6230
6320
  //
6231
6321
  // + Projects scope, location specified:
6232
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
6322
+ // `projects/{project_id}/locations/{location_id}`
6233
6323
  // + Projects scope, no location specified (defaults to global):
6234
- // `projects/`<var>PROJECT_ID</var>
6324
+ // `projects/{project_id}`
6235
6325
  // + Organizations scope, location specified:
6236
- // `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
6326
+ // `organizations/{org_id}/locations/{location_id}`
6237
6327
  // + Organizations scope, no location specified (defaults to global):
6238
- // `organizations/`<var>ORG_ID</var>
6328
+ // `organizations/{org_id}`
6239
6329
  //
6240
6330
  // The following example `parent` string specifies a parent project with the
6241
6331
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -6305,9 +6395,9 @@ message ListStoredInfoTypesRequest {
6305
6395
  // location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6306
6396
  //
6307
6397
  // + Projects scope, location specified:
6308
- // `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
6398
+ // `projects/{project_id}/locations/{location_id}`
6309
6399
  // + Projects scope, no location specified (defaults to global):
6310
- // `projects/`<var>PROJECT_ID</var>
6400
+ // `projects/{project_id}`
6311
6401
  //
6312
6402
  // The following example `parent` string specifies a parent project with the
6313
6403
  // identifier `example-project`, and specifies the `europe-west3` location
@@ -7637,8 +7727,15 @@ message DataProfilePubSubMessage {
7637
7727
 
7638
7728
  // Request message for CreateConnection.
7639
7729
  message CreateConnectionRequest {
7640
- // Required. Parent resource name in the format:
7641
- // `projects/{project}/locations/{location}`.
7730
+ // Required. Parent resource name.
7731
+ //
7732
+ // The format of this value varies depending on the scope of the request
7733
+ // (project or organization):
7734
+ //
7735
+ // + Projects scope:
7736
+ // `projects/{project_id}/locations/{location_id}`
7737
+ // + Organizations scope:
7738
+ // `organizations/{org_id}/locations/{location_id}`
7642
7739
  string parent = 1 [
7643
7740
  (google.api.field_behavior) = REQUIRED,
7644
7741
  (google.api.resource_reference) = {
@@ -7662,8 +7759,9 @@ message GetConnectionRequest {
7662
7759
 
7663
7760
  // Request message for ListConnections.
7664
7761
  message ListConnectionsRequest {
7665
- // Required. Parent name, for example:
7666
- // `projects/project-id/locations/global`.
7762
+ // Required. Resource name of the organization or project, for
7763
+ // example, `organizations/433245324/locations/europe` or
7764
+ // `projects/project-id/locations/asia`.
7667
7765
  string parent = 1 [
7668
7766
  (google.api.field_behavior) = REQUIRED,
7669
7767
  (google.api.resource_reference) = {
@@ -7684,8 +7782,9 @@ message ListConnectionsRequest {
7684
7782
 
7685
7783
  // Request message for SearchConnections.
7686
7784
  message SearchConnectionsRequest {
7687
- // Required. Parent name, typically an organization, without location.
7688
- // For example: `organizations/12345678`.
7785
+ // Required. Resource name of the organization or project with a wildcard
7786
+ // location, for example, `organizations/433245324/locations/-` or
7787
+ // `projects/project-id/locations/-`.
7689
7788
  string parent = 1 [
7690
7789
  (google.api.field_behavior) = REQUIRED,
7691
7790
  (google.api.resource_reference) = {
@@ -7759,6 +7858,7 @@ message Connection {
7759
7858
  option (google.api.resource) = {
7760
7859
  type: "dlp.googleapis.com/Connection"
7761
7860
  pattern: "projects/{project}/locations/{location}/connections/{connection}"
7861
+ pattern: "organizations/{organization}/locations/{location}/connections/{connection}"
7762
7862
  };
7763
7863
 
7764
7864
  // Output only. Name of the connection:
@@ -7891,7 +7991,7 @@ message DataSourceType {
7891
7991
  // Message used to identify file cluster type being profiled.
7892
7992
  message FileClusterType {
7893
7993
  // Cluster type. Each cluster corresponds to a set of file types.
7894
- // Over time new types may be added.
7994
+ // Over time, new types may be added and files may move between clusters.
7895
7995
  enum Cluster {
7896
7996
  // Unused.
7897
7997
  CLUSTER_UNSPECIFIED = 0;
@@ -653,7 +653,7 @@ message StorageConfig {
653
653
  // Specification of the field containing the timestamp of scanned items.
654
654
  // Used for data sources like Datastore and BigQuery.
655
655
  //
656
- // <b>For BigQuery</b>
656
+ // **For BigQuery**
657
657
  //
658
658
  // If this value is not specified and the table was modified between the
659
659
  // given start and end times, the entire table will be scanned. If this
@@ -668,13 +668,11 @@ message StorageConfig {
668
668
  // you can use any of the following pseudo-columns as your timestamp field.
669
669
  // When used with Cloud DLP, these pseudo-column names are case sensitive.
670
670
  //
671
- // <ul>
672
- // <li><code>_PARTITIONTIME</code></li>
673
- // <li><code>_PARTITIONDATE</code></li>
674
- // <li><code>_PARTITION_LOAD_TIME</code></li>
675
- // </ul>
671
+ // - `_PARTITIONTIME`
672
+ // - `_PARTITIONDATE`
673
+ // - `_PARTITION_LOAD_TIME`
676
674
  //
677
- // <b>For Datastore</b>
675
+ // **For Datastore**
678
676
  //
679
677
  // If this value is specified, then entities are filtered based on the given
680
678
  // start and end times. If an entity does not contain the provided timestamp