google-cloud-dlp 0.12.1 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -79,10 +79,9 @@ module Google
79
79
  # system may automatically choose what detectors to run. By default this may
80
80
  # be all types, but may change over time as detectors are updated.
81
81
  #
82
- # The special InfoType name "ALL_BASIC" can be used to trigger all detectors,
83
- # but may change over time as new InfoTypes are added. If you need precise
84
- # control and predictability as to what detectors are run you should specify
85
- # specific InfoTypes listed in the reference.
82
+ # If you need precise control and predictability as to what detectors are
83
+ # run you should specify specific InfoTypes listed in the reference,
84
+ # otherwise a default list will be used, which may change over time.
86
85
  # @!attribute [rw] min_likelihood
87
86
  # @return [Google::Privacy::Dlp::V2::Likelihood]
88
87
  # Only returns findings equal or above this threshold. The default is
@@ -350,6 +349,10 @@ module Google
350
349
  # @!attribute [rw] parent
351
350
  # @return [String]
352
351
  # The parent resource name, for example projects/my-project-id.
352
+ # @!attribute [rw] location_id
353
+ # @return [String]
354
+ # The geographic location to process the request. Reserved for future
355
+ # extensions.
353
356
  # @!attribute [rw] inspect_config
354
357
  # @return [Google::Privacy::Dlp::V2::InspectConfig]
355
358
  # Configuration for the inspector.
@@ -439,6 +442,10 @@ module Google
439
442
  # that are set in this request will replace their corresponding fields in the
440
443
  # template. Repeated fields are appended. Singular sub-messages and groups
441
444
  # are recursively merged.
445
+ # @!attribute [rw] location_id
446
+ # @return [String]
447
+ # The geographic location to process de-identification. Reserved for future
448
+ # extensions.
442
449
  class DeidentifyContentRequest; end
443
450
 
444
451
  # Results of de-identifying a ContentItem.
@@ -453,7 +460,7 @@ module Google
453
460
  # Request to re-identify an item.
454
461
  # @!attribute [rw] parent
455
462
  # @return [String]
456
- # The parent resource name.
463
+ # Required. The parent resource name.
457
464
  # @!attribute [rw] reidentify_config
458
465
  # @return [Google::Privacy::Dlp::V2::DeidentifyConfig]
459
466
  # Configuration for the re-identification of the content item.
@@ -464,7 +471,8 @@ module Google
464
471
  # reverse. This requires that only reversible transformations
465
472
  # be provided here. The reversible transformations are:
466
473
  #
467
- # * `CryptoReplaceFfxFpeConfig`
474
+ # * `CryptoDeterministicConfig`
475
+ # * `CryptoReplaceFfxFpeConfig`
468
476
  # @!attribute [rw] inspect_config
469
477
  # @return [Google::Privacy::Dlp::V2::InspectConfig]
470
478
  # Configuration for the inspector.
@@ -486,6 +494,10 @@ module Google
486
494
  # that are set in this request will replace their corresponding fields in the
487
495
  # template. Repeated fields are appended. Singular sub-messages and groups
488
496
  # are recursively merged.
497
+ # @!attribute [rw] location_id
498
+ # @return [String]
499
+ # The geographic location to process content reidentification. Reserved for
500
+ # future extensions.
489
501
  class ReidentifyContentRequest; end
490
502
 
491
503
  # Results of re-identifying a item.
@@ -515,6 +527,10 @@ module Google
515
527
  # that are set in this request will replace their corresponding fields in the
516
528
  # template. Repeated fields are appended. Singular sub-messages and groups
517
529
  # are recursively merged.
530
+ # @!attribute [rw] location_id
531
+ # @return [String]
532
+ # The geographic location to process content inspection. Reserved for future
533
+ # extensions.
518
534
  class InspectContentRequest; end
519
535
 
520
536
  # Results of inspecting an item.
@@ -639,6 +655,10 @@ module Google
639
655
  # @return [String]
640
656
  # Optional filter to only return infoTypes supported by certain parts of the
641
657
  # API. Defaults to supported_by=INSPECT.
