google-cloud-dataplex-v1 0.7.0 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/dataplex/v1/content_service/client.rb +2 -2
  4. data/lib/google/cloud/dataplex/v1/content_service/rest/client.rb +2 -2
  5. data/lib/google/cloud/dataplex/v1/data_profile_pb.rb +1 -0
  6. data/lib/google/cloud/dataplex/v1/data_scan_service/client.rb +12 -6
  7. data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb +2 -2
  8. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb +12 -6
  9. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb +2 -2
  10. data/lib/google/cloud/dataplex/v1/dataplex_service/client.rb +95 -2
  11. data/lib/google/cloud/dataplex/v1/dataplex_service/operations.rb +2 -2
  12. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/client.rb +72 -2
  13. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/operations.rb +2 -2
  14. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/service_stub.rb +60 -0
  15. data/lib/google/cloud/dataplex/v1/datascans_pb.rb +4 -0
  16. data/lib/google/cloud/dataplex/v1/metadata_pb.rb +12 -0
  17. data/lib/google/cloud/dataplex/v1/metadata_service/client.rb +2 -2
  18. data/lib/google/cloud/dataplex/v1/metadata_service/rest/client.rb +2 -2
  19. data/lib/google/cloud/dataplex/v1/processing_pb.rb +1 -0
  20. data/lib/google/cloud/dataplex/v1/resources_pb.rb +8 -0
  21. data/lib/google/cloud/dataplex/v1/rest.rb +1 -1
  22. data/lib/google/cloud/dataplex/v1/service_pb.rb +8 -0
  23. data/lib/google/cloud/dataplex/v1/service_services_pb.rb +2 -0
  24. data/lib/google/cloud/dataplex/v1/version.rb +1 -1
  25. data/lib/google/cloud/dataplex/v1.rb +1 -1
  26. data/proto_docs/google/api/client.rb +67 -4
  27. data/proto_docs/google/cloud/dataplex/v1/analyze.rb +4 -0
  28. data/proto_docs/google/cloud/dataplex/v1/data_profile.rb +64 -87
  29. data/proto_docs/google/cloud/dataplex/v1/data_quality.rb +54 -32
  30. data/proto_docs/google/cloud/dataplex/v1/datascans.rb +10 -2
  31. data/proto_docs/google/cloud/dataplex/v1/metadata.rb +31 -2
  32. data/proto_docs/google/cloud/dataplex/v1/processing.rb +23 -13
  33. data/proto_docs/google/cloud/dataplex/v1/resources.rb +24 -6
  34. data/proto_docs/google/cloud/dataplex/v1/service.rb +17 -0
  35. data/proto_docs/google/cloud/dataplex/v1/tasks.rb +2 -3
  36. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c58a57481bf5842392003f343f92c62a4bb24e93747ea38f8d427df0a4bd85cb
4
- data.tar.gz: 75203c64c890331bfdd291b08dbc79a5f03cf04c504ecc2dcc2cae68521972f4
3
+ metadata.gz: c35483613348b88979002483ed09c2ffd7089cff46fada0014d8a64823a23e69
4
+ data.tar.gz: c154d7af6581baf4f42a9903efdfe46147ceb218e6eb4e8f3af111f2e00dbb59
5
5
  SHA512:
6
- metadata.gz: ef109669b7db796c040d6df202f084c4338398f42e113eeeba20b301c8e415d2d872f7be57746d1b73542fd34fc9312aad2ab5af8d0d2a32e65e232f99a93b9d
7
- data.tar.gz: 82f4604261d34348b93fb301b1b2e890d9328d272e3aa3611c2c19170f95056a28df1ee48bdf30b871e50863f21e6f3c43e179662f1374d5276c3a495cef7460
6
+ metadata.gz: 8be5ef7e2e7dd47d8804b32cb3937e45f860be693490ee0f1c02ab67a0a7b01a2d9fd282250780ab1936e358b3766ec882b8cf19c4b99c329a7c040b2a826e23
7
+ data.tar.gz: cf48990b15a85df031760865df69e67894d2a7fe43c93dd19486b66b3889cba38112ca512a98b3328b5b791122e61d3ac1045a8b2d290618f4025d2c15807441
data/README.md CHANGED
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -999,9 +999,9 @@ module Google
999
999
  # * (`String`) The path to a service account key file in JSON format
1000
1000
  # * (`Hash`) A service account key as a Hash
