google-cloud-data_catalog-v1 0.14.0 → 0.16.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 (48) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +288 -54
  4. data/lib/google/cloud/data_catalog/v1/data_catalog/operations.rb +768 -0
  5. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb +228 -54
  6. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/operations.rb +792 -0
  7. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/service_stub.rb +120 -0
  8. data/lib/google/cloud/data_catalog/v1/data_catalog/rest.rb +1 -0
  9. data/lib/google/cloud/data_catalog/v1/data_catalog.rb +1 -0
  10. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +6 -3
  11. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/rest/client.rb +6 -3
  12. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +6 -4
  13. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest/client.rb +6 -4
  14. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  15. data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +24 -25
  16. data/lib/google/cloud/datacatalog/v1/common_pb.rb +26 -12
  17. data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +24 -18
  18. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +55 -263
  19. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +33 -0
  20. data/lib/google/cloud/datacatalog/v1/dataplex_spec_pb.rb +25 -21
  21. data/lib/google/cloud/datacatalog/v1/dump_content_pb.rb +49 -0
  22. data/lib/google/cloud/datacatalog/v1/gcs_fileset_spec_pb.rb +25 -10
  23. data/lib/google/cloud/datacatalog/v1/physical_schema_pb.rb +24 -26
  24. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +28 -66
  25. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +25 -43
  26. data/lib/google/cloud/datacatalog/v1/schema_pb.rb +27 -11
  27. data/lib/google/cloud/datacatalog/v1/search_pb.rb +25 -21
  28. data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +24 -26
  29. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +25 -59
  30. data/lib/google/cloud/datacatalog/v1/timestamps_pb.rb +25 -6
  31. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +26 -11
  32. data/proto_docs/google/api/client.rb +67 -4
  33. data/proto_docs/google/cloud/datacatalog/v1/common.rb +25 -0
  34. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +367 -41
  35. data/proto_docs/google/cloud/datacatalog/v1/dump_content.rb +53 -0
  36. data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +2 -1
  37. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +23 -2
  38. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +6 -3
  39. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +68 -3
  40. data/proto_docs/google/cloud/datacatalog/v1/search.rb +2 -2
  41. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +5 -5
  42. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +11 -8
  43. data/proto_docs/google/cloud/datacatalog/v1/usage.rb +30 -1
  44. data/proto_docs/google/longrunning/operations.rb +164 -0
  45. data/proto_docs/google/protobuf/any.rb +144 -0
  46. data/proto_docs/google/protobuf/timestamp.rb +1 -3
  47. data/proto_docs/google/rpc/status.rb +48 -0
  48. metadata +11 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b8ea140377daa0bb096d98b3caa4a748568a94bcef202599229803a74a5f13c1
4
- data.tar.gz: 6b88c341a9b1c9fc6fa3100bac7aee78bdc34806b8a044b241a0c49787fe6670
3
+ metadata.gz: 287a106028e030737475116a68767810728bbe6300dcd308072e53eef227495e
4
+ data.tar.gz: 3ff5fb58112bfb569cdef3307029a14e7f7d0f1de030cf03ccde349352d039a3
5
5
  SHA512:
6
- metadata.gz: 784cac8f9f0f249613d46bc56bd0d0fdbe680eae305166a9e89891a3b32fd0b9602bc69652a46d39ceb0e65e2964650335f225a97b257934e934eaba818703cb
7
- data.tar.gz: 41f5e31b8711d5794e7a7e71ceba78fa1f7b18026b71004cd573fbb8bfe861a6b84222a3b1fc4305cb144fe342e75edf7b175d4bae484f78287660ece350739c
6
+ metadata.gz: 95d4feec2aeb82509fb40dd46b2e1fcc5057f566fdfbd0a0c1038fb5bc7ac11abdb2f8c3cdd1c2c32edd0d10fc29ec9dbdf61efb21c60a5dada00f999fbcb379
7
+ data.tar.gz: e8c76153b2b5814d3f1243eff17e20462ab6166706d077499514315ee7dc07be0311ac9ddb30b928a41546db9313112bf96bf052bba70e95b0af213df887a843
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
 
