google-cloud-dlp-v2 0.18.0 → 0.20.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -39,7 +39,8 @@ module Google
39
39
 
40
40
  # The rule to exclude findings based on a hotword. For record inspection of
41
41
  # tables, column names are considered hotwords. An example of this is to
42
- # exclude a finding if a BigQuery column matches a specific pattern.
42
+ # exclude a finding if it belongs to a BigQuery column that matches a specific
43
+ # pattern.
43
44
  # @!attribute [rw] hotword_regex
44
45
  # @return [::Google::Cloud::Dlp::V2::CustomInfoType::Regex]
45
46
  # Regular expression pattern defining what qualifies as a hotword.
@@ -113,17 +114,26 @@ module Google
113
114
  # https://cloud.google.com/dlp/docs/infotypes-reference.
114
115
  #
115
116
  # When no InfoTypes or CustomInfoTypes are specified in a request, the
116
- # system may automatically choose what detectors to run. By default this may
117
- # be all types, but may change over time as detectors are updated.
117
+ # system may automatically choose a default list of detectors to run, which
118
+ # may change over time.
118
119
  #
119
120
  # If you need precise control and predictability as to what detectors are
120
121
  # run you should specify specific InfoTypes listed in the reference,
121
122
  # otherwise a default list will be used, which may change over time.
122
123
  # @!attribute [rw] min_likelihood
123
124
  # @return [::Google::Cloud::Dlp::V2::Likelihood]
124
- # Only returns findings equal or above this threshold. The default is
125
+ # Only returns findings equal to or above this threshold. The default is
125
126
  # POSSIBLE.
126
- # See https://cloud.google.com/dlp/docs/likelihood to learn more.
127
+ #
128
+ # In general, the highest likelihood setting yields the fewest findings in
129
+ # results and the lowest chance of a false positive. For more information,
130
+ # see [Match likelihood](https://cloud.google.com/dlp/docs/likelihood).
131
+ # @!attribute [rw] min_likelihood_per_info_type
132
+ # @return [::Array<::Google::Cloud::Dlp::V2::InspectConfig::InfoTypeLikelihood>]
133
+ # Minimum likelihood per infotype. For each infotype, a user can specify a
134
+ # minimum likelihood. The system only returns a finding if its likelihood is
135
+ # above this threshold. If this field is not set, the system uses the
136
+ # InspectConfig min_likelihood.
127
137
  # @!attribute [rw] limits
128
138
  # @return [::Google::Cloud::Dlp::V2::InspectConfig::FindingLimits]
129
139
  # Configuration to control the number of findings returned.
@@ -134,11 +144,19 @@ module Google
134
144
  # redacted. Don't include finding limits in
135
145
  # {::Google::Cloud::Dlp::V2::DlpService::Client#redact_image RedactImage}
136
146
  # requests. Otherwise, Cloud DLP returns an error.
147
+ #
148
+ # When set within an
149
+ # {::Google::Cloud::Dlp::V2::InspectJobConfig InspectJobConfig}, the specified
150
+ # maximum values aren't hard limits. If an inspection job reaches these
151
+ # limits, the job ends gradually, not abruptly. Therefore, the actual number
152
+ # of findings that Cloud DLP returns can be multiple times higher than these
153
+ # maximum values.
137
154
  # @!attribute [rw] include_quote
138
155
  # @return [::Boolean]
139
156
  # When true, a contextual quote from the data that triggered a finding is
140
- # included in the response; see {::Google::Cloud::Dlp::V2::Finding#quote Finding.quote}.
141
- # This is not used for data profiling.
157
+ # included in the response; see
158
+ # {::Google::Cloud::Dlp::V2::Finding#quote Finding.quote}. This is not used for
159
+ # data profiling.
142
160
  # @!attribute [rw] exclude_info_types
143
161
  # @return [::Boolean]
144
162
  # When true, excludes type information of the findings.
@@ -159,6 +177,25 @@ module Google
159
177
  include ::Google::Protobuf::MessageExts
160
178
  extend ::Google::Protobuf::MessageExts::ClassMethods
161
179
 
180
+ # Configuration for setting a minimum likelihood per infotype. Used to
181
+ # customize the minimum likelihood level for specific infotypes in the
182
+ # request. For example, use this if you want to lower the precision for
183
+ # PERSON_NAME without lowering the precision for the other infotypes in the
184
+ # request.
185
+ # @!attribute [rw] info_type
186
+ # @return [::Google::Cloud::Dlp::V2::InfoType]
187
+ # Type of information the likelihood threshold applies to. Only one
188
+ # likelihood per info_type should be provided. If InfoTypeLikelihood does
189
+ # not have an info_type, the configuration fails.
190
+ # @!attribute [rw] min_likelihood
191
+ # @return [::Google::Cloud::Dlp::V2::Likelihood]
192
+ # Only returns findings equal to or above this threshold. This field is
193
+ # required or else the configuration fails.
194
+ class InfoTypeLikelihood
195
+ include ::Google::Protobuf::MessageExts
196
+ extend ::Google::Protobuf::MessageExts::ClassMethods
197
+ end
198
+
162
199
  # Configuration to control the number of findings returned for inspection.
163
200
  # This is not used for de-identification or data profiling.
164
201
  #
@@ -169,15 +206,29 @@ module Google
169
206
  # requests. Otherwise, Cloud DLP returns an error.
170
207
  # @!attribute [rw] max_findings_per_item
171
208
  # @return [::Integer]
172
- # Max number of findings that will be returned for each item scanned.
173
- # When set within `InspectJobConfig`,
174
- # the maximum returned is 2000 regardless if this is set higher.
175
- # When set within `InspectContentRequest`, this field is ignored.
209
+ # Max number of findings that are returned for each item scanned.
210
+ #
211
+ # When set within an
212
+ # {::Google::Cloud::Dlp::V2::InspectContentRequest InspectContentRequest},
213
+ # this field is ignored.
214
+ #
215
+ # This value isn't a hard limit. If the number of findings for an item
216
+ # reaches this limit, the inspection of that item ends gradually, not
217
+ # abruptly. Therefore, the actual number of findings that Cloud DLP returns
218
+ # for the item can be multiple times higher than this value.
176
219
  # @!attribute [rw] max_findings_per_request
177
220
  # @return [::Integer]
178
- # Max number of findings that will be returned per request/job.
179
- # When set within `InspectContentRequest`, the maximum returned is 2000
180
- # regardless if this is set higher.
221
+ # Max number of findings that are returned per request or job.
222
+ #
223
+ # If you set this field in an
224
+ # {::Google::Cloud::Dlp::V2::InspectContentRequest InspectContentRequest}, the
225
+ # resulting maximum value is the value that you set or 3,000, whichever is
226
+ # lower.
227
+ #
228
+ # This value isn't a hard limit. If an inspection reaches this limit, the
229
+ # inspection ends gradually, not abruptly. Therefore, the actual number of
230
+ # findings that Cloud DLP returns can be multiple times higher than this
231
+ # value.
181
232
  # @!attribute [rw] max_findings_per_info_type
182
233
  # @return [::Array<::Google::Cloud::Dlp::V2::InspectConfig::FindingLimits::InfoTypeLimit>]
183
234
  # Configuration of findings limit given for specified infoTypes.
@@ -1007,6 +1058,19 @@ module Google
1007
1058
  end
1008
1059
  end
1009
1060
 
1061
+ # The schema of data to be saved to the BigQuery table when the
1062
+ # `DataProfileAction` is enabled.
1063
+ # @!attribute [rw] table_profile
1064
+ # @return [::Google::Cloud::Dlp::V2::TableDataProfile]
1065
+ # Table data profile column
1066
+ # @!attribute [rw] column_profile
1067
+ # @return [::Google::Cloud::Dlp::V2::ColumnDataProfile]
1068
+ # Column data profile column
1069
+ class DataProfileBigQueryRowSchema
1070
+ include ::Google::Protobuf::MessageExts
1071
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1072
+ end
1073
+
1010
1074
  # Statistics related to processing hybrid inspect requests.
1011
1075
  # @!attribute [rw] processed_count
1012
1076
  # @return [::Integer]
@@ -1027,6 +1091,62 @@ module Google
1027
1091
  extend ::Google::Protobuf::MessageExts::ClassMethods
1028
1092
  end
1029
1093
 