1001
1001
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1002
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1002
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1003
1003
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1004
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1004
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1005
1005
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1006
1006
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1007
1007
  # * (`nil`) indicating no credentials
@@ -804,9 +804,9 @@ module Google
804
804
  # * (`String`) The path to a service account key file in JSON format
805
805
  # * (`Hash`) A service account key as a Hash
806
806
  # * (`Google::Auth::Credentials`) A googleauth credentials object
807
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
807
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
808
808
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
809
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
809
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
810
810
  # * (`nil`) indicating no credentials
811
811
  # @return [::Object]
812
812
  # @!attribute [rw] scope
@@ -3,6 +3,7 @@
3
3
 
4
4
  require 'google/protobuf'
5
5
 
6
+ require 'google/api/field_behavior_pb'
6
7
  require 'google/cloud/dataplex/v1/processing_pb'
7
8
 
8
9
  Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -200,7 +200,7 @@ module Google
200
200
  # @param options [::Gapic::CallOptions, ::Hash]
201
201
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
202
202
  #
203
- # @overload create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil)
203
+ # @overload create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil, validate_only: nil)
204
204
  # Pass arguments to `create_data_scan` via keyword arguments. Note that at
205
205
  # least one keyword argument is required. To specify no parameters, or to keep all
206
206
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -220,6 +220,9 @@ module Google
220
220
  # * Must end with a number or a letter.
221
221
  # * Must be between 1-63 characters.
222
222
  # * Must be unique within the customer project / location.
223
+ # @param validate_only [::Boolean]
224
+ # Optional. Only validate the request, but do not perform mutations.
225
+ # The default is `false`.
223
226
  #
224
227
  # @yield [response, operation] Access the result along with the RPC operation
225
228
  # @yieldparam response [::Gapic::Operation]
@@ -306,7 +309,7 @@ module Google
306
309
  # @param options [::Gapic::CallOptions, ::Hash]
307
310
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
308
311
  #
309
- # @overload update_data_scan(data_scan: nil, update_mask: nil)
312
+ # @overload update_data_scan(data_scan: nil, update_mask: nil, validate_only: nil)
310
313
  # Pass arguments to `update_data_scan` via keyword arguments. Note that at
311
314
  # least one keyword argument is required. To specify no parameters, or to keep all
312
315
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -317,6 +320,9 @@ module Google
317
320
  # Only fields specified in `update_mask` are updated.
318
321
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
319
322
  # Required. Mask of fields to update.
323
+ # @param validate_only [::Boolean]
324
+ # Optional. Only validate the request, but do not perform mutations.
325
+ # The default is `false`.
320
326
  #
321
327
  # @yield [response, operation] Access the result along with the RPC operation
322
328
  # @yieldparam response [::Gapic::Operation]
@@ -601,7 +607,7 @@ module Google
601
607
  # `location_id` refers to a GCP region.
602
608
  # @param page_size [::Integer]
603
609
  # Optional. Maximum number of dataScans to return. The service may return
604
- # fewer than this value. If unspecified, at most 10 scans will be returned.
610
+ # fewer than this value. If unspecified, at most 500 scans will be returned.
605
611
  # The maximum value is 1000; values above 1000 will be coerced to 1000.
606
612
  # @param page_token [::String]
607
613
  # Optional. Page token received from a previous `ListDataScans` call. Provide
@@ -793,7 +799,7 @@ module Google
793
799
  #
794
800
  # @param name [::String]
795
801
  # Required. The resource name of the DataScanJob:
796
- # `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id}`
802
+ # `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/jobs/{data_scan_job_id}`
797
803
  # where `project` refers to a *project_id* or *project_number* and
798
804
  # `location_id` refers to a GCP region.
799
805
  # @param view [::Google::Cloud::Dataplex::V1::GetDataScanJobRequest::DataScanJobView]
@@ -1004,9 +1010,9 @@ module Google
1004
1010
  # * (`String`) The path to a service account key file in JSON format
1005
1011
  # * (`Hash`) A service account key as a Hash
1006
1012
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1007
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1013
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1008
1014
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1009
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1015
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1010
1016
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1011
1017
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1012
1018
  # * (`nil`) indicating no credentials
@@ -620,9 +620,9 @@ module Google
620
620
  # * (`String`) The path to a service account key file in JSON format
621
621
  # * (`Hash`) A service account key as a Hash