@@ -67,45 +67,8 @@ module Google
67
67
  default_config = Client::Configuration.new parent_config
68
68
 
69
69
  default_config.timeout = 60.0
70
-
71
- default_config.rpcs.search_catalog.timeout = 60.0
72
- default_config.rpcs.search_catalog.retry_policy = {
73
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
74
- }
75
-
76
- default_config.rpcs.get_entry_group.timeout = 60.0
77
- default_config.rpcs.get_entry_group.retry_policy = {
78
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
79
- }
80
-
81
- default_config.rpcs.list_entry_groups.timeout = 60.0
82
- default_config.rpcs.list_entry_groups.retry_policy = {
83
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
84
- }
85
-
86
- default_config.rpcs.get_entry.timeout = 60.0
87
- default_config.rpcs.get_entry.retry_policy = {
88
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
89
- }
90
-
91
- default_config.rpcs.lookup_entry.timeout = 60.0
92
- default_config.rpcs.lookup_entry.retry_policy = {
93
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
94
- }
95
-
96
- default_config.rpcs.list_entries.timeout = 60.0
97
- default_config.rpcs.list_entries.retry_policy = {
98
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
99
- }
100
-
101
- default_config.rpcs.list_tags.timeout = 60.0
102
- default_config.rpcs.list_tags.retry_policy = {
103
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
104
- }
105
-
106
- default_config.rpcs.get_iam_policy.timeout = 60.0
107
- default_config.rpcs.get_iam_policy.retry_policy = {
108
- initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
70
+ default_config.retry_policy = {
71
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 8, 13]
109
72
  }
110
73
 
111
74
  default_config
@@ -177,6 +140,12 @@ module Google
177
140
  @quota_project_id = @config.quota_project
178
141
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
179
142
 
143
+ @operations_client = Operations.new do |config|
144
+ config.credentials = credentials
145
+ config.quota_project = @quota_project_id
146
+ config.endpoint = @config.endpoint
147
+ end
148
+
180
149
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
181
150
  config.credentials = credentials
182
151
  config.quota_project = @quota_project_id
@@ -192,6 +161,13 @@ module Google
192
161
  )
193
162
  end
194
163
 
164
+ ##
165
+ # Get the associated client for long-running operations.
166
+ #
167
+ # @return [::Google::Cloud::DataCatalog::V1::DataCatalog::Operations]
168
+ #
169
+ attr_reader :operations_client
170
+
195
171
  ##
196
172
  # Get the associated client for mix-in of the IAMPolicy.
197
173
  #
@@ -240,9 +216,8 @@ module Google
240
216
  # empty AND `include_gcp_public_datasets` is set to `false`. In this case,
241
217
  # the request returns an error.
242
218
  # @param query [::String]
243
- # Optional. The query string with a minimum of 3 characters and specific syntax.
244
- # For more information, see
245
- # [Data Catalog search
219
+ # Optional. The query string with a minimum of 3 characters and specific
220
+ # syntax. For more information, see [Data Catalog search
246
221
  # syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
247
222
  #
248
223
  # An empty query string returns all data assets (in the specified scope)
@@ -260,10 +235,11 @@ module Google
260
235
  # The maximum number is 1000. If exceeded, throws an "invalid argument"
261
236
  # exception.
262
237
  # @param page_token [::String]
263
- # Optional. Pagination token that, if specified, returns the next page of search
264
- # results. If empty, returns the first page.
238
+ # Optional. Pagination token that, if specified, returns the next page of
239
+ # search results. If empty, returns the first page.
265
240
  #
266
- # This token is returned in the {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
241
+ # This token is returned in the
242
+ # {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
267
243
  # field of the response to a previous
268
244
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
269
245
  # call.
@@ -384,7 +360,8 @@ module Google
384
360
  # the default parameter values, pass an empty Hash as a request object (see above).
385
361
  #
386
362
  # @param parent [::String]
387
- # Required. The names of the project and location that the new entry group belongs to.
363
+ # Required. The names of the project and location that the new entry group
364
+ # belongs to.
388
365
  #
389
366
  # Note: The entry group itself and its child resources might not be
390
367
  # stored in the location specified in its name.