658
+ # @!attribute [rw] location_id
659
+ # @return [String]
660
+ # The geographic location to list info types. Reserved for future
661
+ # extensions.
642
662
  class ListInfoTypesRequest; end
643
663
 
644
664
  # Response to the ListInfoTypes request.
@@ -1227,7 +1247,7 @@ module Google
1227
1247
  # [1-7]
1228
1248
  DAY_OF_WEEK = 4
1229
1249
 
1230
- # [1-52]
1250
+ # [1-53]
1231
1251
  WEEK_OF_YEAR = 5
1232
1252
 
1233
1253
  # [0-23]
@@ -1269,6 +1289,11 @@ module Google
1269
1289
  # custom info type 'Surrogate'. This facilitates reversal of the
1270
1290
  # surrogate when it occurs in free text.
1271
1291
  #
1292
+ # Note: For record transformations where the entire cell in a table is being
1293
+ # transformed, surrogates are optional to use. Surrogates are used to denote
1294
+ # the location of the token and are necessary for re-identification in free
1295
+ # form text.
1296
+ #
1272
1297
  # In order for inspection to work properly, the name of this info type must
1273
1298
  # not occur naturally anywhere in your data; otherwise, inspection may either
1274
1299
  #
@@ -1281,7 +1306,7 @@ module Google
1281
1306
  # that are highly improbable to exist in your data.
1282
1307
  # For example, assuming your data is entered from a regular ASCII keyboard,
1283
1308
  # the symbol with the hex code point 29DD might be used like so:
1284
- # ⧝MY_TOKEN_TYPE
1309
+ # ⧝MY_TOKEN_TYPE.
1285
1310
  # @!attribute [rw] context
1286
1311
  # @return [Google::Privacy::Dlp::V2::FieldId]
1287
1312
  # Optional. A context may be used for higher security and maintaining
@@ -1353,10 +1378,10 @@ module Google
1353
1378
  # **3.
1354
1379
  # @!attribute [rw] masking_character
1355
1380
  # @return [String]
1356
- # Character to mask the sensitive values—for example, "*" for an
1357
- # alphabetic string such as name, or "0" for a numeric string such as ZIP
1358
- # code or credit card number. String must have length 1. If not supplied, we
1359
- # will default to "*" for strings, 0 for digits.
1381
+ # Character to use to mask the sensitive values—for example, `*` for an
1382
+ # alphabetic string such as a name, or `0` for a numeric string such as ZIP
1383
+ # code or credit card number. This string must have a length of 1. If not
1384
+ # supplied, this value defaults to `*` for strings, and `0` for digits.
1360
1385
  # @!attribute [rw] number_to_mask
1361
1386
  # @return [Integer]
1362
1387
  # Number of characters to mask. If not set, all matching chars will be
@@ -1364,15 +1389,16 @@ module Google
1364
1389
  # @!attribute [rw] reverse_order
1365
1390
  # @return [true, false]
1366
1391
  # Mask characters in reverse order. For example, if `masking_character` is
1367
- # '0', number_to_mask is 14, and `reverse_order` is false, then
1368
- # 1234-5678-9012-3456 -> 00000000000000-3456
1369
- # If `masking_character` is '*', `number_to_mask` is 3, and `reverse_order`
1370
- # is true, then 12345 -> 12***
1392
+ # `0`, `number_to_mask` is `14`, and `reverse_order` is `false`, then the
1393
+ # input string `1234-5678-9012-3456` is masked as `00000000000000-3456`.
1394
+ # If `masking_character` is `*`, `number_to_mask` is `3`, and `reverse_order`
1395
+ # is `true`, then the string `12345` is masked as `12***`.
1371
1396
  # @!attribute [rw] characters_to_ignore
1372
1397
  # @return [Array<Google::Privacy::Dlp::V2::CharsToIgnore>]
1373
- # When masking a string, items in this list will be skipped when replacing.
1374
- # For example, if your string is 555-555-5555 and you ask us to skip `-` and
1375
- # mask 5 chars with * we would produce ***-*55-5555.
1398
+ # When masking a string, items in this list will be skipped when replacing
1399
+ # characters. For example, if the input string is `555-555-5555` and you
1400
+ # instruct Cloud DLP to skip `-` and mask 5 characters with `*`, Cloud DLP
1401
+ # returns `***-**5-5555`.
1376
1402
  class CharacterMaskConfig; end
