google-cloud-dataplex-v1 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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