622
622
  # * (`Google::Auth::Credentials`) A googleauth credentials object
623
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
623
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
624
624
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
625
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
625
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
626
626
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
627
627
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
628
628
  # * (`nil`) indicating no credentials
@@ -193,7 +193,7 @@ module Google
193
193
  # @param options [::Gapic::CallOptions, ::Hash]
194
194
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
195
195
  #
196
- # @overload create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil)
196
+ # @overload create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil, validate_only: nil)
197
197
  # Pass arguments to `create_data_scan` via keyword arguments. Note that at
198
198
  # least one keyword argument is required. To specify no parameters, or to keep all
199
199
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -213,6 +213,9 @@ module Google
213
213
  # * Must end with a number or a letter.
214
214
  # * Must be between 1-63 characters.
215
215
  # * Must be unique within the customer project / location.
216
+ # @param validate_only [::Boolean]
217
+ # Optional. Only validate the request, but do not perform mutations.
218
+ # The default is `false`.
216
219
  # @yield [result, operation] Access the result along with the TransportOperation object
217
220
  # @yieldparam result [::Gapic::Operation]
218
221
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -269,7 +272,7 @@ module Google
269
272
  # @param options [::Gapic::CallOptions, ::Hash]
270
273
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
271
274
  #
272
- # @overload update_data_scan(data_scan: nil, update_mask: nil)
275
+ # @overload update_data_scan(data_scan: nil, update_mask: nil, validate_only: nil)
273
276
  # Pass arguments to `update_data_scan` via keyword arguments. Note that at
274
277
  # least one keyword argument is required. To specify no parameters, or to keep all
275
278
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -280,6 +283,9 @@ module Google
280
283
  # Only fields specified in `update_mask` are updated.
281
284
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
282
285
  # Required. Mask of fields to update.
286
+ # @param validate_only [::Boolean]
287
+ # Optional. Only validate the request, but do not perform mutations.
288
+ # The default is `false`.
283
289
  # @yield [result, operation] Access the result along with the TransportOperation object
284
290
  # @yieldparam result [::Gapic::Operation]
285
291
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -481,7 +487,7 @@ module Google
481
487
  # `location_id` refers to a GCP region.
482
488
  # @param page_size [::Integer]
483
489
  # Optional. Maximum number of dataScans to return. The service may return
484
- # fewer than this value. If unspecified, at most 10 scans will be returned.
490
+ # fewer than this value. If unspecified, at most 500 scans will be returned.
485
491
  # The maximum value is 1000; values above 1000 will be coerced to 1000.
486
492
  # @param page_token [::String]
487
493
  # Optional. Page token received from a previous `ListDataScans` call. Provide
@@ -622,7 +628,7 @@ module Google
622
628
  #
623
629
  # @param name [::String]
624
630
  # Required. The resource name of the DataScanJob:
625
- # `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id}`
631
+ # `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/jobs/{data_scan_job_id}`
626
632
  # where `project` refers to a *project_id* or *project_number* and
627
633
  # `location_id` refers to a GCP region.
628
634
  # @param view [::Google::Cloud::Dataplex::V1::GetDataScanJobRequest::DataScanJobView]
@@ -783,9 +789,9 @@ module Google
783
789
  # * (`String`) The path to a service account key file in JSON format
784
790
  # * (`Hash`) A service account key as a Hash
785
791
  # * (`Google::Auth::Credentials`) A googleauth credentials object
786
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
792
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
787
793
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
788
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
794
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
789
795
  # * (`nil`) indicating no credentials
790
796
  # @return [::Object]
791
797
  # @!attribute [rw] scope
@@ -411,9 +411,9 @@ module Google
411
411
  # * (`String`) The path to a service account key file in JSON format
412
412
  # * (`Hash`) A service account key as a Hash
413
413
  # * (`Google::Auth::Credentials`) A googleauth credentials object
414
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
414
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
415
415
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
416
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
416
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
417
417
  # * (`nil`) indicating no credentials
418
418
  # @return [::Object]
419
419
  # @!attribute [rw] scope
@@ -2656,6 +2656,92 @@ module Google
2656
2656
  raise ::Google::Cloud::Error.from_error(e)
2657
2657
  end
2658
2658
 