1377
1403
 
1378
1404
  # Buckets values based on fixed size ranges. The
@@ -1484,12 +1510,12 @@ module Google
1484
1510
  # that the FFX mode natively supports. This happens before/after
1485
1511
  # encryption/decryption.
1486
1512
  # Each character listed must appear only once.
1487
- # Number of characters must be in the range [2, 62].
1513
+ # Number of characters must be in the range [2, 95].
1488
1514
  # This must be encoded as ASCII.
1489
1515
  # The order of characters does not matter.
1490
1516
  # @!attribute [rw] radix
1491
1517
  # @return [Integer]
1492
- # The native way to select the alphabet. Must be in the range [2, 62].
1518
+ # The native way to select the alphabet. Must be in the range [2, 95].
1493
1519
  # @!attribute [rw] surrogate_info_type
1494
1520
  # @return [Google::Privacy::Dlp::V2::InfoType]
1495
1521
  # The custom infoType to annotate the surrogate with.
@@ -1601,12 +1627,13 @@ module Google
1601
1627
  # @!attribute [rw] context
1602
1628
  # @return [Google::Privacy::Dlp::V2::FieldId]
1603
1629
  # Points to the field that contains the context, for example, an entity id.
1604
- # If set, must also set method. If set, shift will be consistent for the
1630
+ # If set, must also set cryptoKey. If set, shift will be consistent for the
1605
1631
  # given context.
1606
1632
  # @!attribute [rw] crypto_key
1607
1633
  # @return [Google::Privacy::Dlp::V2::CryptoKey]
1608
1634
  # Causes the shift to be computed based on this key and the context. This
1609
- # results in the same shift for the same context and crypto_key.
1635
+ # results in the same shift for the same context and crypto_key. If
1636
+ # set, must also set context. Can only be applied to table items.
1610
1637
  class DateShiftConfig; end
1611
1638
 
1612
1639
  # A type of transformation that will scan unstructured text and
@@ -1820,16 +1847,16 @@ module Google
1820
1847
  # Short description (max 256 chars).
1821
1848
  # @!attribute [rw] create_time
1822
1849
  # @return [Google::Protobuf::Timestamp]
1823
- # The creation timestamp of a inspectTemplate, output only field.
1850
+ # The creation timestamp of an inspectTemplate, output only field.
1824
1851
  # @!attribute [rw] update_time
1825
1852
  # @return [Google::Protobuf::Timestamp]
1826
- # The last update timestamp of a inspectTemplate, output only field.
1853
+ # The last update timestamp of an inspectTemplate, output only field.
1827
1854
  # @!attribute [rw] inspect_config
1828
1855
  # @return [Google::Privacy::Dlp::V2::InspectConfig]
1829
1856
  # The core content of the template. Configuration of the scanning process.
1830
1857
  class InspectTemplate; end
1831
1858
 
1832
- # The DeidentifyTemplates contains instructions on how to deidentify content.
1859
+ # DeidentifyTemplates contains instructions on how to de-identify content.
1833
1860
  # See https://cloud.google.com/dlp/docs/concepts-templates to learn more.
1834
1861
  # @!attribute [rw] name
1835
1862
  # @return [String]
@@ -1846,10 +1873,10 @@ module Google
1846
1873
  # Short description (max 256 chars).
1847
1874
  # @!attribute [rw] create_time
1848
1875
  # @return [Google::Protobuf::Timestamp]
1849
- # The creation timestamp of a inspectTemplate, output only field.
1876
+ # The creation timestamp of an inspectTemplate, output only field.
1850
1877
  # @!attribute [rw] update_time
1851
1878
  # @return [Google::Protobuf::Timestamp]
1852
- # The last update timestamp of a inspectTemplate, output only field.
1879
+ # The last update timestamp of an inspectTemplate, output only field.
1853
1880
  # @!attribute [rw] deidentify_config
1854
1881
  # @return [Google::Privacy::Dlp::V2::DeidentifyConfig]
