google-cloud-dlp-v2 1.18.0 → 1.19.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.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/README.md +2 -6
  4. data/lib/google/cloud/dlp/v2/dlp_service/client.rb +546 -52
  5. data/lib/google/cloud/dlp/v2/dlp_service/credentials.rb +1 -1
  6. data/lib/google/cloud/dlp/v2/dlp_service/paths.rb +20 -1
  7. data/lib/google/cloud/dlp/v2/dlp_service/rest/client.rb +511 -52
  8. data/lib/google/cloud/dlp/v2/dlp_service/rest/service_stub.rb +308 -1
  9. data/lib/google/cloud/dlp/v2/dlp_service/rest.rb +2 -2
  10. data/lib/google/cloud/dlp/v2/dlp_service.rb +2 -2
  11. data/lib/google/cloud/dlp/v2/rest.rb +1 -1
  12. data/lib/google/cloud/dlp/v2/version.rb +1 -1
  13. data/lib/google/cloud/dlp/v2.rb +1 -1
  14. data/lib/google/privacy/dlp/v2/dlp_pb.rb +20 -1
  15. data/lib/google/privacy/dlp/v2/dlp_services_pb.rb +48 -38
  16. data/lib/google/privacy/dlp/v2/storage_pb.rb +5 -1
  17. data/lib/google-cloud-dlp-v2.rb +1 -1
  18. data/proto_docs/README.md +1 -1
  19. data/proto_docs/google/api/client.rb +1 -1
  20. data/proto_docs/google/api/field_behavior.rb +1 -1
  21. data/proto_docs/google/api/launch_stage.rb +1 -1
  22. data/proto_docs/google/api/resource.rb +1 -1
  23. data/proto_docs/google/privacy/dlp/v2/dlp.rb +453 -141
  24. data/proto_docs/google/privacy/dlp/v2/storage.rb +76 -20
  25. data/proto_docs/google/protobuf/any.rb +1 -1
  26. data/proto_docs/google/protobuf/duration.rb +1 -1
  27. data/proto_docs/google/protobuf/empty.rb +1 -1
  28. data/proto_docs/google/protobuf/field_mask.rb +1 -1
  29. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  30. data/proto_docs/google/rpc/status.rb +1 -1
  31. data/proto_docs/google/type/date.rb +1 -1
  32. data/proto_docs/google/type/dayofweek.rb +1 -1
  33. data/proto_docs/google/type/timeofday.rb +1 -1
  34. metadata +6 -5
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2020 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -62,7 +62,7 @@ module Google
62
62
  # @!attribute [rw] info_types
63
63
  # @return [::Array<::Google::Cloud::Dlp::V2::InfoType>]
64
64
  # A list of image-supported infoTypes—excluding [document
65
- # infoTypes](https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference#documents)—to
65
+ # infoTypes](https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference#documents)—to
66
66
  # be used as context for the exclusion rule. A finding is excluded if
67
67
  # its bounding box has the specified spatial relationship (defined by
68
68
  # `image_containment_type`) with a finding of an infoType in this list.
@@ -158,7 +158,7 @@ module Google
158
158
  # @!attribute [rw] info_types
159
159
  # @return [::Array<::Google::Cloud::Dlp::V2::InfoType>]
160
160
  # A list of image-supported infoTypes—excluding [document
161
- # infoTypes](https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference#documents)—to
161
+ # infoTypes](https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference#documents)—to
162
162
  # be used as context for the adjustment rule. Sensitive Data Protection
163
163
  # adjusts the likelihood of an image finding if its bounding box has the
164
164
  # specified spatial relationship (defined by `image_containment_type`) with a
@@ -250,7 +250,7 @@ module Google
250
250
  # @return [::Array<::Google::Cloud::Dlp::V2::InfoType>]
251
251
  # Restricts what info_types to look for. The values must correspond to
252
252
  # InfoType values returned by ListInfoTypes or listed at
253
- # https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference.
253
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference.
254
254
  #
255
255
  # When no InfoTypes or CustomInfoTypes are specified in a request, the
256
256
  # system may automatically choose a default list of detectors to run, which
@@ -267,7 +267,7 @@ module Google
267
267
  # In general, the highest likelihood setting yields the fewest findings in
268
268
  # results and the lowest chance of a false positive. For more information,
269
269
  # see [Match
270
- # likelihood](https://cloud.google.com/sensitive-data-protection/docs/likelihood).
270
+ # likelihood](https://docs.cloud.google.com/sensitive-data-protection/docs/likelihood).
271
271
  # @!attribute [rw] min_likelihood_per_info_type
272
272
  # @return [::Array<::Google::Cloud::Dlp::V2::InspectConfig::InfoTypeLikelihood>]
273
273
  # Minimum likelihood per infotype. For each infotype, a user can specify a
@@ -304,7 +304,7 @@ module Google
304
304
  # @!attribute [rw] custom_info_types
305
305
  # @return [::Array<::Google::Cloud::Dlp::V2::CustomInfoType>]
306
306
  # CustomInfoTypes provided by the user. See
307
- # https://cloud.google.com/sensitive-data-protection/docs/creating-custom-infotypes
307
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/creating-custom-infotypes
308
308
  # to learn more.
309
309
  # @!attribute [rw] content_options
310
310
  # @return [::Array<::Google::Cloud::Dlp::V2::ContentOption>]
@@ -409,7 +409,7 @@ module Google
409
409
 
410
410
  # The type of data being sent for inspection. To learn more, see
411
411
  # [Supported file
412
- # types](https://cloud.google.com/sensitive-data-protection/docs/supported-file-types).
412
+ # types](https://docs.cloud.google.com/sensitive-data-protection/docs/supported-file-types).
413
413
  #
414
414
  # Only the first frame of each multiframe image is inspected. Metadata and
415
415
  # other frames aren't inspected.
@@ -479,7 +479,7 @@ module Google
479
479
  # @!attribute [rw] table
480
480
  # @return [::Google::Cloud::Dlp::V2::Table]
481
481
  # Structured content for inspection. See
482
- # https://cloud.google.com/sensitive-data-protection/docs/inspecting-text#inspecting_a_table
482
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/inspecting-text#inspecting_a_table
483
483
  # to learn more.
484
484
  #
485
485
  # Note: The following fields are mutually exclusive: `table`, `value`, `byte_item`, `conversation`, `batch_content_item`. If a field in that set is populated, all other fields in the set will automatically be cleared.
@@ -512,6 +512,9 @@ module Google
512
512
  # @!attribute [rw] properties
513
513
  # @return [::Array<::Google::Cloud::Dlp::V2::KeyValueMetadataProperty>]
514
514
  # User provided key-value pairs of content metadata.
515
+ # @!attribute [rw] file_labels
516
+ # @return [::Array<::Google::Cloud::Dlp::V2::FileLabel>]
517
+ # Optional. The file labels associated with the content.
515
518
  class ContentMetadata
516
519
  include ::Google::Protobuf::MessageExts
517
520
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -584,7 +587,7 @@ module Google
584
587
  end
585
588
 
586
589
  # Structured content to inspect. Up to 50,000 `Value`s per request allowed. See
587
- # https://cloud.google.com/sensitive-data-protection/docs/inspecting-structured-text#inspecting_a_table
590
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/inspecting-structured-text#inspecting_a_table
588
591
  # to learn more.
589
592
  # @!attribute [rw] headers
590
593
  # @return [::Array<::Google::Cloud::Dlp::V2::FieldId>]
@@ -618,6 +621,57 @@ module Google
618
621
  extend ::Google::Protobuf::MessageExts::ClassMethods
619
622
  end
620
623
 