2659
+ ##
2660
+ # Run an on demand execution of a Task.
2661
+ #
2662
+ # @overload run_task(request, options = nil)
2663
+ # Pass arguments to `run_task` via a request object, either of type
2664
+ # {::Google::Cloud::Dataplex::V1::RunTaskRequest} or an equivalent Hash.
2665
+ #
2666
+ # @param request [::Google::Cloud::Dataplex::V1::RunTaskRequest, ::Hash]
2667
+ # A request object representing the call parameters. Required. To specify no
2668
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2669
+ # @param options [::Gapic::CallOptions, ::Hash]
2670
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2671
+ #
2672
+ # @overload run_task(name: nil)
2673
+ # Pass arguments to `run_task` via keyword arguments. Note that at
2674
+ # least one keyword argument is required. To specify no parameters, or to keep all
2675
+ # the default parameter values, pass an empty Hash as a request object (see above).
2676
+ #
2677
+ # @param name [::String]
2678
+ # Required. The resource name of the task:
2679
+ # `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}`.
2680
+ #
2681
+ # @yield [response, operation] Access the result along with the RPC operation
2682
+ # @yieldparam response [::Google::Cloud::Dataplex::V1::RunTaskResponse]
2683
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2684
+ #
2685
+ # @return [::Google::Cloud::Dataplex::V1::RunTaskResponse]
2686
+ #
2687
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2688
+ #
2689
+ # @example Basic example
2690
+ # require "google/cloud/dataplex/v1"
2691
+ #
2692
+ # # Create a client object. The client can be reused for multiple calls.
2693
+ # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
2694
+ #
2695
+ # # Create a request. To set request fields, pass in keyword arguments.
2696
+ # request = Google::Cloud::Dataplex::V1::RunTaskRequest.new
2697
+ #
2698
+ # # Call the run_task method.
2699
+ # result = client.run_task request
2700
+ #
2701
+ # # The returned object is of type Google::Cloud::Dataplex::V1::RunTaskResponse.
2702
+ # p result
2703
+ #
2704
+ def run_task request, options = nil
2705
+ raise ::ArgumentError, "request must be provided" if request.nil?
2706
+
2707
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::RunTaskRequest
2708
+
2709
+ # Converts hash and nil to an options object
2710
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2711
+
2712
+ # Customize the options with defaults
2713
+ metadata = @config.rpcs.run_task.metadata.to_h
2714
+
2715
+ # Set x-goog-api-client and x-goog-user-project headers
2716
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2717
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2718
+ gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
2719
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2720
+
2721
+ header_params = {}
2722
+ if request.name
2723
+ header_params["name"] = request.name
2724
+ end
2725
+
2726
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2727
+ metadata[:"x-goog-request-params"] ||= request_params_header
2728
+
2729
+ options.apply_defaults timeout: @config.rpcs.run_task.timeout,
2730
+ metadata: metadata,
2731
+ retry_policy: @config.rpcs.run_task.retry_policy
2732
+
2733
+ options.apply_defaults timeout: @config.timeout,
2734
+ metadata: @config.metadata,
2735
+ retry_policy: @config.retry_policy
2736
+
2737
+ @dataplex_service_stub.call_rpc :run_task, request, options: options do |response, operation|
2738
+ yield response, operation if block_given?
2739
+ return response
2740
+ end
2741
+ rescue ::GRPC::BadStatus => e
2742
+ raise ::Google::Cloud::Error.from_error(e)
2743
+ end
2744
+
2659
2745
  ##
2660
2746
  # Get job resource.
2661
2747
  #
@@ -3467,9 +3553,9 @@ module Google
3467
3553
  # * (`String`) The path to a service account key file in JSON format
3468
3554
  # * (`Hash`) A service account key as a Hash
3469
3555
  # * (`Google::Auth::Credentials`) A googleauth credentials object
3470
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
3556
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
3471
3557
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3472
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
3558
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
3473
3559
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
3474
3560
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
3475
3561
  # * (`nil`) indicating no credentials
@@ -3685,6 +3771,11 @@ module Google
3685
3771
  #
3686
3772
  attr_reader :list_jobs
3687
3773
  ##
3774
+ # RPC-specific configuration for `run_task`
3775
+ # @return [::Gapic::Config::Method]
3776
+ #
3777
+ attr_reader :run_task
3778
+ ##
3688
3779
  # RPC-specific configuration for `get_job`
3689
3780
  # @return [::Gapic::Config::Method]
3690
3781
  #
@@ -3775,6 +3866,8 @@ module Google
3775
3866
  @get_task = ::Gapic::Config::Method.new get_task_config
3776
3867
  list_jobs_config = parent_rpcs.list_jobs if parent_rpcs.respond_to? :list_jobs
3777
3868
  @list_jobs = ::Gapic::Config::Method.new list_jobs_config
3869
+ run_task_config = parent_rpcs.run_task if parent_rpcs.respond_to? :run_task
3870
+ @run_task = ::Gapic::Config::Method.new run_task_config
3778
3871
  get_job_config = parent_rpcs.get_job if parent_rpcs.respond_to? :get_job
3779
3872
  @get_job = ::Gapic::Config::Method.new get_job_config
3780
3873
  cancel_job_config = parent_rpcs.cancel_job if parent_rpcs.respond_to? :cancel_job
@@ -620,9 +620,9 @@ module Google
620
620
  # * (`String`) The path to a service account key file in JSON format
621
621
  # * (`Hash`) A service account key as a Hash
622
622
  # * (`Google::Auth::Credentials`) A googleauth credentials object
623
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
623
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
624
624
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
625
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
625
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
626
626
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
627
627
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
628
628
  # * (`nil`) indicating no credentials
@@ -1979,6 +1979,69 @@ module Google
1979
1979
  raise ::Google::Cloud::Error.from_error(e)
1980
1980
  end
1981
1981
 
1982
+ ##
1983
+ # Run an on demand execution of a Task.
1984
+ #
1985
+ # @overload run_task(request, options = nil)
1986
+ # Pass arguments to `run_task` via a request object, either of type
1987
+ # {::Google::Cloud::Dataplex::V1::RunTaskRequest} or an equivalent Hash.
1988
+ #
1989
+ # @param request [::Google::Cloud::Dataplex::V1::RunTaskRequest, ::Hash]
1990
+ # A request object representing the call parameters. Required. To specify no
1991
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1992
+ # @param options [::Gapic::CallOptions, ::Hash]
1993
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1994
+ #
1995
+ # @overload run_task(name: nil)
1996
+ # Pass arguments to `run_task` via keyword arguments. Note that at
1997
+ # least one keyword argument is required. To specify no parameters, or to keep all
1998
+ # the default parameter values, pass an empty Hash as a request object (see above).
1999
+ #
2000
+ # @param name [::String]
2001
+ # Required. The resource name of the task:
2002
+ # `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{task_id}`.
2003
+ # @yield [result, operation] Access the result along with the TransportOperation object
2004
+ # @yieldparam result [::Google::Cloud::Dataplex::V1::RunTaskResponse]
2005
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2006
+ #
2007
+ # @return [::Google::Cloud::Dataplex::V1::RunTaskResponse]
2008
+ #
2009
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2010
+ def run_task request, options = nil
2011
+ raise ::ArgumentError, "request must be provided" if request.nil?
2012
+
2013
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::RunTaskRequest
2014
+
2015
+ # Converts hash and nil to an options object
2016
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2017
+
2018
+ # Customize the options with defaults
2019
+ call_metadata = @config.rpcs.run_task.metadata.to_h
2020
+
2021
+ # Set x-goog-api-client and x-goog-user-project headers
2022
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2023
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2024
+ gapic_version: ::Google::Cloud::Dataplex::V1::VERSION,
2025
+ transports_version_send: [:rest]
2026
+
2027
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2028
+
2029
+ options.apply_defaults timeout: @config.rpcs.run_task.timeout,
2030
+ metadata: call_metadata,
2031
+ retry_policy: @config.rpcs.run_task.retry_policy
2032
+
2033
+ options.apply_defaults timeout: @config.timeout,
2034
+ metadata: @config.metadata,
2035
+ retry_policy: @config.retry_policy
2036
+
2037
+ @dataplex_service_stub.run_task request, options do |result, operation|
2038
+ yield result, operation if block_given?
2039
+ return result
2040
+ end
2041
+ rescue ::Gapic::Rest::Error => e
2042
+ raise ::Google::Cloud::Error.from_error(e)
2043
+ end
2044
+
1982
2045
  ##
1983
2046
  # Get job resource.
1984
2047
  #
@@ -2577,9 +2640,9 @@ module Google
2577
2640
  # * (`String`) The path to a service account key file in JSON format
2578
2641
  # * (`Hash`) A service account key as a Hash