@@ -1256,7 +1233,7 @@ module Google
1256
1233
  # @param options [::Gapic::CallOptions, ::Hash]
1257
1234
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1258
1235
  #
1259
- # @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil)
1236
+ # @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil, project: nil, location: nil)
1260
1237
  # Pass arguments to `lookup_entry` via keyword arguments. Note that at
1261
1238
  # least one keyword argument is required. To specify no parameters, or to keep all
1262
1239
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1285,7 +1262,9 @@ module Google
1285
1262
  # [Lexical structure in Standard SQL]
1286
1263
  # (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
1287
1264
  # @param fully_qualified_name [::String]
1288
- # Fully qualified name (FQN) of the resource.
1265
+ # [Fully Qualified Name
1266
+ # (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
1267
+ # of the resource.
1289
1268
  #
1290
1269
  # FQNs take two forms:
1291
1270
  #
@@ -1300,6 +1279,14 @@ module Google
1300
1279
  # Example for a DPMS table:
1301
1280
  #
1302
1281
  # `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
1282
+ # @param project [::String]
1283
+ # Project where the lookup should be performed. Required to lookup
1284
+ # entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
1285
+ # using its `fully_qualified_name`. Ignored in other cases.
1286
+ # @param location [::String]
1287
+ # Location where the lookup should be performed. Required to lookup
1288
+ # entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
1289
+ # using its `fully_qualified_name`. Ignored in other cases.
1303
1290
  #
1304
1291
  # @yield [response, operation] Access the result along with the RPC operation
1305
1292
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -2158,8 +2145,8 @@ module Google
2158
2145
  # @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
2159
2146
  # Required. The template to update.
2160
2147
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2161
- # Optional. Names of fields whose values to overwrite on an individual field of a tag
2162
- # template. The following fields are modifiable:
2148
+ # Optional. Names of fields whose values to overwrite on an individual field
2149
+ # of a tag template. The following fields are modifiable:
2163
2150
  #
2164
2151
  # * `display_name`
2165
2152
  # * `type.enum_type`
@@ -2264,7 +2251,8 @@ module Google
2264
2251
  # @param name [::String]
2265
2252
  # Required. The name of the tag template field.
2266
2253
  # @param new_tag_template_field_id [::String]
2267
- # Required. The new ID of this tag template field. For example, `my_new_field`.
2254
+ # Required. The new ID of this tag template field. For example,
2255
+ # `my_new_field`.
2268
2256
  #
2269
2257
  # @yield [response, operation] Access the result along with the RPC operation
2270
2258
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
@@ -2353,7 +2341,8 @@ module Google
2353
2341
  # @param name [::String]
2354
2342
  # Required. The name of the enum field value.
2355
2343
  # @param new_enum_value_display_name [::String]
2356
- # Required. The new display name of the enum value. For example, `my_new_enum_value`.
2344
+ # Required. The new display name of the enum value. For example,
2345
+ # `my_new_enum_value`.
2357
2346
  #
2358
2347
  # @yield [response, operation] Access the result along with the RPC operation
2359
2348
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
@@ -2895,6 +2884,122 @@ module Google
2895
2884
  raise ::Google::Cloud::Error.from_error(e)
2896
2885
  end
2897
2886
 