1855
1882
  # ///////////// // The core content of the template // ///////////////
@@ -1871,7 +1898,7 @@ module Google
1871
1898
  # @return [String]
1872
1899
  # Unique resource name for the triggeredJob, assigned by the service when the
1873
1900
  # triggeredJob is created, for example
1874
- # `projects/dlp-test-project/triggeredJobs/53234423`.
1901
+ # `projects/dlp-test-project/jobTriggers/53234423`.
1875
1902
  # @!attribute [rw] display_name
1876
1903
  # @return [String]
1877
1904
  # Display name (max 100 chars)
@@ -1946,6 +1973,9 @@ module Google
1946
1973
  # @return [Google::Privacy::Dlp::V2::Action::JobNotificationEmails]
1947
1974
  # Enable email notification to project owners and editors on job's
1948
1975
  # completion/failure.
1976
+ # @!attribute [rw] publish_to_stackdriver
1977
+ # @return [Google::Privacy::Dlp::V2::Action::PublishToStackdriver]
1978
+ # Enable Stackdriver metric dlp.googleapis.com/finding_count.
1949
1979
  class Action
1950
1980
  # If set, the detailed findings will be persisted to the specified
1951
1981
  # OutputStorageConfig. Only a single instance of this action can be
@@ -1995,12 +2025,18 @@ module Google
1995
2025
  # Enable email notification to project owners and editors on jobs's
1996
2026
  # completion/failure.
1997
2027
  class JobNotificationEmails; end
2028
+
2029
+ # Enable Stackdriver metric dlp.googleapis.com/finding_count. This
2030
+ # will publish a metric to stack driver on each infotype requested and
2031
+ # how many findings were found for it. CustomDetectors will be bucketed
2032
+ # as 'Custom' under the Stackdriver label 'info_type'.
2033
+ class PublishToStackdriver; end
1998
2034
  end
1999
2035
 
2000
2036
  # Request message for CreateInspectTemplate.
2001
2037
  # @!attribute [rw] parent
2002
2038
  # @return [String]
2003
- # The parent resource name, for example projects/my-project-id or
2039
+ # Required. The parent resource name, for example projects/my-project-id or
2004
2040
  # organizations/my-org-id.
2005
2041
  # @!attribute [rw] inspect_template
2006
2042
  # @return [Google::Privacy::Dlp::V2::InspectTemplate]
@@ -2011,12 +2047,16 @@ module Google
2011
2047
  # numbers, and hyphens; that is, it must match the regular
2012
2048
  # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2013
2049
  # characters. Can be empty to allow the system to generate one.
2050
+ # @!attribute [rw] location_id
2051
+ # @return [String]
2052
+ # The geographic location to store the inspection template. Reserved for
2053
+ # future extensions.
2014
2054
  class CreateInspectTemplateRequest; end
2015
2055
 
2016
2056
  # Request message for UpdateInspectTemplate.
2017
2057
  # @!attribute [rw] name
2018
2058
  # @return [String]
2019
- # Resource name of organization and inspectTemplate to be updated, for
2059
+ # Required. Resource name of organization and inspectTemplate to be updated, for
2020
2060
  # example `organizations/433245324/inspectTemplates/432452342` or
2021
2061
  # projects/project-id/inspectTemplates/432452342.
2022
2062
  # @!attribute [rw] inspect_template
@@ -2030,7 +2070,7 @@ module Google
2030
2070
  # Request message for GetInspectTemplate.
2031
2071
  # @!attribute [rw] name
2032
2072
  # @return [String]
2033
- # Resource name of the organization and inspectTemplate to be read, for
2073
+ # Required. Resource name of the organization and inspectTemplate to be read, for
2034
2074
  # example `organizations/433245324/inspectTemplates/432452342` or
2035
2075
  # projects/project-id/inspectTemplates/432452342.
2036
2076
  class GetInspectTemplateRequest; end
@@ -2038,7 +2078,7 @@ module Google
2038
2078
  # Request message for ListInspectTemplates.
2039
2079
  # @!attribute [rw] parent
2040
2080
  # @return [String]