2579
2642
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2580
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
2643
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2581
2644
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2582
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
2645
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2583
2646
  # * (`nil`) indicating no credentials
2584
2647
  # @return [::Object]
2585
2648
  # @!attribute [rw] scope
@@ -2790,6 +2853,11 @@ module Google
2790
2853
  #
2791
2854
  attr_reader :list_jobs
2792
2855
  ##
2856
+ # RPC-specific configuration for `run_task`
2857
+ # @return [::Gapic::Config::Method]
2858
+ #
2859
+ attr_reader :run_task
2860
+ ##
2793
2861
  # RPC-specific configuration for `get_job`
2794
2862
  # @return [::Gapic::Config::Method]
2795
2863
  #
@@ -2880,6 +2948,8 @@ module Google
2880
2948
  @get_task = ::Gapic::Config::Method.new get_task_config
2881
2949
  list_jobs_config = parent_rpcs.list_jobs if parent_rpcs.respond_to? :list_jobs
2882
2950
  @list_jobs = ::Gapic::Config::Method.new list_jobs_config
2951
+ run_task_config = parent_rpcs.run_task if parent_rpcs.respond_to? :run_task
2952
+ @run_task = ::Gapic::Config::Method.new run_task_config
2883
2953
  get_job_config = parent_rpcs.get_job if parent_rpcs.respond_to? :get_job
2884
2954
  @get_job = ::Gapic::Config::Method.new get_job_config
2885
2955
  cancel_job_config = parent_rpcs.cancel_job if parent_rpcs.respond_to? :cancel_job
@@ -411,9 +411,9 @@ module Google
411
411
  # * (`String`) The path to a service account key file in JSON format
412
412
  # * (`Hash`) A service account key as a Hash
413
413
  # * (`Google::Auth::Credentials`) A googleauth credentials object
414
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
414
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
415
415
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
416
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
416
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
417
417
  # * (`nil`) indicating no credentials
418
418
  # @return [::Object]
419
419
  # @!attribute [rw] scope
@@ -952,6 +952,44 @@ module Google
952
952
  result
953
953
  end
954
954
 
955
+ ##
956
+ # Baseline implementation for the run_task REST call
957
+ #
958
+ # @param request_pb [::Google::Cloud::Dataplex::V1::RunTaskRequest]
959
+ # A request object representing the call parameters. Required.
960
+ # @param options [::Gapic::CallOptions]
961
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
962
+ #
963
+ # @yield [result, operation] Access the result along with the TransportOperation object
964
+ # @yieldparam result [::Google::Cloud::Dataplex::V1::RunTaskResponse]
965
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
966
+ #
967
+ # @return [::Google::Cloud::Dataplex::V1::RunTaskResponse]
968
+ # A result object deserialized from the server's reply
969
+ def run_task request_pb, options = nil
970
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
971
+
972
+ verb, uri, query_string_params, body = ServiceStub.transcode_run_task_request request_pb
973
+ query_string_params = if query_string_params.any?
974
+ query_string_params.to_h { |p| p.split("=", 2) }
975
+ else
976
+ {}
977
+ end
978
+
979
+ response = @client_stub.make_http_request(
980
+ verb,
981
+ uri: uri,
982
+ body: body || "",
983
+ params: query_string_params,
984
+ options: options
985
+ )
986
+ operation = ::Gapic::Rest::TransportOperation.new response
987
+ result = ::Google::Cloud::Dataplex::V1::RunTaskResponse.decode_json response.body, ignore_unknown_fields: true
988
+
989
+ yield result, operation if block_given?
990
+ result
991
+ end
992
+
955
993
  ##
956
994
  # Baseline implementation for the get_job REST call
957
995
  #
@@ -1768,6 +1806,28 @@ module Google
1768
1806
  transcoder.transcode request_pb
1769
1807
  end
1770
1808
 
1809
+ ##
1810
+ # @private
1811
+ #
1812
+ # GRPC transcoding helper method for the run_task REST call
1813
+ #
1814
+ # @param request_pb [::Google::Cloud::Dataplex::V1::RunTaskRequest]
1815
+ # A request object representing the call parameters. Required.
1816
+ # @return [Array(String, [String, nil], Hash{String => String})]
1817
+ # Uri, Body, Query string parameters
1818
+ def self.transcode_run_task_request request_pb
1819
+ transcoder = Gapic::Rest::GrpcTranscoder.new
1820
+ .with_bindings(
1821
+ uri_method: :post,
1822
+ uri_template: "/v1/{name}:run",
1823
+ body: "*",
1824
+ matches: [
1825
+ ["name", %r{^projects/[^/]+/locations/[^/]+/lakes/[^/]+/tasks/[^/]+/?$}, false]
1826
+ ]
1827
+ )
1828
+ transcoder.transcode request_pb
1829
+ end
1830
+
1771
1831
  ##
1772
1832
  # @private
1773
1833
  #
@@ -11,7 +11,9 @@ require 'google/cloud/dataplex/v1/data_profile_pb'
11
11
  require 'google/cloud/dataplex/v1/data_quality_pb'
12
12
  require 'google/cloud/dataplex/v1/processing_pb'
13
13
  require 'google/cloud/dataplex/v1/resources_pb'
14
+ require 'google/cloud/dataplex/v1/service_pb'
14
15
  require 'google/longrunning/operations_pb'
16
+ require 'google/protobuf/empty_pb'
15
17
  require 'google/protobuf/field_mask_pb'
16
18
  require 'google/protobuf/timestamp_pb'
17
19
 
@@ -21,10 +23,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
21
23
  optional :parent, :string, 1
22
24
  optional :data_scan, :message, 2, "google.cloud.dataplex.v1.DataScan"
23
25
  optional :data_scan_id, :string, 3
26
+ optional :validate_only, :bool, 4
24
27
  end
25
28
  add_message "google.cloud.dataplex.v1.UpdateDataScanRequest" do
26
29
  optional :data_scan, :message, 1, "google.cloud.dataplex.v1.DataScan"
27
30
  optional :update_mask, :message, 2, "google.protobuf.FieldMask"
31
+ optional :validate_only, :bool, 3
28
32
  end
29
33
  add_message "google.cloud.dataplex.v1.DeleteDataScanRequest" do
30
34
  optional :name, :string, 1
@@ -89,6 +89,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
89
89
  optional :system, :enum, 15, "google.cloud.dataplex.v1.StorageSystem"
90
90
  optional :format, :message, 16, "google.cloud.dataplex.v1.StorageFormat"
91
91
  optional :compatibility, :message, 19, "google.cloud.dataplex.v1.Entity.CompatibilityStatus"
92
+ optional :access, :message, 21, "google.cloud.dataplex.v1.StorageAccess"
93
+ optional :uid, :string, 22
92
94
  optional :schema, :message, 50, "google.cloud.dataplex.v1.Schema"
93
95
  end
94
96
  add_message "google.cloud.dataplex.v1.Entity.CompatibilityStatus" do
@@ -197,6 +199,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
197
199
  value :GZIP, 2
198
200
  value :BZIP2, 3
199
201
  end
202
+ add_message "google.cloud.dataplex.v1.StorageAccess" do
203
+ optional :read, :enum, 21, "google.cloud.dataplex.v1.StorageAccess.AccessMode"
204
+ end
205
+ add_enum "google.cloud.dataplex.v1.StorageAccess.AccessMode" do
206
+ value :ACCESS_MODE_UNSPECIFIED, 0
207
+ value :DIRECT, 1
208
+ value :MANAGED, 2
209
+ end
200
210
  add_enum "google.cloud.dataplex.v1.StorageSystem" do
201
211
  value :STORAGE_SYSTEM_UNSPECIFIED, 0
202
212
  value :CLOUD_STORAGE, 1
@@ -239,6 +249,8 @@ module Google
239
249
  StorageFormat::IcebergOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageFormat.IcebergOptions").msgclass
240
250
  StorageFormat::Format = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageFormat.Format").enummodule
241
251
  StorageFormat::CompressionFormat = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageFormat.CompressionFormat").enummodule
252
+ StorageAccess = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageAccess").msgclass
253
+ StorageAccess::AccessMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageAccess.AccessMode").enummodule
242
254
  StorageSystem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.StorageSystem").enummodule
243
255
  end
244
256
  end
@@ -1101,9 +1101,9 @@ module Google
1101
1101
  # * (`String`) The path to a service account key file in JSON format
1102
1102
  # * (`Hash`) A service account key as a Hash
1103
1103
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1104
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1104
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1105
1105
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1106
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1106
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1107
1107
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1108
1108
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1109
1109
  # * (`nil`) indicating no credentials