2887
+ ##
2888
+ # `ReconcileTags` creates or updates a list of tags on the entry.
2889
+ # If the
2890
+ # {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest#force_delete_missing ReconcileTagsRequest.force_delete_missing}
2891
+ # parameter is set, the operation deletes tags not included in the input tag
2892
+ # list.
2893
+ #
2894
+ # `ReconcileTags` returns a [long-running operation]
2895
+ # [google.longrunning.Operation] resource that can be queried with
2896
+ # Operations.GetOperation
2897
+ # to return [ReconcileTagsMetadata]
2898
+ # [google.cloud.datacatalog.v1.ReconcileTagsMetadata] and
2899
+ # a [ReconcileTagsResponse]
2900
+ # [google.cloud.datacatalog.v1.ReconcileTagsResponse] message.
2901
+ #
2902
+ # @overload reconcile_tags(request, options = nil)
2903
+ # Pass arguments to `reconcile_tags` via a request object, either of type
2904
+ # {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest} or an equivalent Hash.
2905
+ #
2906
+ # @param request [::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest, ::Hash]
2907
+ # A request object representing the call parameters. Required. To specify no
2908
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2909
+ # @param options [::Gapic::CallOptions, ::Hash]
2910
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2911
+ #
2912
+ # @overload reconcile_tags(parent: nil, tag_template: nil, force_delete_missing: nil, tags: nil)
2913
+ # Pass arguments to `reconcile_tags` via keyword arguments. Note that at
2914
+ # least one keyword argument is required. To specify no parameters, or to keep all
2915
+ # the default parameter values, pass an empty Hash as a request object (see above).
2916
+ #
2917
+ # @param parent [::String]
2918
+ # Required. Name of {::Google::Cloud::DataCatalog::V1::Entry Entry} to be tagged.
2919
+ # @param tag_template [::String]
2920
+ # Required. The name of the tag template, which is used for reconciliation.
2921
+ # @param force_delete_missing [::Boolean]
2922
+ # If set to `true`, deletes entry tags related to a tag template
2923
+ # not listed in the tags source from an entry. If set to `false`,
2924
+ # unlisted tags are retained.
2925
+ # @param tags [::Array<::Google::Cloud::DataCatalog::V1::Tag, ::Hash>]
2926
+ # A list of tags to apply to an entry. A tag can specify a
2927
+ # tag template, which must be the template specified in the
2928
+ # `ReconcileTagsRequest`.
2929
+ # The sole entry and each of its columns must be mentioned at most once.
2930
+ #
2931
+ # @yield [response, operation] Access the result along with the RPC operation
2932
+ # @yieldparam response [::Gapic::Operation]
2933
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2934
+ #
2935
+ # @return [::Gapic::Operation]
2936
+ #
2937
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2938
+ #
2939
+ # @example Basic example
2940
+ # require "google/cloud/data_catalog/v1"
2941
+ #
2942
+ # # Create a client object. The client can be reused for multiple calls.
2943
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
2944
+ #
2945
+ # # Create a request. To set request fields, pass in keyword arguments.
2946
+ # request = Google::Cloud::DataCatalog::V1::ReconcileTagsRequest.new
2947
+ #
2948
+ # # Call the reconcile_tags method.
2949
+ # result = client.reconcile_tags request
2950
+ #
2951
+ # # The returned object is of type Gapic::Operation. You can use it to
2952
+ # # check the status of an operation, cancel it, or wait for results.
2953
+ # # Here is how to wait for a response.
2954
+ # result.wait_until_done! timeout: 60
2955
+ # if result.response?
2956
+ # p result.response
2957
+ # else
2958
+ # puts "No response received."
2959
+ # end
2960
+ #
2961
+ def reconcile_tags request, options = nil
2962
+ raise ::ArgumentError, "request must be provided" if request.nil?
2963
+
2964
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest
2965
+
2966
+ # Converts hash and nil to an options object
2967
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2968
+
2969
+ # Customize the options with defaults
2970
+ metadata = @config.rpcs.reconcile_tags.metadata.to_h
2971
+
2972
+ # Set x-goog-api-client and x-goog-user-project headers
2973
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2974
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2975
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
2976
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2977
+
2978
+ header_params = {}
2979
+ if request.parent
2980
+ header_params["parent"] = request.parent
2981
+ end
2982
+
2983
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2984
+ metadata[:"x-goog-request-params"] ||= request_params_header
2985
+
2986
+ options.apply_defaults timeout: @config.rpcs.reconcile_tags.timeout,
2987
+ metadata: metadata,
2988
+ retry_policy: @config.rpcs.reconcile_tags.retry_policy
2989
+
2990
+ options.apply_defaults timeout: @config.timeout,
2991
+ metadata: @config.metadata,
2992
+ retry_policy: @config.retry_policy
2993
+
2994
+ @data_catalog_stub.call_rpc :reconcile_tags, request, options: options do |response, operation|
2995
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2996
+ yield response, operation if block_given?
2997
+ return response
2998
+ end
2999
+ rescue ::GRPC::BadStatus => e
3000
+ raise ::Google::Cloud::Error.from_error(e)
3001
+ end
3002
+
2898
3003
  ##