1094
+ # The results of an {::Google::Cloud::Dlp::V2::Action Action}.
1095
+ # @!attribute [rw] deidentify_details
1096
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyDataSourceDetails]
1097
+ # Outcome of a de-identification action.
1098
+ class ActionDetails
1099
+ include ::Google::Protobuf::MessageExts
1100
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1101
+ end
1102
+
1103
+ # Summary of what was modified during a transformation.
1104
+ # @!attribute [rw] transformed_bytes
1105
+ # @return [::Integer]
1106
+ # Total size in bytes that were transformed in some way.
1107
+ # @!attribute [rw] transformation_count
1108
+ # @return [::Integer]
1109
+ # Number of successfully applied transformations.
1110
+ # @!attribute [rw] transformation_error_count
1111
+ # @return [::Integer]
1112
+ # Number of errors encountered while trying to apply transformations.
1113
+ class DeidentifyDataSourceStats
1114
+ include ::Google::Protobuf::MessageExts
1115
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1116
+ end
1117
+
1118
+ # The results of a {::Google::Cloud::Dlp::V2::Action::Deidentify Deidentify} action
1119
+ # from an inspect job.
1120
+ # @!attribute [rw] requested_options
1121
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyDataSourceDetails::RequestedDeidentifyOptions]
1122
+ # De-identification config used for the request.
1123
+ # @!attribute [rw] deidentify_stats
1124
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyDataSourceStats]
1125
+ # Stats about the de-identification operation.
1126
+ class DeidentifyDataSourceDetails
1127
+ include ::Google::Protobuf::MessageExts
1128
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1129
+
1130
+ # De-identification options.
1131
+ # @!attribute [rw] snapshot_deidentify_template
1132
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
1133
+ # Snapshot of the state of the `DeidentifyTemplate` from the
1134
+ # {::Google::Cloud::Dlp::V2::Action::Deidentify Deidentify} action at the time
1135
+ # this job was run.
1136
+ # @!attribute [rw] snapshot_structured_deidentify_template
1137
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
1138
+ # Snapshot of the state of the structured `DeidentifyTemplate` from the
1139
+ # `Deidentify` action at the time this job was run.
1140
+ # @!attribute [rw] snapshot_image_redact_template
1141
+ # @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
1142
+ # Snapshot of the state of the image transformation `DeidentifyTemplate`
1143
+ # from the `Deidentify` action at the time this job was run.
1144
+ class RequestedDeidentifyOptions
1145
+ include ::Google::Protobuf::MessageExts
1146
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1147
+ end
1148
+ end
1149
+
1030
1150
  # InfoType description.
1031
1151
  # @!attribute [rw] name
1032
1152
  # @return [::String]
@@ -1047,6 +1167,9 @@ module Google
1047
1167
  # @!attribute [rw] categories
1048
1168
  # @return [::Array<::Google::Cloud::Dlp::V2::InfoTypeCategory>]
1049
1169
  # The category of the infoType.
1170
+ # @!attribute [rw] sensitivity_score
1171
+ # @return [::Google::Cloud::Dlp::V2::SensitivityScore]
1172
+ # The default sensitivity of the infoType.
1050
1173
  class InfoTypeDescription
1051
1174
  include ::Google::Protobuf::MessageExts
1052
1175
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1102,6 +1225,9 @@ module Google
1102
1225
  # The infoType is typically used in Colombia.
1103
1226
  COLOMBIA = 9
1104
1227
 
1228
+ # The infoType is typically used in Croatia.
1229
+ CROATIA = 42
1230
+
1105
1231
  # The infoType is typically used in Denmark.
1106
1232
  DENMARK = 10
1107
1233
 
@@ -1144,6 +1270,9 @@ module Google
1144
1270
  # The infoType is typically used in the Netherlands.
1145
1271
  THE_NETHERLANDS = 23
1146
1272
 
1273
+ # The infoType is typically used in New Zealand.
1274
+ NEW_ZEALAND = 41
1275
+
1147
1276
  # The infoType is typically used in Norway.
1148
1277
  NORWAY = 24
1149
1278
 
@@ -1171,6 +1300,9 @@ module Google
1171
1300
  # The infoType is typically used in Sweden.
1172
1301
  SWEDEN = 32
1173
1302
 
1303
+ # The infoType is typically used in Switzerland.
1304
+ SWITZERLAND = 43
1305
+
1174
1306
  # The infoType is typically used in Taiwan.
1175
1307
  TAIWAN = 33
1176
1308
 
@@ -1194,9 +1326,6 @@ module Google
1194
1326
 
1195
1327
  # The infoType is typically used in Google internally.
1196
1328
  INTERNAL = 40
1197
-
1198
- # The infoType is typically used in New Zealand.
1199
- NEW_ZEALAND = 41
1200
1329
  end
1201
1330
 
1202
1331
  # Enum of the current industries in the category.
@@ -1351,8 +1480,8 @@ module Google
1351
1480
  # Required. Quasi-identifier columns.
1352
1481
  # @!attribute [rw] relative_frequency
1353
1482
  # @return [::Google::Cloud::Dlp::V2::FieldId]
1354
- # Required. The relative frequency column must contain a floating-point number
1355
- # between 0 and 1 (inclusive). Null values are assumed to be zero.
1483
+ # Required. The relative frequency column must contain a floating-point
1484
+ # number between 0 and 1 (inclusive). Null values are assumed to be zero.
1356
1485
  class StatisticalTable
1357
1486
  include ::Google::Protobuf::MessageExts
1358
1487
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1467,8 +1596,8 @@ module Google
1467
1596
  # extrapolating from the distribution of values in the input dataset.
1468
1597
  # @!attribute [rw] quasi_ids
1469
1598
  # @return [::Array<::Google::Cloud::Dlp::V2::PrivacyMetric::KMapEstimationConfig::TaggedField>]
1470
- # Required. Fields considered to be quasi-identifiers. No two columns can have the
1471
- # same tag.
1599
+ # Required. Fields considered to be quasi-identifiers. No two columns can
1600
+ # have the same tag.
1472
1601
  # @!attribute [rw] region_code
1473
1602
  # @return [::String]
1474
1603
  # ISO 3166-1 alpha-2 region code to use in the statistical modeling.
@@ -1523,8 +1652,8 @@ module Google
1523
1652
  # Required. Quasi-identifier columns.
1524
1653
  # @!attribute [rw] relative_frequency
1525
1654
  # @return [::Google::Cloud::Dlp::V2::FieldId]
1526
- # Required. The relative frequency column must contain a floating-point number
1527
- # between 0 and 1 (inclusive). Null values are assumed to be zero.
1655
+ # Required. The relative frequency column must contain a floating-point
1656
+ # number between 0 and 1 (inclusive). Null values are assumed to be zero.
1528
1657
  class AuxiliaryTable
1529
1658
  include ::Google::Protobuf::MessageExts
1530
1659
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1550,8 +1679,8 @@ module Google
1550
1679
  # knowing the attack dataset, so we use a statistical model instead.
1551
1680
  # @!attribute [rw] quasi_ids
1552
1681
  # @return [::Array<::Google::Cloud::Dlp::V2::QuasiId>]
1553
- # Required. Fields considered to be quasi-identifiers. No two fields can have the
1554
- # same tag.
1682
+ # Required. Fields considered to be quasi-identifiers. No two fields can
1683
+ # have the same tag.
1555
1684
  # @!attribute [rw] region_code
1556
1685
  # @return [::String]
1557
1686
  # ISO 3166-1 alpha-2 region code to use in the statistical modeling.
@@ -2018,8 +2147,8 @@ module Google
2018
2147
  # Apply transformation to the selected info_types.
2019
2148
  # @!attribute [rw] info_types
2020
2149
  # @return [::Array<::Google::Cloud::Dlp::V2::InfoType>]
2021
- # Required. InfoTypes to apply the transformation to. Required. Provided InfoType
2022
- # must be unique within the ImageTransformations message.
2150
+ # Required. InfoTypes to apply the transformation to. Required. Provided
2151
+ # InfoType must be unique within the ImageTransformations message.
2023
2152
  class SelectedInfoTypes
2024
2153
  include ::Google::Protobuf::MessageExts
2025
2154
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2367,18 +2496,18 @@ module Google
2367
2496
  # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
2368
2497
  # @!attribute [rw] lower_bound
2369
2498
  # @return [::Google::Cloud::Dlp::V2::Value]
2370
- # Required. Lower bound value of buckets. All values less than `lower_bound` are
2371
- # grouped together into a single bucket; for example if `lower_bound` = 10,
2372
- # then all values less than 10 are replaced with the value "-10".
2499
+ # Required. Lower bound value of buckets. All values less than `lower_bound`
2500
+ # are grouped together into a single bucket; for example if `lower_bound` =
2501
+ # 10, then all values less than 10 are replaced with the value "-10".
2373
2502
  # @!attribute [rw] upper_bound
2374
2503
  # @return [::Google::Cloud::Dlp::V2::Value]
2375
- # Required. Upper bound value of buckets. All values greater than upper_bound are
2376
- # grouped together into a single bucket; for example if `upper_bound` = 89,
2377
- # then all values greater than 89 are replaced with the value "89+".
2504
+ # Required. Upper bound value of buckets. All values greater than upper_bound
2505
+ # are grouped together into a single bucket; for example if `upper_bound` =
2506
+ # 89, then all values greater than 89 are replaced with the value "89+".
2378
2507
  # @!attribute [rw] bucket_size
2379
2508
  # @return [::Float]
2380
- # Required. Size of each bucket (except for minimum and maximum buckets). So if
2381
- # `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
2509
+ # Required. Size of each bucket (except for minimum and maximum buckets). So
2510
+ # if `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
2382
2511
  # following buckets would be used: -10, 10-20, 20-30, 30-40, 40-50, 50-60,
2383
2512
  # 60-70, 70-80, 80-89, 89+. Precision up to 2 decimals works.
2384
2513
  class FixedSizeBucketingConfig
@@ -2599,14 +2728,15 @@ module Google
2599
2728
  # to learn more.
2600
2729
  # @!attribute [rw] upper_bound_days
2601
2730
  # @return [::Integer]
