google-cloud-data_catalog-v1 0.14.0 → 0.16.0

Sign up to get free protection for your applications and to get access to all the features.
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