2899
3004
  # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as starred by
2900
3005
  # the current user. Starring information is private to each user.
@@ -3393,6 +3498,121 @@ module Google
3393
3498
  raise ::Google::Cloud::Error.from_error(e)
3394
3499
  end
3395
3500
 
3501
+ ##
3502
+ # Imports entries from a source, such as data previously dumped into a
3503
+ # Cloud Storage bucket, into Data Catalog. Import of entries
3504
+ # is a sync operation that reconciles the state of the third-party system
3505
+ # with the Data Catalog.
3506
+ #
3507
+ # `ImportEntries` accepts source data snapshots of a third-party system.
3508
+ # Snapshot should be delivered as a .wire or base65-encoded .txt file
3509
+ # containing a sequence of Protocol Buffer messages of
3510
+ # {::Google::Cloud::DataCatalog::V1::DumpItem DumpItem} type.
3511
+ #
3512
+ # `ImportEntries` returns a [long-running operation]
3513
+ # [google.longrunning.Operation] resource that can be queried with
3514
+ # Operations.GetOperation
3515
+ # to return
3516
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesMetadata ImportEntriesMetadata}
3517
+ # and an
3518
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesResponse ImportEntriesResponse}
3519
+ # message.
3520
+ #
3521
+ # @overload import_entries(request, options = nil)
3522
+ # Pass arguments to `import_entries` via a request object, either of type
3523
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesRequest} or an equivalent Hash.
3524
+ #
3525
+ # @param request [::Google::Cloud::DataCatalog::V1::ImportEntriesRequest, ::Hash]
3526
+ # A request object representing the call parameters. Required. To specify no
3527
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3528
+ # @param options [::Gapic::CallOptions, ::Hash]
3529
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3530
+ #
3531
+ # @overload import_entries(parent: nil, gcs_bucket_path: nil, job_id: nil)
3532
+ # Pass arguments to `import_entries` via keyword arguments. Note that at
3533
+ # least one keyword argument is required. To specify no parameters, or to keep all
3534
+ # the default parameter values, pass an empty Hash as a request object (see above).
3535
+ #
3536
+ # @param parent [::String]
3537
+ # Required. Target entry group for ingested entries.
3538
+ # @param gcs_bucket_path [::String]
3539
+ # Path to a Cloud Storage bucket that contains a dump ready for ingestion.
3540
+ # @param job_id [::String]
3541
+ # Optional. (Optional) Dataplex task job id, if specified will be used as
3542
+ # part of ImportEntries LRO ID
3543
+ #
3544
+ # @yield [response, operation] Access the result along with the RPC operation
3545
+ # @yieldparam response [::Gapic::Operation]
3546
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3547
+ #
3548
+ # @return [::Gapic::Operation]
3549
+ #
3550
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3551
+ #
3552
+ # @example Basic example
3553
+ # require "google/cloud/data_catalog/v1"
3554
+ #
3555
+ # # Create a client object. The client can be reused for multiple calls.
3556
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
3557
+ #
3558
+ # # Create a request. To set request fields, pass in keyword arguments.
3559
+ # request = Google::Cloud::DataCatalog::V1::ImportEntriesRequest.new
3560
+ #
3561
+ # # Call the import_entries method.
3562
+ # result = client.import_entries request
3563
+ #
3564
+ # # The returned object is of type Gapic::Operation. You can use it to
3565
+ # # check the status of an operation, cancel it, or wait for results.
3566
+ # # Here is how to wait for a response.
3567
+ # result.wait_until_done! timeout: 60
3568
+ # if result.response?
3569
+ # p result.response
3570
+ # else
3571
+ # puts "No response received."
3572
+ # end
3573
+ #
3574
+ def import_entries request, options = nil
3575
+ raise ::ArgumentError, "request must be provided" if request.nil?
3576
+
3577
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ImportEntriesRequest
3578
+
3579
+ # Converts hash and nil to an options object
3580
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3581
+
3582
+ # Customize the options with defaults
3583
+ metadata = @config.rpcs.import_entries.metadata.to_h
3584
+
3585
+ # Set x-goog-api-client and x-goog-user-project headers
3586
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3587
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3588
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
3589
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3590
+
3591
+ header_params = {}
3592
+ if request.parent
3593
+ header_params["parent"] = request.parent
3594
+ end
3595
+
3596
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3597
+ metadata[:"x-goog-request-params"] ||= request_params_header
3598
+
3599
+ options.apply_defaults timeout: @config.rpcs.import_entries.timeout,
3600
+ metadata: metadata,
3601
+ retry_policy: @config.rpcs.import_entries.retry_policy
3602
+
3603
+ options.apply_defaults timeout: @config.timeout,
3604
+ metadata: @config.metadata,
3605
+ retry_policy: @config.retry_policy
3606
+
3607
+ @data_catalog_stub.call_rpc :import_entries, request, options: options do |response, operation|
3608
+ response = ::Gapic::Operation.new response, @operations_client, options: options
3609
+ yield response, operation if block_given?
3610
+ return response
3611
+ end
3612
+ rescue ::GRPC::BadStatus => e
3613
+ raise ::Google::Cloud::Error.from_error(e)
3614
+ end
3615
+
3396
3616
  ##