2602
- # Required. Range of shift in days. Actual shift will be selected at random within this
2603
- # range (inclusive ends). Negative means shift to earlier in time. Must not
2604
- # be more than 365250 days (1000 years) each direction.
2731
+ # Required. Range of shift in days. Actual shift will be selected at random
2732
+ # within this range (inclusive ends). Negative means shift to earlier in
2733
+ # time. Must not be more than 365250 days (1000 years) each direction.
2605
2734
  #
2606
2735
  # For example, 3 means shift date to at most 3 days into the future.
2607
2736
  # @!attribute [rw] lower_bound_days
2608
2737
  # @return [::Integer]
2609
- # Required. For example, -5 means shift date to at most 5 days back in the past.
2738
+ # Required. For example, -5 means shift date to at most 5 days back in the
2739
+ # past.
2610
2740
  # @!attribute [rw] context
2611
2741
  # @return [::Google::Cloud::Dlp::V2::FieldId]
2612
2742
  # Points to the field that contains the context, for example, an entity id.
@@ -3068,7 +3198,8 @@ module Google
3068
3198
  # Detailed error codes and messages.
3069
3199
  # @!attribute [rw] timestamps
3070
3200
  # @return [::Array<::Google::Protobuf::Timestamp>]
3071
- # The times the error occurred.
3201
+ # The times the error occurred. List includes the oldest timestamp and the
3202
+ # last 9 timestamps.
3072
3203
  class Error
3073
3204
  include ::Google::Protobuf::MessageExts
3074
3205
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3097,8 +3228,8 @@ module Google
3097
3228
  # a single Schedule trigger and must have at least one object.
3098
3229
  # @!attribute [r] errors
3099
3230
  # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
3100
- # Output only. A stream of errors encountered when the trigger was activated. Repeated
3101
- # errors may result in the JobTrigger automatically being paused.
3231
+ # Output only. A stream of errors encountered when the trigger was activated.
3232
+ # Repeated errors may result in the JobTrigger automatically being paused.
3102
3233
  # Will return the last 100 errors. Whenever the JobTrigger is modified
3103
3234
  # this list will be cleared.
3104
3235
  # @!attribute [r] create_time
@@ -3205,16 +3336,14 @@ module Google
3205
3336
  extend ::Google::Protobuf::MessageExts::ClassMethods
3206
3337
  end
3207
3338
 
3208
- # Publish the result summary of a DlpJob to the Cloud Security
3209
- # Command Center (CSCC Alpha).
3210
- # This action is only available for projects which are parts of
3211
- # an organization and whitelisted for the alpha Cloud Security Command
3212
- # Center.
3213
- # The action will publish the count of finding instances and their info
3214
- # types. The summary of findings will be persisted in CSCC and are governed
3215
- # by CSCC service-specific policy, see
3216
- # https://cloud.google.com/terms/service-terms Only a single instance of this
3217
- # action can be specified. Compatible with: Inspect
3339
+ # Publish the result summary of a DlpJob to [Security Command
3340
+ # Center](https://cloud.google.com/security-command-center). This action is
3341
+ # available for only projects that belong to an organization. This action
3342
+ # publishes the count of finding instances and their infoTypes. The summary
3343
+ # of findings are persisted in Security Command Center and are governed by
3344
+ # [service-specific policies for Security Command
3345
+ # Center](https://cloud.google.com/terms/service-terms). Only a single
3346
+ # instance of this action can be specified. Compatible with: Inspect
3218
3347
  class PublishSummaryToCscc
3219
3348
  include ::Google::Protobuf::MessageExts
3220
3349
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3272,10 +3401,11 @@ module Google
3272
3401
  # message for more information about what is noted).
3273
3402
  # @!attribute [rw] cloud_storage_output
3274
3403
  # @return [::String]
3275
- # Required. User settable Cloud Storage bucket and folders to store de-identified
3276
- # files. This field must be set for cloud storage deidentification. The
3277
- # output Cloud Storage bucket must be different from the input bucket.
3278
- # De-identified files will overwrite files in the output path.
3404
+ # Required. User settable Cloud Storage bucket and folders to store
3405
+ # de-identified files. This field must be set for cloud storage
3406
+ # deidentification. The output Cloud Storage bucket must be different
3407
+ # from the input bucket. De-identified files will overwrite files in the
3408
+ # output path.
3279
3409
  #
3280
3410
  # Form of: gs://bucket/folder/ or gs://bucket
3281
3411
  # @!attribute [rw] file_types_to_transform
@@ -3384,8 +3514,8 @@ module Google
3384
3514
  # Request message for UpdateInspectTemplate.
3385
3515
  # @!attribute [rw] name
3386
3516
  # @return [::String]
3387
- # Required. Resource name of organization and inspectTemplate to be updated, for
3388
- # example `organizations/433245324/inspectTemplates/432452342` or
3517
+ # Required. Resource name of organization and inspectTemplate to be updated,
3518
+ # for example `organizations/433245324/inspectTemplates/432452342` or
3389
3519
  # projects/project-id/inspectTemplates/432452342.
3390
3520
  # @!attribute [rw] inspect_template
3391
3521
  # @return [::Google::Cloud::Dlp::V2::InspectTemplate]
@@ -3401,8 +3531,8 @@ module Google
3401
3531
  # Request message for GetInspectTemplate.
3402
3532
  # @!attribute [rw] name
3403
3533
  # @return [::String]
3404
- # Required. Resource name of the organization and inspectTemplate to be read, for
3405
- # example `organizations/433245324/inspectTemplates/432452342` or
3534
+ # Required. Resource name of the organization and inspectTemplate to be read,
3535
+ # for example `organizations/433245324/inspectTemplates/432452342` or
3406
3536
  # projects/project-id/inspectTemplates/432452342.
3407
3537
  class GetInspectTemplateRequest
3408
3538
  include ::Google::Protobuf::MessageExts
@@ -3434,17 +3564,17 @@ module Google
3434
3564
  # parent=projects/example-project/locations/europe-west3
3435
3565
  # @!attribute [rw] page_token
3436
3566
  # @return [::String]
3437
- # Page token to continue retrieval. Comes from previous call
3567
+ # Page token to continue retrieval. Comes from the previous call
3438
3568
  # to `ListInspectTemplates`.
3439
3569
  # @!attribute [rw] page_size
3440
3570
  # @return [::Integer]
3441
- # Size of the page, can be limited by the server. If zero server returns
3442
- # a page of max size 100.
3571
+ # Size of the page. This value can be limited by the server. If zero server
3572
+ # returns a page of max size 100.
3443
3573
  # @!attribute [rw] order_by
3444
3574
  # @return [::String]
3445
3575
  # Comma separated list of fields to order by,
3446
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
3447
- # default sorting order is ascending, redundant space characters are
3576
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
3577
+ # default sorting order is ascending. Redundant space characters are
3448
3578
  # insignificant.
3449
3579
  #
3450
3580
  # Example: `name asc,update_time, create_time desc`
@@ -3469,8 +3599,8 @@ module Google
3469
3599
  # List of inspectTemplates, up to page_size in ListInspectTemplatesRequest.
3470
3600
  # @!attribute [rw] next_page_token
3471
3601
  # @return [::String]
3472
- # If the next page is available then the next page token to be used
3473
- # in following ListInspectTemplates request.
3602
+ # If the next page is available then the next page token to be used in the
3603
+ # following ListInspectTemplates request.
3474
3604
  class ListInspectTemplatesResponse
3475
3605
  include ::Google::Protobuf::MessageExts
3476
3606
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3479,9 +3609,9 @@ module Google
3479
3609
  # Request message for DeleteInspectTemplate.
3480
3610
  # @!attribute [rw] name
3481
3611
  # @return [::String]
3482
- # Required. Resource name of the organization and inspectTemplate to be deleted, for
3483
- # example `organizations/433245324/inspectTemplates/432452342` or
3484
- # projects/project-id/inspectTemplates/432452342.
3612
+ # Required. Resource name of the organization and inspectTemplate to be
3613
+ # deleted, for example `organizations/433245324/inspectTemplates/432452342`
3614
+ # or projects/project-id/inspectTemplates/432452342.
3485
3615
  class DeleteInspectTemplateRequest
3486
3616
  include ::Google::Protobuf::MessageExts
3487
3617
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3559,6 +3689,122 @@ module Google
3559
3689
  extend ::Google::Protobuf::MessageExts::ClassMethods
3560
3690
  end
3561
3691
 
