google-cloud-dlp-v2 0.4.2 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7253887dacebc8f2315ffbc3189e78b50a10f670737719ba390fba3a00c492d2
4
- data.tar.gz: d1b989d31f3dad4314d380d0a878ef39e767c256742fb8a8aef12808d438d514
3
+ metadata.gz: f07117349c5b9a0d12b96f7f72025d58661574d12abe9812be088c79a16995d0
4
+ data.tar.gz: c2e066f8476f4dd29b9eba710b63f1e655172a70e8cb4d3033311d7b46c61242
5
5
  SHA512:
6
- metadata.gz: 39890c398b458a6c3430ad538275cc7fd72cb43d30a526b5d2248f472d34a453b302b0396e58d4c8bcb8929ea4706608fd2216eb5137c949029078853072a936
7
- data.tar.gz: 9697fa95e2b199eb464de747f5d9421b1f1e4dd375136eda6596490b8a5171f1b118e4a60736c2e235560c53e7c187b8a860ed798dc512b639376d23420b8b60
6
+ metadata.gz: eabd41567b250b3c9f0b607eaf49c7f1e23caaaa14c06e06fac6e74abf2eba501e0deb8561615aa624d050d02ba39aec12c4e02763ffee990f532e9fb36f5558
7
+ data.tar.gz: 3d75392db96a3e3fb7d7657f53393408b2255602eb7d7813c755d5052eab716048ff0d6ef83c7995eb34f6859219ca0bb4b2bfda66bd1b5b64c6068b62bc9fd8
data/README.md CHANGED
@@ -6,6 +6,12 @@ Provides methods for detection of privacy-sensitive fragments in text, images, a
6
6
 
7
7
  https://github.com/googleapis/google-cloud-ruby
8
8
 