3397
3617
  # Configuration class for the DataCatalog API.
3398
3618
  #
@@ -3431,9 +3651,9 @@ module Google
3431
3651
  # * (`String`) The path to a service account key file in JSON format
3432
3652
  # * (`Hash`) A service account key as a Hash
3433
3653
  # * (`Google::Auth::Credentials`) A googleauth credentials object
3434
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
3654
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
3435
3655
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3436
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
3656
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
3437
3657
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
3438
3658
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
3439
3659
  # * (`nil`) indicating no credentials
@@ -3664,6 +3884,11 @@ module Google
3664
3884
  #
3665
3885
  attr_reader :list_tags
3666
3886
  ##
3887
+ # RPC-specific configuration for `reconcile_tags`
3888
+ # @return [::Gapic::Config::Method]
3889
+ #
3890
+ attr_reader :reconcile_tags
3891
+ ##
3667
3892
  # RPC-specific configuration for `star_entry`
3668
3893
  # @return [::Gapic::Config::Method]
3669
3894
  #
@@ -3688,6 +3913,11 @@ module Google
3688
3913
  # @return [::Gapic::Config::Method]
3689
3914
  #
3690
3915
  attr_reader :test_iam_permissions
3916
+ ##
3917
+ # RPC-specific configuration for `import_entries`
3918
+ # @return [::Gapic::Config::Method]
3919
+ #
3920
+ attr_reader :import_entries
3691
3921
 
3692
3922
  # @private
3693
3923
  def initialize parent_rpcs = nil
@@ -3745,6 +3975,8 @@ module Google
3745
3975
  @delete_tag = ::Gapic::Config::Method.new delete_tag_config
3746
3976
  list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
3747
3977
  @list_tags = ::Gapic::Config::Method.new list_tags_config
3978
+ reconcile_tags_config = parent_rpcs.reconcile_tags if parent_rpcs.respond_to? :reconcile_tags
3979
+ @reconcile_tags = ::Gapic::Config::Method.new reconcile_tags_config
3748
3980
  star_entry_config = parent_rpcs.star_entry if parent_rpcs.respond_to? :star_entry
3749
3981
  @star_entry = ::Gapic::Config::Method.new star_entry_config
3750
3982
  unstar_entry_config = parent_rpcs.unstar_entry if parent_rpcs.respond_to? :unstar_entry
@@ -3755,6 +3987,8 @@ module Google
3755
3987
  @get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
3756
3988
  test_iam_permissions_config = parent_rpcs.test_iam_permissions if parent_rpcs.respond_to? :test_iam_permissions
3757
3989
  @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
3990
+ import_entries_config = parent_rpcs.import_entries if parent_rpcs.respond_to? :import_entries
3991
+ @import_entries = ::Gapic::Config::Method.new import_entries_config
3758
3992
 
3759
3993
  yield self if block_given?
3760
3994
  end