3692
+ # Request message for CreateDiscoveryConfig.
3693
+ # @!attribute [rw] parent
3694
+ # @return [::String]
3695
+ # Required. Parent resource name.
3696
+ #
3697
+ # The format of this value is as follows:
3698
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
3699
+ #
3700
+ # The following example `parent` string specifies a parent project with the
3701
+ # identifier `example-project`, and specifies the `europe-west3` location
3702
+ # for processing data:
3703
+ #
3704
+ # parent=projects/example-project/locations/europe-west3
3705
+ # @!attribute [rw] discovery_config
3706
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig]
3707
+ # Required. The DiscoveryConfig to create.
3708
+ # @!attribute [rw] config_id
3709
+ # @return [::String]
3710
+ # The config ID can contain uppercase and lowercase letters,
3711
+ # numbers, and hyphens; that is, it must match the regular
3712
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
3713
+ # characters. Can be empty to allow the system to generate one.
3714
+ class CreateDiscoveryConfigRequest
3715
+ include ::Google::Protobuf::MessageExts
3716
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3717
+ end
3718
+
3719
+ # Request message for UpdateDiscoveryConfig.
3720
+ # @!attribute [rw] name
3721
+ # @return [::String]
3722
+ # Required. Resource name of the project and the configuration, for example
3723
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
3724
+ # @!attribute [rw] discovery_config
3725
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig]
3726
+ # Required. New DiscoveryConfig value.
3727
+ # @!attribute [rw] update_mask
3728
+ # @return [::Google::Protobuf::FieldMask]
3729
+ # Mask to control which fields get updated.
3730
+ class UpdateDiscoveryConfigRequest
3731
+ include ::Google::Protobuf::MessageExts
3732
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3733
+ end
3734
+
3735
+ # Request message for GetDiscoveryConfig.
3736
+ # @!attribute [rw] name
3737
+ # @return [::String]
3738
+ # Required. Resource name of the project and the configuration, for example
3739
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
3740
+ class GetDiscoveryConfigRequest
3741
+ include ::Google::Protobuf::MessageExts
3742
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3743
+ end
3744
+
3745
+ # Request message for ListDiscoveryConfigs.
3746
+ # @!attribute [rw] parent
3747
+ # @return [::String]
3748
+ # Required. Parent resource name.
3749
+ #
3750
+ # The format of this value is as follows:
3751
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
3752
+ #
3753
+ # The following example `parent` string specifies a parent project with the
3754
+ # identifier `example-project`, and specifies the `europe-west3` location
3755
+ # for processing data:
3756
+ #
3757
+ # parent=projects/example-project/locations/europe-west3
3758
+ # @!attribute [rw] page_token
3759
+ # @return [::String]
3760
+ # Page token to continue retrieval. Comes from the previous call
3761
+ # to ListDiscoveryConfigs. `order_by` field must not
3762
+ # change for subsequent calls.
3763
+ # @!attribute [rw] page_size
3764
+ # @return [::Integer]
3765
+ # Size of the page. This value can be limited by a server.
3766
+ # @!attribute [rw] order_by
3767
+ # @return [::String]
3768
+ # Comma separated list of config fields to order by,
3769
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
3770
+ # default sorting order is ascending. Redundant space characters are
3771
+ # insignificant.
3772
+ #
3773
+ # Example: `name asc,update_time, create_time desc`
3774
+ #
3775
+ # Supported fields are:
3776
+ #
3777
+ # - `last_run_time`: corresponds to the last time the DiscoveryConfig ran.
3778
+ # - `name`: corresponds to the DiscoveryConfig's name.
3779
+ # - `status`: corresponds to DiscoveryConfig's status.
3780
+ class ListDiscoveryConfigsRequest
3781
+ include ::Google::Protobuf::MessageExts
3782
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3783
+ end
3784
+
3785
+ # Response message for ListDiscoveryConfigs.
3786
+ # @!attribute [rw] discovery_configs
3787
+ # @return [::Array<::Google::Cloud::Dlp::V2::DiscoveryConfig>]
3788
+ # List of configs, up to page_size in ListDiscoveryConfigsRequest.
3789
+ # @!attribute [rw] next_page_token
3790
+ # @return [::String]
3791
+ # If the next page is available then this value is the next page token to be
3792
+ # used in the following ListDiscoveryConfigs request.
3793
+ class ListDiscoveryConfigsResponse
3794
+ include ::Google::Protobuf::MessageExts
3795
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3796
+ end
3797
+
3798
+ # Request message for DeleteDiscoveryConfig.
3799
+ # @!attribute [rw] name
3800
+ # @return [::String]
3801
+ # Required. Resource name of the project and the config, for example
3802
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
3803
+ class DeleteDiscoveryConfigRequest
3804
+ include ::Google::Protobuf::MessageExts
3805
+ extend ::Google::Protobuf::MessageExts::ClassMethods
3806
+ end
3807
+
3562
3808
  # Request message for CreateDlpJobRequest. Used to initiate long running
3563
3809
  # jobs such as calculating risk metrics or inspecting Google Cloud
3564
3810
  # Storage.
@@ -3622,17 +3868,17 @@ module Google
3622
3868
  # parent=projects/example-project/locations/europe-west3
3623
3869
  # @!attribute [rw] page_token
3624
3870
  # @return [::String]
3625
- # Page token to continue retrieval. Comes from previous call
3871
+ # Page token to continue retrieval. Comes from the previous call
3626
3872
  # to ListJobTriggers. `order_by` field must not
3627
3873
  # change for subsequent calls.
3628
3874
  # @!attribute [rw] page_size
3629
3875
  # @return [::Integer]
3630
- # Size of the page, can be limited by a server.
3876
+ # Size of the page. This value can be limited by a server.
3631
3877
  # @!attribute [rw] order_by
3632
3878
  # @return [::String]
3633
3879
  # Comma separated list of triggeredJob fields to order by,
3634
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
3635
- # default sorting order is ascending, redundant space characters are
3880
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
3881
+ # default sorting order is ascending. Redundant space characters are
3636
3882
  # insignificant.
3637
3883
  #
3638
3884
  # Example: `name asc,update_time, create_time desc`
@@ -3688,8 +3934,8 @@ module Google
3688
3934
  # List of triggeredJobs, up to page_size in ListJobTriggersRequest.
3689
3935
  # @!attribute [rw] next_page_token
3690
3936
  # @return [::String]
3691
- # If the next page is available then the next page token to be used
3692
- # in following ListJobTriggers request.
3937
+ # If the next page is available then this value is the next page token to be
3938
+ # used in the following ListJobTriggers request.
3693
3939
  class ListJobTriggersResponse
3694
3940
  include ::Google::Protobuf::MessageExts
3695
3941
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3842,7 +4088,7 @@ module Google
3842
4088
  # scanned.
3843
4089
  #
3844
4090
  # For more information, see
3845
- # https://cloud.google.com/dlp/docs/data-profiles#data_residency.
4091
+ # https://cloud.google.com/dlp/docs/data-profiles#data-residency.
3846
4092
  # @!attribute [rw] data_profile_actions
3847
4093
  # @return [::Array<::Google::Cloud::Dlp::V2::DataProfileAction>]
3848
4094
  # Actions to execute at the completion of the job.
@@ -3851,6 +4097,52 @@ module Google
3851
4097
  extend ::Google::Protobuf::MessageExts::ClassMethods
3852
4098
  end
3853
4099
 
4100
+ # A pattern to match against one or more tables, datasets, or projects that
4101
+ # contain BigQuery tables. At least one pattern must be specified.
4102
+ # Regular expressions use RE2
4103
+ # [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found
4104
+ # under the google/re2 repository on GitHub.
4105
+ # @!attribute [rw] project_id_regex
4106
+ # @return [::String]
4107
+ # For organizations, if unset, will match all projects. Has no effect
4108
+ # for data profile configurations created within a project.
4109
+ # @!attribute [rw] dataset_id_regex
4110
+ # @return [::String]
4111
+ # If unset, this property matches all datasets.
4112
+ # @!attribute [rw] table_id_regex
4113
+ # @return [::String]
4114
+ # If unset, this property matches all tables.
4115
+ class BigQueryRegex
4116
+ include ::Google::Protobuf::MessageExts
4117
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4118
+ end
4119
+
4120
+ # A collection of regular expressions to determine what tables to match
4121
+ # against.
4122
+ # @!attribute [rw] patterns
4123
+ # @return [::Array<::Google::Cloud::Dlp::V2::BigQueryRegex>]
4124
+ # A single BigQuery regular expression pattern to match against one or more
4125
+ # tables, datasets, or projects that contain BigQuery tables.
4126
+ class BigQueryRegexes
4127
+ include ::Google::Protobuf::MessageExts
4128
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4129
+ end
4130
+
4131
+ # The types of BigQuery tables supported by Cloud DLP.
4132
+ # @!attribute [rw] types
4133
+ # @return [::Array<::Google::Cloud::Dlp::V2::BigQueryTableType>]
4134
+ # A set of BigQuery table types.
4135
+ class BigQueryTableTypes
4136
+ include ::Google::Protobuf::MessageExts
4137
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4138
+ end
4139
+
4140
+ # Do not profile the tables.
4141
+ class Disabled
4142
+ include ::Google::Protobuf::MessageExts
4143
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4144
+ end
4145
+
3854
4146
  # The data that will be profiled.
3855
4147
  # @!attribute [rw] organization_id
3856
4148
  # @return [::Integer]
@@ -3863,6 +4155,263 @@ module Google
3863
4155
  extend ::Google::Protobuf::MessageExts::ClassMethods
3864
4156
  end
3865
4157
 