9
+ This gem is a _versioned_ client. It provides basic client classes for a
10
+ specific version of the Cloud Data Loss Prevention (DLP) V2 API. Most users should consider using
11
+ the main client gem,
12
+ [google-cloud-dlp](https://rubygems.org/gems/google-cloud-dlp).
13
+ See the section below titled *Which client should I use?* for more information.
14
+
9
15
  ## Installation
10
16
 
11
17
  ```
@@ -73,3 +79,61 @@ in security maintenance, and not end of life. Currently, this means Ruby 2.4
73
79
  and later. Older versions of Ruby _may_ still work, but are unsupported and not
74
80
  recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
75
81
  about the Ruby support schedule.
82
+
83
+ ## Which client should I use?
84
+
85
+ Most modern Ruby client libraries for Google APIs come in two flavors: the main
86
+ client library with a name such as `google-cloud-dlp`,
87
+ and lower-level _versioned_ client libraries with names such as
88
+ `google-cloud-dlp-v2`.
89
+ _In most cases, you should install the main client._
90
+
91
+ ### What's the difference between the main client and a versioned client?
92
+
93
+ A _versioned client_ provides a basic set of data types and client classes for
94
+ a _single version_ of a specific service. (That is, for a service with multiple
95
+ versions, there might be a separate versioned client for each service version.)
96
+ Most versioned clients are written and maintained by a code generator.
97
+
98
+ The _main client_ is designed to provide you with the _recommended_ client
99
+ interfaces for the service. There will be only one main client for any given
100
+ service, even a service with multiple versions. The main client includes
101
+ factory methods for constructing the client objects we recommend for most
102
+ users. In some cases, those will be classes provided by an underlying versioned
103
+ client; in other cases, they will be handwritten higher-level client objects
104
+ with additional capabilities, convenience methods, or best practices built in.
105
+ Generally, the main client will default to a recommended service version,
106
+ although in some cases you can override this if you need to talk to a specific
107
+ service version.
108
+
109
+ ### Why would I want to use the main client?
110
+
111
+ We recommend that most users install the main client gem for a service. You can
112
+ identify this gem as the one _without_ a version in its name, e.g.
113
+ `google-cloud-dlp`.
114
+ The main client is recommended because it will embody the best practices for
115
+ accessing the service, and may also provide more convenient interfaces or
116
+ tighter integration into frameworks and third-party libraries. In addition, the
117
+ documentation and samples published by Google will generally demonstrate use of
118
+ the main client.
119
+
120
+ ### Why would I want to use a versioned client?
121
+
122
+ You can use a versioned client if you are content with a possibly lower-level
123
+ class interface, you explicitly want to avoid features provided by the main
124
+ client, or you want to access a specific service version not be covered by the
125
+ main client. You can identify versioned client gems because the service version
126
+ is part of the name, e.g. `google-cloud-dlp-v2`.
127
+
128
+ ### What about the google-apis-<name> clients?
129
+
130
+ Client library gems with names that begin with `google-apis-` are based on an
131
+ older code generation technology. They talk to a REST/JSON backend (whereas
132
+ most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
133
+ not offer the same performance, features, and ease of use provided by more
134
+ modern clients.
135
+
136
+ The `google-apis-` clients have wide coverage across Google services, so you
137
+ might need to use one if there is no modern client available for the service.
138
+ However, if a modern client is available, we generally recommend it over the
139
+ older `google-apis-` clients.
@@ -33,3 +33,6 @@ module Google
33
33
  end
34
34
  end
35
35
  end
36
+
37
+ helper_path = ::File.join __dir__, "v2", "_helpers.rb"
38
+ require "google/cloud/dlp/v2/_helpers" if ::File.file? helper_path
@@ -322,7 +322,13 @@ module Google
322
322
 
323
323
  # Create credentials
324
324
  credentials = @config.credentials
325
- credentials ||= Credentials.default scope: @config.scope
325
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
326
+ # but only if the default endpoint does not have a region prefix.
327
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
328
+ @config.endpoint == Client.configure.endpoint &&
329
+ !@config.endpoint.split(".").first.include?("-")
330
+ credentials ||= Credentials.default scope: @config.scope,
331
+ enable_self_signed_jwt: enable_self_signed_jwt
326
332
  if credentials.is_a?(String) || credentials.is_a?(Hash)
327
333
  credentials = Credentials.new credentials, scope: @config.scope
328
334
  end
@@ -368,8 +374,21 @@ module Google
368
374
  #
369
375
  # @param parent [::String]
370
376
  # Parent resource name.
371
- # - Format:projects/[PROJECT-ID]
372
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
377
+ #
378
+ # The format of this value varies depending on whether you have [specified a
379
+ # processing
380
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
381
+ #
382
+ # + Projects scope, location specified:<br/>
383
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
384
+ # + Projects scope, no location specified (defaults to global):<br/>
385
+ # `projects/`<var>PROJECT_ID</var>
386
+ #
387
+ # The following example `parent` string specifies a parent project with the
388
+ # identifier `example-project`, and specifies the `europe-west3` location
389
+ # for processing data:
390
+ #
391
+ # parent=projects/example-project/locations/europe-west3
373
392
  # @param inspect_config [::Google::Cloud::Dlp::V2::InspectConfig, ::Hash]
374
393
  # Configuration for the inspector. What specified here will override
375
394
  # the template referenced by the inspect_template_name argument.
@@ -455,9 +474,22 @@ module Google
455
474
  # the default parameter values, pass an empty Hash as a request object (see above).
456
475
  #
457
476
  # @param parent [::String]
458
- # The parent resource name.
459
- # - Format:projects/[PROJECT-ID]
460
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
477
+ # Parent resource name.
478
+ #
479
+ # The format of this value varies depending on whether you have [specified a
480
+ # processing
481
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
482
+ #
483
+ # + Projects scope, location specified:<br/>
484
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
485
+ # + Projects scope, no location specified (defaults to global):<br/>
486
+ # `projects/`<var>PROJECT_ID</var>
487
+ #
488
+ # The following example `parent` string specifies a parent project with the
489
+ # identifier `example-project`, and specifies the `europe-west3` location
490
+ # for processing data:
491
+ #
492
+ # parent=projects/example-project/locations/europe-west3
461
493
  # @param location_id [::String]
462
494
  # Deprecated. This field has no effect.
463
495
  # @param inspect_config [::Google::Cloud::Dlp::V2::InspectConfig, ::Hash]
@@ -542,8 +574,21 @@ module Google
542
574
  #
543
575
  # @param parent [::String]
544
576
  # Parent resource name.
545
- # - Format:projects/[PROJECT-ID]
546
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
577
+ #
578
+ # The format of this value varies depending on whether you have [specified a
579
+ # processing
580
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
581
+ #
582
+ # + Projects scope, location specified:<br/>
583
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
584
+ # + Projects scope, no location specified (defaults to global):<br/>
585
+ # `projects/`<var>PROJECT_ID</var>
586
+ #
587
+ # The following example `parent` string specifies a parent project with the
588
+ # identifier `example-project`, and specifies the `europe-west3` location
589
+ # for processing data:
590
+ #
591
+ # parent=projects/example-project/locations/europe-west3
547
592
  # @param deidentify_config [::Google::Cloud::Dlp::V2::DeidentifyConfig, ::Hash]
548
593
  # Configuration for the de-identification of the content item.
549
594
  # Items specified here will override the template referenced by the
@@ -636,9 +681,22 @@ module Google
636
681
  # the default parameter values, pass an empty Hash as a request object (see above).
637
682
  #
638
683
  # @param parent [::String]
639
- # Required. The parent resource name.
640
- # - Format:projects/[PROJECT-ID]
641
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
684
+ # Required. Parent resource name.
685
+ #
686
+ # The format of this value varies depending on whether you have [specified a
687
+ # processing
688
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
689
+ #
690
+ # + Projects scope, location specified:<br/>
691
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
692
+ # + Projects scope, no location specified (defaults to global):<br/>
693
+ # `projects/`<var>PROJECT_ID</var>
694
+ #
695
+ # The following example `parent` string specifies a parent project with the
696
+ # identifier `example-project`, and specifies the `europe-west3` location
697
+ # for processing data:
698
+ #
699
+ # parent=projects/example-project/locations/europe-west3
642
700
  # @param reidentify_config [::Google::Cloud::Dlp::V2::DeidentifyConfig, ::Hash]
643
701
  # Configuration for the re-identification of the content item.
644
702
  # This field shares the same proto message type that is used for
@@ -663,10 +721,11 @@ module Google
663
721
  # @param reidentify_template_name [::String]
664
722
  # Template to use. References an instance of `DeidentifyTemplate`.
665
723
  # Any configuration directly specified in `reidentify_config` or
666
- # `inspect_config` will override those set in the template. Singular fields
667
- # that are set in this request will replace their corresponding fields in the
668
- # template. Repeated fields are appended. Singular sub-messages and groups
669
- # are recursively merged.
724
+ # `inspect_config` will override those set in the template. The
725
+ # `DeidentifyTemplate` used must include only reversible transformations.
726
+ # Singular fields that are set in this request will replace their
727
+ # corresponding fields in the template. Repeated fields are appended.
728
+ # Singular sub-messages and groups are recursively merged.
670
729
  # @param location_id [::String]
671
730
  # Deprecated. This field has no effect.
672
731
  #
@@ -737,7 +796,10 @@ module Google
737
796
  #
738
797
  # @param parent [::String]
739
798
  # The parent resource name.
740
- # - Format:locations/[LOCATION-ID]
799
+ #
800
+ # The format of this value is as follows:
801
+ #
802
+ # locations/<var>LOCATION_ID</var>
741
803
  # @param language_code [::String]
742
804
  # BCP-47 language code for localized infoType friendly
743
805
  # names. If omitted, or if localized strings are not available,
@@ -809,16 +871,31 @@ module Google
809
871
  #
810
872
  # @param parent [::String]
811
873
  # Required. Parent resource name.
812
- # - Format:projects/[PROJECT-ID]
813
- # - Format:organizations/[ORGANIZATION-ID]
814
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
815
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
874
+ #
875
+ # The format of this value varies depending on the scope of the request
876
+ # (project or organization) and whether you have [specified a processing
877
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
878
+ #
879
+ # + Projects scope, location specified:<br/>
880
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
881
+ # + Projects scope, no location specified (defaults to global):<br/>
882
+ # `projects/`<var>PROJECT_ID</var>
883
+ # + Organizations scope, location specified:<br/>
884
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
885
+ # + Organizations scope, no location specified (defaults to global):<br/>
886
+ # `organizations/`<var>ORG_ID</var>
887
+ #
888
+ # The following example `parent` string specifies a parent project with the
889
+ # identifier `example-project`, and specifies the `europe-west3` location
890
+ # for processing data:
891
+ #
892
+ # parent=projects/example-project/locations/europe-west3
816
893
  # @param inspect_template [::Google::Cloud::Dlp::V2::InspectTemplate, ::Hash]
817
894
  # Required. The InspectTemplate to create.
818
895
  # @param template_id [::String]
819
896
  # The template id can contain uppercase and lowercase letters,
820
897
  # numbers, and hyphens; that is, it must match the regular
821
- # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
898
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
822
899
  # characters. Can be empty to allow the system to generate one.
823
900
  # @param location_id [::String]
824
901
  # Deprecated. This field has no effect.
@@ -1031,10 +1108,25 @@ module Google
1031
1108
  #
1032
1109
  # @param parent [::String]
1033
1110
  # Required. Parent resource name.
1034
- # - Format:projects/[PROJECT-ID]
1035
- # - Format:organizations/[ORGANIZATION-ID]
1036
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
1037
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
1111
+ #
1112
+ # The format of this value varies depending on the scope of the request
1113
+ # (project or organization) and whether you have [specified a processing
1114
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
1115
+ #
1116
+ # + Projects scope, location specified:<br/>
1117
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1118
+ # + Projects scope, no location specified (defaults to global):<br/>
1119
+ # `projects/`<var>PROJECT_ID</var>
1120
+ # + Organizations scope, location specified:<br/>
1121
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
1122
+ # + Organizations scope, no location specified (defaults to global):<br/>
1123
+ # `organizations/`<var>ORG_ID</var>
1124
+ #
1125
+ # The following example `parent` string specifies a parent project with the
1126
+ # identifier `example-project`, and specifies the `europe-west3` location
1127
+ # for processing data:
1128
+ #
1129
+ # parent=projects/example-project/locations/europe-west3
1038
1130
  # @param page_token [::String]
1039
1131
  # Page token to continue retrieval. Comes from previous call
1040
1132
  # to `ListInspectTemplates`.
@@ -1196,16 +1288,31 @@ module Google
1196
1288
  #
1197
1289
  # @param parent [::String]
1198
1290
  # Required. Parent resource name.
1199
- # - Format:projects/[PROJECT-ID]
1200
- # - Format:organizations/[ORGANIZATION-ID]
1201
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
1202
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
1291
+ #
1292
+ # The format of this value varies depending on the scope of the request
1293
+ # (project or organization) and whether you have [specified a processing
1294
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
1295
+ #
1296
+ # + Projects scope, location specified:<br/>
1297
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1298
+ # + Projects scope, no location specified (defaults to global):<br/>
1299
+ # `projects/`<var>PROJECT_ID</var>
1300
+ # + Organizations scope, location specified:<br/>
1301
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
1302
+ # + Organizations scope, no location specified (defaults to global):<br/>
1303
+ # `organizations/`<var>ORG_ID</var>
1304
+ #
1305
+ # The following example `parent` string specifies a parent project with the
1306
+ # identifier `example-project`, and specifies the `europe-west3` location
1307
+ # for processing data:
1308
+ #
1309
+ # parent=projects/example-project/locations/europe-west3
1203
1310
  # @param deidentify_template [::Google::Cloud::Dlp::V2::DeidentifyTemplate, ::Hash]
1204
1311
  # Required. The DeidentifyTemplate to create.
1205
1312
  # @param template_id [::String]
1206
1313
  # The template id can contain uppercase and lowercase letters,
1207
1314
  # numbers, and hyphens; that is, it must match the regular
1208
- # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
1315
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
1209
1316
  # characters. Can be empty to allow the system to generate one.
1210
1317
  # @param location_id [::String]
1211
1318
  # Deprecated. This field has no effect.
@@ -1421,10 +1528,25 @@ module Google
1421
1528
  #
1422
1529
  # @param parent [::String]
1423
1530
  # Required. Parent resource name.
1424
- # - Format:projects/[PROJECT-ID]
1425
- # - Format:organizations/[ORGANIZATION-ID]
1426
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
1427
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
1531
+ #
1532
+ # The format of this value varies depending on the scope of the request
1533
+ # (project or organization) and whether you have [specified a processing
1534
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
1535
+ #
1536
+ # + Projects scope, location specified:<br/>
1537
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1538
+ # + Projects scope, no location specified (defaults to global):<br/>
1539
+ # `projects/`<var>PROJECT_ID</var>
1540
+ # + Organizations scope, location specified:<br/>
1541
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
1542
+ # + Organizations scope, no location specified (defaults to global):<br/>
1543
+ # `organizations/`<var>ORG_ID</var>
1544
+ #
1545
+ # The following example `parent` string specifies a parent project with the
1546
+ # identifier `example-project`, and specifies the `europe-west3` location
1547
+ # for processing data:
1548
+ #
1549
+ # parent=projects/example-project/locations/europe-west3
1428
1550
  # @param page_token [::String]
1429
1551
  # Page token to continue retrieval. Comes from previous call
1430
1552
  # to `ListDeidentifyTemplates`.
@@ -1586,14 +1708,27 @@ module Google
1586
1708
  #
1587
1709
  # @param parent [::String]
1588
1710
  # Required. Parent resource name.
1589
- # - Format:projects/[PROJECT-ID]
1590
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
1711
+ #
1712
+ # The format of this value varies depending on whether you have [specified a
1713
+ # processing
1714
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
1715
+ #
1716
+ # + Projects scope, location specified:<br/>
1717
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
1718
+ # + Projects scope, no location specified (defaults to global):<br/>
1719
+ # `projects/`<var>PROJECT_ID</var>
1720
+ #
1721
+ # The following example `parent` string specifies a parent project with the
1722
+ # identifier `example-project`, and specifies the `europe-west3` location
1723
+ # for processing data:
1724
+ #
1725
+ # parent=projects/example-project/locations/europe-west3
1591
1726
  # @param job_trigger [::Google::Cloud::Dlp::V2::JobTrigger, ::Hash]
1592
1727
  # Required. The JobTrigger to create.
1593
1728
  # @param trigger_id [::String]
1594
1729
  # The trigger id can contain uppercase and lowercase letters,
1595
1730
  # numbers, and hyphens; that is, it must match the regular
1596
- # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
1731
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
1597
1732
  # characters. Can be empty to allow the system to generate one.
1598
1733
  # @param location_id [::String]
1599
1734
  # Deprecated. This field has no effect.
@@ -1878,8 +2013,21 @@ module Google
1878
2013
  #
1879
2014
  # @param parent [::String]
1880
2015
  # Required. Parent resource name.
1881
- # - Format:projects/[PROJECT-ID]
1882
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
2016
+ #
2017
+ # The format of this value varies depending on whether you have [specified a
2018
+ # processing
2019
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
2020
+ #
2021
+ # + Projects scope, location specified:<br/>
2022
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2023
+ # + Projects scope, no location specified (defaults to global):<br/>
2024
+ # `projects/`<var>PROJECT_ID</var>
2025
+ #
2026
+ # The following example `parent` string specifies a parent project with the
2027
+ # identifier `example-project`, and specifies the `europe-west3` location
2028
+ # for processing data:
2029
+ #
2030
+ # parent=projects/example-project/locations/europe-west3
1883
2031
  # @param page_token [::String]
1884
2032
  # Page token to continue retrieval. Comes from previous call
1885
2033
  # to ListJobTriggers. `order_by` field must not
@@ -2138,8 +2286,21 @@ module Google
2138
2286
  #
2139
2287
  # @param parent [::String]
2140
2288
  # Required. Parent resource name.
2141
- # - Format:projects/[PROJECT-ID]
2142
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
2289
+ #
2290
+ # The format of this value varies depending on whether you have [specified a
2291
+ # processing
2292
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
2293
+ #
2294
+ # + Projects scope, location specified:<br/>
2295
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2296
+ # + Projects scope, no location specified (defaults to global):<br/>
2297
+ # `projects/`<var>PROJECT_ID</var>
2298
+ #
2299
+ # The following example `parent` string specifies a parent project with the
2300
+ # identifier `example-project`, and specifies the `europe-west3` location
2301
+ # for processing data:
2302
+ #
2303
+ # parent=projects/example-project/locations/europe-west3
2143
2304
  # @param inspect_job [::Google::Cloud::Dlp::V2::InspectJobConfig, ::Hash]
2144
2305
  # Set to control what and how to inspect.
2145
2306
  # @param risk_job [::Google::Cloud::Dlp::V2::RiskAnalysisJobConfig, ::Hash]
@@ -2147,7 +2308,7 @@ module Google
2147
2308
  # @param job_id [::String]
2148
2309
  # The job id can contain uppercase and lowercase letters,
2149
2310
  # numbers, and hyphens; that is, it must match the regular
2150
- # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2311
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
2151
2312
  # characters. Can be empty to allow the system to generate one.
2152
2313
  # @param location_id [::String]
2153
2314
  # Deprecated. This field has no effect.
@@ -2219,8 +2380,21 @@ module Google
2219
2380
  #
2220
2381
  # @param parent [::String]
2221
2382
  # Required. Parent resource name.
2222
- # - Format:projects/[PROJECT-ID]
2223
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
2383
+ #
2384
+ # The format of this value varies depending on whether you have [specified a
2385
+ # processing
2386
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
2387
+ #
2388
+ # + Projects scope, location specified:<br/>
2389
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2390
+ # + Projects scope, no location specified (defaults to global):<br/>
2391
+ # `projects/`<var>PROJECT_ID</var>
2392
+ #
2393
+ # The following example `parent` string specifies a parent project with the
2394
+ # identifier `example-project`, and specifies the `europe-west3` location
2395
+ # for processing data:
2396
+ #
2397
+ # parent=projects/example-project/locations/europe-west3
2224
2398
  # @param filter [::String]
2225
2399
  # Allows filtering.
2226
2400
  #
@@ -2549,16 +2723,31 @@ module Google
2549
2723
  #
2550
2724
  # @param parent [::String]
2551
2725
  # Required. Parent resource name.
2552
- # - Format:projects/[PROJECT-ID]
2553
- # - Format:organizations/[ORGANIZATION-ID]
2554
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
2555
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
2726
+ #
2727
+ # The format of this value varies depending on the scope of the request
2728
+ # (project or organization) and whether you have [specified a processing
2729
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
2730
+ #
2731
+ # + Projects scope, location specified:<br/>
2732
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2733
+ # + Projects scope, no location specified (defaults to global):<br/>
2734
+ # `projects/`<var>PROJECT_ID</var>
2735
+ # + Organizations scope, location specified:<br/>
2736
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
2737
+ # + Organizations scope, no location specified (defaults to global):<br/>
2738
+ # `organizations/`<var>ORG_ID</var>
2739
+ #
2740
+ # The following example `parent` string specifies a parent project with the
2741
+ # identifier `example-project`, and specifies the `europe-west3` location
2742
+ # for processing data:
2743
+ #
2744
+ # parent=projects/example-project/locations/europe-west3
2556
2745
  # @param config [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig, ::Hash]
2557
2746
  # Required. Configuration of the storedInfoType to create.
2558
2747
  # @param stored_info_type_id [::String]
2559
2748
  # The storedInfoType ID can contain uppercase and lowercase letters,
2560
2749
  # numbers, and hyphens; that is, it must match the regular
2561
- # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2750
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
2562
2751
  # characters. Can be empty to allow the system to generate one.
2563
2752
  # @param location_id [::String]
2564
2753
  # Deprecated. This field has no effect.
@@ -2777,10 +2966,25 @@ module Google
2777
2966
  #
2778
2967
  # @param parent [::String]
2779
2968
  # Required. Parent resource name.
2780
- # - Format:projects/[PROJECT-ID]
2781
- # - Format:organizations/[ORGANIZATION-ID]
2782
- # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID]
2783
- # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID]
2969
+ #
2970
+ # The format of this value varies depending on the scope of the request
2971
+ # (project or organization) and whether you have [specified a processing
2972
+ # location](https://cloud.google.com/dlp/docs/specifying-location):
2973
+ #
2974
+ # + Projects scope, location specified:<br/>
2975
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2976
+ # + Projects scope, no location specified (defaults to global):<br/>
2977
+ # `projects/`<var>PROJECT_ID</var>
2978
+ # + Organizations scope, location specified:<br/>
2979
+ # `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
2980
+ # + Organizations scope, no location specified (defaults to global):<br/>
2981
+ # `organizations/`<var>ORG_ID</var>
2982
+ #
2983
+ # The following example `parent` string specifies a parent project with the
2984
+ # identifier `example-project`, and specifies the `europe-west3` location
2985
+ # for processing data:
2986
+ #
2987
+ # parent=projects/example-project/locations/europe-west3
2784
2988
  # @param page_token [::String]
2785
2989
  # Page token to continue retrieval. Comes from previous call
2786
2990
  # to `ListStoredInfoTypes`.
@@ -3190,7 +3394,7 @@ module Google
3190
3394
  # Each configuration object is of type `Gapic::Config::Method` and includes
3191
3395
  # the following configuration fields:
3192
3396
  #
3193
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
3397
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
3194
3398
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
3195
3399
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
3196
3400
  # include the following keys: