google-cloud-dlp-v2 0.1.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.
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ # This gem does not autoload during Bundler.require. To load this gem,
20
+ # issue explicit require statements for the packages desired, e.g.:
21
+ # require "google/cloud/dlp/v2"
@@ -0,0 +1,15 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/cloud/common_resources.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/api/resource_pb'
7
+ Google::Protobuf::DescriptorPool.generated_pool.build do
8
+ add_file("google/cloud/common_resources.proto", :syntax => :proto3) do
9
+ end
10
+ end
11
+
12
+ module Google
13
+ module Cloud
14
+ end
15
+ end
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/dlp/v2/dlp_service"
20
+ require "google/cloud/dlp/v2/version"
21
+
22
+ module Google
23
+ module Cloud
24
+ module Dlp
25
+ ##
26
+ # To load this package, including all its services, and instantiate a client:
27
+ #
28
+ # require "google/cloud/dlp/v2"
29
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
30
+ #
31
+ module V2
32
+ end
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,57 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/dlp/v2/version"
24
+
25
+ require "google/cloud/dlp/v2/dlp_service/credentials"
26
+ require "google/cloud/dlp/v2/dlp_service/paths"
27
+ require "google/cloud/dlp/v2/dlp_service/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module Dlp
32
+ module V2
33
+ ##
34
+ # The Cloud Data Loss Prevention (DLP) API is a service that allows clients
35
+ # to detect the presence of Personally Identifiable Information (PII) and other
36
+ # privacy-sensitive data in user-supplied, unstructured data streams, like text
37
+ # blocks or images.
38
+ # The service also includes methods for sensitive data redaction and
39
+ # scheduling of data scans on Google Cloud Platform based data sets.
40
+ #
41
+ # To learn more about concepts and find how-to guides see
42
+ # https://cloud.google.com/dlp/docs/.
43
+ #
44
+ # To load this service and instantiate a client:
45
+ #
46
+ # require "google/cloud/dlp/v2/dlp_service"
47
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
48
+ #
49
+ module DlpService
50
+ end
51
+ end
52
+ end
53
+ end
54
+ end
55
+
56
+ helper_path = ::File.join __dir__, "dlp_service", "helpers.rb"
57
+ require "google/cloud/dlp/v2/dlp_service/helpers" if ::File.file? helper_path
@@ -0,0 +1,3448 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/privacy/dlp/v2/dlp_pb"
21
+
22
+ module Google
23
+ module Cloud
24
+ module Dlp
25
+ module V2
26
+ module DlpService
27
+ ##
28
+ # Client for the DlpService service.
29
+ #
30
+ # The Cloud Data Loss Prevention (DLP) API is a service that allows clients
31
+ # to detect the presence of Personally Identifiable Information (PII) and other
32
+ # privacy-sensitive data in user-supplied, unstructured data streams, like text
33
+ # blocks or images.
34
+ # The service also includes methods for sensitive data redaction and
35
+ # scheduling of data scans on Google Cloud Platform based data sets.
36
+ #
37
+ # To learn more about concepts and find how-to guides see
38
+ # https://cloud.google.com/dlp/docs/.
39
+ #
40
+ class Client
41
+ include Paths
42
+
43
+ # @private
44
+ attr_reader :dlp_service_stub
45
+
46
+ ##
47
+ # Configure the DlpService Client class.
48
+ #
49
+ # See {Google::Cloud::Dlp::V2::DlpService::Client::Configuration}
50
+ # for a description of the configuration fields.
51
+ #
52
+ # ## Example
53
+ #
54
+ # To modify the configuration for all DlpService clients:
55
+ #
56
+ # Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
57
+ # config.timeout = 10_000
58
+ # end
59
+ #
60
+ # @yield [config] Configure the Client client.
61
+ # @yieldparam config [Client::Configuration]
62
+ #
63
+ # @return [Client::Configuration]
64
+ #
65
+ def self.configure
66
+ @configure ||= begin
67
+ namespace = ["Google", "Cloud", "Dlp", "V2"]
68
+ parent_config = while namespace.any?
69
+ parent_name = namespace.join "::"
70
+ parent_const = const_get parent_name
71
+ break parent_const.configure if parent_const&.respond_to? :configure
72
+ namespace.pop
73
+ end
74
+ default_config = Client::Configuration.new parent_config
75
+
76
+ default_config.rpcs.inspect_content.timeout = 300.0
77
+ default_config.rpcs.inspect_content.retry_policy = {
78
+ initial_delay: 0.1,
79
+ max_delay: 60.0,
80
+ multiplier: 1.3,
81
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
82
+ }
83
+
84
+ default_config.rpcs.redact_image.timeout = 300.0
85
+ default_config.rpcs.redact_image.retry_policy = {
86
+ initial_delay: 0.1,
87
+ max_delay: 60.0,
88
+ multiplier: 1.3,
89
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
90
+ }
91
+
92
+ default_config.rpcs.deidentify_content.timeout = 300.0
93
+ default_config.rpcs.deidentify_content.retry_policy = {
94
+ initial_delay: 0.1,
95
+ max_delay: 60.0,
96
+ multiplier: 1.3,
97
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
98
+ }
99
+
100
+ default_config.rpcs.reidentify_content.timeout = 300.0
101
+ default_config.rpcs.reidentify_content.retry_policy = {
102
+ initial_delay: 0.1,
103
+ max_delay: 60.0,
104
+ multiplier: 1.3,
105
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
106
+ }
107
+
108
+ default_config.rpcs.list_info_types.timeout = 300.0
109
+ default_config.rpcs.list_info_types.retry_policy = {
110
+ initial_delay: 0.1,
111
+ max_delay: 60.0,
112
+ multiplier: 1.3,
113
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
114
+ }
115
+
116
+ default_config.rpcs.create_inspect_template.timeout = 300.0
117
+
118
+ default_config.rpcs.update_inspect_template.timeout = 300.0
119
+
120
+ default_config.rpcs.get_inspect_template.timeout = 300.0
121
+ default_config.rpcs.get_inspect_template.retry_policy = {
122
+ initial_delay: 0.1,
123
+ max_delay: 60.0,
124
+ multiplier: 1.3,
125
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
126
+ }
127
+
128
+ default_config.rpcs.list_inspect_templates.timeout = 300.0
129
+ default_config.rpcs.list_inspect_templates.retry_policy = {
130
+ initial_delay: 0.1,
131
+ max_delay: 60.0,
132
+ multiplier: 1.3,
133
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
134
+ }
135
+
136
+ default_config.rpcs.delete_inspect_template.timeout = 300.0
137
+ default_config.rpcs.delete_inspect_template.retry_policy = {
138
+ initial_delay: 0.1,
139
+ max_delay: 60.0,
140
+ multiplier: 1.3,
141
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
142
+ }
143
+
144
+ default_config.rpcs.create_deidentify_template.timeout = 300.0
145
+
146
+ default_config.rpcs.update_deidentify_template.timeout = 300.0
147
+
148
+ default_config.rpcs.get_deidentify_template.timeout = 300.0
149
+ default_config.rpcs.get_deidentify_template.retry_policy = {
150
+ initial_delay: 0.1,
151
+ max_delay: 60.0,
152
+ multiplier: 1.3,
153
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
154
+ }
155
+
156
+ default_config.rpcs.list_deidentify_templates.timeout = 300.0
157
+ default_config.rpcs.list_deidentify_templates.retry_policy = {
158
+ initial_delay: 0.1,
159
+ max_delay: 60.0,
160
+ multiplier: 1.3,
161
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
162
+ }
163
+
164
+ default_config.rpcs.delete_deidentify_template.timeout = 300.0
165
+ default_config.rpcs.delete_deidentify_template.retry_policy = {
166
+ initial_delay: 0.1,
167
+ max_delay: 60.0,
168
+ multiplier: 1.3,
169
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
170
+ }
171
+
172
+ default_config.rpcs.create_job_trigger.timeout = 300.0
173
+
174
+ default_config.rpcs.update_job_trigger.timeout = 300.0
175
+
176
+ default_config.rpcs.hybrid_inspect_job_trigger.timeout = 300.0
177
+ default_config.rpcs.hybrid_inspect_job_trigger.retry_policy = {
178
+ initial_delay: 0.1,
179
+ max_delay: 60.0,
180
+ multiplier: 1.3,
181
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
182
+ }
183
+
184
+ default_config.rpcs.get_job_trigger.timeout = 300.0
185
+ default_config.rpcs.get_job_trigger.retry_policy = {
186
+ initial_delay: 0.1,
187
+ max_delay: 60.0,
188
+ multiplier: 1.3,
189
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
190
+ }
191
+
192
+ default_config.rpcs.list_job_triggers.timeout = 300.0
193
+ default_config.rpcs.list_job_triggers.retry_policy = {
194
+ initial_delay: 0.1,
195
+ max_delay: 60.0,
196
+ multiplier: 1.3,
197
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
198
+ }
199
+
200
+ default_config.rpcs.delete_job_trigger.timeout = 300.0
201
+ default_config.rpcs.delete_job_trigger.retry_policy = {
202
+ initial_delay: 0.1,
203
+ max_delay: 60.0,
204
+ multiplier: 1.3,
205
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
206
+ }
207
+
208
+ default_config.rpcs.activate_job_trigger.timeout = 300.0
209
+
210
+ default_config.rpcs.create_dlp_job.timeout = 300.0
211
+
212
+ default_config.rpcs.list_dlp_jobs.timeout = 300.0
213
+ default_config.rpcs.list_dlp_jobs.retry_policy = {
214
+ initial_delay: 0.1,
215
+ max_delay: 60.0,
216
+ multiplier: 1.3,
217
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
218
+ }
219
+
220
+ default_config.rpcs.get_dlp_job.timeout = 300.0
221
+ default_config.rpcs.get_dlp_job.retry_policy = {
222
+ initial_delay: 0.1,
223
+ max_delay: 60.0,
224
+ multiplier: 1.3,
225
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
226
+ }
227
+
228
+ default_config.rpcs.delete_dlp_job.timeout = 300.0
229
+ default_config.rpcs.delete_dlp_job.retry_policy = {
230
+ initial_delay: 0.1,
231
+ max_delay: 60.0,
232
+ multiplier: 1.3,
233
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
234
+ }
235
+
236
+ default_config.rpcs.cancel_dlp_job.timeout = 300.0
237
+
238
+ default_config.rpcs.create_stored_info_type.timeout = 300.0
239
+
240
+ default_config.rpcs.update_stored_info_type.timeout = 300.0
241
+
242
+ default_config.rpcs.get_stored_info_type.timeout = 300.0
243
+ default_config.rpcs.get_stored_info_type.retry_policy = {
244
+ initial_delay: 0.1,
245
+ max_delay: 60.0,
246
+ multiplier: 1.3,
247
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
248
+ }
249
+
250
+ default_config.rpcs.list_stored_info_types.timeout = 300.0
251
+ default_config.rpcs.list_stored_info_types.retry_policy = {
252
+ initial_delay: 0.1,
253
+ max_delay: 60.0,
254
+ multiplier: 1.3,
255
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
256
+ }
257
+
258
+ default_config.rpcs.delete_stored_info_type.timeout = 300.0
259
+ default_config.rpcs.delete_stored_info_type.retry_policy = {
260
+ initial_delay: 0.1,
261
+ max_delay: 60.0,
262
+ multiplier: 1.3,
263
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
264
+ }
265
+
266
+ default_config.rpcs.hybrid_inspect_dlp_job.timeout = 300.0
267
+ default_config.rpcs.hybrid_inspect_dlp_job.retry_policy = {
268
+ initial_delay: 0.1,
269
+ max_delay: 60.0,
270
+ multiplier: 1.3,
271
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
272
+ }
273
+
274
+ default_config.rpcs.finish_dlp_job.timeout = 300.0
275
+ default_config.rpcs.finish_dlp_job.retry_policy = {
276
+ initial_delay: 0.1,
277
+ max_delay: 60.0,
278
+ multiplier: 1.3,
279
+ retry_codes: ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
280
+ }
281
+
282
+ default_config
283
+ end
284
+ yield @configure if block_given?
285
+ @configure
286
+ end
287
+
288
+ ##
289
+ # Configure the DlpService Client instance.
290
+ #
291
+ # The configuration is set to the derived mode, meaning that values can be changed,
292
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
293
+ # should be made on {Client.configure}.
294
+ #
295
+ # See {Google::Cloud::Dlp::V2::DlpService::Client::Configuration}
296
+ # for a description of the configuration fields.
297
+ #
298
+ # @yield [config] Configure the Client client.
299
+ # @yieldparam config [Client::Configuration]
300
+ #
301
+ # @return [Client::Configuration]
302
+ #
303
+ def configure
304
+ yield @config if block_given?
305
+ @config
306
+ end
307
+
308
+ ##
309
+ # Create a new DlpService client object.
310
+ #
311
+ # ## Examples
312
+ #
313
+ # To create a new DlpService client with the default
314
+ # configuration:
315
+ #
316
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
317
+ #
318
+ # To create a new DlpService client with a custom
319
+ # configuration:
320
+ #
321
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
322
+ # config.timeout = 10_000
323
+ # end
324
+ #
325
+ # @yield [config] Configure the DlpService client.
326
+ # @yieldparam config [Client::Configuration]
327
+ #
328
+ def initialize
329
+ # These require statements are intentionally placed here to initialize
330
+ # the gRPC module only when it's required.
331
+ # See https://github.com/googleapis/toolkit/issues/446
332
+ require "gapic/grpc"
333
+ require "google/privacy/dlp/v2/dlp_services_pb"
334
+
335
+ # Create the configuration object
336
+ @config = Configuration.new Client.configure
337
+
338
+ # Yield the configuration if needed
339
+ yield @config if block_given?
340
+
341
+ # Create credentials
342
+ credentials = @config.credentials
343
+ credentials ||= Credentials.default scope: @config.scope
344
+ if credentials.is_a?(String) || credentials.is_a?(Hash)
345
+ credentials = Credentials.new credentials, scope: @config.scope
346
+ end
347
+ @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
348
+
349
+ @dlp_service_stub = Gapic::ServiceStub.new(
350
+ Google::Cloud::Dlp::V2::DlpService::Stub,
351
+ credentials: credentials,
352
+ endpoint: @config.endpoint,
353
+ channel_args: @config.channel_args,
354
+ interceptors: @config.interceptors
355
+ )
356
+ end
357
+
358
+ # Service calls
359
+
360
+ ##
361
+ # Finds potentially sensitive info in content.
362
+ # This method has limits on input size, processing time, and output size.
363
+ #
364
+ # When no InfoTypes or CustomInfoTypes are specified in this request, the
365
+ # system will automatically choose what detectors to run. By default this may
366
+ # be all types, but may change over time as detectors are updated.
367
+ #
368
+ # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
369
+ # and https://cloud.google.com/dlp/docs/inspecting-text,
370
+ #
371
+ # @overload inspect_content(request, options = nil)
372
+ # Pass arguments to `inspect_content` via a request object, either of type
373
+ # {Google::Cloud::Dlp::V2::InspectContentRequest} or an equivalent Hash.
374
+ #
375
+ # @param request [Google::Cloud::Dlp::V2::InspectContentRequest, Hash]
376
+ # A request object representing the call parameters. Required. To specify no
377
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
378
+ # @param options [Gapic::CallOptions, Hash]
379
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
380
+ #
381
+ # @overload inspect_content(parent: nil, inspect_config: nil, item: nil, inspect_template_name: nil, location_id: nil)
382
+ # Pass arguments to `inspect_content` via keyword arguments. Note that at
383
+ # least one keyword argument is required. To specify no parameters, or to keep all
384
+ # the default parameter values, pass an empty Hash as a request object (see above).
385
+ #
386
+ # @param parent [String]
387
+ # The parent resource name, for example projects/my-project-id.
388
+ # @param inspect_config [Google::Cloud::Dlp::V2::InspectConfig, Hash]
389
+ # Configuration for the inspector. What specified here will override
390
+ # the template referenced by the inspect_template_name argument.
391
+ # @param item [Google::Cloud::Dlp::V2::ContentItem, Hash]
392
+ # The item to inspect.
393
+ # @param inspect_template_name [String]
394
+ # Template to use. Any configuration directly specified in
395
+ # inspect_config will override those set in the template. Singular fields
396
+ # that are set in this request will replace their corresponding fields in the
397
+ # template. Repeated fields are appended. Singular sub-messages and groups
398
+ # are recursively merged.
399
+ # @param location_id [String]
400
+ # The geographic location to process content inspection. Reserved for future
401
+ # extensions.
402
+ #
403
+ # @yield [response, operation] Access the result along with the RPC operation
404
+ # @yieldparam response [Google::Cloud::Dlp::V2::InspectContentResponse]
405
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
406
+ #
407
+ # @return [Google::Cloud::Dlp::V2::InspectContentResponse]
408
+ #
409
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
410
+ #
411
+ def inspect_content request, options = nil
412
+ raise ArgumentError, "request must be provided" if request.nil?
413
+
414
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::InspectContentRequest
415
+
416
+ # Converts hash and nil to an options object
417
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
418
+
419
+ # Customize the options with defaults
420
+ metadata = @config.rpcs.inspect_content.metadata.to_h
421
+
422
+ # Set x-goog-api-client and x-goog-user-project headers
423
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
424
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
425
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
426
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
427
+
428
+ header_params = {
429
+ "parent" => request.parent
430
+ }
431
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
432
+ metadata[:"x-goog-request-params"] ||= request_params_header
433
+
434
+ options.apply_defaults timeout: @config.rpcs.inspect_content.timeout,
435
+ metadata: metadata,
436
+ retry_policy: @config.rpcs.inspect_content.retry_policy
437
+ options.apply_defaults metadata: @config.metadata,
438
+ retry_policy: @config.retry_policy
439
+
440
+ @dlp_service_stub.call_rpc :inspect_content, request, options: options do |response, operation|
441
+ yield response, operation if block_given?
442
+ return response
443
+ end
444
+ rescue GRPC::BadStatus => e
445
+ raise Google::Cloud::Error.from_error(e)
446
+ end
447
+
448
+ ##
449
+ # Redacts potentially sensitive info from an image.
450
+ # This method has limits on input size, processing time, and output size.
451
+ # See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
452
+ # learn more.
453
+ #
454
+ # When no InfoTypes or CustomInfoTypes are specified in this request, the
455
+ # system will automatically choose what detectors to run. By default this may
456
+ # be all types, but may change over time as detectors are updated.
457
+ #
458
+ # @overload redact_image(request, options = nil)
459
+ # Pass arguments to `redact_image` via a request object, either of type
460
+ # {Google::Cloud::Dlp::V2::RedactImageRequest} or an equivalent Hash.
461
+ #
462
+ # @param request [Google::Cloud::Dlp::V2::RedactImageRequest, Hash]
463
+ # A request object representing the call parameters. Required. To specify no
464
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
465
+ # @param options [Gapic::CallOptions, Hash]
466
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
467
+ #
468
+ # @overload redact_image(parent: nil, location_id: nil, inspect_config: nil, image_redaction_configs: nil, include_findings: nil, byte_item: nil)
469
+ # Pass arguments to `redact_image` via keyword arguments. Note that at
470
+ # least one keyword argument is required. To specify no parameters, or to keep all
471
+ # the default parameter values, pass an empty Hash as a request object (see above).
472
+ #
473
+ # @param parent [String]
474
+ # The parent resource name, for example projects/my-project-id.
475
+ # @param location_id [String]
476
+ # The geographic location to process the request. Reserved for future
477
+ # extensions.
478
+ # @param inspect_config [Google::Cloud::Dlp::V2::InspectConfig, Hash]
479
+ # Configuration for the inspector.
480
+ # @param image_redaction_configs [Array<Google::Cloud::Dlp::V2::RedactImageRequest::ImageRedactionConfig, Hash>]
481
+ # The configuration for specifying what content to redact from images.
482
+ # @param include_findings [Boolean]
483
+ # Whether the response should include findings along with the redacted
484
+ # image.
485
+ # @param byte_item [Google::Cloud::Dlp::V2::ByteContentItem, Hash]
486
+ # The content must be PNG, JPEG, SVG or BMP.
487
+ #
488
+ # @yield [response, operation] Access the result along with the RPC operation
489
+ # @yieldparam response [Google::Cloud::Dlp::V2::RedactImageResponse]
490
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
491
+ #
492
+ # @return [Google::Cloud::Dlp::V2::RedactImageResponse]
493
+ #
494
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
495
+ #
496
+ def redact_image request, options = nil
497
+ raise ArgumentError, "request must be provided" if request.nil?
498
+
499
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::RedactImageRequest
500
+
501
+ # Converts hash and nil to an options object
502
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
503
+
504
+ # Customize the options with defaults
505
+ metadata = @config.rpcs.redact_image.metadata.to_h
506
+
507
+ # Set x-goog-api-client and x-goog-user-project headers
508
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
509
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
510
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
511
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
512
+
513
+ header_params = {
514
+ "parent" => request.parent
515
+ }
516
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
517
+ metadata[:"x-goog-request-params"] ||= request_params_header
518
+
519
+ options.apply_defaults timeout: @config.rpcs.redact_image.timeout,
520
+ metadata: metadata,
521
+ retry_policy: @config.rpcs.redact_image.retry_policy
522
+ options.apply_defaults metadata: @config.metadata,
523
+ retry_policy: @config.retry_policy
524
+
525
+ @dlp_service_stub.call_rpc :redact_image, request, options: options do |response, operation|
526
+ yield response, operation if block_given?
527
+ return response
528
+ end
529
+ rescue GRPC::BadStatus => e
530
+ raise Google::Cloud::Error.from_error(e)
531
+ end
532
+
533
+ ##
534
+ # De-identifies potentially sensitive info from a ContentItem.
535
+ # This method has limits on input size and output size.
536
+ # See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
537
+ # learn more.
538
+ #
539
+ # When no InfoTypes or CustomInfoTypes are specified in this request, the
540
+ # system will automatically choose what detectors to run. By default this may
541
+ # be all types, but may change over time as detectors are updated.
542
+ #
543
+ # @overload deidentify_content(request, options = nil)
544
+ # Pass arguments to `deidentify_content` via a request object, either of type
545
+ # {Google::Cloud::Dlp::V2::DeidentifyContentRequest} or an equivalent Hash.
546
+ #
547
+ # @param request [Google::Cloud::Dlp::V2::DeidentifyContentRequest, Hash]
548
+ # A request object representing the call parameters. Required. To specify no
549
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
550
+ # @param options [Gapic::CallOptions, Hash]
551
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
552
+ #
553
+ # @overload deidentify_content(parent: nil, deidentify_config: nil, inspect_config: nil, item: nil, inspect_template_name: nil, deidentify_template_name: nil, location_id: nil)
554
+ # Pass arguments to `deidentify_content` via keyword arguments. Note that at
555
+ # least one keyword argument is required. To specify no parameters, or to keep all
556
+ # the default parameter values, pass an empty Hash as a request object (see above).
557
+ #
558
+ # @param parent [String]
559
+ # The parent resource name, for example projects/my-project-id.
560
+ # @param deidentify_config [Google::Cloud::Dlp::V2::DeidentifyConfig, Hash]
561
+ # Configuration for the de-identification of the content item.
562
+ # Items specified here will override the template referenced by the
563
+ # deidentify_template_name argument.
564
+ # @param inspect_config [Google::Cloud::Dlp::V2::InspectConfig, Hash]
565
+ # Configuration for the inspector.
566
+ # Items specified here will override the template referenced by the
567
+ # inspect_template_name argument.
568
+ # @param item [Google::Cloud::Dlp::V2::ContentItem, Hash]
569
+ # The item to de-identify. Will be treated as text.
570
+ # @param inspect_template_name [String]
571
+ # Template to use. Any configuration directly specified in
572
+ # inspect_config will override those set in the template. Singular fields
573
+ # that are set in this request will replace their corresponding fields in the
574
+ # template. Repeated fields are appended. Singular sub-messages and groups
575
+ # are recursively merged.
576
+ # @param deidentify_template_name [String]
577
+ # Template to use. Any configuration directly specified in
578
+ # deidentify_config will override those set in the template. Singular fields
579
+ # that are set in this request will replace their corresponding fields in the
580
+ # template. Repeated fields are appended. Singular sub-messages and groups
581
+ # are recursively merged.
582
+ # @param location_id [String]
583
+ # The geographic location to process de-identification. Reserved for future
584
+ # extensions.
585
+ #
586
+ # @yield [response, operation] Access the result along with the RPC operation
587
+ # @yieldparam response [Google::Cloud::Dlp::V2::DeidentifyContentResponse]
588
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
589
+ #
590
+ # @return [Google::Cloud::Dlp::V2::DeidentifyContentResponse]
591
+ #
592
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
593
+ #
594
+ def deidentify_content request, options = nil
595
+ raise ArgumentError, "request must be provided" if request.nil?
596
+
597
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeidentifyContentRequest
598
+
599
+ # Converts hash and nil to an options object
600
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
601
+
602
+ # Customize the options with defaults
603
+ metadata = @config.rpcs.deidentify_content.metadata.to_h
604
+
605
+ # Set x-goog-api-client and x-goog-user-project headers
606
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
607
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
608
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
609
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
610
+
611
+ header_params = {
612
+ "parent" => request.parent
613
+ }
614
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
615
+ metadata[:"x-goog-request-params"] ||= request_params_header
616
+
617
+ options.apply_defaults timeout: @config.rpcs.deidentify_content.timeout,
618
+ metadata: metadata,
619
+ retry_policy: @config.rpcs.deidentify_content.retry_policy
620
+ options.apply_defaults metadata: @config.metadata,
621
+ retry_policy: @config.retry_policy
622
+
623
+ @dlp_service_stub.call_rpc :deidentify_content, request, options: options do |response, operation|
624
+ yield response, operation if block_given?
625
+ return response
626
+ end
627
+ rescue GRPC::BadStatus => e
628
+ raise Google::Cloud::Error.from_error(e)
629
+ end
630
+
631
+ ##
632
+ # Re-identifies content that has been de-identified.
633
+ # See
634
+ # https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example
635
+ # to learn more.
636
+ #
637
+ # @overload reidentify_content(request, options = nil)
638
+ # Pass arguments to `reidentify_content` via a request object, either of type
639
+ # {Google::Cloud::Dlp::V2::ReidentifyContentRequest} or an equivalent Hash.
640
+ #
641
+ # @param request [Google::Cloud::Dlp::V2::ReidentifyContentRequest, Hash]
642
+ # A request object representing the call parameters. Required. To specify no
643
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
644
+ # @param options [Gapic::CallOptions, Hash]
645
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
646
+ #
647
+ # @overload reidentify_content(parent: nil, reidentify_config: nil, inspect_config: nil, item: nil, inspect_template_name: nil, reidentify_template_name: nil, location_id: nil)
648
+ # Pass arguments to `reidentify_content` via keyword arguments. Note that at
649
+ # least one keyword argument is required. To specify no parameters, or to keep all
650
+ # the default parameter values, pass an empty Hash as a request object (see above).
651
+ #
652
+ # @param parent [String]
653
+ # Required. The parent resource name.
654
+ # @param reidentify_config [Google::Cloud::Dlp::V2::DeidentifyConfig, Hash]
655
+ # Configuration for the re-identification of the content item.
656
+ # This field shares the same proto message type that is used for
657
+ # de-identification, however its usage here is for the reversal of the
658
+ # previous de-identification. Re-identification is performed by examining
659
+ # the transformations used to de-identify the items and executing the
660
+ # reverse. This requires that only reversible transformations
661
+ # be provided here. The reversible transformations are:
662
+ #
663
+ # - `CryptoDeterministicConfig`
664
+ # - `CryptoReplaceFfxFpeConfig`
665
+ # @param inspect_config [Google::Cloud::Dlp::V2::InspectConfig, Hash]
666
+ # Configuration for the inspector.
667
+ # @param item [Google::Cloud::Dlp::V2::ContentItem, Hash]
668
+ # The item to re-identify. Will be treated as text.
669
+ # @param inspect_template_name [String]
670
+ # Template to use. Any configuration directly specified in
671
+ # `inspect_config` will override those set in the template. Singular fields
672
+ # that are set in this request will replace their corresponding fields in the
673
+ # template. Repeated fields are appended. Singular sub-messages and groups
674
+ # are recursively merged.
675
+ # @param reidentify_template_name [String]
676
+ # Template to use. References an instance of `DeidentifyTemplate`.
677
+ # Any configuration directly specified in `reidentify_config` or
678
+ # `inspect_config` will override those set in the template. Singular fields
679
+ # that are set in this request will replace their corresponding fields in the
680
+ # template. Repeated fields are appended. Singular sub-messages and groups
681
+ # are recursively merged.
682
+ # @param location_id [String]
683
+ # The geographic location to process content reidentification. Reserved for
684
+ # future extensions.
685
+ #
686
+ # @yield [response, operation] Access the result along with the RPC operation
687
+ # @yieldparam response [Google::Cloud::Dlp::V2::ReidentifyContentResponse]
688
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
689
+ #
690
+ # @return [Google::Cloud::Dlp::V2::ReidentifyContentResponse]
691
+ #
692
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
693
+ #
694
+ def reidentify_content request, options = nil
695
+ raise ArgumentError, "request must be provided" if request.nil?
696
+
697
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ReidentifyContentRequest
698
+
699
+ # Converts hash and nil to an options object
700
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
701
+
702
+ # Customize the options with defaults
703
+ metadata = @config.rpcs.reidentify_content.metadata.to_h
704
+
705
+ # Set x-goog-api-client and x-goog-user-project headers
706
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
707
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
708
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
709
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
710
+
711
+ header_params = {
712
+ "parent" => request.parent
713
+ }
714
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
715
+ metadata[:"x-goog-request-params"] ||= request_params_header
716
+
717
+ options.apply_defaults timeout: @config.rpcs.reidentify_content.timeout,
718
+ metadata: metadata,
719
+ retry_policy: @config.rpcs.reidentify_content.retry_policy
720
+ options.apply_defaults metadata: @config.metadata,
721
+ retry_policy: @config.retry_policy
722
+
723
+ @dlp_service_stub.call_rpc :reidentify_content, request, options: options do |response, operation|
724
+ yield response, operation if block_given?
725
+ return response
726
+ end
727
+ rescue GRPC::BadStatus => e
728
+ raise Google::Cloud::Error.from_error(e)
729
+ end
730
+
731
+ ##
732
+ # Returns a list of the sensitive information types that the DLP API
733
+ # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
734
+ # learn more.
735
+ #
736
+ # @overload list_info_types(request, options = nil)
737
+ # Pass arguments to `list_info_types` via a request object, either of type
738
+ # {Google::Cloud::Dlp::V2::ListInfoTypesRequest} or an equivalent Hash.
739
+ #
740
+ # @param request [Google::Cloud::Dlp::V2::ListInfoTypesRequest, Hash]
741
+ # A request object representing the call parameters. Required. To specify no
742
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
743
+ # @param options [Gapic::CallOptions, Hash]
744
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
745
+ #
746
+ # @overload list_info_types(language_code: nil, filter: nil, location_id: nil)
747
+ # Pass arguments to `list_info_types` via keyword arguments. Note that at
748
+ # least one keyword argument is required. To specify no parameters, or to keep all
749
+ # the default parameter values, pass an empty Hash as a request object (see above).
750
+ #
751
+ # @param language_code [String]
752
+ # BCP-47 language code for localized infoType friendly
753
+ # names. If omitted, or if localized strings are not available,
754
+ # en-US strings will be returned.
755
+ # @param filter [String]
756
+ # filter to only return infoTypes supported by certain parts of the
757
+ # API. Defaults to supported_by=INSPECT.
758
+ # @param location_id [String]
759
+ # The geographic location to list info types. Reserved for future
760
+ # extensions.
761
+ #
762
+ # @yield [response, operation] Access the result along with the RPC operation
763
+ # @yieldparam response [Google::Cloud::Dlp::V2::ListInfoTypesResponse]
764
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
765
+ #
766
+ # @return [Google::Cloud::Dlp::V2::ListInfoTypesResponse]
767
+ #
768
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
769
+ #
770
+ def list_info_types request, options = nil
771
+ raise ArgumentError, "request must be provided" if request.nil?
772
+
773
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListInfoTypesRequest
774
+
775
+ # Converts hash and nil to an options object
776
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
777
+
778
+ # Customize the options with defaults
779
+ metadata = @config.rpcs.list_info_types.metadata.to_h
780
+
781
+ # Set x-goog-api-client and x-goog-user-project headers
782
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
783
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
784
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
785
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
786
+
787
+ options.apply_defaults timeout: @config.rpcs.list_info_types.timeout,
788
+ metadata: metadata,
789
+ retry_policy: @config.rpcs.list_info_types.retry_policy
790
+ options.apply_defaults metadata: @config.metadata,
791
+ retry_policy: @config.retry_policy
792
+
793
+ @dlp_service_stub.call_rpc :list_info_types, request, options: options do |response, operation|
794
+ yield response, operation if block_given?
795
+ return response
796
+ end
797
+ rescue GRPC::BadStatus => e
798
+ raise Google::Cloud::Error.from_error(e)
799
+ end
800
+
801
+ ##
802
+ # Creates an InspectTemplate for re-using frequently used configuration
803
+ # for inspecting content, images, and storage.
804
+ # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
805
+ #
806
+ # @overload create_inspect_template(request, options = nil)
807
+ # Pass arguments to `create_inspect_template` via a request object, either of type
808
+ # {Google::Cloud::Dlp::V2::CreateInspectTemplateRequest} or an equivalent Hash.
809
+ #
810
+ # @param request [Google::Cloud::Dlp::V2::CreateInspectTemplateRequest, Hash]
811
+ # A request object representing the call parameters. Required. To specify no
812
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
813
+ # @param options [Gapic::CallOptions, Hash]
814
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
815
+ #
816
+ # @overload create_inspect_template(parent: nil, inspect_template: nil, template_id: nil, location_id: nil)
817
+ # Pass arguments to `create_inspect_template` via keyword arguments. Note that at
818
+ # least one keyword argument is required. To specify no parameters, or to keep all
819
+ # the default parameter values, pass an empty Hash as a request object (see above).
820
+ #
821
+ # @param parent [String]
822
+ # Required. The parent resource name, for example projects/my-project-id or
823
+ # organizations/my-org-id.
824
+ # @param inspect_template [Google::Cloud::Dlp::V2::InspectTemplate, Hash]
825
+ # Required. The InspectTemplate to create.
826
+ # @param template_id [String]
827
+ # The template id can contain uppercase and lowercase letters,
828
+ # numbers, and hyphens; that is, it must match the regular
829
+ # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
830
+ # characters. Can be empty to allow the system to generate one.
831
+ # @param location_id [String]
832
+ # The geographic location to store the inspection template. Reserved for
833
+ # future extensions.
834
+ #
835
+ # @yield [response, operation] Access the result along with the RPC operation
836
+ # @yieldparam response [Google::Cloud::Dlp::V2::InspectTemplate]
837
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
838
+ #
839
+ # @return [Google::Cloud::Dlp::V2::InspectTemplate]
840
+ #
841
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
842
+ #
843
+ def create_inspect_template request, options = nil
844
+ raise ArgumentError, "request must be provided" if request.nil?
845
+
846
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CreateInspectTemplateRequest
847
+
848
+ # Converts hash and nil to an options object
849
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
850
+
851
+ # Customize the options with defaults
852
+ metadata = @config.rpcs.create_inspect_template.metadata.to_h
853
+
854
+ # Set x-goog-api-client and x-goog-user-project headers
855
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
856
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
857
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
858
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
859
+
860
+ header_params = {
861
+ "parent" => request.parent
862
+ }
863
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
864
+ metadata[:"x-goog-request-params"] ||= request_params_header
865
+
866
+ options.apply_defaults timeout: @config.rpcs.create_inspect_template.timeout,
867
+ metadata: metadata,
868
+ retry_policy: @config.rpcs.create_inspect_template.retry_policy
869
+ options.apply_defaults metadata: @config.metadata,
870
+ retry_policy: @config.retry_policy
871
+
872
+ @dlp_service_stub.call_rpc :create_inspect_template, request, options: options do |response, operation|
873
+ yield response, operation if block_given?
874
+ return response
875
+ end
876
+ rescue GRPC::BadStatus => e
877
+ raise Google::Cloud::Error.from_error(e)
878
+ end
879
+
880
+ ##
881
+ # Updates the InspectTemplate.
882
+ # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
883
+ #
884
+ # @overload update_inspect_template(request, options = nil)
885
+ # Pass arguments to `update_inspect_template` via a request object, either of type
886
+ # {Google::Cloud::Dlp::V2::UpdateInspectTemplateRequest} or an equivalent Hash.
887
+ #
888
+ # @param request [Google::Cloud::Dlp::V2::UpdateInspectTemplateRequest, Hash]
889
+ # A request object representing the call parameters. Required. To specify no
890
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
891
+ # @param options [Gapic::CallOptions, Hash]
892
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
893
+ #
894
+ # @overload update_inspect_template(name: nil, inspect_template: nil, update_mask: nil)
895
+ # Pass arguments to `update_inspect_template` via keyword arguments. Note that at
896
+ # least one keyword argument is required. To specify no parameters, or to keep all
897
+ # the default parameter values, pass an empty Hash as a request object (see above).
898
+ #
899
+ # @param name [String]
900
+ # Required. Resource name of organization and inspectTemplate to be updated,
901
+ # for example `organizations/433245324/inspectTemplates/432452342` or
902
+ # projects/project-id/inspectTemplates/432452342.
903
+ # @param inspect_template [Google::Cloud::Dlp::V2::InspectTemplate, Hash]
904
+ # New InspectTemplate value.
905
+ # @param update_mask [Google::Protobuf::FieldMask, Hash]
906
+ # Mask to control which fields get updated.
907
+ #
908
+ # @yield [response, operation] Access the result along with the RPC operation
909
+ # @yieldparam response [Google::Cloud::Dlp::V2::InspectTemplate]
910
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
911
+ #
912
+ # @return [Google::Cloud::Dlp::V2::InspectTemplate]
913
+ #
914
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
915
+ #
916
+ def update_inspect_template request, options = nil
917
+ raise ArgumentError, "request must be provided" if request.nil?
918
+
919
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::UpdateInspectTemplateRequest
920
+
921
+ # Converts hash and nil to an options object
922
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
923
+
924
+ # Customize the options with defaults
925
+ metadata = @config.rpcs.update_inspect_template.metadata.to_h
926
+
927
+ # Set x-goog-api-client and x-goog-user-project headers
928
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
929
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
930
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
931
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
932
+
933
+ header_params = {
934
+ "name" => request.name
935
+ }
936
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
937
+ metadata[:"x-goog-request-params"] ||= request_params_header
938
+
939
+ options.apply_defaults timeout: @config.rpcs.update_inspect_template.timeout,
940
+ metadata: metadata,
941
+ retry_policy: @config.rpcs.update_inspect_template.retry_policy
942
+ options.apply_defaults metadata: @config.metadata,
943
+ retry_policy: @config.retry_policy
944
+
945
+ @dlp_service_stub.call_rpc :update_inspect_template, request, options: options do |response, operation|
946
+ yield response, operation if block_given?
947
+ return response
948
+ end
949
+ rescue GRPC::BadStatus => e
950
+ raise Google::Cloud::Error.from_error(e)
951
+ end
952
+
953
+ ##
954
+ # Gets an InspectTemplate.
955
+ # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
956
+ #
957
+ # @overload get_inspect_template(request, options = nil)
958
+ # Pass arguments to `get_inspect_template` via a request object, either of type
959
+ # {Google::Cloud::Dlp::V2::GetInspectTemplateRequest} or an equivalent Hash.
960
+ #
961
+ # @param request [Google::Cloud::Dlp::V2::GetInspectTemplateRequest, Hash]
962
+ # A request object representing the call parameters. Required. To specify no
963
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
964
+ # @param options [Gapic::CallOptions, Hash]
965
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
966
+ #
967
+ # @overload get_inspect_template(name: nil)
968
+ # Pass arguments to `get_inspect_template` via keyword arguments. Note that at
969
+ # least one keyword argument is required. To specify no parameters, or to keep all
970
+ # the default parameter values, pass an empty Hash as a request object (see above).
971
+ #
972
+ # @param name [String]
973
+ # Required. Resource name of the organization and inspectTemplate to be read,
974
+ # for example `organizations/433245324/inspectTemplates/432452342` or
975
+ # projects/project-id/inspectTemplates/432452342.
976
+ #
977
+ # @yield [response, operation] Access the result along with the RPC operation
978
+ # @yieldparam response [Google::Cloud::Dlp::V2::InspectTemplate]
979
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
980
+ #
981
+ # @return [Google::Cloud::Dlp::V2::InspectTemplate]
982
+ #
983
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
984
+ #
985
+ def get_inspect_template request, options = nil
986
+ raise ArgumentError, "request must be provided" if request.nil?
987
+
988
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::GetInspectTemplateRequest
989
+
990
+ # Converts hash and nil to an options object
991
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
992
+
993
+ # Customize the options with defaults
994
+ metadata = @config.rpcs.get_inspect_template.metadata.to_h
995
+
996
+ # Set x-goog-api-client and x-goog-user-project headers
997
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
998
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
999
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1000
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1001
+
1002
+ header_params = {
1003
+ "name" => request.name
1004
+ }
1005
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1006
+ metadata[:"x-goog-request-params"] ||= request_params_header
1007
+
1008
+ options.apply_defaults timeout: @config.rpcs.get_inspect_template.timeout,
1009
+ metadata: metadata,
1010
+ retry_policy: @config.rpcs.get_inspect_template.retry_policy
1011
+ options.apply_defaults metadata: @config.metadata,
1012
+ retry_policy: @config.retry_policy
1013
+
1014
+ @dlp_service_stub.call_rpc :get_inspect_template, request, options: options do |response, operation|
1015
+ yield response, operation if block_given?
1016
+ return response
1017
+ end
1018
+ rescue GRPC::BadStatus => e
1019
+ raise Google::Cloud::Error.from_error(e)
1020
+ end
1021
+
1022
+ ##
1023
+ # Lists InspectTemplates.
1024
+ # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
1025
+ #
1026
+ # @overload list_inspect_templates(request, options = nil)
1027
+ # Pass arguments to `list_inspect_templates` via a request object, either of type
1028
+ # {Google::Cloud::Dlp::V2::ListInspectTemplatesRequest} or an equivalent Hash.
1029
+ #
1030
+ # @param request [Google::Cloud::Dlp::V2::ListInspectTemplatesRequest, Hash]
1031
+ # A request object representing the call parameters. Required. To specify no
1032
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1033
+ # @param options [Gapic::CallOptions, Hash]
1034
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1035
+ #
1036
+ # @overload list_inspect_templates(parent: nil, page_token: nil, page_size: nil, order_by: nil, location_id: nil)
1037
+ # Pass arguments to `list_inspect_templates` via keyword arguments. Note that at
1038
+ # least one keyword argument is required. To specify no parameters, or to keep all
1039
+ # the default parameter values, pass an empty Hash as a request object (see above).
1040
+ #
1041
+ # @param parent [String]
1042
+ # Required. The parent resource name, for example projects/my-project-id or
1043
+ # organizations/my-org-id.
1044
+ # @param page_token [String]
1045
+ # Page token to continue retrieval. Comes from previous call
1046
+ # to `ListInspectTemplates`.
1047
+ # @param page_size [Integer]
1048
+ # Size of the page, can be limited by server. If zero server returns
1049
+ # a page of max size 100.
1050
+ # @param order_by [String]
1051
+ # Comma separated list of fields to order by,
1052
+ # followed by `asc` or `desc` postfix. This list is case-insensitive,
1053
+ # default sorting order is ascending, redundant space characters are
1054
+ # insignificant.
1055
+ #
1056
+ # Example: `name asc,update_time, create_time desc`
1057
+ #
1058
+ # Supported fields are:
1059
+ #
1060
+ # - `create_time`: corresponds to time the template was created.
1061
+ # - `update_time`: corresponds to time the template was last updated.
1062
+ # - `name`: corresponds to template's name.
1063
+ # - `display_name`: corresponds to template's display name.
1064
+ # @param location_id [String]
1065
+ # The geographic location where inspection templates will be retrieved from.
1066
+ # Use `-` for all locations. Reserved for future extensions.
1067
+ #
1068
+ # @yield [response, operation] Access the result along with the RPC operation
1069
+ # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::InspectTemplate>]
1070
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1071
+ #
1072
+ # @return [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::InspectTemplate>]
1073
+ #
1074
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1075
+ #
1076
+ def list_inspect_templates request, options = nil
1077
+ raise ArgumentError, "request must be provided" if request.nil?
1078
+
1079
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListInspectTemplatesRequest
1080
+
1081
+ # Converts hash and nil to an options object
1082
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1083
+
1084
+ # Customize the options with defaults
1085
+ metadata = @config.rpcs.list_inspect_templates.metadata.to_h
1086
+
1087
+ # Set x-goog-api-client and x-goog-user-project headers
1088
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1089
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1090
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1091
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1092
+
1093
+ header_params = {
1094
+ "parent" => request.parent
1095
+ }
1096
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1097
+ metadata[:"x-goog-request-params"] ||= request_params_header
1098
+
1099
+ options.apply_defaults timeout: @config.rpcs.list_inspect_templates.timeout,
1100
+ metadata: metadata,
1101
+ retry_policy: @config.rpcs.list_inspect_templates.retry_policy
1102
+ options.apply_defaults metadata: @config.metadata,
1103
+ retry_policy: @config.retry_policy
1104
+
1105
+ @dlp_service_stub.call_rpc :list_inspect_templates, request, options: options do |response, operation|
1106
+ response = Gapic::PagedEnumerable.new @dlp_service_stub, :list_inspect_templates, request, response, operation, options
1107
+ yield response, operation if block_given?
1108
+ return response
1109
+ end
1110
+ rescue GRPC::BadStatus => e
1111
+ raise Google::Cloud::Error.from_error(e)
1112
+ end
1113
+
1114
+ ##
1115
+ # Deletes an InspectTemplate.
1116
+ # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
1117
+ #
1118
+ # @overload delete_inspect_template(request, options = nil)
1119
+ # Pass arguments to `delete_inspect_template` via a request object, either of type
1120
+ # {Google::Cloud::Dlp::V2::DeleteInspectTemplateRequest} or an equivalent Hash.
1121
+ #
1122
+ # @param request [Google::Cloud::Dlp::V2::DeleteInspectTemplateRequest, Hash]
1123
+ # A request object representing the call parameters. Required. To specify no
1124
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1125
+ # @param options [Gapic::CallOptions, Hash]
1126
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1127
+ #
1128
+ # @overload delete_inspect_template(name: nil)
1129
+ # Pass arguments to `delete_inspect_template` via keyword arguments. Note that at
1130
+ # least one keyword argument is required. To specify no parameters, or to keep all
1131
+ # the default parameter values, pass an empty Hash as a request object (see above).
1132
+ #
1133
+ # @param name [String]
1134
+ # Required. Resource name of the organization and inspectTemplate to be
1135
+ # deleted, for example `organizations/433245324/inspectTemplates/432452342`
1136
+ # or projects/project-id/inspectTemplates/432452342.
1137
+ #
1138
+ # @yield [response, operation] Access the result along with the RPC operation
1139
+ # @yieldparam response [Google::Protobuf::Empty]
1140
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1141
+ #
1142
+ # @return [Google::Protobuf::Empty]
1143
+ #
1144
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1145
+ #
1146
+ def delete_inspect_template request, options = nil
1147
+ raise ArgumentError, "request must be provided" if request.nil?
1148
+
1149
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeleteInspectTemplateRequest
1150
+
1151
+ # Converts hash and nil to an options object
1152
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1153
+
1154
+ # Customize the options with defaults
1155
+ metadata = @config.rpcs.delete_inspect_template.metadata.to_h
1156
+
1157
+ # Set x-goog-api-client and x-goog-user-project headers
1158
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1159
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1160
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1161
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1162
+
1163
+ header_params = {
1164
+ "name" => request.name
1165
+ }
1166
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1167
+ metadata[:"x-goog-request-params"] ||= request_params_header
1168
+
1169
+ options.apply_defaults timeout: @config.rpcs.delete_inspect_template.timeout,
1170
+ metadata: metadata,
1171
+ retry_policy: @config.rpcs.delete_inspect_template.retry_policy
1172
+ options.apply_defaults metadata: @config.metadata,
1173
+ retry_policy: @config.retry_policy
1174
+
1175
+ @dlp_service_stub.call_rpc :delete_inspect_template, request, options: options do |response, operation|
1176
+ yield response, operation if block_given?
1177
+ return response
1178
+ end
1179
+ rescue GRPC::BadStatus => e
1180
+ raise Google::Cloud::Error.from_error(e)
1181
+ end
1182
+
1183
+ ##
1184
+ # Creates a DeidentifyTemplate for re-using frequently used configuration
1185
+ # for de-identifying content, images, and storage.
1186
+ # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
1187
+ # more.
1188
+ #
1189
+ # @overload create_deidentify_template(request, options = nil)
1190
+ # Pass arguments to `create_deidentify_template` via a request object, either of type
1191
+ # {Google::Cloud::Dlp::V2::CreateDeidentifyTemplateRequest} or an equivalent Hash.
1192
+ #
1193
+ # @param request [Google::Cloud::Dlp::V2::CreateDeidentifyTemplateRequest, Hash]
1194
+ # A request object representing the call parameters. Required. To specify no
1195
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1196
+ # @param options [Gapic::CallOptions, Hash]
1197
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1198
+ #
1199
+ # @overload create_deidentify_template(parent: nil, deidentify_template: nil, template_id: nil, location_id: nil)
1200
+ # Pass arguments to `create_deidentify_template` via keyword arguments. Note that at
1201
+ # least one keyword argument is required. To specify no parameters, or to keep all
1202
+ # the default parameter values, pass an empty Hash as a request object (see above).
1203
+ #
1204
+ # @param parent [String]
1205
+ # Required. The parent resource name, for example projects/my-project-id or
1206
+ # organizations/my-org-id.
1207
+ # @param deidentify_template [Google::Cloud::Dlp::V2::DeidentifyTemplate, Hash]
1208
+ # Required. The DeidentifyTemplate to create.
1209
+ # @param template_id [String]
1210
+ # The template id can contain uppercase and lowercase letters,
1211
+ # numbers, and hyphens; that is, it must match the regular
1212
+ # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
1213
+ # characters. Can be empty to allow the system to generate one.
1214
+ # @param location_id [String]
1215
+ # The geographic location to store the deidentification template. Reserved
1216
+ # for future extensions.
1217
+ #
1218
+ # @yield [response, operation] Access the result along with the RPC operation
1219
+ # @yieldparam response [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1220
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1221
+ #
1222
+ # @return [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1223
+ #
1224
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1225
+ #
1226
+ def create_deidentify_template request, options = nil
1227
+ raise ArgumentError, "request must be provided" if request.nil?
1228
+
1229
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CreateDeidentifyTemplateRequest
1230
+
1231
+ # Converts hash and nil to an options object
1232
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1233
+
1234
+ # Customize the options with defaults
1235
+ metadata = @config.rpcs.create_deidentify_template.metadata.to_h
1236
+
1237
+ # Set x-goog-api-client and x-goog-user-project headers
1238
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1239
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1240
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1241
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1242
+
1243
+ header_params = {
1244
+ "parent" => request.parent
1245
+ }
1246
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1247
+ metadata[:"x-goog-request-params"] ||= request_params_header
1248
+
1249
+ options.apply_defaults timeout: @config.rpcs.create_deidentify_template.timeout,
1250
+ metadata: metadata,
1251
+ retry_policy: @config.rpcs.create_deidentify_template.retry_policy
1252
+ options.apply_defaults metadata: @config.metadata,
1253
+ retry_policy: @config.retry_policy
1254
+
1255
+ @dlp_service_stub.call_rpc :create_deidentify_template, request, options: options do |response, operation|
1256
+ yield response, operation if block_given?
1257
+ return response
1258
+ end
1259
+ rescue GRPC::BadStatus => e
1260
+ raise Google::Cloud::Error.from_error(e)
1261
+ end
1262
+
1263
+ ##
1264
+ # Updates the DeidentifyTemplate.
1265
+ # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
1266
+ # more.
1267
+ #
1268
+ # @overload update_deidentify_template(request, options = nil)
1269
+ # Pass arguments to `update_deidentify_template` via a request object, either of type
1270
+ # {Google::Cloud::Dlp::V2::UpdateDeidentifyTemplateRequest} or an equivalent Hash.
1271
+ #
1272
+ # @param request [Google::Cloud::Dlp::V2::UpdateDeidentifyTemplateRequest, Hash]
1273
+ # A request object representing the call parameters. Required. To specify no
1274
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1275
+ # @param options [Gapic::CallOptions, Hash]
1276
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1277
+ #
1278
+ # @overload update_deidentify_template(name: nil, deidentify_template: nil, update_mask: nil)
1279
+ # Pass arguments to `update_deidentify_template` via keyword arguments. Note that at
1280
+ # least one keyword argument is required. To specify no parameters, or to keep all
1281
+ # the default parameter values, pass an empty Hash as a request object (see above).
1282
+ #
1283
+ # @param name [String]
1284
+ # Required. Resource name of organization and deidentify template to be
1285
+ # updated, for example
1286
+ # `organizations/433245324/deidentifyTemplates/432452342` or
1287
+ # projects/project-id/deidentifyTemplates/432452342.
1288
+ # @param deidentify_template [Google::Cloud::Dlp::V2::DeidentifyTemplate, Hash]
1289
+ # New DeidentifyTemplate value.
1290
+ # @param update_mask [Google::Protobuf::FieldMask, Hash]
1291
+ # Mask to control which fields get updated.
1292
+ #
1293
+ # @yield [response, operation] Access the result along with the RPC operation
1294
+ # @yieldparam response [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1295
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1296
+ #
1297
+ # @return [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1298
+ #
1299
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1300
+ #
1301
+ def update_deidentify_template request, options = nil
1302
+ raise ArgumentError, "request must be provided" if request.nil?
1303
+
1304
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::UpdateDeidentifyTemplateRequest
1305
+
1306
+ # Converts hash and nil to an options object
1307
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1308
+
1309
+ # Customize the options with defaults
1310
+ metadata = @config.rpcs.update_deidentify_template.metadata.to_h
1311
+
1312
+ # Set x-goog-api-client and x-goog-user-project headers
1313
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1314
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1315
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1316
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1317
+
1318
+ header_params = {
1319
+ "name" => request.name
1320
+ }
1321
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1322
+ metadata[:"x-goog-request-params"] ||= request_params_header
1323
+
1324
+ options.apply_defaults timeout: @config.rpcs.update_deidentify_template.timeout,
1325
+ metadata: metadata,
1326
+ retry_policy: @config.rpcs.update_deidentify_template.retry_policy
1327
+ options.apply_defaults metadata: @config.metadata,
1328
+ retry_policy: @config.retry_policy
1329
+
1330
+ @dlp_service_stub.call_rpc :update_deidentify_template, request, options: options do |response, operation|
1331
+ yield response, operation if block_given?
1332
+ return response
1333
+ end
1334
+ rescue GRPC::BadStatus => e
1335
+ raise Google::Cloud::Error.from_error(e)
1336
+ end
1337
+
1338
+ ##
1339
+ # Gets a DeidentifyTemplate.
1340
+ # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
1341
+ # more.
1342
+ #
1343
+ # @overload get_deidentify_template(request, options = nil)
1344
+ # Pass arguments to `get_deidentify_template` via a request object, either of type
1345
+ # {Google::Cloud::Dlp::V2::GetDeidentifyTemplateRequest} or an equivalent Hash.
1346
+ #
1347
+ # @param request [Google::Cloud::Dlp::V2::GetDeidentifyTemplateRequest, Hash]
1348
+ # A request object representing the call parameters. Required. To specify no
1349
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1350
+ # @param options [Gapic::CallOptions, Hash]
1351
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1352
+ #
1353
+ # @overload get_deidentify_template(name: nil)
1354
+ # Pass arguments to `get_deidentify_template` via keyword arguments. Note that at
1355
+ # least one keyword argument is required. To specify no parameters, or to keep all
1356
+ # the default parameter values, pass an empty Hash as a request object (see above).
1357
+ #
1358
+ # @param name [String]
1359
+ # Required. Resource name of the organization and deidentify template to be
1360
+ # read, for example `organizations/433245324/deidentifyTemplates/432452342`
1361
+ # or projects/project-id/deidentifyTemplates/432452342.
1362
+ #
1363
+ # @yield [response, operation] Access the result along with the RPC operation
1364
+ # @yieldparam response [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1365
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1366
+ #
1367
+ # @return [Google::Cloud::Dlp::V2::DeidentifyTemplate]
1368
+ #
1369
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1370
+ #
1371
+ def get_deidentify_template request, options = nil
1372
+ raise ArgumentError, "request must be provided" if request.nil?
1373
+
1374
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::GetDeidentifyTemplateRequest
1375
+
1376
+ # Converts hash and nil to an options object
1377
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1378
+
1379
+ # Customize the options with defaults
1380
+ metadata = @config.rpcs.get_deidentify_template.metadata.to_h
1381
+
1382
+ # Set x-goog-api-client and x-goog-user-project headers
1383
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1384
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1385
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1386
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1387
+
1388
+ header_params = {
1389
+ "name" => request.name
1390
+ }
1391
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1392
+ metadata[:"x-goog-request-params"] ||= request_params_header
1393
+
1394
+ options.apply_defaults timeout: @config.rpcs.get_deidentify_template.timeout,
1395
+ metadata: metadata,
1396
+ retry_policy: @config.rpcs.get_deidentify_template.retry_policy
1397
+ options.apply_defaults metadata: @config.metadata,
1398
+ retry_policy: @config.retry_policy
1399
+
1400
+ @dlp_service_stub.call_rpc :get_deidentify_template, request, options: options do |response, operation|
1401
+ yield response, operation if block_given?
1402
+ return response
1403
+ end
1404
+ rescue GRPC::BadStatus => e
1405
+ raise Google::Cloud::Error.from_error(e)
1406
+ end
1407
+
1408
+ ##
1409
+ # Lists DeidentifyTemplates.
1410
+ # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
1411
+ # more.
1412
+ #
1413
+ # @overload list_deidentify_templates(request, options = nil)
1414
+ # Pass arguments to `list_deidentify_templates` via a request object, either of type
1415
+ # {Google::Cloud::Dlp::V2::ListDeidentifyTemplatesRequest} or an equivalent Hash.
1416
+ #
1417
+ # @param request [Google::Cloud::Dlp::V2::ListDeidentifyTemplatesRequest, Hash]
1418
+ # A request object representing the call parameters. Required. To specify no
1419
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1420
+ # @param options [Gapic::CallOptions, Hash]
1421
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1422
+ #
1423
+ # @overload list_deidentify_templates(parent: nil, page_token: nil, page_size: nil, order_by: nil, location_id: nil)
1424
+ # Pass arguments to `list_deidentify_templates` via keyword arguments. Note that at
1425
+ # least one keyword argument is required. To specify no parameters, or to keep all
1426
+ # the default parameter values, pass an empty Hash as a request object (see above).
1427
+ #
1428
+ # @param parent [String]
1429
+ # Required. The parent resource name, for example projects/my-project-id or
1430
+ # organizations/my-org-id.
1431
+ # @param page_token [String]
1432
+ # Page token to continue retrieval. Comes from previous call
1433
+ # to `ListDeidentifyTemplates`.
1434
+ # @param page_size [Integer]
1435
+ # Size of the page, can be limited by server. If zero server returns
1436
+ # a page of max size 100.
1437
+ # @param order_by [String]
1438
+ # Comma separated list of fields to order by,
1439
+ # followed by `asc` or `desc` postfix. This list is case-insensitive,
1440
+ # default sorting order is ascending, redundant space characters are
1441
+ # insignificant.
1442
+ #
1443
+ # Example: `name asc,update_time, create_time desc`
1444
+ #
1445
+ # Supported fields are:
1446
+ #
1447
+ # - `create_time`: corresponds to time the template was created.
1448
+ # - `update_time`: corresponds to time the template was last updated.
1449
+ # - `name`: corresponds to template's name.
1450
+ # - `display_name`: corresponds to template's display name.
1451
+ # @param location_id [String]
1452
+ # The geographic location where deidentifications templates will be retrieved
1453
+ # from. Use `-` for all locations. Reserved for future extensions.
1454
+ #
1455
+ # @yield [response, operation] Access the result along with the RPC operation
1456
+ # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::DeidentifyTemplate>]
1457
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1458
+ #
1459
+ # @return [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::DeidentifyTemplate>]
1460
+ #
1461
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1462
+ #
1463
+ def list_deidentify_templates request, options = nil
1464
+ raise ArgumentError, "request must be provided" if request.nil?
1465
+
1466
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListDeidentifyTemplatesRequest
1467
+
1468
+ # Converts hash and nil to an options object
1469
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1470
+
1471
+ # Customize the options with defaults
1472
+ metadata = @config.rpcs.list_deidentify_templates.metadata.to_h
1473
+
1474
+ # Set x-goog-api-client and x-goog-user-project headers
1475
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1476
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1477
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1478
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1479
+
1480
+ header_params = {
1481
+ "parent" => request.parent
1482
+ }
1483
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1484
+ metadata[:"x-goog-request-params"] ||= request_params_header
1485
+
1486
+ options.apply_defaults timeout: @config.rpcs.list_deidentify_templates.timeout,
1487
+ metadata: metadata,
1488
+ retry_policy: @config.rpcs.list_deidentify_templates.retry_policy
1489
+ options.apply_defaults metadata: @config.metadata,
1490
+ retry_policy: @config.retry_policy
1491
+
1492
+ @dlp_service_stub.call_rpc :list_deidentify_templates, request, options: options do |response, operation|
1493
+ response = Gapic::PagedEnumerable.new @dlp_service_stub, :list_deidentify_templates, request, response, operation, options
1494
+ yield response, operation if block_given?
1495
+ return response
1496
+ end
1497
+ rescue GRPC::BadStatus => e
1498
+ raise Google::Cloud::Error.from_error(e)
1499
+ end
1500
+
1501
+ ##
1502
+ # Deletes a DeidentifyTemplate.
1503
+ # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
1504
+ # more.
1505
+ #
1506
+ # @overload delete_deidentify_template(request, options = nil)
1507
+ # Pass arguments to `delete_deidentify_template` via a request object, either of type
1508
+ # {Google::Cloud::Dlp::V2::DeleteDeidentifyTemplateRequest} or an equivalent Hash.
1509
+ #
1510
+ # @param request [Google::Cloud::Dlp::V2::DeleteDeidentifyTemplateRequest, Hash]
1511
+ # A request object representing the call parameters. Required. To specify no
1512
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1513
+ # @param options [Gapic::CallOptions, Hash]
1514
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1515
+ #
1516
+ # @overload delete_deidentify_template(name: nil)
1517
+ # Pass arguments to `delete_deidentify_template` via keyword arguments. Note that at
1518
+ # least one keyword argument is required. To specify no parameters, or to keep all
1519
+ # the default parameter values, pass an empty Hash as a request object (see above).
1520
+ #
1521
+ # @param name [String]
1522
+ # Required. Resource name of the organization and deidentify template to be
1523
+ # deleted, for example
1524
+ # `organizations/433245324/deidentifyTemplates/432452342` or
1525
+ # projects/project-id/deidentifyTemplates/432452342.
1526
+ #
1527
+ # @yield [response, operation] Access the result along with the RPC operation
1528
+ # @yieldparam response [Google::Protobuf::Empty]
1529
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1530
+ #
1531
+ # @return [Google::Protobuf::Empty]
1532
+ #
1533
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1534
+ #
1535
+ def delete_deidentify_template request, options = nil
1536
+ raise ArgumentError, "request must be provided" if request.nil?
1537
+
1538
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeleteDeidentifyTemplateRequest
1539
+
1540
+ # Converts hash and nil to an options object
1541
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1542
+
1543
+ # Customize the options with defaults
1544
+ metadata = @config.rpcs.delete_deidentify_template.metadata.to_h
1545
+
1546
+ # Set x-goog-api-client and x-goog-user-project headers
1547
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1548
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1549
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1550
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1551
+
1552
+ header_params = {
1553
+ "name" => request.name
1554
+ }
1555
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1556
+ metadata[:"x-goog-request-params"] ||= request_params_header
1557
+
1558
+ options.apply_defaults timeout: @config.rpcs.delete_deidentify_template.timeout,
1559
+ metadata: metadata,
1560
+ retry_policy: @config.rpcs.delete_deidentify_template.retry_policy
1561
+ options.apply_defaults metadata: @config.metadata,
1562
+ retry_policy: @config.retry_policy
1563
+
1564
+ @dlp_service_stub.call_rpc :delete_deidentify_template, request, options: options do |response, operation|
1565
+ yield response, operation if block_given?
1566
+ return response
1567
+ end
1568
+ rescue GRPC::BadStatus => e
1569
+ raise Google::Cloud::Error.from_error(e)
1570
+ end
1571
+
1572
+ ##
1573
+ # Creates a job trigger to run DLP actions such as scanning storage for
1574
+ # sensitive information on a set schedule.
1575
+ # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
1576
+ #
1577
+ # @overload create_job_trigger(request, options = nil)
1578
+ # Pass arguments to `create_job_trigger` via a request object, either of type
1579
+ # {Google::Cloud::Dlp::V2::CreateJobTriggerRequest} or an equivalent Hash.
1580
+ #
1581
+ # @param request [Google::Cloud::Dlp::V2::CreateJobTriggerRequest, Hash]
1582
+ # A request object representing the call parameters. Required. To specify no
1583
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1584
+ # @param options [Gapic::CallOptions, Hash]
1585
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1586
+ #
1587
+ # @overload create_job_trigger(parent: nil, job_trigger: nil, trigger_id: nil, location_id: nil)
1588
+ # Pass arguments to `create_job_trigger` via keyword arguments. Note that at
1589
+ # least one keyword argument is required. To specify no parameters, or to keep all
1590
+ # the default parameter values, pass an empty Hash as a request object (see above).
1591
+ #
1592
+ # @param parent [String]
1593
+ # Required. The parent resource name, for example projects/my-project-id.
1594
+ # @param job_trigger [Google::Cloud::Dlp::V2::JobTrigger, Hash]
1595
+ # Required. The JobTrigger to create.
1596
+ # @param trigger_id [String]
1597
+ # The trigger id can contain uppercase and lowercase letters,
1598
+ # numbers, and hyphens; that is, it must match the regular
1599
+ # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
1600
+ # characters. Can be empty to allow the system to generate one.
1601
+ # @param location_id [String]
1602
+ # The geographic location to store the job trigger. Reserved for
1603
+ # future extensions.
1604
+ #
1605
+ # @yield [response, operation] Access the result along with the RPC operation
1606
+ # @yieldparam response [Google::Cloud::Dlp::V2::JobTrigger]
1607
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1608
+ #
1609
+ # @return [Google::Cloud::Dlp::V2::JobTrigger]
1610
+ #
1611
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1612
+ #
1613
+ def create_job_trigger request, options = nil
1614
+ raise ArgumentError, "request must be provided" if request.nil?
1615
+
1616
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CreateJobTriggerRequest
1617
+
1618
+ # Converts hash and nil to an options object
1619
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1620
+
1621
+ # Customize the options with defaults
1622
+ metadata = @config.rpcs.create_job_trigger.metadata.to_h
1623
+
1624
+ # Set x-goog-api-client and x-goog-user-project headers
1625
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1626
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1627
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1628
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1629
+
1630
+ header_params = {
1631
+ "parent" => request.parent
1632
+ }
1633
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1634
+ metadata[:"x-goog-request-params"] ||= request_params_header
1635
+
1636
+ options.apply_defaults timeout: @config.rpcs.create_job_trigger.timeout,
1637
+ metadata: metadata,
1638
+ retry_policy: @config.rpcs.create_job_trigger.retry_policy
1639
+ options.apply_defaults metadata: @config.metadata,
1640
+ retry_policy: @config.retry_policy
1641
+
1642
+ @dlp_service_stub.call_rpc :create_job_trigger, request, options: options do |response, operation|
1643
+ yield response, operation if block_given?
1644
+ return response
1645
+ end
1646
+ rescue GRPC::BadStatus => e
1647
+ raise Google::Cloud::Error.from_error(e)
1648
+ end
1649
+
1650
+ ##
1651
+ # Updates a job trigger.
1652
+ # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
1653
+ #
1654
+ # @overload update_job_trigger(request, options = nil)
1655
+ # Pass arguments to `update_job_trigger` via a request object, either of type
1656
+ # {Google::Cloud::Dlp::V2::UpdateJobTriggerRequest} or an equivalent Hash.
1657
+ #
1658
+ # @param request [Google::Cloud::Dlp::V2::UpdateJobTriggerRequest, Hash]
1659
+ # A request object representing the call parameters. Required. To specify no
1660
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1661
+ # @param options [Gapic::CallOptions, Hash]
1662
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1663
+ #
1664
+ # @overload update_job_trigger(name: nil, job_trigger: nil, update_mask: nil)
1665
+ # Pass arguments to `update_job_trigger` via keyword arguments. Note that at
1666
+ # least one keyword argument is required. To specify no parameters, or to keep all
1667
+ # the default parameter values, pass an empty Hash as a request object (see above).
1668
+ #
1669
+ # @param name [String]
1670
+ # Required. Resource name of the project and the triggeredJob, for example
1671
+ # `projects/dlp-test-project/jobTriggers/53234423`.
1672
+ # @param job_trigger [Google::Cloud::Dlp::V2::JobTrigger, Hash]
1673
+ # New JobTrigger value.
1674
+ # @param update_mask [Google::Protobuf::FieldMask, Hash]
1675
+ # Mask to control which fields get updated.
1676
+ #
1677
+ # @yield [response, operation] Access the result along with the RPC operation
1678
+ # @yieldparam response [Google::Cloud::Dlp::V2::JobTrigger]
1679
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1680
+ #
1681
+ # @return [Google::Cloud::Dlp::V2::JobTrigger]
1682
+ #
1683
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1684
+ #
1685
+ def update_job_trigger request, options = nil
1686
+ raise ArgumentError, "request must be provided" if request.nil?
1687
+
1688
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::UpdateJobTriggerRequest
1689
+
1690
+ # Converts hash and nil to an options object
1691
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1692
+
1693
+ # Customize the options with defaults
1694
+ metadata = @config.rpcs.update_job_trigger.metadata.to_h
1695
+
1696
+ # Set x-goog-api-client and x-goog-user-project headers
1697
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1698
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1699
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1700
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1701
+
1702
+ header_params = {
1703
+ "name" => request.name
1704
+ }
1705
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1706
+ metadata[:"x-goog-request-params"] ||= request_params_header
1707
+
1708
+ options.apply_defaults timeout: @config.rpcs.update_job_trigger.timeout,
1709
+ metadata: metadata,
1710
+ retry_policy: @config.rpcs.update_job_trigger.retry_policy
1711
+ options.apply_defaults metadata: @config.metadata,
1712
+ retry_policy: @config.retry_policy
1713
+
1714
+ @dlp_service_stub.call_rpc :update_job_trigger, request, options: options do |response, operation|
1715
+ yield response, operation if block_given?
1716
+ return response
1717
+ end
1718
+ rescue GRPC::BadStatus => e
1719
+ raise Google::Cloud::Error.from_error(e)
1720
+ end
1721
+
1722
+ ##
1723
+ # Inspect hybrid content and store findings to a trigger. The inspection
1724
+ # will be processed asynchronously. To review the findings monitor the
1725
+ # jobs within the trigger.
1726
+ # Early access feature is in a pre-release state and might change or have
1727
+ # limited support. For more information, see
1728
+ # https://cloud.google.com/products#product-launch-stages.
1729
+ #
1730
+ # @overload hybrid_inspect_job_trigger(request, options = nil)
1731
+ # Pass arguments to `hybrid_inspect_job_trigger` via a request object, either of type
1732
+ # {Google::Cloud::Dlp::V2::HybridInspectJobTriggerRequest} or an equivalent Hash.
1733
+ #
1734
+ # @param request [Google::Cloud::Dlp::V2::HybridInspectJobTriggerRequest, Hash]
1735
+ # A request object representing the call parameters. Required. To specify no
1736
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1737
+ # @param options [Gapic::CallOptions, Hash]
1738
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1739
+ #
1740
+ # @overload hybrid_inspect_job_trigger(name: nil, hybrid_item: nil)
1741
+ # Pass arguments to `hybrid_inspect_job_trigger` via keyword arguments. Note that at
1742
+ # least one keyword argument is required. To specify no parameters, or to keep all
1743
+ # the default parameter values, pass an empty Hash as a request object (see above).
1744
+ #
1745
+ # @param name [String]
1746
+ # Required. Resource name of the trigger to execute a hybrid inspect on, for
1747
+ # example `projects/dlp-test-project/jobTriggers/53234423`.
1748
+ # @param hybrid_item [Google::Cloud::Dlp::V2::HybridContentItem, Hash]
1749
+ # The item to inspect.
1750
+ #
1751
+ # @yield [response, operation] Access the result along with the RPC operation
1752
+ # @yieldparam response [Google::Cloud::Dlp::V2::HybridInspectResponse]
1753
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1754
+ #
1755
+ # @return [Google::Cloud::Dlp::V2::HybridInspectResponse]
1756
+ #
1757
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1758
+ #
1759
+ def hybrid_inspect_job_trigger request, options = nil
1760
+ raise ArgumentError, "request must be provided" if request.nil?
1761
+
1762
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::HybridInspectJobTriggerRequest
1763
+
1764
+ # Converts hash and nil to an options object
1765
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1766
+
1767
+ # Customize the options with defaults
1768
+ metadata = @config.rpcs.hybrid_inspect_job_trigger.metadata.to_h
1769
+
1770
+ # Set x-goog-api-client and x-goog-user-project headers
1771
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1772
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1773
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1774
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1775
+
1776
+ header_params = {
1777
+ "name" => request.name
1778
+ }
1779
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1780
+ metadata[:"x-goog-request-params"] ||= request_params_header
1781
+
1782
+ options.apply_defaults timeout: @config.rpcs.hybrid_inspect_job_trigger.timeout,
1783
+ metadata: metadata,
1784
+ retry_policy: @config.rpcs.hybrid_inspect_job_trigger.retry_policy
1785
+ options.apply_defaults metadata: @config.metadata,
1786
+ retry_policy: @config.retry_policy
1787
+
1788
+ @dlp_service_stub.call_rpc :hybrid_inspect_job_trigger, request, options: options do |response, operation|
1789
+ yield response, operation if block_given?
1790
+ return response
1791
+ end
1792
+ rescue GRPC::BadStatus => e
1793
+ raise Google::Cloud::Error.from_error(e)
1794
+ end
1795
+
1796
+ ##
1797
+ # Gets a job trigger.
1798
+ # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
1799
+ #
1800
+ # @overload get_job_trigger(request, options = nil)
1801
+ # Pass arguments to `get_job_trigger` via a request object, either of type
1802
+ # {Google::Cloud::Dlp::V2::GetJobTriggerRequest} or an equivalent Hash.
1803
+ #
1804
+ # @param request [Google::Cloud::Dlp::V2::GetJobTriggerRequest, Hash]
1805
+ # A request object representing the call parameters. Required. To specify no
1806
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1807
+ # @param options [Gapic::CallOptions, Hash]
1808
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1809
+ #
1810
+ # @overload get_job_trigger(name: nil)
1811
+ # Pass arguments to `get_job_trigger` via keyword arguments. Note that at
1812
+ # least one keyword argument is required. To specify no parameters, or to keep all
1813
+ # the default parameter values, pass an empty Hash as a request object (see above).
1814
+ #
1815
+ # @param name [String]
1816
+ # Required. Resource name of the project and the triggeredJob, for example
1817
+ # `projects/dlp-test-project/jobTriggers/53234423`.
1818
+ #
1819
+ # @yield [response, operation] Access the result along with the RPC operation
1820
+ # @yieldparam response [Google::Cloud::Dlp::V2::JobTrigger]
1821
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1822
+ #
1823
+ # @return [Google::Cloud::Dlp::V2::JobTrigger]
1824
+ #
1825
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1826
+ #
1827
+ def get_job_trigger request, options = nil
1828
+ raise ArgumentError, "request must be provided" if request.nil?
1829
+
1830
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::GetJobTriggerRequest
1831
+
1832
+ # Converts hash and nil to an options object
1833
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1834
+
1835
+ # Customize the options with defaults
1836
+ metadata = @config.rpcs.get_job_trigger.metadata.to_h
1837
+
1838
+ # Set x-goog-api-client and x-goog-user-project headers
1839
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1840
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1841
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1842
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1843
+
1844
+ header_params = {
1845
+ "name" => request.name
1846
+ }
1847
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1848
+ metadata[:"x-goog-request-params"] ||= request_params_header
1849
+
1850
+ options.apply_defaults timeout: @config.rpcs.get_job_trigger.timeout,
1851
+ metadata: metadata,
1852
+ retry_policy: @config.rpcs.get_job_trigger.retry_policy
1853
+ options.apply_defaults metadata: @config.metadata,
1854
+ retry_policy: @config.retry_policy
1855
+
1856
+ @dlp_service_stub.call_rpc :get_job_trigger, request, options: options do |response, operation|
1857
+ yield response, operation if block_given?
1858
+ return response
1859
+ end
1860
+ rescue GRPC::BadStatus => e
1861
+ raise Google::Cloud::Error.from_error(e)
1862
+ end
1863
+
1864
+ ##
1865
+ # Lists job triggers.
1866
+ # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
1867
+ #
1868
+ # @overload list_job_triggers(request, options = nil)
1869
+ # Pass arguments to `list_job_triggers` via a request object, either of type
1870
+ # {Google::Cloud::Dlp::V2::ListJobTriggersRequest} or an equivalent Hash.
1871
+ #
1872
+ # @param request [Google::Cloud::Dlp::V2::ListJobTriggersRequest, Hash]
1873
+ # A request object representing the call parameters. Required. To specify no
1874
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1875
+ # @param options [Gapic::CallOptions, Hash]
1876
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1877
+ #
1878
+ # @overload list_job_triggers(parent: nil, page_token: nil, page_size: nil, order_by: nil, filter: nil, location_id: nil)
1879
+ # Pass arguments to `list_job_triggers` via keyword arguments. Note that at
1880
+ # least one keyword argument is required. To specify no parameters, or to keep all
1881
+ # the default parameter values, pass an empty Hash as a request object (see above).
1882
+ #
1883
+ # @param parent [String]
1884
+ # Required. The parent resource name, for example `projects/my-project-id`.
1885
+ # @param page_token [String]
1886
+ # Page token to continue retrieval. Comes from previous call
1887
+ # to ListJobTriggers. `order_by` field must not
1888
+ # change for subsequent calls.
1889
+ # @param page_size [Integer]
1890
+ # Size of the page, can be limited by a server.
1891
+ # @param order_by [String]
1892
+ # Comma separated list of triggeredJob fields to order by,
1893
+ # followed by `asc` or `desc` postfix. This list is case-insensitive,
1894
+ # default sorting order is ascending, redundant space characters are
1895
+ # insignificant.
1896
+ #
1897
+ # Example: `name asc,update_time, create_time desc`
1898
+ #
1899
+ # Supported fields are:
1900
+ #
1901
+ # - `create_time`: corresponds to time the JobTrigger was created.
1902
+ # - `update_time`: corresponds to time the JobTrigger was last updated.
1903
+ # - `last_run_time`: corresponds to the last time the JobTrigger ran.
1904
+ # - `name`: corresponds to JobTrigger's name.
1905
+ # - `display_name`: corresponds to JobTrigger's display name.
1906
+ # - `status`: corresponds to JobTrigger's status.
1907
+ # @param filter [String]
1908
+ # Allows filtering.
1909
+ #
1910
+ # Supported syntax:
1911
+ #
1912
+ # * Filter expressions are made up of one or more restrictions.
1913
+ # * Restrictions can be combined by `AND` or `OR` logical operators. A
1914
+ # sequence of restrictions implicitly uses `AND`.
1915
+ # * A restriction has the form of `{field} {operator} {value}`.
1916
+ # * Supported fields/values for inspect jobs:
1917
+ # - `status` - HEALTHY|PAUSED|CANCELLED
1918
+ # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
1919
+ # - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
1920
+ # quotation marks. Nanoseconds are ignored.
1921
+ # - 'error_count' - Number of errors that have occurred while running.
1922
+ # * The operator must be `=` or `!=` for status and inspected_storage.
1923
+ #
1924
+ # Examples:
1925
+ #
1926
+ # * inspected_storage = cloud_storage AND status = HEALTHY
1927
+ # * inspected_storage = cloud_storage OR inspected_storage = bigquery
1928
+ # * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
1929
+ # * last_run_time > \"2017-12-12T00:00:00+00:00\"
1930
+ #
1931
+ # The length of this field should be no more than 500 characters.
1932
+ # @param location_id [String]
1933
+ # The geographic location where job triggers will be retrieved from.
1934
+ # Use `-` for all locations. Reserved for future extensions.
1935
+ #
1936
+ # @yield [response, operation] Access the result along with the RPC operation
1937
+ # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::JobTrigger>]
1938
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
1939
+ #
1940
+ # @return [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::JobTrigger>]
1941
+ #
1942
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
1943
+ #
1944
+ def list_job_triggers request, options = nil
1945
+ raise ArgumentError, "request must be provided" if request.nil?
1946
+
1947
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListJobTriggersRequest
1948
+
1949
+ # Converts hash and nil to an options object
1950
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1951
+
1952
+ # Customize the options with defaults
1953
+ metadata = @config.rpcs.list_job_triggers.metadata.to_h
1954
+
1955
+ # Set x-goog-api-client and x-goog-user-project headers
1956
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
1957
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1958
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
1959
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1960
+
1961
+ header_params = {
1962
+ "parent" => request.parent
1963
+ }
1964
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1965
+ metadata[:"x-goog-request-params"] ||= request_params_header
1966
+
1967
+ options.apply_defaults timeout: @config.rpcs.list_job_triggers.timeout,
1968
+ metadata: metadata,
1969
+ retry_policy: @config.rpcs.list_job_triggers.retry_policy
1970
+ options.apply_defaults metadata: @config.metadata,
1971
+ retry_policy: @config.retry_policy
1972
+
1973
+ @dlp_service_stub.call_rpc :list_job_triggers, request, options: options do |response, operation|
1974
+ response = Gapic::PagedEnumerable.new @dlp_service_stub, :list_job_triggers, request, response, operation, options
1975
+ yield response, operation if block_given?
1976
+ return response
1977
+ end
1978
+ rescue GRPC::BadStatus => e
1979
+ raise Google::Cloud::Error.from_error(e)
1980
+ end
1981
+
1982
+ ##
1983
+ # Deletes a job trigger.
1984
+ # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
1985
+ #
1986
+ # @overload delete_job_trigger(request, options = nil)
1987
+ # Pass arguments to `delete_job_trigger` via a request object, either of type
1988
+ # {Google::Cloud::Dlp::V2::DeleteJobTriggerRequest} or an equivalent Hash.
1989
+ #
1990
+ # @param request [Google::Cloud::Dlp::V2::DeleteJobTriggerRequest, Hash]
1991
+ # A request object representing the call parameters. Required. To specify no
1992
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1993
+ # @param options [Gapic::CallOptions, Hash]
1994
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1995
+ #
1996
+ # @overload delete_job_trigger(name: nil)
1997
+ # Pass arguments to `delete_job_trigger` via keyword arguments. Note that at
1998
+ # least one keyword argument is required. To specify no parameters, or to keep all
1999
+ # the default parameter values, pass an empty Hash as a request object (see above).
2000
+ #
2001
+ # @param name [String]
2002
+ # Required. Resource name of the project and the triggeredJob, for example
2003
+ # `projects/dlp-test-project/jobTriggers/53234423`.
2004
+ #
2005
+ # @yield [response, operation] Access the result along with the RPC operation
2006
+ # @yieldparam response [Google::Protobuf::Empty]
2007
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2008
+ #
2009
+ # @return [Google::Protobuf::Empty]
2010
+ #
2011
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2012
+ #
2013
+ def delete_job_trigger request, options = nil
2014
+ raise ArgumentError, "request must be provided" if request.nil?
2015
+
2016
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeleteJobTriggerRequest
2017
+
2018
+ # Converts hash and nil to an options object
2019
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2020
+
2021
+ # Customize the options with defaults
2022
+ metadata = @config.rpcs.delete_job_trigger.metadata.to_h
2023
+
2024
+ # Set x-goog-api-client and x-goog-user-project headers
2025
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2026
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2027
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2028
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2029
+
2030
+ header_params = {
2031
+ "name" => request.name
2032
+ }
2033
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2034
+ metadata[:"x-goog-request-params"] ||= request_params_header
2035
+
2036
+ options.apply_defaults timeout: @config.rpcs.delete_job_trigger.timeout,
2037
+ metadata: metadata,
2038
+ retry_policy: @config.rpcs.delete_job_trigger.retry_policy
2039
+ options.apply_defaults metadata: @config.metadata,
2040
+ retry_policy: @config.retry_policy
2041
+
2042
+ @dlp_service_stub.call_rpc :delete_job_trigger, request, options: options do |response, operation|
2043
+ yield response, operation if block_given?
2044
+ return response
2045
+ end
2046
+ rescue GRPC::BadStatus => e
2047
+ raise Google::Cloud::Error.from_error(e)
2048
+ end
2049
+
2050
+ ##
2051
+ # Activate a job trigger. Causes the immediate execute of a trigger
2052
+ # instead of waiting on the trigger event to occur.
2053
+ #
2054
+ # @overload activate_job_trigger(request, options = nil)
2055
+ # Pass arguments to `activate_job_trigger` via a request object, either of type
2056
+ # {Google::Cloud::Dlp::V2::ActivateJobTriggerRequest} or an equivalent Hash.
2057
+ #
2058
+ # @param request [Google::Cloud::Dlp::V2::ActivateJobTriggerRequest, Hash]
2059
+ # A request object representing the call parameters. Required. To specify no
2060
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2061
+ # @param options [Gapic::CallOptions, Hash]
2062
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2063
+ #
2064
+ # @overload activate_job_trigger(name: nil)
2065
+ # Pass arguments to `activate_job_trigger` via keyword arguments. Note that at
2066
+ # least one keyword argument is required. To specify no parameters, or to keep all
2067
+ # the default parameter values, pass an empty Hash as a request object (see above).
2068
+ #
2069
+ # @param name [String]
2070
+ # Required. Resource name of the trigger to activate, for example
2071
+ # `projects/dlp-test-project/jobTriggers/53234423`.
2072
+ #
2073
+ # @yield [response, operation] Access the result along with the RPC operation
2074
+ # @yieldparam response [Google::Cloud::Dlp::V2::DlpJob]
2075
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2076
+ #
2077
+ # @return [Google::Cloud::Dlp::V2::DlpJob]
2078
+ #
2079
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2080
+ #
2081
+ def activate_job_trigger request, options = nil
2082
+ raise ArgumentError, "request must be provided" if request.nil?
2083
+
2084
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ActivateJobTriggerRequest
2085
+
2086
+ # Converts hash and nil to an options object
2087
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2088
+
2089
+ # Customize the options with defaults
2090
+ metadata = @config.rpcs.activate_job_trigger.metadata.to_h
2091
+
2092
+ # Set x-goog-api-client and x-goog-user-project headers
2093
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2094
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2095
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2096
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2097
+
2098
+ header_params = {
2099
+ "name" => request.name
2100
+ }
2101
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2102
+ metadata[:"x-goog-request-params"] ||= request_params_header
2103
+
2104
+ options.apply_defaults timeout: @config.rpcs.activate_job_trigger.timeout,
2105
+ metadata: metadata,
2106
+ retry_policy: @config.rpcs.activate_job_trigger.retry_policy
2107
+ options.apply_defaults metadata: @config.metadata,
2108
+ retry_policy: @config.retry_policy
2109
+
2110
+ @dlp_service_stub.call_rpc :activate_job_trigger, request, options: options do |response, operation|
2111
+ yield response, operation if block_given?
2112
+ return response
2113
+ end
2114
+ rescue GRPC::BadStatus => e
2115
+ raise Google::Cloud::Error.from_error(e)
2116
+ end
2117
+
2118
+ ##
2119
+ # Creates a new job to inspect storage or calculate risk metrics.
2120
+ # See https://cloud.google.com/dlp/docs/inspecting-storage and
2121
+ # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
2122
+ #
2123
+ # When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
2124
+ # system will automatically choose what detectors to run. By default this may
2125
+ # be all types, but may change over time as detectors are updated.
2126
+ #
2127
+ # @overload create_dlp_job(request, options = nil)
2128
+ # Pass arguments to `create_dlp_job` via a request object, either of type
2129
+ # {Google::Cloud::Dlp::V2::CreateDlpJobRequest} or an equivalent Hash.
2130
+ #
2131
+ # @param request [Google::Cloud::Dlp::V2::CreateDlpJobRequest, Hash]
2132
+ # A request object representing the call parameters. Required. To specify no
2133
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2134
+ # @param options [Gapic::CallOptions, Hash]
2135
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2136
+ #
2137
+ # @overload create_dlp_job(parent: nil, inspect_job: nil, risk_job: nil, job_id: nil, location_id: nil)
2138
+ # Pass arguments to `create_dlp_job` via keyword arguments. Note that at
2139
+ # least one keyword argument is required. To specify no parameters, or to keep all
2140
+ # the default parameter values, pass an empty Hash as a request object (see above).
2141
+ #
2142
+ # @param parent [String]
2143
+ # Required. The parent resource name, for example projects/my-project-id.
2144
+ # @param inspect_job [Google::Cloud::Dlp::V2::InspectJobConfig, Hash]
2145
+ # Set to control what and how to inspect.
2146
+ # @param risk_job [Google::Cloud::Dlp::V2::RiskAnalysisJobConfig, Hash]
2147
+ # Set to choose what metric to calculate.
2148
+ # @param job_id [String]
2149
+ # The job id can contain uppercase and lowercase letters,
2150
+ # numbers, and hyphens; that is, it must match the regular
2151
+ # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2152
+ # characters. Can be empty to allow the system to generate one.
2153
+ # @param location_id [String]
2154
+ # The geographic location to store and process the job. Reserved for
2155
+ # future extensions.
2156
+ #
2157
+ # @yield [response, operation] Access the result along with the RPC operation
2158
+ # @yieldparam response [Google::Cloud::Dlp::V2::DlpJob]
2159
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2160
+ #
2161
+ # @return [Google::Cloud::Dlp::V2::DlpJob]
2162
+ #
2163
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2164
+ #
2165
+ def create_dlp_job request, options = nil
2166
+ raise ArgumentError, "request must be provided" if request.nil?
2167
+
2168
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CreateDlpJobRequest
2169
+
2170
+ # Converts hash and nil to an options object
2171
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2172
+
2173
+ # Customize the options with defaults
2174
+ metadata = @config.rpcs.create_dlp_job.metadata.to_h
2175
+
2176
+ # Set x-goog-api-client and x-goog-user-project headers
2177
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2178
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2179
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2180
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2181
+
2182
+ header_params = {
2183
+ "parent" => request.parent
2184
+ }
2185
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2186
+ metadata[:"x-goog-request-params"] ||= request_params_header
2187
+
2188
+ options.apply_defaults timeout: @config.rpcs.create_dlp_job.timeout,
2189
+ metadata: metadata,
2190
+ retry_policy: @config.rpcs.create_dlp_job.retry_policy
2191
+ options.apply_defaults metadata: @config.metadata,
2192
+ retry_policy: @config.retry_policy
2193
+
2194
+ @dlp_service_stub.call_rpc :create_dlp_job, request, options: options do |response, operation|
2195
+ yield response, operation if block_given?
2196
+ return response
2197
+ end
2198
+ rescue GRPC::BadStatus => e
2199
+ raise Google::Cloud::Error.from_error(e)
2200
+ end
2201
+
2202
+ ##
2203
+ # Lists DlpJobs that match the specified filter in the request.
2204
+ # See https://cloud.google.com/dlp/docs/inspecting-storage and
2205
+ # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
2206
+ #
2207
+ # @overload list_dlp_jobs(request, options = nil)
2208
+ # Pass arguments to `list_dlp_jobs` via a request object, either of type
2209
+ # {Google::Cloud::Dlp::V2::ListDlpJobsRequest} or an equivalent Hash.
2210
+ #
2211
+ # @param request [Google::Cloud::Dlp::V2::ListDlpJobsRequest, Hash]
2212
+ # A request object representing the call parameters. Required. To specify no
2213
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2214
+ # @param options [Gapic::CallOptions, Hash]
2215
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2216
+ #
2217
+ # @overload list_dlp_jobs(parent: nil, filter: nil, page_size: nil, page_token: nil, type: nil, order_by: nil, location_id: nil)
2218
+ # Pass arguments to `list_dlp_jobs` via keyword arguments. Note that at
2219
+ # least one keyword argument is required. To specify no parameters, or to keep all
2220
+ # the default parameter values, pass an empty Hash as a request object (see above).
2221
+ #
2222
+ # @param parent [String]
2223
+ # Required. The parent resource name, for example projects/my-project-id.
2224
+ # @param filter [String]
2225
+ # Allows filtering.
2226
+ #
2227
+ # Supported syntax:
2228
+ #
2229
+ # * Filter expressions are made up of one or more restrictions.
2230
+ # * Restrictions can be combined by `AND` or `OR` logical operators. A
2231
+ # sequence of restrictions implicitly uses `AND`.
2232
+ # * A restriction has the form of `{field} {operator} {value}`.
2233
+ # * Supported fields/values for inspect jobs:
2234
+ # - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
2235
+ # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
2236
+ # - `trigger_name` - The resource name of the trigger that created job.
2237
+ # - 'end_time` - Corresponds to time the job finished.
2238
+ # - 'start_time` - Corresponds to time the job finished.
2239
+ # * Supported fields for risk analysis jobs:
2240
+ # - `state` - RUNNING|CANCELED|FINISHED|FAILED
2241
+ # - 'end_time` - Corresponds to time the job finished.
2242
+ # - 'start_time` - Corresponds to time the job finished.
2243
+ # * The operator must be `=` or `!=`.
2244
+ #
2245
+ # Examples:
2246
+ #
2247
+ # * inspected_storage = cloud_storage AND state = done
2248
+ # * inspected_storage = cloud_storage OR inspected_storage = bigquery
2249
+ # * inspected_storage = cloud_storage AND (state = done OR state = canceled)
2250
+ # * end_time > \"2017-12-12T00:00:00+00:00\"
2251
+ #
2252
+ # The length of this field should be no more than 500 characters.
2253
+ # @param page_size [Integer]
2254
+ # The standard list page size.
2255
+ # @param page_token [String]
2256
+ # The standard list page token.
2257
+ # @param type [Google::Cloud::Dlp::V2::DlpJobType]
2258
+ # The type of job. Defaults to `DlpJobType.INSPECT`
2259
+ # @param order_by [String]
2260
+ # Comma separated list of fields to order by,
2261
+ # followed by `asc` or `desc` postfix. This list is case-insensitive,
2262
+ # default sorting order is ascending, redundant space characters are
2263
+ # insignificant.
2264
+ #
2265
+ # Example: `name asc, end_time asc, create_time desc`
2266
+ #
2267
+ # Supported fields are:
2268
+ #
2269
+ # - `create_time`: corresponds to time the job was created.
2270
+ # - `end_time`: corresponds to time the job ended.
2271
+ # - `name`: corresponds to job's name.
2272
+ # - `state`: corresponds to `state`
2273
+ # @param location_id [String]
2274
+ # The geographic location where jobs will be retrieved from.
2275
+ # Use `-` for all locations. Reserved for future extensions.
2276
+ #
2277
+ # @yield [response, operation] Access the result along with the RPC operation
2278
+ # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::DlpJob>]
2279
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2280
+ #
2281
+ # @return [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::DlpJob>]
2282
+ #
2283
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2284
+ #
2285
+ def list_dlp_jobs request, options = nil
2286
+ raise ArgumentError, "request must be provided" if request.nil?
2287
+
2288
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListDlpJobsRequest
2289
+
2290
+ # Converts hash and nil to an options object
2291
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2292
+
2293
+ # Customize the options with defaults
2294
+ metadata = @config.rpcs.list_dlp_jobs.metadata.to_h
2295
+
2296
+ # Set x-goog-api-client and x-goog-user-project headers
2297
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2298
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2299
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2300
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2301
+
2302
+ header_params = {
2303
+ "parent" => request.parent
2304
+ }
2305
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2306
+ metadata[:"x-goog-request-params"] ||= request_params_header
2307
+
2308
+ options.apply_defaults timeout: @config.rpcs.list_dlp_jobs.timeout,
2309
+ metadata: metadata,
2310
+ retry_policy: @config.rpcs.list_dlp_jobs.retry_policy
2311
+ options.apply_defaults metadata: @config.metadata,
2312
+ retry_policy: @config.retry_policy
2313
+
2314
+ @dlp_service_stub.call_rpc :list_dlp_jobs, request, options: options do |response, operation|
2315
+ response = Gapic::PagedEnumerable.new @dlp_service_stub, :list_dlp_jobs, request, response, operation, options
2316
+ yield response, operation if block_given?
2317
+ return response
2318
+ end
2319
+ rescue GRPC::BadStatus => e
2320
+ raise Google::Cloud::Error.from_error(e)
2321
+ end
2322
+
2323
+ ##
2324
+ # Gets the latest state of a long-running DlpJob.
2325
+ # See https://cloud.google.com/dlp/docs/inspecting-storage and
2326
+ # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
2327
+ #
2328
+ # @overload get_dlp_job(request, options = nil)
2329
+ # Pass arguments to `get_dlp_job` via a request object, either of type
2330
+ # {Google::Cloud::Dlp::V2::GetDlpJobRequest} or an equivalent Hash.
2331
+ #
2332
+ # @param request [Google::Cloud::Dlp::V2::GetDlpJobRequest, Hash]
2333
+ # A request object representing the call parameters. Required. To specify no
2334
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2335
+ # @param options [Gapic::CallOptions, Hash]
2336
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2337
+ #
2338
+ # @overload get_dlp_job(name: nil)
2339
+ # Pass arguments to `get_dlp_job` via keyword arguments. Note that at
2340
+ # least one keyword argument is required. To specify no parameters, or to keep all
2341
+ # the default parameter values, pass an empty Hash as a request object (see above).
2342
+ #
2343
+ # @param name [String]
2344
+ # Required. The name of the DlpJob resource.
2345
+ #
2346
+ # @yield [response, operation] Access the result along with the RPC operation
2347
+ # @yieldparam response [Google::Cloud::Dlp::V2::DlpJob]
2348
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2349
+ #
2350
+ # @return [Google::Cloud::Dlp::V2::DlpJob]
2351
+ #
2352
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2353
+ #
2354
+ def get_dlp_job request, options = nil
2355
+ raise ArgumentError, "request must be provided" if request.nil?
2356
+
2357
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::GetDlpJobRequest
2358
+
2359
+ # Converts hash and nil to an options object
2360
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2361
+
2362
+ # Customize the options with defaults
2363
+ metadata = @config.rpcs.get_dlp_job.metadata.to_h
2364
+
2365
+ # Set x-goog-api-client and x-goog-user-project headers
2366
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2367
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2368
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2369
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2370
+
2371
+ header_params = {
2372
+ "name" => request.name
2373
+ }
2374
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2375
+ metadata[:"x-goog-request-params"] ||= request_params_header
2376
+
2377
+ options.apply_defaults timeout: @config.rpcs.get_dlp_job.timeout,
2378
+ metadata: metadata,
2379
+ retry_policy: @config.rpcs.get_dlp_job.retry_policy
2380
+ options.apply_defaults metadata: @config.metadata,
2381
+ retry_policy: @config.retry_policy
2382
+
2383
+ @dlp_service_stub.call_rpc :get_dlp_job, request, options: options do |response, operation|
2384
+ yield response, operation if block_given?
2385
+ return response
2386
+ end
2387
+ rescue GRPC::BadStatus => e
2388
+ raise Google::Cloud::Error.from_error(e)
2389
+ end
2390
+
2391
+ ##
2392
+ # Deletes a long-running DlpJob. This method indicates that the client is
2393
+ # no longer interested in the DlpJob result. The job will be cancelled if
2394
+ # possible.
2395
+ # See https://cloud.google.com/dlp/docs/inspecting-storage and
2396
+ # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
2397
+ #
2398
+ # @overload delete_dlp_job(request, options = nil)
2399
+ # Pass arguments to `delete_dlp_job` via a request object, either of type
2400
+ # {Google::Cloud::Dlp::V2::DeleteDlpJobRequest} or an equivalent Hash.
2401
+ #
2402
+ # @param request [Google::Cloud::Dlp::V2::DeleteDlpJobRequest, Hash]
2403
+ # A request object representing the call parameters. Required. To specify no
2404
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2405
+ # @param options [Gapic::CallOptions, Hash]
2406
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2407
+ #
2408
+ # @overload delete_dlp_job(name: nil)
2409
+ # Pass arguments to `delete_dlp_job` via keyword arguments. Note that at
2410
+ # least one keyword argument is required. To specify no parameters, or to keep all
2411
+ # the default parameter values, pass an empty Hash as a request object (see above).
2412
+ #
2413
+ # @param name [String]
2414
+ # Required. The name of the DlpJob resource to be deleted.
2415
+ #
2416
+ # @yield [response, operation] Access the result along with the RPC operation
2417
+ # @yieldparam response [Google::Protobuf::Empty]
2418
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2419
+ #
2420
+ # @return [Google::Protobuf::Empty]
2421
+ #
2422
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2423
+ #
2424
+ def delete_dlp_job request, options = nil
2425
+ raise ArgumentError, "request must be provided" if request.nil?
2426
+
2427
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeleteDlpJobRequest
2428
+
2429
+ # Converts hash and nil to an options object
2430
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2431
+
2432
+ # Customize the options with defaults
2433
+ metadata = @config.rpcs.delete_dlp_job.metadata.to_h
2434
+
2435
+ # Set x-goog-api-client and x-goog-user-project headers
2436
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2437
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2438
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2439
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2440
+
2441
+ header_params = {
2442
+ "name" => request.name
2443
+ }
2444
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2445
+ metadata[:"x-goog-request-params"] ||= request_params_header
2446
+
2447
+ options.apply_defaults timeout: @config.rpcs.delete_dlp_job.timeout,
2448
+ metadata: metadata,
2449
+ retry_policy: @config.rpcs.delete_dlp_job.retry_policy
2450
+ options.apply_defaults metadata: @config.metadata,
2451
+ retry_policy: @config.retry_policy
2452
+
2453
+ @dlp_service_stub.call_rpc :delete_dlp_job, request, options: options do |response, operation|
2454
+ yield response, operation if block_given?
2455
+ return response
2456
+ end
2457
+ rescue GRPC::BadStatus => e
2458
+ raise Google::Cloud::Error.from_error(e)
2459
+ end
2460
+
2461
+ ##
2462
+ # Starts asynchronous cancellation on a long-running DlpJob. The server
2463
+ # makes a best effort to cancel the DlpJob, but success is not
2464
+ # guaranteed.
2465
+ # See https://cloud.google.com/dlp/docs/inspecting-storage and
2466
+ # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
2467
+ #
2468
+ # @overload cancel_dlp_job(request, options = nil)
2469
+ # Pass arguments to `cancel_dlp_job` via a request object, either of type
2470
+ # {Google::Cloud::Dlp::V2::CancelDlpJobRequest} or an equivalent Hash.
2471
+ #
2472
+ # @param request [Google::Cloud::Dlp::V2::CancelDlpJobRequest, Hash]
2473
+ # A request object representing the call parameters. Required. To specify no
2474
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2475
+ # @param options [Gapic::CallOptions, Hash]
2476
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2477
+ #
2478
+ # @overload cancel_dlp_job(name: nil)
2479
+ # Pass arguments to `cancel_dlp_job` via keyword arguments. Note that at
2480
+ # least one keyword argument is required. To specify no parameters, or to keep all
2481
+ # the default parameter values, pass an empty Hash as a request object (see above).
2482
+ #
2483
+ # @param name [String]
2484
+ # Required. The name of the DlpJob resource to be cancelled.
2485
+ #
2486
+ # @yield [response, operation] Access the result along with the RPC operation
2487
+ # @yieldparam response [Google::Protobuf::Empty]
2488
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2489
+ #
2490
+ # @return [Google::Protobuf::Empty]
2491
+ #
2492
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2493
+ #
2494
+ def cancel_dlp_job request, options = nil
2495
+ raise ArgumentError, "request must be provided" if request.nil?
2496
+
2497
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CancelDlpJobRequest
2498
+
2499
+ # Converts hash and nil to an options object
2500
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2501
+
2502
+ # Customize the options with defaults
2503
+ metadata = @config.rpcs.cancel_dlp_job.metadata.to_h
2504
+
2505
+ # Set x-goog-api-client and x-goog-user-project headers
2506
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2507
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2508
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2509
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2510
+
2511
+ header_params = {
2512
+ "name" => request.name
2513
+ }
2514
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2515
+ metadata[:"x-goog-request-params"] ||= request_params_header
2516
+
2517
+ options.apply_defaults timeout: @config.rpcs.cancel_dlp_job.timeout,
2518
+ metadata: metadata,
2519
+ retry_policy: @config.rpcs.cancel_dlp_job.retry_policy
2520
+ options.apply_defaults metadata: @config.metadata,
2521
+ retry_policy: @config.retry_policy
2522
+
2523
+ @dlp_service_stub.call_rpc :cancel_dlp_job, request, options: options do |response, operation|
2524
+ yield response, operation if block_given?
2525
+ return response
2526
+ end
2527
+ rescue GRPC::BadStatus => e
2528
+ raise Google::Cloud::Error.from_error(e)
2529
+ end
2530
+
2531
+ ##
2532
+ # Creates a pre-built stored infoType to be used for inspection.
2533
+ # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
2534
+ # learn more.
2535
+ #
2536
+ # @overload create_stored_info_type(request, options = nil)
2537
+ # Pass arguments to `create_stored_info_type` via a request object, either of type
2538
+ # {Google::Cloud::Dlp::V2::CreateStoredInfoTypeRequest} or an equivalent Hash.
2539
+ #
2540
+ # @param request [Google::Cloud::Dlp::V2::CreateStoredInfoTypeRequest, Hash]
2541
+ # A request object representing the call parameters. Required. To specify no
2542
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2543
+ # @param options [Gapic::CallOptions, Hash]
2544
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2545
+ #
2546
+ # @overload create_stored_info_type(parent: nil, config: nil, stored_info_type_id: nil, location_id: nil)
2547
+ # Pass arguments to `create_stored_info_type` via keyword arguments. Note that at
2548
+ # least one keyword argument is required. To specify no parameters, or to keep all
2549
+ # the default parameter values, pass an empty Hash as a request object (see above).
2550
+ #
2551
+ # @param parent [String]
2552
+ # Required. The parent resource name, for example projects/my-project-id or
2553
+ # organizations/my-org-id.
2554
+ # @param config [Google::Cloud::Dlp::V2::StoredInfoTypeConfig, Hash]
2555
+ # Required. Configuration of the storedInfoType to create.
2556
+ # @param stored_info_type_id [String]
2557
+ # The storedInfoType ID can contain uppercase and lowercase letters,
2558
+ # numbers, and hyphens; that is, it must match the regular
2559
+ # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
2560
+ # characters. Can be empty to allow the system to generate one.
2561
+ # @param location_id [String]
2562
+ # The geographic location to store the stored infoType. Reserved for
2563
+ # future extensions.
2564
+ #
2565
+ # @yield [response, operation] Access the result along with the RPC operation
2566
+ # @yieldparam response [Google::Cloud::Dlp::V2::StoredInfoType]
2567
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2568
+ #
2569
+ # @return [Google::Cloud::Dlp::V2::StoredInfoType]
2570
+ #
2571
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2572
+ #
2573
+ def create_stored_info_type request, options = nil
2574
+ raise ArgumentError, "request must be provided" if request.nil?
2575
+
2576
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::CreateStoredInfoTypeRequest
2577
+
2578
+ # Converts hash and nil to an options object
2579
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2580
+
2581
+ # Customize the options with defaults
2582
+ metadata = @config.rpcs.create_stored_info_type.metadata.to_h
2583
+
2584
+ # Set x-goog-api-client and x-goog-user-project headers
2585
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2586
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2587
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2588
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2589
+
2590
+ header_params = {
2591
+ "parent" => request.parent
2592
+ }
2593
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2594
+ metadata[:"x-goog-request-params"] ||= request_params_header
2595
+
2596
+ options.apply_defaults timeout: @config.rpcs.create_stored_info_type.timeout,
2597
+ metadata: metadata,
2598
+ retry_policy: @config.rpcs.create_stored_info_type.retry_policy
2599
+ options.apply_defaults metadata: @config.metadata,
2600
+ retry_policy: @config.retry_policy
2601
+
2602
+ @dlp_service_stub.call_rpc :create_stored_info_type, request, options: options do |response, operation|
2603
+ yield response, operation if block_given?
2604
+ return response
2605
+ end
2606
+ rescue GRPC::BadStatus => e
2607
+ raise Google::Cloud::Error.from_error(e)
2608
+ end
2609
+
2610
+ ##
2611
+ # Updates the stored infoType by creating a new version. The existing version
2612
+ # will continue to be used until the new version is ready.
2613
+ # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
2614
+ # learn more.
2615
+ #
2616
+ # @overload update_stored_info_type(request, options = nil)
2617
+ # Pass arguments to `update_stored_info_type` via a request object, either of type
2618
+ # {Google::Cloud::Dlp::V2::UpdateStoredInfoTypeRequest} or an equivalent Hash.
2619
+ #
2620
+ # @param request [Google::Cloud::Dlp::V2::UpdateStoredInfoTypeRequest, Hash]
2621
+ # A request object representing the call parameters. Required. To specify no
2622
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2623
+ # @param options [Gapic::CallOptions, Hash]
2624
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2625
+ #
2626
+ # @overload update_stored_info_type(name: nil, config: nil, update_mask: nil)
2627
+ # Pass arguments to `update_stored_info_type` via keyword arguments. Note that at
2628
+ # least one keyword argument is required. To specify no parameters, or to keep all
2629
+ # the default parameter values, pass an empty Hash as a request object (see above).
2630
+ #
2631
+ # @param name [String]
2632
+ # Required. Resource name of organization and storedInfoType to be updated,
2633
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
2634
+ # projects/project-id/storedInfoTypes/432452342.
2635
+ # @param config [Google::Cloud::Dlp::V2::StoredInfoTypeConfig, Hash]
2636
+ # Updated configuration for the storedInfoType. If not provided, a new
2637
+ # version of the storedInfoType will be created with the existing
2638
+ # configuration.
2639
+ # @param update_mask [Google::Protobuf::FieldMask, Hash]
2640
+ # Mask to control which fields get updated.
2641
+ #
2642
+ # @yield [response, operation] Access the result along with the RPC operation
2643
+ # @yieldparam response [Google::Cloud::Dlp::V2::StoredInfoType]
2644
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2645
+ #
2646
+ # @return [Google::Cloud::Dlp::V2::StoredInfoType]
2647
+ #
2648
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2649
+ #
2650
+ def update_stored_info_type request, options = nil
2651
+ raise ArgumentError, "request must be provided" if request.nil?
2652
+
2653
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::UpdateStoredInfoTypeRequest
2654
+
2655
+ # Converts hash and nil to an options object
2656
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2657
+
2658
+ # Customize the options with defaults
2659
+ metadata = @config.rpcs.update_stored_info_type.metadata.to_h
2660
+
2661
+ # Set x-goog-api-client and x-goog-user-project headers
2662
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2663
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2664
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2665
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2666
+
2667
+ header_params = {
2668
+ "name" => request.name
2669
+ }
2670
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2671
+ metadata[:"x-goog-request-params"] ||= request_params_header
2672
+
2673
+ options.apply_defaults timeout: @config.rpcs.update_stored_info_type.timeout,
2674
+ metadata: metadata,
2675
+ retry_policy: @config.rpcs.update_stored_info_type.retry_policy
2676
+ options.apply_defaults metadata: @config.metadata,
2677
+ retry_policy: @config.retry_policy
2678
+
2679
+ @dlp_service_stub.call_rpc :update_stored_info_type, request, options: options do |response, operation|
2680
+ yield response, operation if block_given?
2681
+ return response
2682
+ end
2683
+ rescue GRPC::BadStatus => e
2684
+ raise Google::Cloud::Error.from_error(e)
2685
+ end
2686
+
2687
+ ##
2688
+ # Gets a stored infoType.
2689
+ # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
2690
+ # learn more.
2691
+ #
2692
+ # @overload get_stored_info_type(request, options = nil)
2693
+ # Pass arguments to `get_stored_info_type` via a request object, either of type
2694
+ # {Google::Cloud::Dlp::V2::GetStoredInfoTypeRequest} or an equivalent Hash.
2695
+ #
2696
+ # @param request [Google::Cloud::Dlp::V2::GetStoredInfoTypeRequest, Hash]
2697
+ # A request object representing the call parameters. Required. To specify no
2698
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2699
+ # @param options [Gapic::CallOptions, Hash]
2700
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2701
+ #
2702
+ # @overload get_stored_info_type(name: nil)
2703
+ # Pass arguments to `get_stored_info_type` via keyword arguments. Note that at
2704
+ # least one keyword argument is required. To specify no parameters, or to keep all
2705
+ # the default parameter values, pass an empty Hash as a request object (see above).
2706
+ #
2707
+ # @param name [String]
2708
+ # Required. Resource name of the organization and storedInfoType to be read,
2709
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
2710
+ # projects/project-id/storedInfoTypes/432452342.
2711
+ #
2712
+ # @yield [response, operation] Access the result along with the RPC operation
2713
+ # @yieldparam response [Google::Cloud::Dlp::V2::StoredInfoType]
2714
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2715
+ #
2716
+ # @return [Google::Cloud::Dlp::V2::StoredInfoType]
2717
+ #
2718
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2719
+ #
2720
+ def get_stored_info_type request, options = nil
2721
+ raise ArgumentError, "request must be provided" if request.nil?
2722
+
2723
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::GetStoredInfoTypeRequest
2724
+
2725
+ # Converts hash and nil to an options object
2726
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2727
+
2728
+ # Customize the options with defaults
2729
+ metadata = @config.rpcs.get_stored_info_type.metadata.to_h
2730
+
2731
+ # Set x-goog-api-client and x-goog-user-project headers
2732
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2733
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2734
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2735
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2736
+
2737
+ header_params = {
2738
+ "name" => request.name
2739
+ }
2740
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2741
+ metadata[:"x-goog-request-params"] ||= request_params_header
2742
+
2743
+ options.apply_defaults timeout: @config.rpcs.get_stored_info_type.timeout,
2744
+ metadata: metadata,
2745
+ retry_policy: @config.rpcs.get_stored_info_type.retry_policy
2746
+ options.apply_defaults metadata: @config.metadata,
2747
+ retry_policy: @config.retry_policy
2748
+
2749
+ @dlp_service_stub.call_rpc :get_stored_info_type, request, options: options do |response, operation|
2750
+ yield response, operation if block_given?
2751
+ return response
2752
+ end
2753
+ rescue GRPC::BadStatus => e
2754
+ raise Google::Cloud::Error.from_error(e)
2755
+ end
2756
+
2757
+ ##
2758
+ # Lists stored infoTypes.
2759
+ # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
2760
+ # learn more.
2761
+ #
2762
+ # @overload list_stored_info_types(request, options = nil)
2763
+ # Pass arguments to `list_stored_info_types` via a request object, either of type
2764
+ # {Google::Cloud::Dlp::V2::ListStoredInfoTypesRequest} or an equivalent Hash.
2765
+ #
2766
+ # @param request [Google::Cloud::Dlp::V2::ListStoredInfoTypesRequest, Hash]
2767
+ # A request object representing the call parameters. Required. To specify no
2768
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2769
+ # @param options [Gapic::CallOptions, Hash]
2770
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2771
+ #
2772
+ # @overload list_stored_info_types(parent: nil, page_token: nil, page_size: nil, order_by: nil, location_id: nil)
2773
+ # Pass arguments to `list_stored_info_types` via keyword arguments. Note that at
2774
+ # least one keyword argument is required. To specify no parameters, or to keep all
2775
+ # the default parameter values, pass an empty Hash as a request object (see above).
2776
+ #
2777
+ # @param parent [String]
2778
+ # Required. The parent resource name, for example projects/my-project-id or
2779
+ # organizations/my-org-id.
2780
+ # @param page_token [String]
2781
+ # Page token to continue retrieval. Comes from previous call
2782
+ # to `ListStoredInfoTypes`.
2783
+ # @param page_size [Integer]
2784
+ # Size of the page, can be limited by server. If zero server returns
2785
+ # a page of max size 100.
2786
+ # @param order_by [String]
2787
+ # Comma separated list of fields to order by,
2788
+ # followed by `asc` or `desc` postfix. This list is case-insensitive,
2789
+ # default sorting order is ascending, redundant space characters are
2790
+ # insignificant.
2791
+ #
2792
+ # Example: `name asc, display_name, create_time desc`
2793
+ #
2794
+ # Supported fields are:
2795
+ #
2796
+ # - `create_time`: corresponds to time the most recent version of the
2797
+ # resource was created.
2798
+ # - `state`: corresponds to the state of the resource.
2799
+ # - `name`: corresponds to resource name.
2800
+ # - `display_name`: corresponds to info type's display name.
2801
+ # @param location_id [String]
2802
+ # The geographic location where stored infoTypes will be retrieved from.
2803
+ # Use `-` for all locations. Reserved for future extensions.
2804
+ #
2805
+ # @yield [response, operation] Access the result along with the RPC operation
2806
+ # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::StoredInfoType>]
2807
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2808
+ #
2809
+ # @return [Gapic::PagedEnumerable<Google::Cloud::Dlp::V2::StoredInfoType>]
2810
+ #
2811
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2812
+ #
2813
+ def list_stored_info_types request, options = nil
2814
+ raise ArgumentError, "request must be provided" if request.nil?
2815
+
2816
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::ListStoredInfoTypesRequest
2817
+
2818
+ # Converts hash and nil to an options object
2819
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2820
+
2821
+ # Customize the options with defaults
2822
+ metadata = @config.rpcs.list_stored_info_types.metadata.to_h
2823
+
2824
+ # Set x-goog-api-client and x-goog-user-project headers
2825
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2826
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2827
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2828
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2829
+
2830
+ header_params = {
2831
+ "parent" => request.parent
2832
+ }
2833
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2834
+ metadata[:"x-goog-request-params"] ||= request_params_header
2835
+
2836
+ options.apply_defaults timeout: @config.rpcs.list_stored_info_types.timeout,
2837
+ metadata: metadata,
2838
+ retry_policy: @config.rpcs.list_stored_info_types.retry_policy
2839
+ options.apply_defaults metadata: @config.metadata,
2840
+ retry_policy: @config.retry_policy
2841
+
2842
+ @dlp_service_stub.call_rpc :list_stored_info_types, request, options: options do |response, operation|
2843
+ response = Gapic::PagedEnumerable.new @dlp_service_stub, :list_stored_info_types, request, response, operation, options
2844
+ yield response, operation if block_given?
2845
+ return response
2846
+ end
2847
+ rescue GRPC::BadStatus => e
2848
+ raise Google::Cloud::Error.from_error(e)
2849
+ end
2850
+
2851
+ ##
2852
+ # Deletes a stored infoType.
2853
+ # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
2854
+ # learn more.
2855
+ #
2856
+ # @overload delete_stored_info_type(request, options = nil)
2857
+ # Pass arguments to `delete_stored_info_type` via a request object, either of type
2858
+ # {Google::Cloud::Dlp::V2::DeleteStoredInfoTypeRequest} or an equivalent Hash.
2859
+ #
2860
+ # @param request [Google::Cloud::Dlp::V2::DeleteStoredInfoTypeRequest, Hash]
2861
+ # A request object representing the call parameters. Required. To specify no
2862
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2863
+ # @param options [Gapic::CallOptions, Hash]
2864
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2865
+ #
2866
+ # @overload delete_stored_info_type(name: nil)
2867
+ # Pass arguments to `delete_stored_info_type` via keyword arguments. Note that at
2868
+ # least one keyword argument is required. To specify no parameters, or to keep all
2869
+ # the default parameter values, pass an empty Hash as a request object (see above).
2870
+ #
2871
+ # @param name [String]
2872
+ # Required. Resource name of the organization and storedInfoType to be
2873
+ # deleted, for example `organizations/433245324/storedInfoTypes/432452342` or
2874
+ # projects/project-id/storedInfoTypes/432452342.
2875
+ #
2876
+ # @yield [response, operation] Access the result along with the RPC operation
2877
+ # @yieldparam response [Google::Protobuf::Empty]
2878
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2879
+ #
2880
+ # @return [Google::Protobuf::Empty]
2881
+ #
2882
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2883
+ #
2884
+ def delete_stored_info_type request, options = nil
2885
+ raise ArgumentError, "request must be provided" if request.nil?
2886
+
2887
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::DeleteStoredInfoTypeRequest
2888
+
2889
+ # Converts hash and nil to an options object
2890
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2891
+
2892
+ # Customize the options with defaults
2893
+ metadata = @config.rpcs.delete_stored_info_type.metadata.to_h
2894
+
2895
+ # Set x-goog-api-client and x-goog-user-project headers
2896
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2897
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2898
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2899
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2900
+
2901
+ header_params = {
2902
+ "name" => request.name
2903
+ }
2904
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2905
+ metadata[:"x-goog-request-params"] ||= request_params_header
2906
+
2907
+ options.apply_defaults timeout: @config.rpcs.delete_stored_info_type.timeout,
2908
+ metadata: metadata,
2909
+ retry_policy: @config.rpcs.delete_stored_info_type.retry_policy
2910
+ options.apply_defaults metadata: @config.metadata,
2911
+ retry_policy: @config.retry_policy
2912
+
2913
+ @dlp_service_stub.call_rpc :delete_stored_info_type, request, options: options do |response, operation|
2914
+ yield response, operation if block_given?
2915
+ return response
2916
+ end
2917
+ rescue GRPC::BadStatus => e
2918
+ raise Google::Cloud::Error.from_error(e)
2919
+ end
2920
+
2921
+ ##
2922
+ # Inspect hybrid content and store findings to a job.
2923
+ # To review the findings inspect the job. Inspection will occur
2924
+ # asynchronously.
2925
+ # Early access feature is in a pre-release state and might change or have
2926
+ # limited support. For more information, see
2927
+ # https://cloud.google.com/products#product-launch-stages.
2928
+ #
2929
+ # @overload hybrid_inspect_dlp_job(request, options = nil)
2930
+ # Pass arguments to `hybrid_inspect_dlp_job` via a request object, either of type
2931
+ # {Google::Cloud::Dlp::V2::HybridInspectDlpJobRequest} or an equivalent Hash.
2932
+ #
2933
+ # @param request [Google::Cloud::Dlp::V2::HybridInspectDlpJobRequest, Hash]
2934
+ # A request object representing the call parameters. Required. To specify no
2935
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2936
+ # @param options [Gapic::CallOptions, Hash]
2937
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2938
+ #
2939
+ # @overload hybrid_inspect_dlp_job(name: nil, hybrid_item: nil)
2940
+ # Pass arguments to `hybrid_inspect_dlp_job` via keyword arguments. Note that at
2941
+ # least one keyword argument is required. To specify no parameters, or to keep all
2942
+ # the default parameter values, pass an empty Hash as a request object (see above).
2943
+ #
2944
+ # @param name [String]
2945
+ # Required. Resource name of the job to execute a hybrid inspect on, for
2946
+ # example `projects/dlp-test-project/dlpJob/53234423`.
2947
+ # @param hybrid_item [Google::Cloud::Dlp::V2::HybridContentItem, Hash]
2948
+ # The item to inspect.
2949
+ #
2950
+ # @yield [response, operation] Access the result along with the RPC operation
2951
+ # @yieldparam response [Google::Cloud::Dlp::V2::HybridInspectResponse]
2952
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
2953
+ #
2954
+ # @return [Google::Cloud::Dlp::V2::HybridInspectResponse]
2955
+ #
2956
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
2957
+ #
2958
+ def hybrid_inspect_dlp_job request, options = nil
2959
+ raise ArgumentError, "request must be provided" if request.nil?
2960
+
2961
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::HybridInspectDlpJobRequest
2962
+
2963
+ # Converts hash and nil to an options object
2964
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2965
+
2966
+ # Customize the options with defaults
2967
+ metadata = @config.rpcs.hybrid_inspect_dlp_job.metadata.to_h
2968
+
2969
+ # Set x-goog-api-client and x-goog-user-project headers
2970
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
2971
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2972
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2973
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2974
+
2975
+ header_params = {
2976
+ "name" => request.name
2977
+ }
2978
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2979
+ metadata[:"x-goog-request-params"] ||= request_params_header
2980
+
2981
+ options.apply_defaults timeout: @config.rpcs.hybrid_inspect_dlp_job.timeout,
2982
+ metadata: metadata,
2983
+ retry_policy: @config.rpcs.hybrid_inspect_dlp_job.retry_policy
2984
+ options.apply_defaults metadata: @config.metadata,
2985
+ retry_policy: @config.retry_policy
2986
+
2987
+ @dlp_service_stub.call_rpc :hybrid_inspect_dlp_job, request, options: options do |response, operation|
2988
+ yield response, operation if block_given?
2989
+ return response
2990
+ end
2991
+ rescue GRPC::BadStatus => e
2992
+ raise Google::Cloud::Error.from_error(e)
2993
+ end
2994
+
2995
+ ##
2996
+ # Finish a running hybrid DlpJob. Triggers the finalization steps and running
2997
+ # of any enabled actions that have not yet run.
2998
+ # Early access feature is in a pre-release state and might change or have
2999
+ # limited support. For more information, see
3000
+ # https://cloud.google.com/products#product-launch-stages.
3001
+ #
3002
+ # @overload finish_dlp_job(request, options = nil)
3003
+ # Pass arguments to `finish_dlp_job` via a request object, either of type
3004
+ # {Google::Cloud::Dlp::V2::FinishDlpJobRequest} or an equivalent Hash.
3005
+ #
3006
+ # @param request [Google::Cloud::Dlp::V2::FinishDlpJobRequest, Hash]
3007
+ # A request object representing the call parameters. Required. To specify no
3008
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3009
+ # @param options [Gapic::CallOptions, Hash]
3010
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3011
+ #
3012
+ # @overload finish_dlp_job(name: nil)
3013
+ # Pass arguments to `finish_dlp_job` via keyword arguments. Note that at
3014
+ # least one keyword argument is required. To specify no parameters, or to keep all
3015
+ # the default parameter values, pass an empty Hash as a request object (see above).
3016
+ #
3017
+ # @param name [String]
3018
+ # Required. The name of the DlpJob resource to be cancelled.
3019
+ #
3020
+ # @yield [response, operation] Access the result along with the RPC operation
3021
+ # @yieldparam response [Google::Protobuf::Empty]
3022
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
3023
+ #
3024
+ # @return [Google::Protobuf::Empty]
3025
+ #
3026
+ # @raise [Google::Cloud::Error] if the RPC is aborted.
3027
+ #
3028
+ def finish_dlp_job request, options = nil
3029
+ raise ArgumentError, "request must be provided" if request.nil?
3030
+
3031
+ request = Gapic::Protobuf.coerce request, to: Google::Cloud::Dlp::V2::FinishDlpJobRequest
3032
+
3033
+ # Converts hash and nil to an options object
3034
+ options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3035
+
3036
+ # Customize the options with defaults
3037
+ metadata = @config.rpcs.finish_dlp_job.metadata.to_h
3038
+
3039
+ # Set x-goog-api-client and x-goog-user-project headers
3040
+ metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
3041
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3042
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
3043
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3044
+
3045
+ header_params = {
3046
+ "name" => request.name
3047
+ }
3048
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3049
+ metadata[:"x-goog-request-params"] ||= request_params_header
3050
+
3051
+ options.apply_defaults timeout: @config.rpcs.finish_dlp_job.timeout,
3052
+ metadata: metadata,
3053
+ retry_policy: @config.rpcs.finish_dlp_job.retry_policy
3054
+ options.apply_defaults metadata: @config.metadata,
3055
+ retry_policy: @config.retry_policy
3056
+
3057
+ @dlp_service_stub.call_rpc :finish_dlp_job, request, options: options do |response, operation|
3058
+ yield response, operation if block_given?
3059
+ return response
3060
+ end
3061
+ rescue GRPC::BadStatus => e
3062
+ raise Google::Cloud::Error.from_error(e)
3063
+ end
3064
+
3065
+ ##
3066
+ # Configuration class for the DlpService API.
3067
+ #
3068
+ # This class represents the configuration for DlpService,
3069
+ # providing control over timeouts, retry behavior, logging, transport
3070
+ # parameters, and other low-level controls. Certain parameters can also be
3071
+ # applied individually to specific RPCs. See
3072
+ # {Google::Cloud::Dlp::V2::DlpService::Client::Configuration::Rpcs}
3073
+ # for a list of RPCs that can be configured independently.
3074
+ #
3075
+ # Configuration can be applied globally to all clients, or to a single client
3076
+ # on construction.
3077
+ #
3078
+ # # Examples
3079
+ #
3080
+ # To modify the global config, setting the timeout for inspect_content
3081
+ # to 20 seconds, and all remaining timeouts to 10 seconds:
3082
+ #
3083
+ # Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
3084
+ # config.timeout = 10_000
3085
+ # config.rpcs.inspect_content.timeout = 20_000
3086
+ # end
3087
+ #
3088
+ # To apply the above configuration only to a new client:
3089
+ #
3090
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
3091
+ # config.timeout = 10_000
3092
+ # config.rpcs.inspect_content.timeout = 20_000
3093
+ # end
3094
+ #
3095
+ # @!attribute [rw] endpoint
3096
+ # The hostname or hostname:port of the service endpoint.
3097
+ # Defaults to `"dlp.googleapis.com"`.
3098
+ # @return [String]
3099
+ # @!attribute [rw] credentials
3100
+ # Credentials to send with calls. You may provide any of the following types:
3101
+ # * (`String`) The path to a service account key file in JSON format
3102
+ # * (`Hash`) A service account key as a Hash
3103
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
3104
+ # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
3105
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3106
+ # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
3107
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
3108
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
3109
+ # * (`nil`) indicating no credentials
3110
+ # @return [Object]
3111
+ # @!attribute [rw] scope
3112
+ # The OAuth scopes
3113
+ # @return [Array<String>]
3114
+ # @!attribute [rw] lib_name
3115
+ # The library name as recorded in instrumentation and logging
3116
+ # @return [String]
3117
+ # @!attribute [rw] lib_version
3118
+ # The library version as recorded in instrumentation and logging
3119
+ # @return [String]
3120
+ # @!attribute [rw] channel_args
3121
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
3122
+ # `GRPC::Core::Channel` object is provided as the credential.
3123
+ # @return [Hash]
3124
+ # @!attribute [rw] interceptors
3125
+ # An array of interceptors that are run before calls are executed.
3126
+ # @return [Array<GRPC::ClientInterceptor>]
3127
+ # @!attribute [rw] timeout
3128
+ # The call timeout in milliseconds.
3129
+ # @return [Numeric]
3130
+ # @!attribute [rw] metadata
3131
+ # Additional gRPC headers to be sent with the call.
3132
+ # @return [Hash{Symbol=>String}]
3133
+ # @!attribute [rw] retry_policy
3134
+ # The retry policy. The value is a hash with the following keys:
3135
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3136
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3137
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3138
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3139
+ # trigger a retry.
3140
+ # @return [Hash]
3141
+ #
3142
+ class Configuration
3143
+ extend Gapic::Config
3144
+
3145
+ config_attr :endpoint, "dlp.googleapis.com", String
3146
+ config_attr :credentials, nil do |value|
3147
+ allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
3148
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
3149
+ allowed.any? { |klass| klass === value }
3150
+ end
3151
+ config_attr :scope, nil, String, Array, nil
3152
+ config_attr :lib_name, nil, String, nil
3153
+ config_attr :lib_version, nil, String, nil
3154
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
3155
+ config_attr :interceptors, nil, Array, nil
3156
+ config_attr :timeout, nil, Numeric, nil
3157
+ config_attr :metadata, nil, Hash, nil
3158
+ config_attr :retry_policy, nil, Hash, Proc, nil
3159
+
3160
+ # @private
3161
+ def initialize parent_config = nil
3162
+ @parent_config = parent_config unless parent_config.nil?
3163
+
3164
+ yield self if block_given?
3165
+ end
3166
+
3167
+ ##
3168
+ # Configurations for individual RPCs
3169
+ # @return [Rpcs]
3170
+ #
3171
+ def rpcs
3172
+ @rpcs ||= begin
3173
+ parent_rpcs = nil
3174
+ parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
3175
+ Rpcs.new parent_rpcs
3176
+ end
3177
+ end
3178
+
3179
+ ##
3180
+ # Configuration RPC class for the DlpService API.
3181
+ #
3182
+ # Includes fields providing the configuration for each RPC in this service.
3183
+ # Each configuration object is of type `Gapic::Config::Method` and includes
3184
+ # the following configuration fields:
3185
+ #
3186
+ # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
3187
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
3188
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
3189
+ # include the following keys:
3190
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3191
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3192
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3193
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3194
+ # trigger a retry.
3195
+ #
3196
+ class Rpcs
3197
+ ##
3198
+ # RPC-specific configuration for `inspect_content`
3199
+ # @return [Gapic::Config::Method]
3200
+ #
3201
+ attr_reader :inspect_content
3202
+ ##
3203
+ # RPC-specific configuration for `redact_image`
3204
+ # @return [Gapic::Config::Method]
3205
+ #
3206
+ attr_reader :redact_image
3207
+ ##
3208
+ # RPC-specific configuration for `deidentify_content`
3209
+ # @return [Gapic::Config::Method]
3210
+ #
3211
+ attr_reader :deidentify_content
3212
+ ##
3213
+ # RPC-specific configuration for `reidentify_content`
3214
+ # @return [Gapic::Config::Method]
3215
+ #
3216
+ attr_reader :reidentify_content
3217
+ ##
3218
+ # RPC-specific configuration for `list_info_types`
3219
+ # @return [Gapic::Config::Method]
3220
+ #
3221
+ attr_reader :list_info_types
3222
+ ##
3223
+ # RPC-specific configuration for `create_inspect_template`
3224
+ # @return [Gapic::Config::Method]
3225
+ #
3226
+ attr_reader :create_inspect_template
3227
+ ##
3228
+ # RPC-specific configuration for `update_inspect_template`
3229
+ # @return [Gapic::Config::Method]
3230
+ #
3231
+ attr_reader :update_inspect_template
3232
+ ##
3233
+ # RPC-specific configuration for `get_inspect_template`
3234
+ # @return [Gapic::Config::Method]
3235
+ #
3236
+ attr_reader :get_inspect_template
3237
+ ##
3238
+ # RPC-specific configuration for `list_inspect_templates`
3239
+ # @return [Gapic::Config::Method]
3240
+ #
3241
+ attr_reader :list_inspect_templates
3242
+ ##
3243
+ # RPC-specific configuration for `delete_inspect_template`
3244
+ # @return [Gapic::Config::Method]
3245
+ #
3246
+ attr_reader :delete_inspect_template
3247
+ ##
3248
+ # RPC-specific configuration for `create_deidentify_template`
3249
+ # @return [Gapic::Config::Method]
3250
+ #
3251
+ attr_reader :create_deidentify_template
3252
+ ##
3253
+ # RPC-specific configuration for `update_deidentify_template`
3254
+ # @return [Gapic::Config::Method]
3255
+ #
3256
+ attr_reader :update_deidentify_template
3257
+ ##
3258
+ # RPC-specific configuration for `get_deidentify_template`
3259
+ # @return [Gapic::Config::Method]
3260
+ #
3261
+ attr_reader :get_deidentify_template
3262
+ ##
3263
+ # RPC-specific configuration for `list_deidentify_templates`
3264
+ # @return [Gapic::Config::Method]
3265
+ #
3266
+ attr_reader :list_deidentify_templates
3267
+ ##
3268
+ # RPC-specific configuration for `delete_deidentify_template`
3269
+ # @return [Gapic::Config::Method]
3270
+ #
3271
+ attr_reader :delete_deidentify_template
3272
+ ##
3273
+ # RPC-specific configuration for `create_job_trigger`
3274
+ # @return [Gapic::Config::Method]
3275
+ #
3276
+ attr_reader :create_job_trigger
3277
+ ##
3278
+ # RPC-specific configuration for `update_job_trigger`
3279
+ # @return [Gapic::Config::Method]
3280
+ #
3281
+ attr_reader :update_job_trigger
3282
+ ##
3283
+ # RPC-specific configuration for `hybrid_inspect_job_trigger`
3284
+ # @return [Gapic::Config::Method]
3285
+ #
3286
+ attr_reader :hybrid_inspect_job_trigger
3287
+ ##
3288
+ # RPC-specific configuration for `get_job_trigger`
3289
+ # @return [Gapic::Config::Method]
3290
+ #
3291
+ attr_reader :get_job_trigger
3292
+ ##
3293
+ # RPC-specific configuration for `list_job_triggers`
3294
+ # @return [Gapic::Config::Method]
3295
+ #
3296
+ attr_reader :list_job_triggers
3297
+ ##
3298
+ # RPC-specific configuration for `delete_job_trigger`
3299
+ # @return [Gapic::Config::Method]
3300
+ #
3301
+ attr_reader :delete_job_trigger
3302
+ ##
3303
+ # RPC-specific configuration for `activate_job_trigger`
3304
+ # @return [Gapic::Config::Method]
3305
+ #
3306
+ attr_reader :activate_job_trigger
3307
+ ##
3308
+ # RPC-specific configuration for `create_dlp_job`
3309
+ # @return [Gapic::Config::Method]
3310
+ #
3311
+ attr_reader :create_dlp_job
3312
+ ##
3313
+ # RPC-specific configuration for `list_dlp_jobs`
3314
+ # @return [Gapic::Config::Method]
3315
+ #
3316
+ attr_reader :list_dlp_jobs
3317
+ ##
3318
+ # RPC-specific configuration for `get_dlp_job`
3319
+ # @return [Gapic::Config::Method]
3320
+ #
3321
+ attr_reader :get_dlp_job
3322
+ ##
3323
+ # RPC-specific configuration for `delete_dlp_job`
3324
+ # @return [Gapic::Config::Method]
3325
+ #
3326
+ attr_reader :delete_dlp_job
3327
+ ##
3328
+ # RPC-specific configuration for `cancel_dlp_job`
3329
+ # @return [Gapic::Config::Method]
3330
+ #
3331
+ attr_reader :cancel_dlp_job
3332
+ ##
3333
+ # RPC-specific configuration for `create_stored_info_type`
3334
+ # @return [Gapic::Config::Method]
3335
+ #
3336
+ attr_reader :create_stored_info_type
3337
+ ##
3338
+ # RPC-specific configuration for `update_stored_info_type`
3339
+ # @return [Gapic::Config::Method]
3340
+ #
3341
+ attr_reader :update_stored_info_type
3342
+ ##
3343
+ # RPC-specific configuration for `get_stored_info_type`
3344
+ # @return [Gapic::Config::Method]
3345
+ #
3346
+ attr_reader :get_stored_info_type
3347
+ ##
3348
+ # RPC-specific configuration for `list_stored_info_types`
3349
+ # @return [Gapic::Config::Method]
3350
+ #
3351
+ attr_reader :list_stored_info_types
3352
+ ##
3353
+ # RPC-specific configuration for `delete_stored_info_type`
3354
+ # @return [Gapic::Config::Method]
3355
+ #
3356
+ attr_reader :delete_stored_info_type
3357
+ ##
3358
+ # RPC-specific configuration for `hybrid_inspect_dlp_job`
3359
+ # @return [Gapic::Config::Method]
3360
+ #
3361
+ attr_reader :hybrid_inspect_dlp_job
3362
+ ##
3363
+ # RPC-specific configuration for `finish_dlp_job`
3364
+ # @return [Gapic::Config::Method]
3365
+ #
3366
+ attr_reader :finish_dlp_job
3367
+
3368
+ # @private
3369
+ def initialize parent_rpcs = nil
3370
+ inspect_content_config = parent_rpcs&.inspect_content if parent_rpcs&.respond_to? :inspect_content
3371
+ @inspect_content = Gapic::Config::Method.new inspect_content_config
3372
+ redact_image_config = parent_rpcs&.redact_image if parent_rpcs&.respond_to? :redact_image
3373
+ @redact_image = Gapic::Config::Method.new redact_image_config
3374
+ deidentify_content_config = parent_rpcs&.deidentify_content if parent_rpcs&.respond_to? :deidentify_content
3375
+ @deidentify_content = Gapic::Config::Method.new deidentify_content_config
3376
+ reidentify_content_config = parent_rpcs&.reidentify_content if parent_rpcs&.respond_to? :reidentify_content
3377
+ @reidentify_content = Gapic::Config::Method.new reidentify_content_config
3378
+ list_info_types_config = parent_rpcs&.list_info_types if parent_rpcs&.respond_to? :list_info_types
3379
+ @list_info_types = Gapic::Config::Method.new list_info_types_config
3380
+ create_inspect_template_config = parent_rpcs&.create_inspect_template if parent_rpcs&.respond_to? :create_inspect_template
3381
+ @create_inspect_template = Gapic::Config::Method.new create_inspect_template_config
3382
+ update_inspect_template_config = parent_rpcs&.update_inspect_template if parent_rpcs&.respond_to? :update_inspect_template
3383
+ @update_inspect_template = Gapic::Config::Method.new update_inspect_template_config
3384
+ get_inspect_template_config = parent_rpcs&.get_inspect_template if parent_rpcs&.respond_to? :get_inspect_template
3385
+ @get_inspect_template = Gapic::Config::Method.new get_inspect_template_config
3386
+ list_inspect_templates_config = parent_rpcs&.list_inspect_templates if parent_rpcs&.respond_to? :list_inspect_templates
3387
+ @list_inspect_templates = Gapic::Config::Method.new list_inspect_templates_config
3388
+ delete_inspect_template_config = parent_rpcs&.delete_inspect_template if parent_rpcs&.respond_to? :delete_inspect_template
3389
+ @delete_inspect_template = Gapic::Config::Method.new delete_inspect_template_config
3390
+ create_deidentify_template_config = parent_rpcs&.create_deidentify_template if parent_rpcs&.respond_to? :create_deidentify_template
3391
+ @create_deidentify_template = Gapic::Config::Method.new create_deidentify_template_config
3392
+ update_deidentify_template_config = parent_rpcs&.update_deidentify_template if parent_rpcs&.respond_to? :update_deidentify_template
3393
+ @update_deidentify_template = Gapic::Config::Method.new update_deidentify_template_config
3394
+ get_deidentify_template_config = parent_rpcs&.get_deidentify_template if parent_rpcs&.respond_to? :get_deidentify_template
3395
+ @get_deidentify_template = Gapic::Config::Method.new get_deidentify_template_config
3396
+ list_deidentify_templates_config = parent_rpcs&.list_deidentify_templates if parent_rpcs&.respond_to? :list_deidentify_templates
3397
+ @list_deidentify_templates = Gapic::Config::Method.new list_deidentify_templates_config
3398
+ delete_deidentify_template_config = parent_rpcs&.delete_deidentify_template if parent_rpcs&.respond_to? :delete_deidentify_template
3399
+ @delete_deidentify_template = Gapic::Config::Method.new delete_deidentify_template_config
3400
+ create_job_trigger_config = parent_rpcs&.create_job_trigger if parent_rpcs&.respond_to? :create_job_trigger
3401
+ @create_job_trigger = Gapic::Config::Method.new create_job_trigger_config
3402
+ update_job_trigger_config = parent_rpcs&.update_job_trigger if parent_rpcs&.respond_to? :update_job_trigger
3403
+ @update_job_trigger = Gapic::Config::Method.new update_job_trigger_config
3404
+ hybrid_inspect_job_trigger_config = parent_rpcs&.hybrid_inspect_job_trigger if parent_rpcs&.respond_to? :hybrid_inspect_job_trigger
3405
+ @hybrid_inspect_job_trigger = Gapic::Config::Method.new hybrid_inspect_job_trigger_config
3406
+ get_job_trigger_config = parent_rpcs&.get_job_trigger if parent_rpcs&.respond_to? :get_job_trigger
3407
+ @get_job_trigger = Gapic::Config::Method.new get_job_trigger_config
3408
+ list_job_triggers_config = parent_rpcs&.list_job_triggers if parent_rpcs&.respond_to? :list_job_triggers
3409
+ @list_job_triggers = Gapic::Config::Method.new list_job_triggers_config
3410
+ delete_job_trigger_config = parent_rpcs&.delete_job_trigger if parent_rpcs&.respond_to? :delete_job_trigger
3411
+ @delete_job_trigger = Gapic::Config::Method.new delete_job_trigger_config
3412
+ activate_job_trigger_config = parent_rpcs&.activate_job_trigger if parent_rpcs&.respond_to? :activate_job_trigger
3413
+ @activate_job_trigger = Gapic::Config::Method.new activate_job_trigger_config
3414
+ create_dlp_job_config = parent_rpcs&.create_dlp_job if parent_rpcs&.respond_to? :create_dlp_job
3415
+ @create_dlp_job = Gapic::Config::Method.new create_dlp_job_config
3416
+ list_dlp_jobs_config = parent_rpcs&.list_dlp_jobs if parent_rpcs&.respond_to? :list_dlp_jobs
3417
+ @list_dlp_jobs = Gapic::Config::Method.new list_dlp_jobs_config
3418
+ get_dlp_job_config = parent_rpcs&.get_dlp_job if parent_rpcs&.respond_to? :get_dlp_job
3419
+ @get_dlp_job = Gapic::Config::Method.new get_dlp_job_config
3420
+ delete_dlp_job_config = parent_rpcs&.delete_dlp_job if parent_rpcs&.respond_to? :delete_dlp_job
3421
+ @delete_dlp_job = Gapic::Config::Method.new delete_dlp_job_config
3422
+ cancel_dlp_job_config = parent_rpcs&.cancel_dlp_job if parent_rpcs&.respond_to? :cancel_dlp_job
3423
+ @cancel_dlp_job = Gapic::Config::Method.new cancel_dlp_job_config
3424
+ create_stored_info_type_config = parent_rpcs&.create_stored_info_type if parent_rpcs&.respond_to? :create_stored_info_type
3425
+ @create_stored_info_type = Gapic::Config::Method.new create_stored_info_type_config
3426
+ update_stored_info_type_config = parent_rpcs&.update_stored_info_type if parent_rpcs&.respond_to? :update_stored_info_type
3427
+ @update_stored_info_type = Gapic::Config::Method.new update_stored_info_type_config
3428
+ get_stored_info_type_config = parent_rpcs&.get_stored_info_type if parent_rpcs&.respond_to? :get_stored_info_type
3429
+ @get_stored_info_type = Gapic::Config::Method.new get_stored_info_type_config
3430
+ list_stored_info_types_config = parent_rpcs&.list_stored_info_types if parent_rpcs&.respond_to? :list_stored_info_types
3431
+ @list_stored_info_types = Gapic::Config::Method.new list_stored_info_types_config
3432
+ delete_stored_info_type_config = parent_rpcs&.delete_stored_info_type if parent_rpcs&.respond_to? :delete_stored_info_type
3433
+ @delete_stored_info_type = Gapic::Config::Method.new delete_stored_info_type_config
3434
+ hybrid_inspect_dlp_job_config = parent_rpcs&.hybrid_inspect_dlp_job if parent_rpcs&.respond_to? :hybrid_inspect_dlp_job
3435
+ @hybrid_inspect_dlp_job = Gapic::Config::Method.new hybrid_inspect_dlp_job_config
3436
+ finish_dlp_job_config = parent_rpcs&.finish_dlp_job if parent_rpcs&.respond_to? :finish_dlp_job
3437
+ @finish_dlp_job = Gapic::Config::Method.new finish_dlp_job_config
3438
+
3439
+ yield self if block_given?
3440
+ end
3441
+ end
3442
+ end
3443
+ end
3444
+ end
3445
+ end
3446
+ end
3447
+ end
3448
+ end