4158
+ # Configuration for discovery to scan resources for profile generation.
4159
+ # Only one discovery configuration may exist per organization, folder,
4160
+ # or project.
4161
+ #
4162
+ # The generated data profiles are retained according to the
4163
+ # [data retention policy]
4164
+ # (https://cloud.google.com/dlp/docs/data-profiles#retention).
4165
+ # @!attribute [rw] name
4166
+ # @return [::String]
4167
+ # Unique resource name for the DiscoveryConfig, assigned by the service when
4168
+ # the DiscoveryConfig is created, for example
4169
+ # `projects/dlp-test-project/locations/global/discoveryConfigs/53234423`.
4170
+ # @!attribute [rw] display_name
4171
+ # @return [::String]
4172
+ # Display name (max 100 chars)
4173
+ # @!attribute [rw] org_config
4174
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig::OrgConfig]
4175
+ # Only set when the parent is an org.
4176
+ # @!attribute [rw] inspect_templates
4177
+ # @return [::Array<::String>]
4178
+ # Detection logic for profile generation.
4179
+ #
4180
+ # Not all template features are used by Discovery. FindingLimits,
4181
+ # include_quote and exclude_info_types have no impact on
4182
+ # Discovery.
4183
+ #
4184
+ # Multiple templates may be provided if there is data in multiple regions.
4185
+ # At most one template must be specified per-region (including "global").
4186
+ # Each region is scanned using the applicable template. If no region-specific
4187
+ # template is specified, but a "global" template is specified, it will be
4188
+ # copied to that region and used instead. If no global or region-specific
4189
+ # template is provided for a region with data, that region's data will not be
4190
+ # scanned.
4191
+ #
4192
+ # For more information, see
4193
+ # https://cloud.google.com/dlp/docs/data-profiles#data-residency.
4194
+ # @!attribute [rw] actions
4195
+ # @return [::Array<::Google::Cloud::Dlp::V2::DataProfileAction>]
4196
+ # Actions to execute at the completion of scanning.
4197
+ # @!attribute [rw] targets
4198
+ # @return [::Array<::Google::Cloud::Dlp::V2::DiscoveryTarget>]
4199
+ # Target to match against for determining what to scan and how frequently.
4200
+ # @!attribute [r] errors
4201
+ # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
4202
+ # Output only. A stream of errors encountered when the config was activated.
4203
+ # Repeated errors may result in the config automatically being paused. Output
4204
+ # only field. Will return the last 100 errors. Whenever the config is
4205
+ # modified this list will be cleared.
4206
+ # @!attribute [r] create_time
4207
+ # @return [::Google::Protobuf::Timestamp]
4208
+ # Output only. The creation timestamp of a DiscoveryConfig.
4209
+ # @!attribute [r] update_time
4210
+ # @return [::Google::Protobuf::Timestamp]
4211
+ # Output only. The last update timestamp of a DiscoveryConfig.
4212
+ # @!attribute [r] last_run_time
4213
+ # @return [::Google::Protobuf::Timestamp]
4214
+ # Output only. The timestamp of the last time this config was executed.
4215
+ # @!attribute [rw] status
4216
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig::Status]
4217
+ # Required. A status for this configuration.
4218
+ class DiscoveryConfig
4219
+ include ::Google::Protobuf::MessageExts
4220
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4221
+
4222
+ # Project and scan location information. Only set when the parent is an org.
4223
+ # @!attribute [rw] location
4224
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryStartingLocation]
4225
+ # The data to scan: folder, org, or project
4226
+ # @!attribute [rw] project_id
4227
+ # @return [::String]
4228
+ # The project that will run the scan. The DLP service
4229
+ # account that exists within this project must have access to all resources
4230
+ # that are profiled, and the Cloud DLP API must be enabled.
4231
+ class OrgConfig
4232
+ include ::Google::Protobuf::MessageExts
4233
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4234
+ end
4235
+
4236
+ # Whether the discovery config is currently active. New options may be added
4237
+ # at a later time.
4238
+ module Status
4239
+ # Unused
4240
+ STATUS_UNSPECIFIED = 0
4241
+
4242
+ # The discovery config is currently active.
4243
+ RUNNING = 1
4244
+
4245
+ # The discovery config is paused temporarily.
4246
+ PAUSED = 2
4247
+ end
4248
+ end
4249
+
4250
+ # Target used to match against for Discovery.
4251
+ # @!attribute [rw] big_query_target
4252
+ # @return [::Google::Cloud::Dlp::V2::BigQueryDiscoveryTarget]
4253
+ # BigQuery target for Discovery. The first target to match a table will be
4254
+ # the one applied.
4255
+ class DiscoveryTarget
4256
+ include ::Google::Protobuf::MessageExts
4257
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4258
+ end
4259
+
4260
+ # Target used to match against for discovery with BigQuery tables
4261
+ # @!attribute [rw] filter
4262
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryBigQueryFilter]
4263
+ # Required. The tables the discovery cadence applies to. The first target
4264
+ # with a matching filter will be the one to apply to a table.
4265
+ # @!attribute [rw] conditions
4266
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryBigQueryConditions]
4267
+ # In addition to matching the filter, these conditions must be true
4268
+ # before a profile is generated.
4269
+ # @!attribute [rw] cadence
4270
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryGenerationCadence]
4271
+ # How often and when to update profiles. New tables that match both the
4272
+ # filter and conditions are scanned as quickly as possible depending on
4273
+ # system capacity.
4274
+ # @!attribute [rw] disabled
4275
+ # @return [::Google::Cloud::Dlp::V2::Disabled]
4276
+ # Tables that match this filter will not have profiles created.
4277
+ class BigQueryDiscoveryTarget
4278
+ include ::Google::Protobuf::MessageExts
4279
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4280
+ end
4281
+
4282
+ # Determines what tables will have profiles generated within an organization
4283
+ # or project. Includes the ability to filter by regular expression patterns
4284
+ # on project ID, dataset ID, and table ID.
4285
+ # @!attribute [rw] tables
4286
+ # @return [::Google::Cloud::Dlp::V2::BigQueryTableCollection]
4287
+ # A specific set of tables for this filter to apply to. A table collection
4288
+ # must be specified in only one filter per config.
4289
+ # If a table id or dataset is empty, Cloud DLP assumes all tables in that
4290
+ # collection must be profiled. Must specify a project ID.
4291
+ # @!attribute [rw] other_tables
4292
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryBigQueryFilter::AllOtherBigQueryTables]
4293
+ # Catch-all. This should always be the last filter in the list because
4294
+ # anything above it will apply first. Should only appear once in a
4295
+ # configuration. If none is specified, a default one will be added
4296
+ # automatically.
4297
+ class DiscoveryBigQueryFilter
4298
+ include ::Google::Protobuf::MessageExts
4299
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4300
+
4301
+ # Catch-all for all other tables not specified by other filters. Should
4302
+ # always be last, except for single-table configurations, which will only
4303
+ # have a TableReference target.
4304
+ class AllOtherBigQueryTables
4305
+ include ::Google::Protobuf::MessageExts
4306
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4307
+ end
4308
+ end
4309
+
4310
+ # Specifies a collection of BigQuery tables. Used for Discovery.
4311
+ # @!attribute [rw] include_regexes
4312
+ # @return [::Google::Cloud::Dlp::V2::BigQueryRegexes]
4313
+ # A collection of regular expressions to match a BigQuery table against.
4314
+ class BigQueryTableCollection
4315
+ include ::Google::Protobuf::MessageExts
4316
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4317
+ end
4318
+
4319
+ # Requirements that must be true before a table is scanned in discovery for the
4320
+ # first time. There is an AND relationship between the top-level attributes.
4321
+ # Additionally, minimum conditions with an OR relationship that must be met
4322
+ # before Cloud DLP scans a table can be set (like a minimum row count or a
4323
+ # minimum table age).
4324
+ # @!attribute [rw] created_after
4325
+ # @return [::Google::Protobuf::Timestamp]
4326
+ # BigQuery table must have been created after this date. Used to avoid
4327
+ # backfilling.
4328
+ # @!attribute [rw] types
4329
+ # @return [::Google::Cloud::Dlp::V2::BigQueryTableTypes]
4330
+ # Restrict discovery to specific table types.
4331
+ # @!attribute [rw] type_collection
4332
+ # @return [::Google::Cloud::Dlp::V2::BigQueryTableTypeCollection]
4333
+ # Restrict discovery to categories of table types.
4334
+ # @!attribute [rw] or_conditions
4335
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryBigQueryConditions::OrConditions]
4336
+ # At least one of the conditions must be true for a table to be scanned.
4337
+ class DiscoveryBigQueryConditions
4338
+ include ::Google::Protobuf::MessageExts
4339
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4340
+
4341
+ # There is an OR relationship between these attributes. They are used to
4342
+ # determine if a table should be scanned or not in Discovery.
4343
+ # @!attribute [rw] min_row_count
4344
+ # @return [::Integer]
4345
+ # Minimum number of rows that should be present before Cloud DLP
4346
+ # profiles a table
4347
+ # @!attribute [rw] min_age
4348
+ # @return [::Google::Protobuf::Duration]
4349
+ # Minimum age a table must have before Cloud DLP can profile it. Value must
4350
+ # be 1 hour or greater.
4351
+ class OrConditions
4352
+ include ::Google::Protobuf::MessageExts
4353
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4354
+ end
4355
+ end
4356
+
4357
+ # What must take place for a profile to be updated and how
4358
+ # frequently it should occur.
4359
+ # New tables are scanned as quickly as possible depending on system
4360
+ # capacity.
4361
+ # @!attribute [rw] schema_modified_cadence
4362
+ # @return [::Google::Cloud::Dlp::V2::DiscoverySchemaModifiedCadence]
4363
+ # Governs when to update data profiles when a schema is modified.
4364
+ # @!attribute [rw] table_modified_cadence
4365
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryTableModifiedCadence]
4366
+ # Governs when to update data profiles when a table is modified.
4367
+ class DiscoveryGenerationCadence
4368
+ include ::Google::Protobuf::MessageExts
4369
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4370
+ end
4371
+
4372
+ # The cadence at which to update data profiles when a table is modified.
4373
+ # @!attribute [rw] types
4374
+ # @return [::Array<::Google::Cloud::Dlp::V2::BigQueryTableModification>]
4375
+ # The type of events to consider when deciding if the table has been
4376
+ # modified and should have the profile updated. Defaults to
4377
+ # MODIFIED_TIMESTAMP.
4378
+ # @!attribute [rw] frequency
4379
+ # @return [::Google::Cloud::Dlp::V2::DataProfileUpdateFrequency]
4380
+ # How frequently data profiles can be updated when tables are modified.
4381
+ # Defaults to never.
4382
+ class DiscoveryTableModifiedCadence
4383
+ include ::Google::Protobuf::MessageExts
4384
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4385
+ end
4386
+
4387
+ # The cadence at which to update data profiles when a schema is modified.
4388
+ # @!attribute [rw] types
4389
+ # @return [::Array<::Google::Cloud::Dlp::V2::BigQuerySchemaModification>]
4390
+ # The type of events to consider when deciding if the table's schema
4391
+ # has been modified and should have the profile updated. Defaults to
4392
+ # NEW_COLUMNS.
4393
+ # @!attribute [rw] frequency
4394
+ # @return [::Google::Cloud::Dlp::V2::DataProfileUpdateFrequency]
4395
+ # How frequently profiles may be updated when schemas are
4396
+ # modified. Defaults to monthly.
4397
+ class DiscoverySchemaModifiedCadence
4398
+ include ::Google::Protobuf::MessageExts
4399
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4400
+ end
4401
+
4402
+ # The location to begin a discovery scan. Denotes an organization ID or folder
4403
+ # ID within an organization.
4404
+ # @!attribute [rw] organization_id
4405
+ # @return [::Integer]
4406
+ # The ID of an organization to scan.
4407
+ # @!attribute [rw] folder_id
4408
+ # @return [::Integer]
4409
+ # The ID of the Folder within an organization to scan.
4410
+ class DiscoveryStartingLocation
4411
+ include ::Google::Protobuf::MessageExts
4412
+ extend ::Google::Protobuf::MessageExts::ClassMethods
4413
+ end
4414
+
3866
4415
  # Combines all of the information about a DLP job.