624
+ # Represents a file label.
625
+ # @!attribute [rw] sensitivity_label
626
+ # @return [::Google::Cloud::Dlp::V2::FileLabel::SensitivityLabelMetadata]
627
+ # Sensitivity labels published by Microsoft.
628
+ #
629
+ # Note: The following fields are mutually exclusive: `sensitivity_label`, `google_drive_label`. If a field in that set is populated, all other fields in the set will automatically be cleared.
630
+ # @!attribute [rw] google_drive_label
631
+ # @return [::Google::Cloud::Dlp::V2::FileLabel::GoogleDriveLabelMetadata]
632
+ # Google Drive labels published by Google.
633
+ #
634
+ # Note: The following fields are mutually exclusive: `google_drive_label`, `sensitivity_label`. If a field in that set is populated, all other fields in the set will automatically be cleared.
635
+ class FileLabel
636
+ include ::Google::Protobuf::MessageExts
637
+ extend ::Google::Protobuf::MessageExts::ClassMethods
638
+
639
+ # Sensitivity labels published by Microsoft.
640
+ # @!attribute [rw] guid
641
+ # @return [::String]
642
+ # Required. The GUID of the sensitivity label.
643
+ class SensitivityLabelMetadata
644
+ include ::Google::Protobuf::MessageExts
645
+ extend ::Google::Protobuf::MessageExts::ClassMethods
646
+ end
647
+
648
+ # Google Drive labels published by Google.
649
+ # @!attribute [rw] label_id
650
+ # @return [::String]
651
+ # The [label
652
+ # ID](https://developers.google.com/workspace/drive/labels/guides/overview)
653
+ # of the Google Drive label.
654
+ # @!attribute [rw] label_fields
655
+ # @return [::Array<::Google::Cloud::Dlp::V2::FileLabel::GoogleDriveLabelMetadata::LabelFieldMetadata>]
656
+ # The field values of the Google Drive label
657
+ class GoogleDriveLabelMetadata
658
+ include ::Google::Protobuf::MessageExts
659
+ extend ::Google::Protobuf::MessageExts::ClassMethods
660
+
661
+ # The field values of the Google Drive label
662
+ # @!attribute [rw] id
663
+ # @return [::String]
664
+ # The identifier of the Label Field.
665
+ # @!attribute [rw] value
666
+ # @return [::Google::Cloud::Dlp::V2::Value]
667
+ # The value of the Label Field.
668
+ class LabelFieldMetadata
669
+ include ::Google::Protobuf::MessageExts
670
+ extend ::Google::Protobuf::MessageExts::ClassMethods
671
+ end
672
+ end
673
+ end
674
+
621
675
  # All the findings for a single scanned item.
622
676
  # @!attribute [rw] findings
623
677
  # @return [::Array<::Google::Cloud::Dlp::V2::Finding>]
@@ -979,7 +1033,8 @@ module Google
979
1033
  extend ::Google::Protobuf::MessageExts::ClassMethods
980
1034
  end
981
1035
 
982
- # Bounding box encompassing detected text within an image.
1036
+ # Bounding box encompassing detected text within an image. Coordinates are in
1037
+ # pixels and strictly within the image or frame bounds.
983
1038
  # @!attribute [rw] top
984
1039
  # @return [::Integer]
985
1040
  # Top coordinate of the bounding box. (0,0) is upper left.
@@ -1005,7 +1060,7 @@ module Google
1005
1060
  #
1006
1061
  # The format of this value varies depending on whether you have [specified a
1007
1062
  # processing
1008
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1063
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
1009
1064
  #
1010
1065
  # + Projects scope, location specified:
1011
1066
  # `projects/{project_id}/locations/{location_id}`
@@ -1120,7 +1175,7 @@ module Google
1120
1175
  #
1121
1176
  # The format of this value varies depending on whether you have [specified a
1122
1177
  # processing
1123
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1178
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
1124
1179
  #
1125
1180
  # + Projects scope, location specified:
1126
1181
  # `projects/{project_id}/locations/{location_id}`
@@ -1193,7 +1248,7 @@ module Google
1193
1248
  #
1194
1249
  # The format of this value varies depending on whether you have [specified a
1195
1250
  # processing
1196
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1251
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
1197
1252
  #
1198
1253
  # + Projects scope, location specified:
1199
1254
  # `projects/{project_id}/locations/{location_id}`
@@ -1266,7 +1321,7 @@ module Google
1266
1321
  #
1267
1322
  # The format of this value varies depending on whether you have [specified a
1268
1323
  # processing
1269
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
1324
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
1270
1325
  #
1271
1326
  # + Projects scope, location specified:
1272
1327
  # `projects/{project_id}/locations/{location_id}`
@@ -1399,18 +1454,18 @@ module Google
1399
1454
  # @!attribute [rw] requested_options
1400
1455
  # @return [::Google::Cloud::Dlp::V2::InspectDataSourceDetails::RequestedOptions]
1401
1456
  # The configuration used for this job.
1402
- # @!attribute [rw] result
1457
+ # @!attribute [r] result
1403
1458
  # @return [::Google::Cloud::Dlp::V2::InspectDataSourceDetails::Result]
1404
- # A summary of the outcome of this inspection job.
1459
+ # Output only. A summary of the outcome of this inspection job.
1405
1460
  class InspectDataSourceDetails
1406
1461
  include ::Google::Protobuf::MessageExts
1407
1462
  extend ::Google::Protobuf::MessageExts::ClassMethods
1408
1463
 
1409
1464
  # Snapshot of the inspection configuration.
1410
- # @!attribute [rw] snapshot_inspect_template
1465
+ # @!attribute [r] snapshot_inspect_template
1411
1466
  # @return [::Google::Cloud::Dlp::V2::InspectTemplate]
1412
- # If run with an InspectTemplate, a snapshot of its state at the time of
1413
- # this run.
1467
+ # Output only. If run with an InspectTemplate, a snapshot of its state at
1468
+ # the time of this run.
1414
1469
  # @!attribute [rw] job_config
1415
1470
  # @return [::Google::Cloud::Dlp::V2::InspectJobConfig]
1416
1471
  # Inspect config.
@@ -1911,7 +1966,7 @@ module Google
1911
1966
  end
1912
1967
 
1913
1968
  # Configuration for a risk analysis job. See
1914
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-risk-analysis
1969
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-risk-analysis
1915
1970
  # to learn more.
1916
1971
  # @!attribute [rw] privacy_metric
1917
1972
  # @return [::Google::Cloud::Dlp::V2::PrivacyMetric]
@@ -2216,34 +2271,34 @@ module Google
2216
2271
  # @!attribute [rw] requested_source_table
2217
2272
  # @return [::Google::Cloud::Dlp::V2::BigQueryTable]
2218
2273
  # Input dataset to compute metrics over.
2219
- # @!attribute [rw] numerical_stats_result
2274
+ # @!attribute [r] numerical_stats_result
2220
2275
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::NumericalStatsResult]
2221
- # Numerical stats result
2276
+ # Output only. Numerical stats result
2222
2277
  #
2223
2278
  # Note: The following fields are mutually exclusive: `numerical_stats_result`, `categorical_stats_result`, `k_anonymity_result`, `l_diversity_result`, `k_map_estimation_result`, `delta_presence_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2224
- # @!attribute [rw] categorical_stats_result
2279
+ # @!attribute [r] categorical_stats_result
2225
2280
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::CategoricalStatsResult]
2226
- # Categorical stats result
2281
+ # Output only. Categorical stats result
2227
2282
  #
2228
2283
  # Note: The following fields are mutually exclusive: `categorical_stats_result`, `numerical_stats_result`, `k_anonymity_result`, `l_diversity_result`, `k_map_estimation_result`, `delta_presence_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2229
- # @!attribute [rw] k_anonymity_result
2284
+ # @!attribute [r] k_anonymity_result
2230
2285
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::KAnonymityResult]
2231
- # K-anonymity result
2286
+ # Output only. K-anonymity result
2232
2287
  #
2233
2288
  # Note: The following fields are mutually exclusive: `k_anonymity_result`, `numerical_stats_result`, `categorical_stats_result`, `l_diversity_result`, `k_map_estimation_result`, `delta_presence_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2234
- # @!attribute [rw] l_diversity_result
2289
+ # @!attribute [r] l_diversity_result
2235
2290
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::LDiversityResult]
2236
- # L-divesity result
2291
+ # Output only. L-divesity result
2237
2292
  #
2238
2293
  # Note: The following fields are mutually exclusive: `l_diversity_result`, `numerical_stats_result`, `categorical_stats_result`, `k_anonymity_result`, `k_map_estimation_result`, `delta_presence_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2239
- # @!attribute [rw] k_map_estimation_result
2294
+ # @!attribute [r] k_map_estimation_result
2240
2295
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::KMapEstimationResult]
2241
- # K-map result
2296
+ # Output only. K-map result
2242
2297
  #
2243
2298
  # Note: The following fields are mutually exclusive: `k_map_estimation_result`, `numerical_stats_result`, `categorical_stats_result`, `k_anonymity_result`, `l_diversity_result`, `delta_presence_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2244
- # @!attribute [rw] delta_presence_estimation_result
2299
+ # @!attribute [r] delta_presence_estimation_result
2245
2300
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails::DeltaPresenceEstimationResult]
2246
- # Delta-presence result
2301
+ # Output only. Delta-presence result
2247
2302
  #
2248
2303
  # Note: The following fields are mutually exclusive: `delta_presence_estimation_result`, `numerical_stats_result`, `categorical_stats_result`, `k_anonymity_result`, `l_diversity_result`, `k_map_estimation_result`. If a field in that set is populated, all other fields in the set will automatically be cleared.
2249
2304
  # @!attribute [rw] requested_options
@@ -2866,7 +2921,8 @@ module Google
2866
2921
  # Outputs a base64 encoded representation of the hashed output
2867
2922
  # (for example, L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=).
2868
2923
  # Currently, only string and integer values can be hashed.
2869
- # See https://cloud.google.com/sensitive-data-protection/docs/pseudonymization
2924
+ # See
2925
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/pseudonymization
2870
2926
  # to learn more.
2871
2927
  # @!attribute [rw] crypto_key
2872
2928
  # @return [::Google::Cloud::Dlp::V2::CryptoKey]
@@ -2956,8 +3012,8 @@ module Google
2956
3012
  # @!attribute [rw] word_list
2957
3013
  # @return [::Google::Cloud::Dlp::V2::CustomInfoType::Dictionary::WordList]
2958
3014
  # A list of words to select from for random replacement. The
2959
- # [limits](https://cloud.google.com/sensitive-data-protection/limits) page
2960
- # contains details about the size limits of dictionaries.
3015
+ # [limits](https://docs.cloud.google.com/sensitive-data-protection/limits)
3016
+ # page contains details about the size limits of dictionaries.
2961
3017
  class ReplaceDictionaryConfig
2962
3018
  include ::Google::Protobuf::MessageExts
2963
3019
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3081,8 +3137,8 @@ module Google
3081
3137
  # be transformed to match the type of the bound before comparing.
3082
3138
  #
3083
3139
  # See
3084
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-bucketing to
3085
- # learn more.
3140
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-bucketing
3141
+ # to learn more.
3086
3142
  # @!attribute [rw] lower_bound
3087
3143
  # @return [::Google::Cloud::Dlp::V2::Value]
3088
3144
  # Required. Lower bound value of buckets. All values less than `lower_bound`
@@ -3114,8 +3170,8 @@ module Google
3114
3170
  # will first attempt converting the type of the data to be transformed to match
3115
3171
  # the type of the bound before comparing.
3116
3172
  # See
3117
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-bucketing to
3118
- # learn more.
3173
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-bucketing
3174
+ # to learn more.
3119
3175
  # @!attribute [rw] buckets
3120
3176
  # @return [::Array<::Google::Cloud::Dlp::V2::BucketingConfig::Bucket>]
3121
3177
  # Set of buckets. Ranges must be non-overlapping.
@@ -3148,8 +3204,8 @@ module Google
3148
3204
  # will be replaced with the same surrogate. Identifiers must be at least two
3149
3205
  # characters long. In the case that the identifier is the empty string, it will
3150
3206
  # be skipped. See
3151
- # https://cloud.google.com/sensitive-data-protection/docs/pseudonymization to
3152
- # learn more.
3207
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/pseudonymization
3208
+ # to learn more.
3153
3209
  #
3154
3210
  # Note: We recommend using CryptoDeterministicConfig for all use cases which
3155
3211
  # do not require preserving the input alphabet space and size, plus warrant
@@ -3216,7 +3272,7 @@ module Google
3216
3272
  #
3217
3273
  # This annotation identifies the surrogate when inspecting content using the
3218
3274
  # custom infoType
3219
- # [`SurrogateType`](https://cloud.google.com/sensitive-data-protection/docs/reference/rest/v2/InspectConfig#surrogatetype).
3275
+ # [`SurrogateType`](https://docs.cloud.google.com/sensitive-data-protection/docs/reference/rest/v2/InspectConfig#surrogatetype).
3220
3276
  # This facilitates reversal of the surrogate when it occurs in free text.
3221
3277
  #
3222
3278
  # In order for inspection to work properly, the name of this infoType must
@@ -3312,7 +3368,7 @@ module Google
3312
3368
  # dlp.kms.encrypt
3313
3369
  #
3314
3370
  # For more information, see [Creating a wrapped key]
3315
- # (https://cloud.google.com/sensitive-data-protection/docs/create-wrapped-key).
3371
+ # (https://docs.cloud.google.com/sensitive-data-protection/docs/create-wrapped-key).
3316
3372
  #
3317
3373
  # Note: When you use Cloud KMS for cryptographic operations,
3318
3374
  # [charges apply](https://cloud.google.com/kms/pricing).
@@ -3329,7 +3385,7 @@ module Google
3329
3385
 
3330
3386
  # Shifts dates by random number of days, with option to be consistent for the
3331
3387
  # same context. See
3332
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-date-shifting
3388
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-date-shifting
3333
3389
  # to learn more.
3334
3390
  # @!attribute [rw] upper_bound_days
3335
3391
  # @return [::Integer]
@@ -3749,8 +3805,8 @@ module Google
3749
3805
  # The inspectTemplate contains a configuration (set of types of sensitive data
3750
3806
  # to be detected) to be used anywhere you otherwise would normally specify
3751
3807
  # InspectConfig. See
3752
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-templates to
3753
- # learn more.
3808
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-templates
3809
+ # to learn more.
3754
3810
  # @!attribute [r] name
3755
3811
  # @return [::String]
3756
3812
  # Output only. The template name.
@@ -3773,6 +3829,12 @@ module Google
3773
3829
  # @!attribute [rw] inspect_config
3774
3830
  # @return [::Google::Cloud::Dlp::V2::InspectConfig]
3775
3831
  # The core content of the template. Configuration of the scanning process.
3832
+ # @!attribute [rw] allow_limited_availability_info_types
3833
+ # @return [::Boolean]
3834
+ # Optional. Enables the use of [limited-availability built-in
3835
+ # infoTypes](https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference#limited-availability-infotypes)
3836
+ # in inspect_config. These infoTypes are supported only in specific regions
3837
+ # and can cause scanning errors if used elsewhere.
3776
3838
  class InspectTemplate
3777
3839
  include ::Google::Protobuf::MessageExts
3778
3840
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3780,8 +3842,8 @@ module Google
3780
3842
 
3781
3843
  # DeidentifyTemplates contains instructions on how to de-identify content.
3782
3844
  # See
3783
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-templates to
3784
- # learn more.
3845
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-templates
3846
+ # to learn more.
3785
3847
  # @!attribute [r] name
3786
3848
  # @return [::String]
3787
3849
  # Output only. The template name.
@@ -3840,12 +3902,12 @@ module Google
3840
3902
 
3841
3903
  # Contains a configuration to make API calls on a repeating basis.
3842
3904
  # See
3843
- # https://cloud.google.com/sensitive-data-protection/docs/concepts-job-triggers
3905
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-job-triggers
3844
3906
  # to learn more.
3845
- # @!attribute [rw] name
3907
+ # @!attribute [r] name
3846
3908
  # @return [::String]
3847
- # Unique resource name for the triggeredJob, assigned by the service when the
3848
- # triggeredJob is created, for example
3909
+ # Output only. Unique resource name for the triggeredJob, assigned by the
3910
+ # service when the triggeredJob is created, for example
3849
3911
  # `projects/dlp-test-project/jobTriggers/53234423`.
3850
3912
  # @!attribute [rw] display_name
3851
3913
  # @return [::String]
@@ -3919,7 +3981,8 @@ module Google
3919
3981
  end
3920
3982
 
3921
3983
  # A task to execute on the completion of a job.
3922
- # See https://cloud.google.com/sensitive-data-protection/docs/concepts-actions
3984
+ # See
3985
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/concepts-actions
3923
3986
  # to learn more.
3924
3987
  # @!attribute [rw] save_findings
3925
3988
  # @return [::Google::Cloud::Dlp::V2::Action::SaveFindings]
@@ -3958,7 +4021,7 @@ module Google
3958
4021
  # @return [::Google::Cloud::Dlp::V2::Action::JobNotificationEmails]
3959
4022
  # Sends an email when the job completes. The email goes to IAM project
3960
4023
  # owners and technical [Essential
3961
- # Contacts](https://cloud.google.com/resource-manager/docs/managing-notification-contacts).
4024
+ # Contacts](https://docs.cloud.google.com/resource-manager/docs/managing-notification-contacts).
3962
4025
  #
3963
4026
  # Note: The following fields are mutually exclusive: `job_notification_emails`, `save_findings`, `pub_sub`, `publish_summary_to_cscc`, `publish_findings_to_cloud_data_catalog`, `publish_findings_to_dataplex_catalog`, `deidentify`, `publish_to_stackdriver`. If a field in that set is populated, all other fields in the set will automatically be cleared.
3964
4027
  # @!attribute [rw] publish_to_stackdriver
@@ -3985,7 +4048,7 @@ module Google
3985
4048
  # Publish a message into a given Pub/Sub topic when DlpJob has completed. The
3986
4049
  # message contains a single field, `DlpJobName`, which is equal to the
3987
4050
  # finished job's
3988
- # [`DlpJob.name`](https://cloud.google.com/sensitive-data-protection/docs/reference/rest/v2/projects.dlpJobs#DlpJob).
4051
+ # [`DlpJob.name`](https://docs.cloud.google.com/sensitive-data-protection/docs/reference/rest/v2/projects.dlpJobs#DlpJob).
3989
4052
  # Compatible with: Inspect, Risk
3990
4053
  # @!attribute [rw] topic
3991
4054
  # @return [::String]
@@ -4037,7 +4100,7 @@ module Google
4037
4100
  # Publish findings of a DlpJob to Dataplex Universal Catalog as a
4038
4101
  # `sensitive-data-protection-job-result` aspect. For more information,
4039
4102
  # see [Send inspection results to Dataplex Universal Catalog as
4040
- # aspects](https://cloud.google.com/sensitive-data-protection/docs/add-aspects-inspection-job).
4103
+ # aspects](https://docs.cloud.google.com/sensitive-data-protection/docs/add-aspects-inspection-job).
4041
4104
  #
4042
4105
  # Aspects are stored in Dataplex Universal Catalog storage and are
4043
4106
  # governed by service-specific policies for Dataplex Universal Catalog. For
@@ -4150,7 +4213,7 @@ module Google
4150
4213
 
4151
4214
  # Sends an email when the job completes. The email goes to IAM project owners
4152
4215
  # and technical [Essential
4153
- # Contacts](https://cloud.google.com/resource-manager/docs/managing-notification-contacts).
4216
+ # Contacts](https://docs.cloud.google.com/resource-manager/docs/managing-notification-contacts).
4154
4217
  class JobNotificationEmails
4155
4218
  include ::Google::Protobuf::MessageExts
4156
4219
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -4204,7 +4267,7 @@ module Google
4204
4267
  #
4205
4268
  # The format of this value varies depending on the scope of the request
4206
4269
  # (project or organization) and whether you have [specified a processing
4207
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4270
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
4208
4271
  #
4209
4272
  # + Projects scope, location specified:
4210
4273
  # `projects/{project_id}/locations/{location_id}`
@@ -4272,7 +4335,7 @@ module Google
4272
4335
  #
4273
4336
  # The format of this value varies depending on the scope of the request
4274
4337
  # (project or organization) and whether you have [specified a processing
4275
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4338
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
4276
4339
  #
4277
4340
  # + Projects scope, location specified:
4278
4341
  # `projects/{project_id}/locations/{location_id}`
@@ -4350,7 +4413,7 @@ module Google
4350
4413
  #
4351
4414
  # The format of this value varies depending on whether you have [specified a
4352
4415
  # processing
4353
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4416
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
4354
4417
  #
4355
4418
  # + Projects scope, location specified:
4356
4419
  # `projects/{project_id}/locations/{location_id}`
@@ -4545,7 +4608,7 @@ module Google
4545
4608
  #
4546
4609
  # The format of this value varies depending on whether you have [specified a
4547
4610
  # processing
4548
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4611
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
4549
4612
  #
4550
4613
  # + Projects scope, location specified:
4551
4614
  # `projects/{project_id}/locations/{location_id}`
@@ -4589,7 +4652,7 @@ module Google
4589
4652
  #
4590
4653
  # The format of this value varies depending on whether you have [specified a
4591
4654
  # processing
4592
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
4655
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
4593
4656
  #
4594
4657
  # + Projects scope, location specified:
4595
4658
  # `projects/{project_id}/locations/{location_id}`
@@ -4724,7 +4787,7 @@ module Google
4724
4787
  # Publishes generated data profiles to Google Security Operations.
4725
4788
  # For more information, see [Use Sensitive Data Protection data in
4726
4789
  # context-aware
4727
- # analytics](https://cloud.google.com/chronicle/docs/detection/usecase-dlp-high-risk-user-download).
4790
+ # analytics](https://docs.cloud.google.com/chronicle/docs/detection/usecase-dlp-high-risk-user-download).
4728
4791
  #
4729
4792
  # Note: The following fields are mutually exclusive: `publish_to_chronicle`, `export_data`, `pub_sub_notification`, `publish_to_scc`, `tag_resources`, `publish_to_dataplex_catalog`. If a field in that set is populated, all other fields in the set will automatically be cleared.
4730
4793
  # @!attribute [rw] publish_to_scc
@@ -4761,9 +4824,9 @@ module Google
4761
4824
  # generated and the dataset and table are created, the discovery scan
4762
4825
  # configuration will be updated with the dataset and table names.
4763
4826
  # * See [Analyze data profiles stored in
4764
- # BigQuery](https://cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles).
4827
+ # BigQuery](https://docs.cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles).
4765
4828
  # * See [Sample queries for your BigQuery
4766
- # table](https://cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles#sample_sql_queries).
4829
+ # table](https://docs.cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles#sample_sql_queries).
4767
4830
  # * Data is inserted using [streaming
4768
4831
  # insert](https://cloud.google.com/blog/products/bigquery/life-of-a-bigquery-streaming-insert)
4769
4832
  # and so data may be in the buffer for a period of time after the
@@ -4774,7 +4837,7 @@ module Google
4774
4837
  # notification.
4775
4838
  # * The best practice is to use the same table for an entire organization
4776
4839
  # so that you can take advantage of the [provided Data Studio
4777
- # reports](https://cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles#use_a_premade_report).
4840
+ # reports](https://docs.cloud.google.com/sensitive-data-protection/docs/analyze-data-profiles#use_a_premade_report).
4778
4841
  # If you use VPC Service Controls to define security perimeters, then
4779
4842
  # you must use a separate table for each boundary.
4780
4843
  # @!attribute [rw] sample_findings_table
@@ -4846,7 +4909,8 @@ module Google
4846
4909
 
4847
4910
  # Create Dataplex Universal Catalog aspects for profiled resources with the
4848
4911
  # aspect type Sensitive Data Protection Profile. To learn more about aspects,
4849
- # see https://cloud.google.com/sensitive-data-protection/docs/add-aspects.
4912
+ # see
4913
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/add-aspects.
4850
4914
  # @!attribute [rw] lower_data_risk_to_low
4851
4915
  # @return [::Boolean]
4852
4916
  # Whether creating a Dataplex Universal Catalog aspect for a profiled
@@ -4861,10 +4925,10 @@ module Google
4861
4925
  end
4862
4926
 
4863
4927
  # If set, attaches the [tags]
4864
- # (https://cloud.google.com/resource-manager/docs/tags/tags-overview)
4928
+ # (https://docs.cloud.google.com/resource-manager/docs/tags/tags-overview)
4865
4929
  # provided to profiled resources. Tags support [access
4866
- # control](https://cloud.google.com/iam/docs/tags-access-control). You can
4867
- # conditionally grant or deny access to a resource based on whether the
4930
+ # control](https://docs.cloud.google.com/iam/docs/tags-access-control). You
4931
+ # can conditionally grant or deny access to a resource based on whether the
4868
4932
  # resource has a specific tag.
4869
4933
  # @!attribute [rw] tag_conditions
4870
4934
  # @return [::Array<::Google::Cloud::Dlp::V2::DataProfileAction::TagResources::TagCondition>]
@@ -4881,11 +4945,11 @@ module Google
4881
4945
  # @return [::Boolean]
4882
4946
  # Whether applying a tag to a resource should lower the risk of the profile
4883
4947
  # for that resource. For example, in conjunction with an [IAM deny
4884
- # policy](https://cloud.google.com/iam/docs/deny-overview), you can deny
4885
- # all principals a permission if a tag value is present, mitigating the
4886
- # risk of the resource. This also lowers the data risk of resources at the
4887
- # lower levels of the resource hierarchy. For example, reducing the data
4888
- # risk of a table data profile also reduces the data risk of the
4948
+ # policy](https://docs.cloud.google.com/iam/docs/deny-overview), you can
4949
+ # deny all principals a permission if a tag value is present, mitigating
4950
+ # the risk of the resource. This also lowers the data risk of resources at
4951
+ # the lower levels of the resource hierarchy. For example, reducing the
4952
+ # data risk of a table data profile also reduces the data risk of the
4889
4953
  # constituent column data profiles.
4890
4954
  class TagResources
4891
4955
  include ::Google::Protobuf::MessageExts
@@ -4949,7 +5013,7 @@ module Google
4949
5013
  # @!attribute [rw] infotype
4950
5014
  # @return [::Google::Cloud::Dlp::V2::InfoType]
4951
5015
  # The [type of
4952
- # content](https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference)
5016
+ # content](https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference)
4953
5017
  # that might have been found.
4954
5018
  # @!attribute [rw] quote_info
4955
5019
  # @return [::Google::Cloud::Dlp::V2::QuoteInfo]
@@ -5016,7 +5080,7 @@ module Google
5016
5080
  #
5017
5081
  # The generated data profiles are retained according to the
5018
5082
  # [data retention policy]
5019
- # (https://cloud.google.com/sensitive-data-protection/docs/data-profiles#retention).
5083
+ # (https://docs.cloud.google.com/sensitive-data-protection/docs/data-profiles#retention).
5020
5084
  # @!attribute [rw] location
5021
5085
  # @return [::Google::Cloud::Dlp::V2::DataProfileLocation]
5022
5086
  # The data to scan.
@@ -5045,7 +5109,7 @@ module Google
5045
5109
  # scanned.
5046
5110
  #
5047
5111
  # For more information, see
5048
- # https://cloud.google.com/sensitive-data-protection/docs/data-profiles#data-residency.
5112
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/data-profiles#data-residency.
5049
5113
  # @!attribute [rw] data_profile_actions
5050
5114
  # @return [::Array<::Google::Cloud::Dlp::V2::DataProfileAction>]
5051
5115
  # Actions to execute at the completion of the job.
@@ -5122,11 +5186,11 @@ module Google
5122
5186
  #
5123
5187
  # The generated data profiles are retained according to the
5124
5188
  # [data retention policy]
5125
- # (https://cloud.google.com/sensitive-data-protection/docs/data-profiles#retention).
5126
- # @!attribute [rw] name
5189
+ # (https://docs.cloud.google.com/sensitive-data-protection/docs/data-profiles#retention).
5190
+ # @!attribute [r] name
5127
5191
  # @return [::String]
5128
- # Unique resource name for the DiscoveryConfig, assigned by the service when
5129
- # the DiscoveryConfig is created, for example
5192
+ # Output only. Unique resource name for the DiscoveryConfig, assigned by the
5193
+ # service when the DiscoveryConfig is created, for example
5130
5194
  # `projects/dlp-test-project/locations/global/discoveryConfigs/53234423`.
5131
5195
  # @!attribute [rw] display_name
5132
5196
  # @return [::String]
@@ -5154,7 +5218,7 @@ module Google
5154
5218
  # scanned.
5155
5219
  #
5156
5220
  # For more information, see
5157
- # https://cloud.google.com/sensitive-data-protection/docs/data-profiles#data-residency.
5221
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/data-profiles#data-residency.
5158
5222
  # @!attribute [rw] actions
5159
5223
  # @return [::Array<::Google::Cloud::Dlp::V2::DataProfileAction>]
5160
5224
  # Actions to execute at the completion of scanning.
@@ -5673,7 +5737,7 @@ module Google
5673
5737
  # No inspect template should be included in the discovery config for a
5674
5738
  # security benchmarks scan. Instead, the built-in list of secrets and
5675
5739
  # credentials infoTypes will be used (see
5676
- # https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference#credentials_and_secrets).
5740
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/infotypes-reference#credentials_and_secrets).
5677
5741
  #
5678
5742
  # Credentials and secrets discovered will be reported as vulnerabilities to
5679
5743
  # Security Command Center.
@@ -5753,7 +5817,7 @@ module Google
5753
5817
  # For a resource to match the tag filters, the resource must have all of the
5754
5818
  # provided tags attached. Tags refer to Resource Manager tags bound to the
5755
5819
  # resource or its ancestors. For more information, see [Manage
5756
- # schedules](https://cloud.google.com/sensitive-data-protection/docs/profile-project-cloud-storage#manage-schedules).
5820
+ # schedules](https://docs.cloud.google.com/sensitive-data-protection/docs/profile-project-cloud-storage#manage-schedules).
5757
5821
  class FileStoreCollection
5758
5822
  include ::Google::Protobuf::MessageExts
5759
5823
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -5847,8 +5911,8 @@ module Google
5847
5911
  extend ::Google::Protobuf::MessageExts::ClassMethods
5848
5912
 
5849
5913
  # The attribute of an object. See
5850
- # https://cloud.google.com/storage/docs/storage-classes for more information
5851
- # on storage classes.
5914
+ # https://docs.cloud.google.com/storage/docs/storage-classes for more
5915
+ # information on storage classes.
5852
5916
  module CloudStorageObjectAttribute
5853
5917
  # Unused.
5854
5918
  CLOUD_STORAGE_OBJECT_ATTRIBUTE_UNSPECIFIED = 0
@@ -5890,12 +5954,14 @@ module Google
5890
5954
  # Scan buckets regardless of the attribute.
5891
5955
  ALL_SUPPORTED_BUCKETS = 1
5892
5956
 
5893
- # Buckets with [Autoclass](https://cloud.google.com/storage/docs/autoclass)
5957
+ # Buckets with
5958
+ # [Autoclass](https://docs.cloud.google.com/storage/docs/autoclass)
5894
5959
  # disabled. Only one of
5895
5960
  # AUTOCLASS_DISABLED or AUTOCLASS_ENABLED should be set.
5896
5961
  AUTOCLASS_DISABLED = 2
5897
5962
 
5898
- # Buckets with [Autoclass](https://cloud.google.com/storage/docs/autoclass)
5963
+ # Buckets with
5964
+ # [Autoclass](https://docs.cloud.google.com/storage/docs/autoclass)
5899
5965
  # enabled. Only one of
5900
5966
  # AUTOCLASS_DISABLED or AUTOCLASS_ENABLED should be set. Scanning
5901
5967
  # Autoclass-enabled buckets can affect object storage classes.
@@ -5924,7 +5990,7 @@ module Google
5924
5990
 
5925
5991
  # Target used to match against for discovery of resources from other clouds.
5926
5992
  # An [AWS connector in Security Command Center
5927
- # (Enterprise](https://cloud.google.com/security-command-center/docs/connect-scc-to-aws)
5993
+ # (Enterprise](https://docs.cloud.google.com/security-command-center/docs/connect-scc-to-aws)
5928
5994
  # is required to use this feature.
5929
5995
  # @!attribute [rw] data_source_type
5930
5996
  # @return [::Google::Cloud::Dlp::V2::DataSourceType]
@@ -6334,15 +6400,15 @@ module Google
6334
6400
  end
6335
6401
 
6336
6402
  # Combines all of the information about a DLP job.
6337
- # @!attribute [rw] name
6403
+ # @!attribute [r] name
6338
6404
  # @return [::String]
6339
- # The server-assigned name.
6405
+ # Output only. The server-assigned name.
6340
6406
  # @!attribute [rw] type
6341
6407
  # @return [::Google::Cloud::Dlp::V2::DlpJobType]
6342
6408
  # The type of job.
6343
- # @!attribute [rw] state
6409
+ # @!attribute [r] state
6344
6410
  # @return [::Google::Cloud::Dlp::V2::DlpJob::JobState]
6345
- # State of a job.
6411
+ # Output only. State of a job.
6346
6412
  # @!attribute [rw] risk_details
6347
6413
  # @return [::Google::Cloud::Dlp::V2::AnalyzeDataSourceRiskDetails]
6348
6414
  # Results from analyzing risk of a data source.
@@ -6353,28 +6419,28 @@ module Google
6353
6419
  # Results from inspecting a data source.
6354
6420
  #
6355
6421
  # Note: The following fields are mutually exclusive: `inspect_details`, `risk_details`. If a field in that set is populated, all other fields in the set will automatically be cleared.
6356
- # @!attribute [rw] create_time
6422
+ # @!attribute [r] create_time
6357
6423
  # @return [::Google::Protobuf::Timestamp]
6358
- # Time when the job was created.
6359
- # @!attribute [rw] start_time
6424
+ # Output only. Time when the job was created.
6425
+ # @!attribute [r] start_time
6360
6426
  # @return [::Google::Protobuf::Timestamp]
6361
- # Time when the job started.
6362
- # @!attribute [rw] end_time
6427
+ # Output only. Time when the job started.
6428
+ # @!attribute [r] end_time
6363
6429
  # @return [::Google::Protobuf::Timestamp]
6364
- # Time when the job finished.
6365
- # @!attribute [rw] last_modified
6430
+ # Output only. Time when the job finished.
6431
+ # @!attribute [r] last_modified
6366
6432
  # @return [::Google::Protobuf::Timestamp]
6367
- # Time when the job was last modified by the system.
6368
- # @!attribute [rw] job_trigger_name
6433
+ # Output only. Time when the job was last modified by the system.
6434
+ # @!attribute [r] job_trigger_name
6369
6435
  # @return [::String]
6370
- # If created by a job trigger, the resource name of the trigger that
6371
- # instantiated the job.
6372
- # @!attribute [rw] errors
6436
+ # Output only. If created by a job trigger, the resource name of the trigger
6437
+ # that instantiated the job.
6438
+ # @!attribute [r] errors
6373
6439
  # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
6374
- # A stream of errors encountered running the job.
6375
- # @!attribute [rw] action_details
6440
+ # Output only. A stream of errors encountered running the job.
6441
+ # @!attribute [r] action_details
6376
6442
  # @return [::Array<::Google::Cloud::Dlp::V2::ActionDetails>]
6377
- # Events that should occur after the job has completed.
6443
+ # Output only. Events that should occur after the job has completed.
6378
6444
  class DlpJob
6379
6445
  include ::Google::Protobuf::MessageExts
6380
6446
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -6425,7 +6491,7 @@ module Google
6425
6491
  #
6426
6492
  # The format of this value varies depending on whether you have [specified a
6427
6493
  # processing
6428
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6494
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
6429
6495
  #
6430
6496
  # + Projects scope, location specified:
6431
6497
  # `projects/{project_id}/locations/{location_id}`
@@ -6547,7 +6613,7 @@ module Google
6547
6613
  #
6548
6614
  # The format of this value varies depending on the scope of the request
6549
6615
  # (project or organization) and whether you have [specified a processing
6550
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6616
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
6551
6617
  #
6552
6618
  # + Projects scope, location specified:
6553
6619
  # `projects/{project_id}/locations/{location_id}`
@@ -6616,7 +6682,7 @@ module Google
6616
6682
  #
6617
6683
  # The format of this value varies depending on the scope of the request
6618
6684
  # (project or organization) and whether you have [specified a processing
6619
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6685
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
6620
6686
  #
6621
6687
  # + Projects scope, location specified:
6622
6688
  # `projects/{project_id}/locations/{location_id}`
@@ -6691,10 +6757,10 @@ module Google
6691
6757
 
6692
6758
  # Configuration for a custom dictionary created from a data source of any size
6693
6759
  # up to the maximum size defined in the
6694
- # [limits](https://cloud.google.com/sensitive-data-protection/limits) page. The
6695
- # artifacts of dictionary creation are stored in the specified Cloud Storage
6696
- # location. Consider using `CustomInfoType.Dictionary` for smaller dictionaries
6697
- # that satisfy the size requirements.
6760
+ # [limits](https://docs.cloud.google.com/sensitive-data-protection/limits)
6761
+ # page. The artifacts of dictionary creation are stored in the specified Cloud
6762
+ # Storage location. Consider using `CustomInfoType.Dictionary` for smaller
6763
+ # dictionaries that satisfy the size requirements.
6698
6764
  # @!attribute [rw] output_path
6699
6765
  # @return [::Google::Cloud::Dlp::V2::CloudStoragePath]
6700
6766
  # Location to store dictionary artifacts in Cloud Storage. These files
@@ -6727,7 +6793,7 @@ module Google
6727
6793
 
6728
6794
  # Configuration for stored infoTypes. All fields and subfield are provided
6729
6795
  # by the user. For more information, see
6730
- # https://cloud.google.com/sensitive-data-protection/docs/creating-custom-infotypes.
6796
+ # https://docs.cloud.google.com/sensitive-data-protection/docs/creating-custom-infotypes.
6731
6797
  # @!attribute [rw] display_name
6732
6798
  # @return [::String]
6733
6799
  # Display name of the StoredInfoType (max 256 characters).
@@ -6768,20 +6834,20 @@ module Google
6768
6834
  # @!attribute [rw] config
6769
6835
  # @return [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig]
6770
6836
  # StoredInfoType configuration.
6771
- # @!attribute [rw] create_time
6837
+ # @!attribute [r] create_time
6772
6838
  # @return [::Google::Protobuf::Timestamp]
6773
- # Create timestamp of the version. Read-only, determined by the system
6774
- # when the version is created.
6775
- # @!attribute [rw] state
6839
+ # Output only. Create timestamp of the version. Read-only, determined by the
6840
+ # system when the version is created.
6841
+ # @!attribute [r] state
6776
6842
  # @return [::Google::Cloud::Dlp::V2::StoredInfoTypeState]
6777
- # Stored info type version state. Read-only, updated by the system
6778
- # during dictionary creation.
6779
- # @!attribute [rw] errors
6843
+ # Output only. Stored info type version state. Read-only, updated by the
6844
+ # system during dictionary creation.
6845
+ # @!attribute [r] errors
6780
6846
  # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
6781
- # Errors that occurred when creating this storedInfoType version, or
6782
- # anomalies detected in the storedInfoType data that render it unusable. Only
6783
- # the five most recent errors will be displayed, with the most recent error
6784
- # appearing first.
6847
+ # Output only. Errors that occurred when creating this storedInfoType
6848
+ # version, or anomalies detected in the storedInfoType data that render it
6849
+ # unusable. Only the five most recent errors will be displayed, with the most
6850
+ # recent error appearing first.
6785
6851
  #
6786
6852
  # For example, some of the data for stored custom dictionaries is put in
6787
6853
  # the user's Cloud Storage bucket, and if this data is modified or
@@ -6791,9 +6857,9 @@ module Google
6791
6857
  # use the UpdateStoredInfoType API method to create another version of the
6792
6858
  # storedInfoType to continue using it, reusing the same `config` if it was
6793
6859
  # not the source of the error.
6794
- # @!attribute [rw] stats
6860
+ # @!attribute [r] stats
6795
6861
  # @return [::Google::Cloud::Dlp::V2::StoredInfoTypeStats]
6796
- # Statistics about this storedInfoType version.
6862
+ # Output only. Statistics about this storedInfoType version.
6797
6863
  class StoredInfoTypeVersion
6798
6864
  include ::Google::Protobuf::MessageExts
6799
6865
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -6801,9 +6867,9 @@ module Google
6801
6867
 
6802
6868
  # StoredInfoType resource message that contains information about the current
6803
6869
  # version and any pending updates.
6804
- # @!attribute [rw] name
6870
+ # @!attribute [r] name
6805
6871
  # @return [::String]
6806
- # Resource name.
6872
+ # Output only. Resource name.
6807
6873
  # @!attribute [rw] current_version
6808
6874
  # @return [::Google::Cloud::Dlp::V2::StoredInfoTypeVersion]
6809
6875
  # Current version of the stored info type.
@@ -6823,7 +6889,7 @@ module Google
6823
6889
  #
6824
6890
  # The format of this value varies depending on the scope of the request
6825
6891
  # (project or organization) and whether you have [specified a processing
6826
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6892
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
6827
6893
  #
6828
6894
  # + Projects scope, location specified:
6829
6895
  # `projects/{project_id}/locations/{location_id}`
@@ -6893,7 +6959,7 @@ module Google
6893
6959
  #
6894
6960
  # The format of this value varies depending on the scope of the request
6895
6961
  # (project or organization) and whether you have [specified a processing
6896
- # location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
6962
+ # location](https://docs.cloud.google.com/sensitive-data-protection/docs/specifying-location):
6897
6963
  #
6898
6964
  # + Projects scope, location specified:
6899
6965
  # `projects/{project_id}/locations/{location_id}`
@@ -7466,7 +7532,7 @@ module Google
7466
7532
  # @!attribute [rw] dataset_location
7467
7533
  # @return [::String]
7468
7534
  # If supported, the location where the dataset's data is stored.
7469
- # See https://cloud.google.com/bigquery/docs/locations for supported
7535
+ # See https://docs.cloud.google.com/bigquery/docs/locations for supported
7470
7536
  # locations.
7471
7537
  # @!attribute [rw] dataset_id
7472
7538
  # @return [::String]
@@ -7648,7 +7714,7 @@ module Google
7648
7714
  # @!attribute [rw] dataset_location
7649
7715
  # @return [::String]
7650
7716
  # If supported, the location where the dataset's data is stored.
7651
- # See https://cloud.google.com/bigquery/docs/locations for supported
7717
+ # See https://docs.cloud.google.com/bigquery/docs/locations for supported
7652
7718
  # BigQuery locations.
7653
7719
  # @!attribute [rw] dataset_id
7654
7720
  # @return [::String]
@@ -7803,7 +7869,7 @@ module Google
7803
7869
  # The location of the file store.
7804
7870
  #
7805
7871
  # * Cloud Storage:
7806
- # https://cloud.google.com/storage/docs/locations#available-locations
7872
+ # https://docs.cloud.google.com/storage/docs/locations#available-locations
7807
7873
  # * Amazon S3:
7808
7874
  # https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints
7809
7875
  # @!attribute [rw] data_storage_locations
@@ -8450,8 +8516,8 @@ module Google
8450
8516
 
8451
8517
  # Use IAM authentication to connect. This requires the Cloud SQL IAM feature
8452
8518
  # to be enabled on the instance, which is not the default for Cloud SQL.
8453
- # See https://cloud.google.com/sql/docs/postgres/authentication and
8454
- # https://cloud.google.com/sql/docs/mysql/authentication.
8519
+ # See https://docs.cloud.google.com/sql/docs/postgres/authentication and
8520
+ # https://docs.cloud.google.com/sql/docs/mysql/authentication.
8455
8521
  class CloudSqlIamCredential
8456
8522
  include ::Google::Protobuf::MessageExts
8457
8523
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -8688,12 +8754,12 @@ module Google
8688
8754
  EMBEDDING = 7
8689
8755
 
8690
8756
  # The [Cloud SQL Vertex
8691
- # AI](https://cloud.google.com/sql/docs/postgres/integrate-cloud-sql-with-vertex-ai)
8757
+ # AI](https://docs.cloud.google.com/sql/docs/postgres/integrate-cloud-sql-with-vertex-ai)
8692
8758
  # plugin is installed on the database.
8693
8759
  VERTEX_PLUGIN = 3
8694
8760
 
8695
8761
  # Support for [Cloud SQL vector
8696
- # embeddings](https://cloud.google.com/sql/docs/mysql/enable-vector-search)
8762
+ # embeddings](https://docs.cloud.google.com/sql/docs/mysql/enable-vector-search)
8697
8763
  # is enabled on the database.
8698
8764
  VECTOR_PLUGIN = 4
8699
8765
 
@@ -8706,6 +8772,252 @@ module Google
8706
8772
  end
8707
8773
  end
8708
8774
 