2041
- # The parent resource name, for example projects/my-project-id or
2081
+ # Required. The parent resource name, for example projects/my-project-id or
2042
2082
  # organizations/my-org-id.
2043
2083
  # @!attribute [rw] page_token
2044
2084
  # @return [String]
@@ -2063,6 +2103,10 @@ module Google
2063
2103
  # * `update_time`: corresponds to time the template was last updated.
2064
2104
  # * `name`: corresponds to template's name.
2065
2105
  # * `display_name`: corresponds to template's display name.
2106
+ # @!attribute [rw] location_id
2107
+ # @return [String]
2108
+ # The geographic location where inspection templates will be retrieved from.
2109
+ # Use `-` for all locations. Reserved for future extensions.
2066
2110
  class ListInspectTemplatesRequest; end
2067
2111
 
2068
2112
  # Response message for ListInspectTemplates.
@@ -2078,7 +2122,7 @@ module Google
2078
2122
  # Request message for DeleteInspectTemplate.
2079
2123
  # @!attribute [rw] name
2080
2124
  # @return [String]
2081
- # Resource name of the organization and inspectTemplate to be deleted, for
2125
+ # Required. Resource name of the organization and inspectTemplate to be deleted, for
2082
2126
  # example `organizations/433245324/inspectTemplates/432452342` or
2083
2127
  # projects/project-id/inspectTemplates/432452342.
2084
2128
  class DeleteInspectTemplateRequest; end
@@ -2086,7 +2130,7 @@ module Google
2086
2130
  # Request message for CreateJobTrigger.
2087
2131
  # @!attribute [rw] parent
2088
2132
  # @return [String]
2089
- # The parent resource name, for example projects/my-project-id.
2133
+ # Required. The parent resource name, for example projects/my-project-id.
2090
2134
  # @!attribute [rw] job_trigger
2091
2135
  # @return [Google::Privacy::Dlp::V2::JobTrigger]
2092
2136
  # The JobTrigger to create.
@@ -2096,19 +2140,23 @@ module Google
2096
2140
  # numbers, and hyphens; that is, it must match the regular
2097
2141
  # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2098
2142
  # characters. Can be empty to allow the system to generate one.
2143
+ # @!attribute [rw] location_id
2144
+ # @return [String]
2145
+ # The geographic location to store the job trigger. Reserved for
2146
+ # future extensions.
2099
2147
  class CreateJobTriggerRequest; end
2100
2148
 
2101
2149
  # Request message for ActivateJobTrigger.
2102
2150
  # @!attribute [rw] name
2103
2151
  # @return [String]
2104
- # Resource name of the trigger to activate, for example
2152
+ # Required. Resource name of the trigger to activate, for example
2105
2153
  # `projects/dlp-test-project/jobTriggers/53234423`.
2106
2154
  class ActivateJobTriggerRequest; end
2107
2155
 
2108
2156
  # Request message for UpdateJobTrigger.
2109
2157
  # @!attribute [rw] name
2110
2158
  # @return [String]
2111
- # Resource name of the project and the triggeredJob, for example
2159
+ # Required. Resource name of the project and the triggeredJob, for example
2112
2160
  # `projects/dlp-test-project/jobTriggers/53234423`.
2113
2161
  # @!attribute [rw] job_trigger
2114
2162
  # @return [Google::Privacy::Dlp::V2::JobTrigger]
@@ -2121,7 +2169,7 @@ module Google
2121
2169
  # Request message for GetJobTrigger.
2122
2170
  # @!attribute [rw] name
2123
2171
  # @return [String]
2124
- # Resource name of the project and the triggeredJob, for example
2172
+ # Required. Resource name of the project and the triggeredJob, for example
2125
2173
  # `projects/dlp-test-project/jobTriggers/53234423`.
2126
2174
  class GetJobTriggerRequest; end
2127
2175
 
@@ -2130,7 +2178,7 @@ module Google
2130
2178
  # Storage.
2131
2179
  # @!attribute [rw] parent
2132
2180
  # @return [String]
2133
- # The parent resource name, for example projects/my-project-id.
2181
+ # Required. The parent resource name, for example projects/my-project-id.
2134
2182
  # @!attribute [rw] inspect_job
2135
2183
  # @return [Google::Privacy::Dlp::V2::InspectJobConfig]
2136
2184
  # @!attribute [rw] risk_job
@@ -2141,12 +2189,16 @@ module Google
2141
2189
  # numbers, and hyphens; that is, it must match the regular
2142
2190
  # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2143
2191
  # characters. Can be empty to allow the system to generate one.
2192
+ # @!attribute [rw] location_id
2193
+ # @return [String]
2194
+ # The geographic location to store and process the job. Reserved for
2195
+ # future extensions.
2144
2196
  class CreateDlpJobRequest; end
2145
2197
 
2146
2198
  # Request message for ListJobTriggers.
2147
2199
  # @!attribute [rw] parent
2148
2200
  # @return [String]
2149
- # The parent resource name, for example `projects/my-project-id`.
2201
+ # Required. The parent resource name, for example `projects/my-project-id`.
2150
2202
  # @!attribute [rw] page_token
2151
2203
  # @return [String]
2152
2204
  # Optional page token to continue retrieval. Comes from previous call
@@ -2198,6 +2250,10 @@ module Google
2198
2250
  # * last_run_time > \"2017-12-12T00:00:00+00:00\"
2199
2251
  #
2200
2252
  # The length of this field should be no more than 500 characters.
2253
+ # @!attribute [rw] location_id
2254
+ # @return [String]
2255
+ # The geographic location where job triggers will be retrieved from.
2256
+ # Use `-` for all locations. Reserved for future extensions.
2201
2257
  class ListJobTriggersRequest; end
2202
2258
 
2203
2259
  # Response message for ListJobTriggers.
@@ -2213,7 +2269,7 @@ module Google
2213
2269
  # Request message for DeleteJobTrigger.
2214
2270
  # @!attribute [rw] name
2215
2271
  # @return [String]
2216
- # Resource name of the project and the triggeredJob, for example
2272
+ # Required. Resource name of the project and the triggeredJob, for example
2217
2273
  # `projects/dlp-test-project/jobTriggers/53234423`.
2218
2274
  class DeleteJobTriggerRequest; end
2219
2275
 
@@ -2289,13 +2345,13 @@ module Google
2289
2345
  # The request message for {DlpJobs::GetDlpJob}.
2290
2346
  # @!attribute [rw] name
2291
2347
  # @return [String]
2292
- # The name of the DlpJob resource.
2348
+ # Required. The name of the DlpJob resource.
2293
2349
  class GetDlpJobRequest; end
2294
2350
 
2295
2351
  # The request message for listing DLP jobs.
2296
2352
  # @!attribute [rw] parent
2297
2353
  # @return [String]
2298
- # The parent resource name, for example projects/my-project-id.
2354
+ # Required. The parent resource name, for example projects/my-project-id.
2299
2355
  # @!attribute [rw] filter
2300
2356
  # @return [String]
2301
2357
  # Optional. Allows filtering.
@@ -2350,6 +2406,10 @@ module Google
2350
2406
  # * `end_time`: corresponds to time the job ended.
2351
2407
  # * `name`: corresponds to job's name.
2352
2408
  # * `state`: corresponds to `state`
2409
+ # @!attribute [rw] location_id
2410
+ # @return [String]
2411
+ # The geographic location where jobs will be retrieved from.
2412
+ # Use `-` for all locations. Reserved for future extensions.
2353
2413
  class ListDlpJobsRequest; end
2354
2414
 
2355
2415
  # The response message for listing DLP jobs.
@@ -2364,19 +2424,19 @@ module Google
2364
2424
  # The request message for canceling a DLP job.
2365
2425
  # @!attribute [rw] name
2366
2426
  # @return [String]
2367
- # The name of the DlpJob resource to be cancelled.
2427
+ # Required. The name of the DlpJob resource to be cancelled.
2368
2428
  class CancelDlpJobRequest; end
2369
2429
 
2370
2430
  # The request message for deleting a DLP job.
2371
2431
  # @!attribute [rw] name
2372
2432
  # @return [String]
2373
- # The name of the DlpJob resource to be deleted.
2433
+ # Required. The name of the DlpJob resource to be deleted.
2374
2434
  class DeleteDlpJobRequest; end
2375
2435
 
2376
2436
  # Request message for CreateDeidentifyTemplate.
2377
2437
  # @!attribute [rw] parent
2378
2438
  # @return [String]
2379
- # The parent resource name, for example projects/my-project-id or
2439
+ # Required. The parent resource name, for example projects/my-project-id or
2380
2440
  # organizations/my-org-id.
2381
2441
  # @!attribute [rw] deidentify_template
2382
2442
  # @return [Google::Privacy::Dlp::V2::DeidentifyTemplate]
@@ -2387,12 +2447,16 @@ module Google
2387
2447
  # numbers, and hyphens; that is, it must match the regular
2388
2448
  # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2389
2449
  # characters. Can be empty to allow the system to generate one.
2450
+ # @!attribute [rw] location_id
2451
+ # @return [String]
2452
+ # The geographic location to store the deidentification template. Reserved
2453
+ # for future extensions.
2390
2454
  class CreateDeidentifyTemplateRequest; end
2391
2455
 
2392
2456
  # Request message for UpdateDeidentifyTemplate.
2393
2457
  # @!attribute [rw] name
2394
2458
  # @return [String]
2395
- # Resource name of organization and deidentify template to be updated, for
2459
+ # Required. Resource name of organization and deidentify template to be updated, for
2396
2460
  # example `organizations/433245324/deidentifyTemplates/432452342` or
2397
2461
  # projects/project-id/deidentifyTemplates/432452342.
2398
2462
  # @!attribute [rw] deidentify_template
@@ -2406,7 +2470,7 @@ module Google
2406
2470
  # Request message for GetDeidentifyTemplate.
2407
2471
  # @!attribute [rw] name
2408
2472
  # @return [String]
2409
- # Resource name of the organization and deidentify template to be read, for
2473
+ # Required. Resource name of the organization and deidentify template to be read, for
2410
2474
  # example `organizations/433245324/deidentifyTemplates/432452342` or
2411
2475
  # projects/project-id/deidentifyTemplates/432452342.
2412
2476
  class GetDeidentifyTemplateRequest; end
@@ -2414,7 +2478,7 @@ module Google
2414
2478
  # Request message for ListDeidentifyTemplates.
2415
2479
  # @!attribute [rw] parent
2416
2480
  # @return [String]
2417
- # The parent resource name, for example projects/my-project-id or
2481
+ # Required. The parent resource name, for example projects/my-project-id or
2418
2482
  # organizations/my-org-id.
2419
2483
  # @!attribute [rw] page_token
2420
2484
  # @return [String]
@@ -2439,6 +2503,10 @@ module Google
2439
2503
  # * `update_time`: corresponds to time the template was last updated.
2440
2504
  # * `name`: corresponds to template's name.
2441
2505
  # * `display_name`: corresponds to template's display name.
2506
+ # @!attribute [rw] location_id
2507
+ # @return [String]
2508
+ # The geographic location where deidentifications templates will be retrieved
2509
+ # from. Use `-` for all locations. Reserved for future extensions.
2442
2510
  class ListDeidentifyTemplatesRequest; end
2443
2511
 
2444
2512
  # Response message for ListDeidentifyTemplates.
@@ -2455,7 +2523,7 @@ module Google
2455
2523
  # Request message for DeleteDeidentifyTemplate.
2456
2524
  # @!attribute [rw] name
2457
2525
  # @return [String]
2458
- # Resource name of the organization and deidentify template to be deleted,
2526
+ # Required. Resource name of the organization and deidentify template to be deleted,
2459
2527
  # for example `organizations/433245324/deidentifyTemplates/432452342` or
2460
2528
  # projects/project-id/deidentifyTemplates/432452342.
2461
2529
  class DeleteDeidentifyTemplateRequest; end
@@ -2486,7 +2554,9 @@ module Google
2486
2554
  # Approximate number of distinct phrases in the dictionary.
2487
2555
  class LargeCustomDictionaryStats; end
2488
2556
 
2489
- # Configuration for a StoredInfoType.
2557
+ # Configuration for stored infoTypes. All fields and subfield are provided
2558
+ # by the user. For more information, see
2559
+ # https://cloud.google.com/dlp/docs/creating-custom-infotypes.
2490
2560
  # @!attribute [rw] display_name
2491
2561
  # @return [String]
2492
2562
  # Display name of the StoredInfoType (max 256 characters).
@@ -2552,7 +2622,7 @@ module Google
2552
2622
  # Request message for CreateStoredInfoType.
2553
2623
  # @!attribute [rw] parent
2554
2624
  # @return [String]
2555
- # The parent resource name, for example projects/my-project-id or
2625
+ # Required. The parent resource name, for example projects/my-project-id or
2556
2626
  # organizations/my-org-id.
2557
2627
  # @!attribute [rw] config
2558
2628
  # @return [Google::Privacy::Dlp::V2::StoredInfoTypeConfig]
@@ -2563,12 +2633,16 @@ module Google
2563
2633
  # numbers, and hyphens; that is, it must match the regular
2564
2634
  # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2565
2635
  # characters. Can be empty to allow the system to generate one.
2636
+ # @!attribute [rw] location_id
2637
+ # @return [String]
2638
+ # The geographic location to store the stored infoType. Reserved for
2639
+ # future extensions.
2566
2640
  class CreateStoredInfoTypeRequest; end
2567
2641
 
2568
2642
  # Request message for UpdateStoredInfoType.
2569
2643
  # @!attribute [rw] name
2570
2644
  # @return [String]
2571
- # Resource name of organization and storedInfoType to be updated, for
2645
+ # Required. Resource name of organization and storedInfoType to be updated, for
2572
2646
  # example `organizations/433245324/storedInfoTypes/432452342` or
2573
2647
  # projects/project-id/storedInfoTypes/432452342.
2574
2648
  # @!attribute [rw] config
@@ -2584,7 +2658,7 @@ module Google
2584
2658
  # Request message for GetStoredInfoType.
2585
2659
  # @!attribute [rw] name
2586
2660
  # @return [String]
2587
- # Resource name of the organization and storedInfoType to be read, for
2661
+ # Required. Resource name of the organization and storedInfoType to be read, for
2588
2662
  # example `organizations/433245324/storedInfoTypes/432452342` or
2589
2663
  # projects/project-id/storedInfoTypes/432452342.
2590
2664
  class GetStoredInfoTypeRequest; end
@@ -2592,7 +2666,7 @@ module Google
2592
2666
  # Request message for ListStoredInfoTypes.
2593
2667
  # @!attribute [rw] parent
2594
2668
  # @return [String]
2595
- # The parent resource name, for example projects/my-project-id or
2669
+ # Required. The parent resource name, for example projects/my-project-id or
2596
2670
  # organizations/my-org-id.
2597
2671
  # @!attribute [rw] page_token
2598
2672
  # @return [String]
@@ -2618,6 +2692,10 @@ module Google
2618
2692
  # * `state`: corresponds to the state of the resource.
2619
2693
  # * `name`: corresponds to resource name.
2620
2694
  # * `display_name`: corresponds to info type's display name.
2695
+ # @!attribute [rw] location_id
2696
+ # @return [String]
2697
+ # The geographic location where stored infoTypes will be retrieved from.
2698
+ # Use `-` for all locations. Reserved for future extensions.
2621
2699
  class ListStoredInfoTypesRequest; end
2622
2700
 
2623
2701
  # Response message for ListStoredInfoTypes.
@@ -2633,7 +2711,7 @@ module Google
2633
2711
  # Request message for DeleteStoredInfoType.
2634
2712
  # @!attribute [rw] name
2635
2713
  # @return [String]
2636
- # Resource name of the organization and storedInfoType to be deleted, for
2714
+ # Required. Resource name of the organization and storedInfoType to be deleted, for
2637
2715
  # example `organizations/433245324/storedInfoTypes/432452342` or
2638
2716
  # projects/project-id/storedInfoTypes/432452342.
2639
2717
  class DeleteStoredInfoTypeRequest; end