3867
4416
  # @!attribute [rw] name
3868
4417
  # @return [::String]
@@ -3888,6 +4437,9 @@ module Google
3888
4437
  # @!attribute [rw] end_time
3889
4438
  # @return [::Google::Protobuf::Timestamp]
3890
4439
  # Time when the job finished.
4440
+ # @!attribute [rw] last_modified
4441
+ # @return [::Google::Protobuf::Timestamp]
4442
+ # Time when the job was last modified by the system.
3891
4443
  # @!attribute [rw] job_trigger_name
3892
4444
  # @return [::String]
3893
4445
  # If created by a job trigger, the resource name of the trigger that
@@ -3895,6 +4447,9 @@ module Google
3895
4447
  # @!attribute [rw] errors
3896
4448
  # @return [::Array<::Google::Cloud::Dlp::V2::Error>]
3897
4449
  # A stream of errors encountered running the job.
4450
+ # @!attribute [rw] action_details
4451
+ # @return [::Array<::Google::Cloud::Dlp::V2::ActionDetails>]
4452
+ # Events that should occur after the job has completed.
3898
4453
  class DlpJob
3899
4454
  include ::Google::Protobuf::MessageExts
3900
4455
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3998,8 +4553,8 @@ module Google
3998
4553
  # @!attribute [rw] order_by
3999
4554
  # @return [::String]
4000
4555
  # Comma separated list of fields to order by,
4001
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
4002
- # default sorting order is ascending, redundant space characters are
4556
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
4557
+ # default sorting order is ascending. Redundant space characters are
4003
4558
  # insignificant.
4004
4559
  #
4005
4560
  # Example: `name asc, end_time asc, create_time desc`
@@ -4100,8 +4655,9 @@ module Google
4100
4655
  # Request message for UpdateDeidentifyTemplate.
4101
4656
  # @!attribute [rw] name
4102
4657
  # @return [::String]
4103
- # Required. Resource name of organization and deidentify template to be updated, for
4104
- # example `organizations/433245324/deidentifyTemplates/432452342` or
4658
+ # Required. Resource name of organization and deidentify template to be
4659
+ # updated, for example
4660
+ # `organizations/433245324/deidentifyTemplates/432452342` or
4105
4661
  # projects/project-id/deidentifyTemplates/432452342.
4106
4662
  # @!attribute [rw] deidentify_template
4107
4663
  # @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
@@ -4117,9 +4673,9 @@ module Google
4117
4673
  # Request message for GetDeidentifyTemplate.
4118
4674
  # @!attribute [rw] name
4119
4675
  # @return [::String]
4120
- # Required. Resource name of the organization and deidentify template to be read, for
4121
- # example `organizations/433245324/deidentifyTemplates/432452342` or
4122
- # projects/project-id/deidentifyTemplates/432452342.
4676
+ # Required. Resource name of the organization and deidentify template to be
4677
+ # read, for example `organizations/433245324/deidentifyTemplates/432452342`
4678
+ # or projects/project-id/deidentifyTemplates/432452342.
4123
4679
  class GetDeidentifyTemplateRequest
4124
4680
  include ::Google::Protobuf::MessageExts
4125
4681
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -4150,17 +4706,17 @@ module Google
4150
4706
  # parent=projects/example-project/locations/europe-west3
4151
4707
  # @!attribute [rw] page_token
4152
4708
  # @return [::String]
4153
- # Page token to continue retrieval. Comes from previous call
4709
+ # Page token to continue retrieval. Comes from the previous call
4154
4710
  # to `ListDeidentifyTemplates`.
4155
4711
  # @!attribute [rw] page_size
4156
4712
  # @return [::Integer]
4157
- # Size of the page, can be limited by the server. If zero server returns
4158
- # a page of max size 100.
4713
+ # Size of the page. This value can be limited by the server. If zero server
4714
+ # returns a page of max size 100.
4159
4715
  # @!attribute [rw] order_by
4160
4716
  # @return [::String]
4161
4717
  # Comma separated list of fields to order by,
4162
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
4163
- # default sorting order is ascending, redundant space characters are
4718
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
4719
+ # default sorting order is ascending. Redundant space characters are
4164
4720
  # insignificant.
4165
4721
  #
4166
4722
  # Example: `name asc,update_time, create_time desc`
@@ -4186,8 +4742,8 @@ module Google
4186
4742
  # ListDeidentifyTemplatesRequest.
4187
4743
  # @!attribute [rw] next_page_token
4188
4744
  # @return [::String]
4189
- # If the next page is available then the next page token to be used
4190
- # in following ListDeidentifyTemplates request.
4745
+ # If the next page is available then the next page token to be used in the
4746
+ # following ListDeidentifyTemplates request.
4191
4747
  class ListDeidentifyTemplatesResponse
4192
4748
  include ::Google::Protobuf::MessageExts
4193
4749
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -4196,8 +4752,9 @@ module Google
4196
4752
  # Request message for DeleteDeidentifyTemplate.
4197
4753
  # @!attribute [rw] name
4198
4754
  # @return [::String]
4199
- # Required. Resource name of the organization and deidentify template to be deleted,
4200
- # for example `organizations/433245324/deidentifyTemplates/432452342` or
4755
+ # Required. Resource name of the organization and deidentify template to be
4756
+ # deleted, for example
4757
+ # `organizations/433245324/deidentifyTemplates/432452342` or
4201
4758
  # projects/project-id/deidentifyTemplates/432452342.
4202
4759
  class DeleteDeidentifyTemplateRequest
4203
4760
  include ::Google::Protobuf::MessageExts
@@ -4364,8 +4921,8 @@ module Google
4364
4921
  # Request message for UpdateStoredInfoType.
4365
4922
  # @!attribute [rw] name
4366
4923
  # @return [::String]
4367
- # Required. Resource name of organization and storedInfoType to be updated, for
4368
- # example `organizations/433245324/storedInfoTypes/432452342` or
4924
+ # Required. Resource name of organization and storedInfoType to be updated,
4925
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
4369
4926
  # projects/project-id/storedInfoTypes/432452342.
4370
4927
  # @!attribute [rw] config
4371
4928
  # @return [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig]
@@ -4383,8 +4940,8 @@ module Google
4383
4940
  # Request message for GetStoredInfoType.
4384
4941
  # @!attribute [rw] name
4385
4942
  # @return [::String]
4386
- # Required. Resource name of the organization and storedInfoType to be read, for
4387
- # example `organizations/433245324/storedInfoTypes/432452342` or
4943
+ # Required. Resource name of the organization and storedInfoType to be read,
4944
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
4388
4945
  # projects/project-id/storedInfoTypes/432452342.
4389
4946
  class GetStoredInfoTypeRequest
4390
4947
  include ::Google::Protobuf::MessageExts
@@ -4412,17 +4969,17 @@ module Google
4412
4969
  # parent=projects/example-project/locations/europe-west3
4413
4970
  # @!attribute [rw] page_token
4414
4971
  # @return [::String]
4415
- # Page token to continue retrieval. Comes from previous call
4972
+ # Page token to continue retrieval. Comes from the previous call
4416
4973
  # to `ListStoredInfoTypes`.
4417
4974
  # @!attribute [rw] page_size
4418
4975
  # @return [::Integer]
4419
- # Size of the page, can be limited by the server. If zero server returns
4420
- # a page of max size 100.
4976
+ # Size of the page. This value can be limited by the server. If zero server
4977
+ # returns a page of max size 100.
4421
4978
  # @!attribute [rw] order_by
4422
4979
  # @return [::String]
4423
4980
  # Comma separated list of fields to order by,
4424
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
4425
- # default sorting order is ascending, redundant space characters are
4981
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
4982
+ # default sorting order is ascending. Redundant space characters are
4426
4983
  # insignificant.
4427
4984
  #
4428
4985
  # Example: `name asc, display_name, create_time desc`
@@ -4449,7 +5006,7 @@ module Google
4449
5006
  # @!attribute [rw] next_page_token
4450
5007
  # @return [::String]
4451
5008
  # If the next page is available then the next page token to be used
4452
- # in following ListStoredInfoTypes request.
5009
+ # in the following ListStoredInfoTypes request.
4453
5010
  class ListStoredInfoTypesResponse
4454
5011
  include ::Google::Protobuf::MessageExts
4455
5012
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -4458,8 +5015,8 @@ module Google
4458
5015
  # Request message for DeleteStoredInfoType.
4459
5016
  # @!attribute [rw] name
4460
5017
  # @return [::String]
4461
- # Required. Resource name of the organization and storedInfoType to be deleted, for
4462
- # example `organizations/433245324/storedInfoTypes/432452342` or
5018
+ # Required. Resource name of the organization and storedInfoType to be
5019
+ # deleted, for example `organizations/433245324/storedInfoTypes/432452342` or
4463
5020
  # projects/project-id/storedInfoTypes/432452342.
4464
5021
  class DeleteStoredInfoTypeRequest
4465
5022
  include ::Google::Protobuf::MessageExts
@@ -4469,8 +5026,8 @@ module Google
4469
5026
  # Request to search for potentially sensitive info in a custom location.
4470
5027
  # @!attribute [rw] name
4471
5028
  # @return [::String]
4472
- # Required. Resource name of the trigger to execute a hybrid inspect on, for example
4473
- # `projects/dlp-test-project/jobTriggers/53234423`.
5029
+ # Required. Resource name of the trigger to execute a hybrid inspect on, for
5030
+ # example `projects/dlp-test-project/jobTriggers/53234423`.
4474
5031
  # @!attribute [rw] hybrid_item
4475
5032
  # @return [::Google::Cloud::Dlp::V2::HybridContentItem]
4476
5033
  # The item to inspect.
@@ -4482,8 +5039,8 @@ module Google
4482
5039
  # Request to search for potentially sensitive info in a custom location.
4483
5040
  # @!attribute [rw] name
4484
5041
  # @return [::String]
4485
- # Required. Resource name of the job to execute a hybrid inspect on, for example
4486
- # `projects/dlp-test-project/dlpJob/53234423`.
5042
+ # Required. Resource name of the job to execute a hybrid inspect on, for
5043
+ # example `projects/dlp-test-project/dlpJob/53234423`.
4487
5044
  # @!attribute [rw] hybrid_item
4488
5045
  # @return [::Google::Cloud::Dlp::V2::HybridContentItem]
4489
5046
  # The item to inspect.
@@ -4618,7 +5175,7 @@ module Google
4618
5175
  # The resource name to the project data profile for this table.
4619
5176
  # @!attribute [rw] dataset_project_id
4620
5177
  # @return [::String]
4621
- # The GCP project ID that owns the BigQuery dataset.
5178
+ # The Google Cloud project ID that owns the BigQuery dataset.
4622
5179
  # @!attribute [rw] dataset_location
4623
5180
  # @return [::String]
4624
5181
  # The BigQuery location where the dataset's data is stored.
@@ -4721,7 +5278,8 @@ module Google
4721
5278
 
4722
5279
  # @!attribute [rw] status
4723
5280
  # @return [::Google::Rpc::Status]
4724
- # Profiling status code and optional message
5281
+ # Profiling status code and optional message. The `status.code` value is 0
5282
+ # (default value) for OK.
4725
5283
  # @!attribute [rw] timestamp
4726
5284
  # @return [::Google::Protobuf::Timestamp]
4727
5285
  # Time when the profile generation status was updated
@@ -4735,6 +5293,7 @@ module Google
4735
5293
  # @return [::Google::Cloud::Dlp::V2::InfoType]
4736
5294
  # The infoType.
4737
5295
  # @!attribute [rw] estimated_prevalence
5296
+ # @deprecated This field is deprecated and may be removed in the next major version update.
4738
5297
  # @return [::Integer]
4739
5298
  # Not populated for predicted infotypes.
4740
5299
  class InfoTypeSummary
@@ -4750,11 +5309,162 @@ module Google
4750
5309
  # @return [::Integer]
4751
5310
  # Approximate percentage of non-null rows that contained data detected by
4752
5311
  # this infotype.
5312
+ # @!attribute [rw] excluded_from_analysis
5313
+ # @return [::Boolean]
5314
+ # Whether this infoType was excluded from sensitivity and risk analysis due
5315
+ # to factors such as low prevalence (subject to change).
4753
5316
  class OtherInfoTypeSummary
4754
5317
  include ::Google::Protobuf::MessageExts
4755
5318
  extend ::Google::Protobuf::MessageExts::ClassMethods
4756
5319
  end
4757
5320
 
5321
+ # The profile for a scanned column within a table.
5322
+ # @!attribute [rw] name
5323
+ # @return [::String]
5324
+ # The name of the profile.
5325
+ # @!attribute [rw] profile_status
5326
+ # @return [::Google::Cloud::Dlp::V2::ProfileStatus]
5327
+ # Success or error status from the most recent profile generation attempt.
5328
+ # May be empty if the profile is still being generated.
5329
+ # @!attribute [rw] state
5330
+ # @return [::Google::Cloud::Dlp::V2::ColumnDataProfile::State]
5331
+ # State of a profile.
5332
+ # @!attribute [rw] profile_last_generated
5333
+ # @return [::Google::Protobuf::Timestamp]
5334
+ # The last time the profile was generated.
5335
+ # @!attribute [rw] table_data_profile
5336
+ # @return [::String]
5337
+ # The resource name of the table data profile.
5338
+ # @!attribute [rw] table_full_resource
5339
+ # @return [::String]
5340
+ # The resource name of the table this column is within.
5341
+ # @!attribute [rw] dataset_project_id
5342
+ # @return [::String]
5343
+ # The Google Cloud project ID that owns the BigQuery dataset.
5344
+ # @!attribute [rw] dataset_location
5345
+ # @return [::String]
5346
+ # The BigQuery location where the dataset's data is stored.
5347
+ # See https://cloud.google.com/bigquery/docs/locations for supported
5348
+ # locations.
5349
+ # @!attribute [rw] dataset_id
5350
+ # @return [::String]
5351
+ # The BigQuery dataset ID.
5352
+ # @!attribute [rw] table_id
5353
+ # @return [::String]
5354
+ # The BigQuery table ID.
5355
+ # @!attribute [rw] column
5356
+ # @return [::String]
5357
+ # The name of the column.
5358
+ # @!attribute [rw] sensitivity_score
5359
+ # @return [::Google::Cloud::Dlp::V2::SensitivityScore]
5360
+ # The sensitivity of this column.
5361
+ # @!attribute [rw] data_risk_level
5362
+ # @return [::Google::Cloud::Dlp::V2::DataRiskLevel]
5363
+ # The data risk level for this column.
5364
+ # @!attribute [rw] column_info_type
5365
+ # @return [::Google::Cloud::Dlp::V2::InfoTypeSummary]
5366
+ # If it's been determined this column can be identified as a single type,
5367
+ # this will be set. Otherwise the column either has unidentifiable content
5368
+ # or mixed types.
5369
+ # @!attribute [rw] other_matches
5370
+ # @return [::Array<::Google::Cloud::Dlp::V2::OtherInfoTypeSummary>]
5371
+ # Other types found within this column. List will be unordered.
5372
+ # @!attribute [rw] estimated_null_percentage
5373
+ # @return [::Google::Cloud::Dlp::V2::NullPercentageLevel]
5374
+ # Approximate percentage of entries being null in the column.
5375
+ # @!attribute [rw] estimated_uniqueness_score
5376
+ # @return [::Google::Cloud::Dlp::V2::UniquenessScoreLevel]
5377
+ # Approximate uniqueness of the column.
5378
+ # @!attribute [rw] free_text_score
5379
+ # @return [::Float]
5380
+ # The likelihood that this column contains free-form text.
5381
+ # A value close to 1 may indicate the column is likely to contain
5382
+ # free-form or natural language text.
5383
+ # Range in 0-1.
5384
+ # @!attribute [rw] column_type
5385
+ # @return [::Google::Cloud::Dlp::V2::ColumnDataProfile::ColumnDataType]
5386
+ # The data type of a given column.
5387
+ # @!attribute [rw] policy_state
5388
+ # @return [::Google::Cloud::Dlp::V2::ColumnDataProfile::ColumnPolicyState]
5389
+ # Indicates if a policy tag has been applied to the column.
5390
+ class ColumnDataProfile
5391
+ include ::Google::Protobuf::MessageExts
5392
+ extend ::Google::Protobuf::MessageExts::ClassMethods
5393
+
5394
+ # Possible states of a profile. New items may be added.
5395
+ module State
5396
+ # Unused.
5397
+ STATE_UNSPECIFIED = 0
5398
+
5399
+ # The profile is currently running. Once a profile has finished it will
5400
+ # transition to DONE.
5401
+ RUNNING = 1
5402
+
5403
+ # The profile is no longer generating.
5404
+ # If profile_status.status.code is 0, the profile succeeded, otherwise, it
5405
+ # failed.
5406
+ DONE = 2
5407
+ end
5408
+
5409
+ # Data types of the data in a column. Types may be added over time.
5410
+ module ColumnDataType
5411
+ # Invalid type.
5412
+ COLUMN_DATA_TYPE_UNSPECIFIED = 0
5413
+
5414
+ # Encoded as a string in decimal format.
5415
+ TYPE_INT64 = 1
5416
+
5417
+ # Encoded as a boolean "false" or "true".
5418
+ TYPE_BOOL = 2
5419
+
5420
+ # Encoded as a number, or string "NaN", "Infinity" or "-Infinity".
5421
+ TYPE_FLOAT64 = 3
5422
+
5423
+ # Encoded as a string value.
5424
+ TYPE_STRING = 4
5425
+
5426
+ # Encoded as a base64 string per RFC 4648, section 4.
5427
+ TYPE_BYTES = 5
5428
+
5429
+ # Encoded as an RFC 3339 timestamp with mandatory "Z" time zone string:
5430
+ # 1985-04-12T23:20:50.52Z
5431
+ TYPE_TIMESTAMP = 6
5432
+
5433
+ # Encoded as RFC 3339 full-date format string: 1985-04-12
5434
+ TYPE_DATE = 7
5435
+
5436
+ # Encoded as RFC 3339 partial-time format string: 23:20:50.52
5437
+ TYPE_TIME = 8
5438
+
5439
+ # Encoded as RFC 3339 full-date "T" partial-time: 1985-04-12T23:20:50.52
5440
+ TYPE_DATETIME = 9
5441
+
5442
+ # Encoded as WKT
5443
+ TYPE_GEOGRAPHY = 10
5444
+
5445
+ # Encoded as a decimal string.
5446
+ TYPE_NUMERIC = 11
5447
+
5448
+ # Container of ordered fields, each with a type and field name.
5449
+ TYPE_RECORD = 12
5450
+
5451
+ # Decimal type.
5452
+ TYPE_BIGNUMERIC = 13
5453
+
5454
+ # Json type.
5455
+ TYPE_JSON = 14
5456
+ end
5457
+
5458
+ # The possible policy states for a column.
5459
+ module ColumnPolicyState
5460
+ # No policy tags.
5461
+ COLUMN_POLICY_STATE_UNSPECIFIED = 0
5462
+
5463
+ # Column has policy tag applied.
5464
+ COLUMN_POLICY_TAGGED = 1
5465
+ end
5466
+ end
5467
+
4758
5468
  # A condition for determining whether a Pub/Sub should be triggered.