8775
+ # Request message for CreateContentPolicy.
8776
+ # @!attribute [rw] parent
8777
+ # @return [::String]
8778
+ # Required. Parent resource name.
8779
+ #
8780
+ # The format of this value varies depending on the scope of the request
8781
+ # (project):
8782
+ #
8783
+ # + Projects scope:
8784
+ # `projects/{project_id}/locations/{location_id}`
8785
+ # @!attribute [rw] content_policy
8786
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy]
8787
+ # Required. The content_policy resource.
8788
+ # @!attribute [rw] content_policy_id
8789
+ # @return [::String]
8790
+ # Optional. The content policy ID can contain uppercase and lowercase
8791
+ # letters, numbers, and hyphens; that is, it must match the regular
8792
+ # expression:
8793
+ # `[a-zA-Z\d-_]+`.
8794
+ # The maximum length is 100 characters. If empty, the system will generate
8795
+ # a random id.
8796
+ class CreateContentPolicyRequest
8797
+ include ::Google::Protobuf::MessageExts
8798
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8799
+ end
8800
+
8801
+ # Request message for GetContentPolicy.
8802
+ # @!attribute [rw] name
8803
+ # @return [::String]
8804
+ # Required. Resource name in the format:
8805
+ # `projects/{project}/locations/{location}/contentPolicies/{content_policy}`.
8806
+ class GetContentPolicyRequest
8807
+ include ::Google::Protobuf::MessageExts
8808
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8809
+ end
8810
+
8811
+ # Request message for ListContentPolicies.
8812
+ # @!attribute [rw] parent
8813
+ # @return [::String]
8814
+ # Required. Resource name of the project,
8815
+ # for example, `projects/project-id/locations/asia`.
8816
+ # @!attribute [rw] page_size
8817
+ # @return [::Integer]
8818
+ # Optional. Number of results per page, max 1000.
8819
+ # @!attribute [rw] page_token
8820
+ # @return [::String]
8821
+ # Optional. Page token from a previous page to return the next set of
8822
+ # results. If set, all other request fields must match the original request.
8823
+ class ListContentPoliciesRequest
8824
+ include ::Google::Protobuf::MessageExts
8825
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8826
+ end
8827
+
8828
+ # Response message for ListContentPolicies.
8829
+ # @!attribute [rw] content_policies
8830
+ # @return [::Array<::Google::Cloud::Dlp::V2::ContentPolicy>]
8831
+ # List of content policies.
8832
+ # @!attribute [rw] next_page_token
8833
+ # @return [::String]
8834
+ # Token to retrieve the next page of results. An empty value means there are
8835
+ # no more results.
8836
+ class ListContentPoliciesResponse
8837
+ include ::Google::Protobuf::MessageExts
8838
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8839
+ end
8840
+
8841
+ # Request message for UpdateContentPolicy.
8842
+ # @!attribute [rw] name
8843
+ # @return [::String]
8844
+ # Required. Resource name in the format:
8845
+ # `projects/{project}/locations/{location}/contentPolicies/{content_policy}`.
8846
+ # @!attribute [rw] content_policy
8847
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy]
8848
+ # Required. The content_policy with new values for the relevant fields.
8849
+ # @!attribute [rw] update_mask
8850
+ # @return [::Google::Protobuf::FieldMask]
8851
+ # Optional. Mask to control which fields get updated.
8852
+ class UpdateContentPolicyRequest
8853
+ include ::Google::Protobuf::MessageExts
8854
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8855
+ end
8856
+
8857
+ # Request message for DeleteContentPolicy.
8858
+ # @!attribute [rw] name
8859
+ # @return [::String]
8860
+ # Required. Resource name of the ContentPolicy to be deleted, in the format:
8861
+ # `projects/{project}/locations/{location}/contentPolicies/{content_policy}`.
8862
+ class DeleteContentPolicyRequest
8863
+ include ::Google::Protobuf::MessageExts
8864
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8865
+ end
8866
+
8867
+ # A policy to apply to content based on its inspection findings.
8868
+ # @!attribute [r] name
8869
+ # @return [::String]
8870
+ # Output only. Resource name of the policy.
8871
+ # @!attribute [r] create_time
8872
+ # @return [::Google::Protobuf::Timestamp]
8873
+ # Output only. The creation timestamp of a contentPolicy; output-only field.
8874
+ # @!attribute [r] update_time
8875
+ # @return [::Google::Protobuf::Timestamp]
8876
+ # Output only. The last update timestamp of a contentPolicy; output-only
8877
+ # field.
8878
+ # @!attribute [rw] display_name
8879
+ # @return [::String]
8880
+ # Optional. Display name (max 63 chars)
8881
+ # @!attribute [rw] inspect_config
8882
+ # @return [::Google::Cloud::Dlp::V2::InspectConfig]
8883
+ # Optional. InspectConfig to use to produce findings.
8884
+ # @!attribute [rw] rules
8885
+ # @return [::Array<::Google::Cloud::Dlp::V2::ContentPolicy::PolicyRule>]
8886
+ # Required. Policies to apply, based on the findings returned by inspection.
8887
+ # The first rule to match applies.
8888
+ # @!attribute [rw] unsupported_file_type
8889
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyAction]
8890
+ # Optional. Action to take if the content is an unsupported file type.
8891
+ # @!attribute [rw] input_too_large
8892
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyAction]
8893
+ # Optional. Action to take if the content is a supported file type but is too
8894
+ # large to be scanned.
8895
+ # @!attribute [rw] failed_to_scan_supported_file_type
8896
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyAction]
8897
+ # Optional. Action to take if the content is a supported file type and size
8898
+ # but fails to be scanned, for example because the file is encrypted or
8899
+ # corrupted.
8900
+ # @!attribute [rw] default_action
8901
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyAction]
8902
+ # Action to take if the content is scanned and no rules match.
8903
+ # Defaults to returning an ALLOW verdict if not set.
8904
+ # @!attribute [rw] logging_configs
8905
+ # @return [::Array<::Google::Cloud::Dlp::V2::ContentPolicy::LoggingConfig>]
8906
+ # Optional. Log the actions taken by the content policy to external systems.
8907
+ # @!attribute [r] errors
8908
+ # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
8909
+ # Output only. A stream of errors encountered when the policy was applied.
8910
+ # Output only field. Will return the last 100 errors. Whenever the policy is
8911
+ # modified this list will be cleared.
8912
+ class ContentPolicy
8913
+ include ::Google::Protobuf::MessageExts
8914
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8915
+
8916
+ # A possible action to take when applying a content policy.
8917
+ # @!attribute [rw] return_verdict
8918
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicyVerdict]
8919
+ # Optional. If set, the verdict will be returned to the user.
8920
+ class PolicyAction
8921
+ include ::Google::Protobuf::MessageExts
8922
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8923
+ end
8924
+
8925
+ # A single policy rule. The first rule to match from the list above controls
8926
+ # the result.
8927
+ # @!attribute [rw] conditions
8928
+ # @return [::Array<::Google::Cloud::Dlp::V2::ContentPolicy::PolicyRule::PolicyCondition>]
8929
+ # Optional. Conditions that must match for this rule to apply.
8930
+ # All conditions must match (`AND`). For `OR` conditions, use multiple
8931
+ # rules.
8932
+ # @!attribute [rw] action
8933
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyAction]
8934
+ # Required. Action to take if this rule applies.
8935
+ class PolicyRule
8936
+ include ::Google::Protobuf::MessageExts
8937
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8938
+
8939
+ # A condition that must match for this rule to apply.
8940
+ # @!attribute [rw] info_type_condition
8941
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyRule::PolicyCondition::InfoTypeCondition]
8942
+ # A condition based on info types.
8943
+ class PolicyCondition
8944
+ include ::Google::Protobuf::MessageExts
8945
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8946
+
8947
+ # A info type based condition.
8948
+ # @!attribute [rw] min_count
8949
+ # @return [::Integer]
8950
+ # Optional. The minimum total number of findings of all matching info
8951
+ # types required for this condition to evaluate to true. Defaults to 1
8952
+ # if unset.
8953
+ # @!attribute [rw] info_types
8954
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::PolicyRule::PolicyCondition::InfoTypeCondition::InfoTypes]
8955
+ # match any of these info types.
8956
+ #
8957
+ # Note: The following fields are mutually exclusive: `info_types`, `any_info_type`. If a field in that set is populated, all other fields in the set will automatically be cleared.
8958
+ # @!attribute [rw] any_info_type
8959
+ # @return [::Google::Protobuf::Empty]
8960
+ # match any info types.
8961
+ #
8962
+ # Note: The following fields are mutually exclusive: `any_info_type`, `info_types`. If a field in that set is populated, all other fields in the set will automatically be cleared.
8963
+ class InfoTypeCondition
8964
+ include ::Google::Protobuf::MessageExts
8965
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8966
+
8967
+ # Info types to match.
8968
+ # @!attribute [rw] info_type_names
8969
+ # @return [::Array<::String>]
8970
+ # Required. A list of info types to match.
8971
+ class InfoTypes
8972
+ include ::Google::Protobuf::MessageExts
8973
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8974
+ end
8975
+ end
8976
+ end
8977
+ end
8978
+
8979
+ # A single logging configuration.
8980
+ # @!attribute [rw] log_to_big_query
8981
+ # @return [::Google::Cloud::Dlp::V2::ContentPolicy::LoggingConfig::LogToBigQuery]
8982
+ # Optional. Log the actions taken to a BigQuery table.
8983
+ class LoggingConfig
8984
+ include ::Google::Protobuf::MessageExts
8985
+ extend ::Google::Protobuf::MessageExts::ClassMethods
8986
+
8987
+ # Configuration for logging content policy actions to BigQuery.
8988
+ # @!attribute [rw] project_id
8989
+ # @return [::String]
8990
+ # Required. The ID of the project containing the BigQuery table to write
8991
+ # to.
8992
+ # @!attribute [rw] dataset_id
8993
+ # @return [::String]
8994
+ # Required. The ID of the dataset containing the BigQuery table to write
8995
+ # to.
8996
+ # @!attribute [rw] table_id
8997
+ # @return [::String]
8998
+ # Required. The ID of the BigQuery table to write to.
8999
+ class LogToBigQuery
9000
+ include ::Google::Protobuf::MessageExts
9001
+ extend ::Google::Protobuf::MessageExts::ClassMethods
9002
+ end
9003
+ end
9004
+ end
9005
+
9006
+ # Possible results of applying a content policy. This may expand to include
9007
+ # additional result types in the future.
9008
+ module ContentPolicyVerdict
9009
+ # Not used.
9010
+ CONTENT_POLICY_VERDICT_UNSPECIFIED = 0
9011
+
9012
+ # The policy allows the provided content to be used.
9013
+ ALLOW = 1
9014
+
9015
+ # The policy prevents the provided content from being used. This should
9016
+ # result in a blocked file upload, exclusion from training dataset, or
9017
+ # other similar block action. (specific action will depend on the caller).
9018
+ BLOCK = 2
9019
+ end
9020
+
8709
9021
  # Enum of possible outcomes of transformations. SUCCESS if transformation and
8710
9022
  # storing of transformation was successful, otherwise, reason for not
8711
9023
  # transforming.