4759
5469
  # @!attribute [rw] expressions
4760
5470
  # @return [::Google::Cloud::Dlp::V2::DataProfilePubSubCondition::PubSubExpressions]
@@ -4913,6 +5623,79 @@ module Google
4913
5623
  REDACT_IMAGE = 14
4914
5624
  end
4915
5625
 
5626
+ # Over time new types may be added. Currently VIEW, MATERIALIZED_VIEW,
5627
+ # and SNAPSHOT are not supported.
5628
+ module BigQueryTableTypeCollection
5629
+ # Unused.
5630
+ BIG_QUERY_COLLECTION_UNSPECIFIED = 0
5631
+
5632
+ # Automatically generate profiles for all tables, even if the table type is
5633
+ # not yet fully supported for analysis. Profiles for unsupported tables will
5634
+ # be generated with errors to indicate their partial support. When full
5635
+ # support is added, the tables will automatically be profiled during the next
5636
+ # scheduled run.
5637
+ BIG_QUERY_COLLECTION_ALL_TYPES = 1
5638
+
5639
+ # Only those types fully supported will be profiled. Will expand
5640
+ # automatically as Cloud DLP adds support for new table types. Unsupported
5641
+ # table types will not have partial profiles generated.
5642
+ BIG_QUERY_COLLECTION_ONLY_SUPPORTED_TYPES = 2
5643
+ end
5644
+
5645
+ # Over time new types may be added. Currently VIEW, MATERIALIZED_VIEW,
5646
+ # SNAPSHOT, and non-BigLake external tables are not supported.
5647
+ module BigQueryTableType
5648
+ # Unused.
5649
+ BIG_QUERY_TABLE_TYPE_UNSPECIFIED = 0
5650
+
5651
+ # A normal BigQuery table.
5652
+ BIG_QUERY_TABLE_TYPE_TABLE = 1
5653
+
5654
+ # A table that references data stored in Cloud Storage.
5655
+ BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE = 2
5656
+ end
5657
+
5658
+ # How frequently data profiles can be updated. New options can be added at a
5659
+ # later time.
5660
+ module DataProfileUpdateFrequency
5661
+ # Unspecified.
5662
+ UPDATE_FREQUENCY_UNSPECIFIED = 0
5663
+
5664
+ # After the data profile is created, it will never be updated.
5665
+ UPDATE_FREQUENCY_NEVER = 1
5666
+
5667
+ # The data profile can be updated up to once every 24 hours.
5668
+ UPDATE_FREQUENCY_DAILY = 2
5669
+
5670
+ # The data profile can be updated up to once every 30 days. Default.
5671
+ UPDATE_FREQUENCY_MONTHLY = 4
5672
+ end
5673
+
5674
+ # Attributes evaluated to determine if a table has been modified. New values
5675
+ # may be added at a later time.
5676
+ module BigQueryTableModification
5677
+ # Unused.
5678
+ TABLE_MODIFICATION_UNSPECIFIED = 0
5679
+
5680
+ # A table will be considered modified when the last_modified_time from
5681
+ # BigQuery has been updated.
5682
+ TABLE_MODIFIED_TIMESTAMP = 1
5683
+ end
5684
+
5685
+ # Attributes evaluated to determine if a schema has been modified. New values
5686
+ # may be added at a later time.
5687
+ module BigQuerySchemaModification
5688
+ # Unused
5689
+ SCHEMA_MODIFICATION_UNSPECIFIED = 0
5690
+
5691
+ # Profiles should be regenerated when new columns are added to the table.
5692
+ # Default.
5693
+ SCHEMA_NEW_COLUMNS = 1
5694
+
5695
+ # Profiles should be regenerated when columns are removed from the table.
5696
+ SCHEMA_REMOVED_COLUMNS = 2
5697
+ end
5698
+
4916
5699
  # Operators available for comparing the value of fields.
4917
5700
  module RelationalOperator
4918
5701
  # Unused
@@ -5059,6 +5842,43 @@ module Google
5059
5842
  # Customer provides the key.
5060
5843
  ENCRYPTION_CUSTOMER_MANAGED = 2
5061
5844
  end
5845
+
5846
+ # Bucketized nullness percentage levels. A higher level means a higher
5847
+ # percentage of the column is null.
5848
+ module NullPercentageLevel
5849
+ # Unused.
5850
+ NULL_PERCENTAGE_LEVEL_UNSPECIFIED = 0
5851
+
5852
+ # Very few null entries.
5853
+ NULL_PERCENTAGE_VERY_LOW = 1
5854
+
5855
+ # Some null entries.
5856
+ NULL_PERCENTAGE_LOW = 2
5857
+
5858
+ NULL_PERCENTAGE_MEDIUM = 3
5859
+
5860
+ # A lot of null entries.
5861
+ NULL_PERCENTAGE_HIGH = 4
5862
+ end
5863
+
5864
+ # Bucketized uniqueness score levels. A higher uniqueness score is a strong
5865
+ # signal that the column may contain a unique identifier like user id. A low
5866
+ # value indicates that the column contains few unique values like booleans or
5867
+ # other classifiers.
5868
+ module UniquenessScoreLevel
5869
+ # Some columns do not have estimated uniqueness. Possible reasons include
5870
+ # having too few values.
5871
+ UNIQUENESS_SCORE_LEVEL_UNSPECIFIED = 0
5872
+
5873
+ # Low uniqueness, possibly a boolean, enum or similiarly typed column.
5874
+ UNIQUENESS_SCORE_LOW = 1
5875
+
5876
+ # Medium uniqueness.
5877
+ UNIQUENESS_SCORE_MEDIUM = 2
5878
+
5879
+ # High uniqueness, possibly a column of free text or unique identifiers.
5880
+ UNIQUENESS_SCORE_HIGH = 3
5881
+ end
5062
5882
  end
5063
5883
  end
5064
5884
  end