google-cloud-data_catalog-v1 0.13.0 → 0.15.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 (45) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +276 -13
  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 +3214 -0
  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 +2142 -0
  8. data/lib/google/cloud/data_catalog/v1/data_catalog/rest.rb +54 -0
  9. data/lib/google/cloud/data_catalog/v1/data_catalog.rb +7 -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 +1273 -0
  12. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/rest/service_stub.rb +846 -0
  13. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/rest.rb +57 -0
  14. data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +6 -0
  15. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +6 -4
  16. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest/client.rb +538 -0
  17. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest/service_stub.rb +227 -0
  18. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest.rb +55 -0
  19. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +6 -0
  20. data/lib/google/cloud/data_catalog/v1/rest.rb +39 -0
  21. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  22. data/lib/google/cloud/data_catalog/v1.rb +5 -0
  23. data/lib/google/cloud/datacatalog/v1/common_pb.rb +8 -0
  24. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +90 -0
  25. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +33 -0
  26. data/lib/google/cloud/datacatalog/v1/dump_content_pb.rb +35 -0
  27. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +8 -0
  28. data/lib/google/cloud/datacatalog/v1/schema_pb.rb +28 -0
  29. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +6 -0
  30. data/proto_docs/google/api/client.rb +9 -3
  31. data/proto_docs/google/cloud/datacatalog/v1/common.rb +19 -0
  32. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +283 -21
  33. data/proto_docs/google/cloud/datacatalog/v1/dump_content.rb +53 -0
  34. data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +2 -1
  35. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +23 -2
  36. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +6 -3
  37. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +68 -3
  38. data/proto_docs/google/cloud/datacatalog/v1/search.rb +2 -2
  39. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +5 -5
  40. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +11 -8
  41. data/proto_docs/google/cloud/datacatalog/v1/usage.rb +30 -1
  42. data/proto_docs/google/longrunning/operations.rb +164 -0
  43. data/proto_docs/google/protobuf/any.rb +141 -0
  44. data/proto_docs/google/rpc/status.rb +48 -0
  45. metadata +23 -5
@@ -0,0 +1,3214 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/cloud/datacatalog/v1/datacatalog_pb"
21
+ require "google/cloud/data_catalog/v1/data_catalog/rest/service_stub"
22
+ require "google/iam/v1/rest"
23
+
24
+ module Google
25
+ module Cloud
26
+ module DataCatalog
27
+ module V1
28
+ module DataCatalog
29
+ module Rest
30
+ ##
31
+ # REST client for the DataCatalog service.
32
+ #
33
+ # Data Catalog API service allows you to discover, understand, and manage
34
+ # your data.
35
+ #
36
+ class Client
37
+ include Paths
38
+
39
+ # @private
40
+ attr_reader :data_catalog_stub
41
+
42
+ ##
43
+ # Configure the DataCatalog Client class.
44
+ #
45
+ # See {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client::Configuration}
46
+ # for a description of the configuration fields.
47
+ #
48
+ # @example
49
+ #
50
+ # # Modify the configuration for all DataCatalog clients
51
+ # ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.configure do |config|
52
+ # config.timeout = 10.0
53
+ # end
54
+ #
55
+ # @yield [config] Configure the Client client.
56
+ # @yieldparam config [Client::Configuration]
57
+ #
58
+ # @return [Client::Configuration]
59
+ #
60
+ def self.configure
61
+ @configure ||= begin
62
+ namespace = ["Google", "Cloud", "DataCatalog", "V1"]
63
+ parent_config = while namespace.any?
64
+ parent_name = namespace.join "::"
65
+ parent_const = const_get parent_name
66
+ break parent_const.configure if parent_const.respond_to? :configure
67
+ namespace.pop
68
+ end
69
+ default_config = Client::Configuration.new parent_config
70
+
71
+ default_config.timeout = 60.0
72
+
73
+ default_config.rpcs.search_catalog.timeout = 60.0
74
+ default_config.rpcs.search_catalog.retry_policy = {
75
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
76
+ }
77
+
78
+ default_config.rpcs.get_entry_group.timeout = 60.0
79
+ default_config.rpcs.get_entry_group.retry_policy = {
80
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
81
+ }
82
+
83
+ default_config.rpcs.list_entry_groups.timeout = 60.0
84
+ default_config.rpcs.list_entry_groups.retry_policy = {
85
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
86
+ }
87
+
88
+ default_config.rpcs.get_entry.timeout = 60.0
89
+ default_config.rpcs.get_entry.retry_policy = {
90
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
91
+ }
92
+
93
+ default_config.rpcs.lookup_entry.timeout = 60.0
94
+ default_config.rpcs.lookup_entry.retry_policy = {
95
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
96
+ }
97
+
98
+ default_config.rpcs.list_entries.timeout = 60.0
99
+ default_config.rpcs.list_entries.retry_policy = {
100
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
101
+ }
102
+
103
+ default_config.rpcs.list_tags.timeout = 60.0
104
+ default_config.rpcs.list_tags.retry_policy = {
105
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
106
+ }
107
+
108
+ default_config.rpcs.get_iam_policy.timeout = 60.0
109
+ default_config.rpcs.get_iam_policy.retry_policy = {
110
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
111
+ }
112
+
113
+ default_config.rpcs.import_entries.timeout = 60.0
114
+ default_config.rpcs.import_entries.retry_policy = {
115
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
116
+ }
117
+
118
+ default_config
119
+ end
120
+ yield @configure if block_given?
121
+ @configure
122
+ end
123
+
124
+ ##
125
+ # Configure the DataCatalog Client instance.
126
+ #
127
+ # The configuration is set to the derived mode, meaning that values can be changed,
128
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
129
+ # should be made on {Client.configure}.
130
+ #
131
+ # See {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client::Configuration}
132
+ # for a description of the configuration fields.
133
+ #
134
+ # @yield [config] Configure the Client client.
135
+ # @yieldparam config [Client::Configuration]
136
+ #
137
+ # @return [Client::Configuration]
138
+ #
139
+ def configure
140
+ yield @config if block_given?
141
+ @config
142
+ end
143
+
144
+ ##
145
+ # Create a new DataCatalog REST client object.
146
+ #
147
+ # @example
148
+ #
149
+ # # Create a client using the default configuration
150
+ # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new
151
+ #
152
+ # # Create a client using a custom configuration
153
+ # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new do |config|
154
+ # config.timeout = 10.0
155
+ # end
156
+ #
157
+ # @yield [config] Configure the DataCatalog client.
158
+ # @yieldparam config [Client::Configuration]
159
+ #
160
+ def initialize
161
+ # Create the configuration object
162
+ @config = Configuration.new Client.configure
163
+
164
+ # Yield the configuration if needed
165
+ yield @config if block_given?
166
+
167
+ # Create credentials
168
+ credentials = @config.credentials
169
+ # Use self-signed JWT if the endpoint is unchanged from default,
170
+ # but only if the default endpoint does not have a region prefix.
171
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
172
+ !@config.endpoint.split(".").first.include?("-")
173
+ credentials ||= Credentials.default scope: @config.scope,
174
+ enable_self_signed_jwt: enable_self_signed_jwt
175
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
176
+ credentials = Credentials.new credentials, scope: @config.scope
177
+ end
178
+
179
+ @quota_project_id = @config.quota_project
180
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
181
+
182
+ @operations_client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Operations.new do |config|
183
+ config.credentials = credentials
184
+ config.quota_project = @quota_project_id
185
+ config.endpoint = @config.endpoint
186
+ end
187
+
188
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
189
+ config.credentials = credentials
190
+ config.quota_project = @quota_project_id
191
+ config.endpoint = @config.endpoint
192
+ end
193
+
194
+ @data_catalog_stub = ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
195
+ end
196
+
197
+ ##
198
+ # Get the associated client for long-running operations.
199
+ #
200
+ # @return [::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Operations]
201
+ #
202
+ attr_reader :operations_client
203
+
204
+ ##
205
+ # Get the associated client for mix-in of the IAMPolicy.
206
+ #
207
+ # @return [Google::Iam::V1::IAMPolicy::Rest::Client]
208
+ #
209
+ attr_reader :iam_policy_client
210
+
211
+ # Service calls
212
+
213
+ ##
214
+ # Searches Data Catalog for multiple resources like entries and tags that
215
+ # match a query.
216
+ #
217
+ # This is a [Custom Method]
218
+ # (https://cloud.google.com/apis/design/custom_methods) that doesn't return
219
+ # all information on a resource, only its ID and high level fields. To get
220
+ # more information, you can subsequently call specific get methods.
221
+ #
222
+ # Note: Data Catalog search queries don't guarantee full recall. Results
223
+ # that match your query might not be returned, even in subsequent
224
+ # result pages. Additionally, returned (and not returned) results can vary
225
+ # if you repeat search queries.
226
+ #
227
+ # For more information, see [Data Catalog search syntax]
228
+ # (https://cloud.google.com/data-catalog/docs/how-to/search-reference).
229
+ #
230
+ # @overload search_catalog(request, options = nil)
231
+ # Pass arguments to `search_catalog` via a request object, either of type
232
+ # {::Google::Cloud::DataCatalog::V1::SearchCatalogRequest} or an equivalent Hash.
233
+ #
234
+ # @param request [::Google::Cloud::DataCatalog::V1::SearchCatalogRequest, ::Hash]
235
+ # A request object representing the call parameters. Required. To specify no
236
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
237
+ # @param options [::Gapic::CallOptions, ::Hash]
238
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
239
+ #
240
+ # @overload search_catalog(scope: nil, query: nil, page_size: nil, page_token: nil, order_by: nil)
241
+ # Pass arguments to `search_catalog` via keyword arguments. Note that at
242
+ # least one keyword argument is required. To specify no parameters, or to keep all
243
+ # the default parameter values, pass an empty Hash as a request object (see above).
244
+ #
245
+ # @param scope [::Google::Cloud::DataCatalog::V1::SearchCatalogRequest::Scope, ::Hash]
246
+ # Required. The scope of this search request.
247
+ #
248
+ # The `scope` is invalid if `include_org_ids`, `include_project_ids` are
249
+ # empty AND `include_gcp_public_datasets` is set to `false`. In this case,
250
+ # the request returns an error.
251
+ # @param query [::String]
252
+ # Optional. The query string with a minimum of 3 characters and specific
253
+ # syntax. For more information, see [Data Catalog search
254
+ # syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
255
+ #
256
+ # An empty query string returns all data assets (in the specified scope)
257
+ # that you have access to.
258
+ #
259
+ # A query string can be a simple `xyz` or qualified by predicates:
260
+ #
261
+ # * `name:x`
262
+ # * `column:y`
263
+ # * `description:z`
264
+ # @param page_size [::Integer]
265
+ # Number of results to return in a single search page.
266
+ #
267
+ # Can't be negative or 0, defaults to 10 in this case.
268
+ # The maximum number is 1000. If exceeded, throws an "invalid argument"
269
+ # exception.
270
+ # @param page_token [::String]
271
+ # Optional. Pagination token that, if specified, returns the next page of
272
+ # search results. If empty, returns the first page.
273
+ #
274
+ # This token is returned in the
275
+ # {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
276
+ # field of the response to a previous
277
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client#search_catalog SearchCatalogRequest}
278
+ # call.
279
+ # @param order_by [::String]
280
+ # Specifies the order of results.
281
+ #
282
+ # Currently supported case-sensitive values are:
283
+ #
284
+ # * `relevance` that can only be descending
285
+ # * `last_modified_timestamp [asc|desc]` with descending (`desc`) as default
286
+ # * `default` that can only be descending
287
+ #
288
+ # If this parameter is omitted, it defaults to the descending `relevance`.
289
+ # @yield [result, operation] Access the result along with the TransportOperation object
290
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::SearchCatalogResponse]
291
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
292
+ #
293
+ # @return [::Google::Cloud::DataCatalog::V1::SearchCatalogResponse]
294
+ #
295
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
296
+ def search_catalog request, options = nil
297
+ raise ::ArgumentError, "request must be provided" if request.nil?
298
+
299
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::SearchCatalogRequest
300
+
301
+ # Converts hash and nil to an options object
302
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
303
+
304
+ # Customize the options with defaults
305
+ call_metadata = @config.rpcs.search_catalog.metadata.to_h
306
+
307
+ # Set x-goog-api-client and x-goog-user-project headers
308
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
309
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
310
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
311
+ transports_version_send: [:rest]
312
+
313
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
314
+
315
+ options.apply_defaults timeout: @config.rpcs.search_catalog.timeout,
316
+ metadata: call_metadata,
317
+ retry_policy: @config.rpcs.search_catalog.retry_policy
318
+
319
+ options.apply_defaults timeout: @config.timeout,
320
+ metadata: @config.metadata,
321
+ retry_policy: @config.retry_policy
322
+
323
+ @data_catalog_stub.search_catalog request, options do |result, operation|
324
+ yield result, operation if block_given?
325
+ return result
326
+ end
327
+ rescue ::Gapic::Rest::Error => e
328
+ raise ::Google::Cloud::Error.from_error(e)
329
+ end
330
+
331
+ ##
332
+ # Creates an entry group.
333
+ #
334
+ # An entry group contains logically related entries together with [Cloud
335
+ # Identity and Access Management](/data-catalog/docs/concepts/iam) policies.
336
+ # These policies specify users who can create, edit, and view entries
337
+ # within entry groups.
338
+ #
339
+ # Data Catalog automatically creates entry groups with names that start with
340
+ # the `@` symbol for the following resources:
341
+ #
342
+ # * BigQuery entries (`@bigquery`)
343
+ # * Pub/Sub topics (`@pubsub`)
344
+ # * Dataproc Metastore services (`@dataproc_metastore_{SERVICE_NAME_HASH}`)
345
+ #
346
+ # You can create your own entry groups for Cloud Storage fileset entries
347
+ # and custom entries together with the corresponding IAM policies.
348
+ # User-created entry groups can't contain the `@` symbol, it is reserved
349
+ # for automatically created groups.
350
+ #
351
+ # Entry groups, like entries, can be searched.
352
+ #
353
+ # A maximum of 10,000 entry groups may be created per organization across all
354
+ # locations.
355
+ #
356
+ # You must enable the Data Catalog API in the project identified by
357
+ # the `parent` parameter. For more information, see [Data Catalog resource
358
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
359
+ #
360
+ # @overload create_entry_group(request, options = nil)
361
+ # Pass arguments to `create_entry_group` via a request object, either of type
362
+ # {::Google::Cloud::DataCatalog::V1::CreateEntryGroupRequest} or an equivalent Hash.
363
+ #
364
+ # @param request [::Google::Cloud::DataCatalog::V1::CreateEntryGroupRequest, ::Hash]
365
+ # A request object representing the call parameters. Required. To specify no
366
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
367
+ # @param options [::Gapic::CallOptions, ::Hash]
368
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
369
+ #
370
+ # @overload create_entry_group(parent: nil, entry_group_id: nil, entry_group: nil)
371
+ # Pass arguments to `create_entry_group` via keyword arguments. Note that at
372
+ # least one keyword argument is required. To specify no parameters, or to keep all
373
+ # the default parameter values, pass an empty Hash as a request object (see above).
374
+ #
375
+ # @param parent [::String]
376
+ # Required. The names of the project and location that the new entry group
377
+ # belongs to.
378
+ #
379
+ # Note: The entry group itself and its child resources might not be
380
+ # stored in the location specified in its name.
381
+ # @param entry_group_id [::String]
382
+ # Required. The ID of the entry group to create.
383
+ #
384
+ # The ID must contain only letters (a-z, A-Z), numbers (0-9),
385
+ # underscores (_), and must start with a letter or underscore.
386
+ # The maximum size is 64 bytes when encoded in UTF-8.
387
+ # @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
388
+ # The entry group to create. Defaults to empty.
389
+ # @yield [result, operation] Access the result along with the TransportOperation object
390
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::EntryGroup]
391
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
392
+ #
393
+ # @return [::Google::Cloud::DataCatalog::V1::EntryGroup]
394
+ #
395
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
396
+ def create_entry_group request, options = nil
397
+ raise ::ArgumentError, "request must be provided" if request.nil?
398
+
399
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::CreateEntryGroupRequest
400
+
401
+ # Converts hash and nil to an options object
402
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
403
+
404
+ # Customize the options with defaults
405
+ call_metadata = @config.rpcs.create_entry_group.metadata.to_h
406
+
407
+ # Set x-goog-api-client and x-goog-user-project headers
408
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
409
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
410
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
411
+ transports_version_send: [:rest]
412
+
413
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
414
+
415
+ options.apply_defaults timeout: @config.rpcs.create_entry_group.timeout,
416
+ metadata: call_metadata,
417
+ retry_policy: @config.rpcs.create_entry_group.retry_policy
418
+
419
+ options.apply_defaults timeout: @config.timeout,
420
+ metadata: @config.metadata,
421
+ retry_policy: @config.retry_policy
422
+
423
+ @data_catalog_stub.create_entry_group request, options do |result, operation|
424
+ yield result, operation if block_given?
425
+ return result
426
+ end
427
+ rescue ::Gapic::Rest::Error => e
428
+ raise ::Google::Cloud::Error.from_error(e)
429
+ end
430
+
431
+ ##
432
+ # Gets an entry group.
433
+ #
434
+ # @overload get_entry_group(request, options = nil)
435
+ # Pass arguments to `get_entry_group` via a request object, either of type
436
+ # {::Google::Cloud::DataCatalog::V1::GetEntryGroupRequest} or an equivalent Hash.
437
+ #
438
+ # @param request [::Google::Cloud::DataCatalog::V1::GetEntryGroupRequest, ::Hash]
439
+ # A request object representing the call parameters. Required. To specify no
440
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
441
+ # @param options [::Gapic::CallOptions, ::Hash]
442
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
443
+ #
444
+ # @overload get_entry_group(name: nil, read_mask: nil)
445
+ # Pass arguments to `get_entry_group` via keyword arguments. Note that at
446
+ # least one keyword argument is required. To specify no parameters, or to keep all
447
+ # the default parameter values, pass an empty Hash as a request object (see above).
448
+ #
449
+ # @param name [::String]
450
+ # Required. The name of the entry group to get.
451
+ # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
452
+ # The fields to return. If empty or omitted, all fields are returned.
453
+ # @yield [result, operation] Access the result along with the TransportOperation object
454
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::EntryGroup]
455
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
456
+ #
457
+ # @return [::Google::Cloud::DataCatalog::V1::EntryGroup]
458
+ #
459
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
460
+ def get_entry_group request, options = nil
461
+ raise ::ArgumentError, "request must be provided" if request.nil?
462
+
463
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::GetEntryGroupRequest
464
+
465
+ # Converts hash and nil to an options object
466
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
467
+
468
+ # Customize the options with defaults
469
+ call_metadata = @config.rpcs.get_entry_group.metadata.to_h
470
+
471
+ # Set x-goog-api-client and x-goog-user-project headers
472
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
473
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
474
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
475
+ transports_version_send: [:rest]
476
+
477
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
478
+
479
+ options.apply_defaults timeout: @config.rpcs.get_entry_group.timeout,
480
+ metadata: call_metadata,
481
+ retry_policy: @config.rpcs.get_entry_group.retry_policy
482
+
483
+ options.apply_defaults timeout: @config.timeout,
484
+ metadata: @config.metadata,
485
+ retry_policy: @config.retry_policy
486
+
487
+ @data_catalog_stub.get_entry_group request, options do |result, operation|
488
+ yield result, operation if block_given?
489
+ return result
490
+ end
491
+ rescue ::Gapic::Rest::Error => e
492
+ raise ::Google::Cloud::Error.from_error(e)
493
+ end
494
+
495
+ ##
496
+ # Updates an entry group.
497
+ #
498
+ # You must enable the Data Catalog API in the project identified by
499
+ # the `entry_group.name` parameter. For more information, see [Data Catalog
500
+ # resource
501
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
502
+ #
503
+ # @overload update_entry_group(request, options = nil)
504
+ # Pass arguments to `update_entry_group` via a request object, either of type
505
+ # {::Google::Cloud::DataCatalog::V1::UpdateEntryGroupRequest} or an equivalent Hash.
506
+ #
507
+ # @param request [::Google::Cloud::DataCatalog::V1::UpdateEntryGroupRequest, ::Hash]
508
+ # A request object representing the call parameters. Required. To specify no
509
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
510
+ # @param options [::Gapic::CallOptions, ::Hash]
511
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
512
+ #
513
+ # @overload update_entry_group(entry_group: nil, update_mask: nil)
514
+ # Pass arguments to `update_entry_group` via keyword arguments. Note that at
515
+ # least one keyword argument is required. To specify no parameters, or to keep all
516
+ # the default parameter values, pass an empty Hash as a request object (see above).
517
+ #
518
+ # @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
519
+ # Required. Updates for the entry group. The `name` field must be set.
520
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
521
+ # Names of fields whose values to overwrite on an entry group.
522
+ #
523
+ # If this parameter is absent or empty, all modifiable fields
524
+ # are overwritten. If such fields are non-required and omitted in the
525
+ # request body, their values are emptied.
526
+ # @yield [result, operation] Access the result along with the TransportOperation object
527
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::EntryGroup]
528
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
529
+ #
530
+ # @return [::Google::Cloud::DataCatalog::V1::EntryGroup]
531
+ #
532
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
533
+ def update_entry_group request, options = nil
534
+ raise ::ArgumentError, "request must be provided" if request.nil?
535
+
536
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UpdateEntryGroupRequest
537
+
538
+ # Converts hash and nil to an options object
539
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
540
+
541
+ # Customize the options with defaults
542
+ call_metadata = @config.rpcs.update_entry_group.metadata.to_h
543
+
544
+ # Set x-goog-api-client and x-goog-user-project headers
545
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
546
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
547
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
548
+ transports_version_send: [:rest]
549
+
550
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
551
+
552
+ options.apply_defaults timeout: @config.rpcs.update_entry_group.timeout,
553
+ metadata: call_metadata,
554
+ retry_policy: @config.rpcs.update_entry_group.retry_policy
555
+
556
+ options.apply_defaults timeout: @config.timeout,
557
+ metadata: @config.metadata,
558
+ retry_policy: @config.retry_policy
559
+
560
+ @data_catalog_stub.update_entry_group request, options do |result, operation|
561
+ yield result, operation if block_given?
562
+ return result
563
+ end
564
+ rescue ::Gapic::Rest::Error => e
565
+ raise ::Google::Cloud::Error.from_error(e)
566
+ end
567
+
568
+ ##
569
+ # Deletes an entry group.
570
+ #
571
+ # You must enable the Data Catalog API in the project
572
+ # identified by the `name` parameter. For more information, see [Data Catalog
573
+ # resource
574
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
575
+ #
576
+ # @overload delete_entry_group(request, options = nil)
577
+ # Pass arguments to `delete_entry_group` via a request object, either of type
578
+ # {::Google::Cloud::DataCatalog::V1::DeleteEntryGroupRequest} or an equivalent Hash.
579
+ #
580
+ # @param request [::Google::Cloud::DataCatalog::V1::DeleteEntryGroupRequest, ::Hash]
581
+ # A request object representing the call parameters. Required. To specify no
582
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
583
+ # @param options [::Gapic::CallOptions, ::Hash]
584
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
585
+ #
586
+ # @overload delete_entry_group(name: nil, force: nil)
587
+ # Pass arguments to `delete_entry_group` via keyword arguments. Note that at
588
+ # least one keyword argument is required. To specify no parameters, or to keep all
589
+ # the default parameter values, pass an empty Hash as a request object (see above).
590
+ #
591
+ # @param name [::String]
592
+ # Required. The name of the entry group to delete.
593
+ # @param force [::Boolean]
594
+ # Optional. If true, deletes all entries in the entry group.
595
+ # @yield [result, operation] Access the result along with the TransportOperation object
596
+ # @yieldparam result [::Google::Protobuf::Empty]
597
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
598
+ #
599
+ # @return [::Google::Protobuf::Empty]
600
+ #
601
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
602
+ def delete_entry_group request, options = nil
603
+ raise ::ArgumentError, "request must be provided" if request.nil?
604
+
605
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::DeleteEntryGroupRequest
606
+
607
+ # Converts hash and nil to an options object
608
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
609
+
610
+ # Customize the options with defaults
611
+ call_metadata = @config.rpcs.delete_entry_group.metadata.to_h
612
+
613
+ # Set x-goog-api-client and x-goog-user-project headers
614
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
615
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
616
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
617
+ transports_version_send: [:rest]
618
+
619
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
620
+
621
+ options.apply_defaults timeout: @config.rpcs.delete_entry_group.timeout,
622
+ metadata: call_metadata,
623
+ retry_policy: @config.rpcs.delete_entry_group.retry_policy
624
+
625
+ options.apply_defaults timeout: @config.timeout,
626
+ metadata: @config.metadata,
627
+ retry_policy: @config.retry_policy
628
+
629
+ @data_catalog_stub.delete_entry_group request, options do |result, operation|
630
+ yield result, operation if block_given?
631
+ return result
632
+ end
633
+ rescue ::Gapic::Rest::Error => e
634
+ raise ::Google::Cloud::Error.from_error(e)
635
+ end
636
+
637
+ ##
638
+ # Lists entry groups.
639
+ #
640
+ # @overload list_entry_groups(request, options = nil)
641
+ # Pass arguments to `list_entry_groups` via a request object, either of type
642
+ # {::Google::Cloud::DataCatalog::V1::ListEntryGroupsRequest} or an equivalent Hash.
643
+ #
644
+ # @param request [::Google::Cloud::DataCatalog::V1::ListEntryGroupsRequest, ::Hash]
645
+ # A request object representing the call parameters. Required. To specify no
646
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
647
+ # @param options [::Gapic::CallOptions, ::Hash]
648
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
649
+ #
650
+ # @overload list_entry_groups(parent: nil, page_size: nil, page_token: nil)
651
+ # Pass arguments to `list_entry_groups` via keyword arguments. Note that at
652
+ # least one keyword argument is required. To specify no parameters, or to keep all
653
+ # the default parameter values, pass an empty Hash as a request object (see above).
654
+ #
655
+ # @param parent [::String]
656
+ # Required. The name of the location that contains the entry groups to list.
657
+ #
658
+ # Can be provided as a URL.
659
+ # @param page_size [::Integer]
660
+ # Optional. The maximum number of items to return.
661
+ #
662
+ # Default is 10. Maximum limit is 1000.
663
+ # Throws an invalid argument if `page_size` is greater than 1000.
664
+ # @param page_token [::String]
665
+ # Optional. Pagination token that specifies the next page to return.
666
+ # If empty, returns the first page.
667
+ # @yield [result, operation] Access the result along with the TransportOperation object
668
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::EntryGroup>]
669
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
670
+ #
671
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::EntryGroup>]
672
+ #
673
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
674
+ def list_entry_groups request, options = nil
675
+ raise ::ArgumentError, "request must be provided" if request.nil?
676
+
677
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ListEntryGroupsRequest
678
+
679
+ # Converts hash and nil to an options object
680
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
681
+
682
+ # Customize the options with defaults
683
+ call_metadata = @config.rpcs.list_entry_groups.metadata.to_h
684
+
685
+ # Set x-goog-api-client and x-goog-user-project headers
686
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
687
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
688
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
689
+ transports_version_send: [:rest]
690
+
691
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
692
+
693
+ options.apply_defaults timeout: @config.rpcs.list_entry_groups.timeout,
694
+ metadata: call_metadata,
695
+ retry_policy: @config.rpcs.list_entry_groups.retry_policy
696
+
697
+ options.apply_defaults timeout: @config.timeout,
698
+ metadata: @config.metadata,
699
+ retry_policy: @config.retry_policy
700
+
701
+ @data_catalog_stub.list_entry_groups request, options do |result, operation|
702
+ result = ::Gapic::Rest::PagedEnumerable.new @data_catalog_stub, :list_entry_groups, "entry_groups", request, result, options
703
+ yield result, operation if block_given?
704
+ return result
705
+ end
706
+ rescue ::Gapic::Rest::Error => e
707
+ raise ::Google::Cloud::Error.from_error(e)
708
+ end
709
+
710
+ ##
711
+ # Creates an entry.
712
+ #
713
+ # You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM',
714
+ # or custom types. Data Catalog automatically creates entries with other
715
+ # types during metadata ingestion from integrated systems.
716
+ #
717
+ # You must enable the Data Catalog API in the project identified by
718
+ # the `parent` parameter. For more information, see [Data Catalog resource
719
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
720
+ #
721
+ # An entry group can have a maximum of 100,000 entries.
722
+ #
723
+ # @overload create_entry(request, options = nil)
724
+ # Pass arguments to `create_entry` via a request object, either of type
725
+ # {::Google::Cloud::DataCatalog::V1::CreateEntryRequest} or an equivalent Hash.
726
+ #
727
+ # @param request [::Google::Cloud::DataCatalog::V1::CreateEntryRequest, ::Hash]
728
+ # A request object representing the call parameters. Required. To specify no
729
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
730
+ # @param options [::Gapic::CallOptions, ::Hash]
731
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
732
+ #
733
+ # @overload create_entry(parent: nil, entry_id: nil, entry: nil)
734
+ # Pass arguments to `create_entry` via keyword arguments. Note that at
735
+ # least one keyword argument is required. To specify no parameters, or to keep all
736
+ # the default parameter values, pass an empty Hash as a request object (see above).
737
+ #
738
+ # @param parent [::String]
739
+ # Required. The name of the entry group this entry belongs to.
740
+ #
741
+ # Note: The entry itself and its child resources might not be stored in
742
+ # the location specified in its name.
743
+ # @param entry_id [::String]
744
+ # Required. The ID of the entry to create.
745
+ #
746
+ # The ID must contain only letters (a-z, A-Z), numbers (0-9),
747
+ # and underscores (_).
748
+ # The maximum size is 64 bytes when encoded in UTF-8.
749
+ # @param entry [::Google::Cloud::DataCatalog::V1::Entry, ::Hash]
750
+ # Required. The entry to create.
751
+ # @yield [result, operation] Access the result along with the TransportOperation object
752
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Entry]
753
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
754
+ #
755
+ # @return [::Google::Cloud::DataCatalog::V1::Entry]
756
+ #
757
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
758
+ def create_entry request, options = nil
759
+ raise ::ArgumentError, "request must be provided" if request.nil?
760
+
761
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::CreateEntryRequest
762
+
763
+ # Converts hash and nil to an options object
764
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
765
+
766
+ # Customize the options with defaults
767
+ call_metadata = @config.rpcs.create_entry.metadata.to_h
768
+
769
+ # Set x-goog-api-client and x-goog-user-project headers
770
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
771
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
772
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
773
+ transports_version_send: [:rest]
774
+
775
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
776
+
777
+ options.apply_defaults timeout: @config.rpcs.create_entry.timeout,
778
+ metadata: call_metadata,
779
+ retry_policy: @config.rpcs.create_entry.retry_policy
780
+
781
+ options.apply_defaults timeout: @config.timeout,
782
+ metadata: @config.metadata,
783
+ retry_policy: @config.retry_policy
784
+
785
+ @data_catalog_stub.create_entry request, options do |result, operation|
786
+ yield result, operation if block_given?
787
+ return result
788
+ end
789
+ rescue ::Gapic::Rest::Error => e
790
+ raise ::Google::Cloud::Error.from_error(e)
791
+ end
792
+
793
+ ##
794
+ # Updates an existing entry.
795
+ #
796
+ # You must enable the Data Catalog API in the project identified by
797
+ # the `entry.name` parameter. For more information, see [Data Catalog
798
+ # resource
799
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
800
+ #
801
+ # @overload update_entry(request, options = nil)
802
+ # Pass arguments to `update_entry` via a request object, either of type
803
+ # {::Google::Cloud::DataCatalog::V1::UpdateEntryRequest} or an equivalent Hash.
804
+ #
805
+ # @param request [::Google::Cloud::DataCatalog::V1::UpdateEntryRequest, ::Hash]
806
+ # A request object representing the call parameters. Required. To specify no
807
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
808
+ # @param options [::Gapic::CallOptions, ::Hash]
809
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
810
+ #
811
+ # @overload update_entry(entry: nil, update_mask: nil)
812
+ # Pass arguments to `update_entry` via keyword arguments. Note that at
813
+ # least one keyword argument is required. To specify no parameters, or to keep all
814
+ # the default parameter values, pass an empty Hash as a request object (see above).
815
+ #
816
+ # @param entry [::Google::Cloud::DataCatalog::V1::Entry, ::Hash]
817
+ # Required. Updates for the entry. The `name` field must be set.
818
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
819
+ # Names of fields whose values to overwrite on an entry.
820
+ #
821
+ # If this parameter is absent or empty, all modifiable fields
822
+ # are overwritten. If such fields are non-required and omitted in the
823
+ # request body, their values are emptied.
824
+ #
825
+ # You can modify only the fields listed below.
826
+ #
827
+ # For entries with type `DATA_STREAM`:
828
+ #
829
+ # * `schema`
830
+ #
831
+ # For entries with type `FILESET`:
832
+ #
833
+ # * `schema`
834
+ # * `display_name`
835
+ # * `description`
836
+ # * `gcs_fileset_spec`
837
+ # * `gcs_fileset_spec.file_patterns`
838
+ #
839
+ # For entries with `user_specified_type`:
840
+ #
841
+ # * `schema`
842
+ # * `display_name`
843
+ # * `description`
844
+ # * `user_specified_type`
845
+ # * `user_specified_system`
846
+ # * `linked_resource`
847
+ # * `source_system_timestamps`
848
+ # @yield [result, operation] Access the result along with the TransportOperation object
849
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Entry]
850
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
851
+ #
852
+ # @return [::Google::Cloud::DataCatalog::V1::Entry]
853
+ #
854
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
855
+ def update_entry request, options = nil
856
+ raise ::ArgumentError, "request must be provided" if request.nil?
857
+
858
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UpdateEntryRequest
859
+
860
+ # Converts hash and nil to an options object
861
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
862
+
863
+ # Customize the options with defaults
864
+ call_metadata = @config.rpcs.update_entry.metadata.to_h
865
+
866
+ # Set x-goog-api-client and x-goog-user-project headers
867
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
868
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
869
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
870
+ transports_version_send: [:rest]
871
+
872
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
873
+
874
+ options.apply_defaults timeout: @config.rpcs.update_entry.timeout,
875
+ metadata: call_metadata,
876
+ retry_policy: @config.rpcs.update_entry.retry_policy
877
+
878
+ options.apply_defaults timeout: @config.timeout,
879
+ metadata: @config.metadata,
880
+ retry_policy: @config.retry_policy
881
+
882
+ @data_catalog_stub.update_entry request, options do |result, operation|
883
+ yield result, operation if block_given?
884
+ return result
885
+ end
886
+ rescue ::Gapic::Rest::Error => e
887
+ raise ::Google::Cloud::Error.from_error(e)
888
+ end
889
+
890
+ ##
891
+ # Deletes an existing entry.
892
+ #
893
+ # You can delete only the entries created by the
894
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client#create_entry CreateEntry}
895
+ # method.
896
+ #
897
+ # You must enable the Data Catalog API in the project identified by
898
+ # the `name` parameter. For more information, see [Data Catalog
899
+ # resource
900
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
901
+ #
902
+ # @overload delete_entry(request, options = nil)
903
+ # Pass arguments to `delete_entry` via a request object, either of type
904
+ # {::Google::Cloud::DataCatalog::V1::DeleteEntryRequest} or an equivalent Hash.
905
+ #
906
+ # @param request [::Google::Cloud::DataCatalog::V1::DeleteEntryRequest, ::Hash]
907
+ # A request object representing the call parameters. Required. To specify no
908
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
909
+ # @param options [::Gapic::CallOptions, ::Hash]
910
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
911
+ #
912
+ # @overload delete_entry(name: nil)
913
+ # Pass arguments to `delete_entry` via keyword arguments. Note that at
914
+ # least one keyword argument is required. To specify no parameters, or to keep all
915
+ # the default parameter values, pass an empty Hash as a request object (see above).
916
+ #
917
+ # @param name [::String]
918
+ # Required. The name of the entry to delete.
919
+ # @yield [result, operation] Access the result along with the TransportOperation object
920
+ # @yieldparam result [::Google::Protobuf::Empty]
921
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
922
+ #
923
+ # @return [::Google::Protobuf::Empty]
924
+ #
925
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
926
+ def delete_entry request, options = nil
927
+ raise ::ArgumentError, "request must be provided" if request.nil?
928
+
929
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::DeleteEntryRequest
930
+
931
+ # Converts hash and nil to an options object
932
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
933
+
934
+ # Customize the options with defaults
935
+ call_metadata = @config.rpcs.delete_entry.metadata.to_h
936
+
937
+ # Set x-goog-api-client and x-goog-user-project headers
938
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
939
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
940
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
941
+ transports_version_send: [:rest]
942
+
943
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
944
+
945
+ options.apply_defaults timeout: @config.rpcs.delete_entry.timeout,
946
+ metadata: call_metadata,
947
+ retry_policy: @config.rpcs.delete_entry.retry_policy
948
+
949
+ options.apply_defaults timeout: @config.timeout,
950
+ metadata: @config.metadata,
951
+ retry_policy: @config.retry_policy
952
+
953
+ @data_catalog_stub.delete_entry request, options do |result, operation|
954
+ yield result, operation if block_given?
955
+ return result
956
+ end
957
+ rescue ::Gapic::Rest::Error => e
958
+ raise ::Google::Cloud::Error.from_error(e)
959
+ end
960
+
961
+ ##
962
+ # Gets an entry.
963
+ #
964
+ # @overload get_entry(request, options = nil)
965
+ # Pass arguments to `get_entry` via a request object, either of type
966
+ # {::Google::Cloud::DataCatalog::V1::GetEntryRequest} or an equivalent Hash.
967
+ #
968
+ # @param request [::Google::Cloud::DataCatalog::V1::GetEntryRequest, ::Hash]
969
+ # A request object representing the call parameters. Required. To specify no
970
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
971
+ # @param options [::Gapic::CallOptions, ::Hash]
972
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
973
+ #
974
+ # @overload get_entry(name: nil)
975
+ # Pass arguments to `get_entry` via keyword arguments. Note that at
976
+ # least one keyword argument is required. To specify no parameters, or to keep all
977
+ # the default parameter values, pass an empty Hash as a request object (see above).
978
+ #
979
+ # @param name [::String]
980
+ # Required. The name of the entry to get.
981
+ # @yield [result, operation] Access the result along with the TransportOperation object
982
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Entry]
983
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
984
+ #
985
+ # @return [::Google::Cloud::DataCatalog::V1::Entry]
986
+ #
987
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
988
+ def get_entry request, options = nil
989
+ raise ::ArgumentError, "request must be provided" if request.nil?
990
+
991
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::GetEntryRequest
992
+
993
+ # Converts hash and nil to an options object
994
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
995
+
996
+ # Customize the options with defaults
997
+ call_metadata = @config.rpcs.get_entry.metadata.to_h
998
+
999
+ # Set x-goog-api-client and x-goog-user-project headers
1000
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1001
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1002
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1003
+ transports_version_send: [:rest]
1004
+
1005
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1006
+
1007
+ options.apply_defaults timeout: @config.rpcs.get_entry.timeout,
1008
+ metadata: call_metadata,
1009
+ retry_policy: @config.rpcs.get_entry.retry_policy
1010
+
1011
+ options.apply_defaults timeout: @config.timeout,
1012
+ metadata: @config.metadata,
1013
+ retry_policy: @config.retry_policy
1014
+
1015
+ @data_catalog_stub.get_entry request, options do |result, operation|
1016
+ yield result, operation if block_given?
1017
+ return result
1018
+ end
1019
+ rescue ::Gapic::Rest::Error => e
1020
+ raise ::Google::Cloud::Error.from_error(e)
1021
+ end
1022
+
1023
+ ##
1024
+ # Gets an entry by its target resource name.
1025
+ #
1026
+ # The resource name comes from the source Google Cloud Platform service.
1027
+ #
1028
+ # @overload lookup_entry(request, options = nil)
1029
+ # Pass arguments to `lookup_entry` via a request object, either of type
1030
+ # {::Google::Cloud::DataCatalog::V1::LookupEntryRequest} or an equivalent Hash.
1031
+ #
1032
+ # @param request [::Google::Cloud::DataCatalog::V1::LookupEntryRequest, ::Hash]
1033
+ # A request object representing the call parameters. Required. To specify no
1034
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1035
+ # @param options [::Gapic::CallOptions, ::Hash]
1036
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1037
+ #
1038
+ # @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil)
1039
+ # Pass arguments to `lookup_entry` via keyword arguments. Note that at
1040
+ # least one keyword argument is required. To specify no parameters, or to keep all
1041
+ # the default parameter values, pass an empty Hash as a request object (see above).
1042
+ #
1043
+ # @param linked_resource [::String]
1044
+ # The full name of the Google Cloud Platform resource the Data Catalog
1045
+ # entry represents. For more information, see [Full Resource Name]
1046
+ # (https://cloud.google.com/apis/design/resource_names#full_resource_name).
1047
+ #
1048
+ # Full names are case-sensitive. For example:
1049
+ #
1050
+ # * `//bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
1051
+ # * `//pubsub.googleapis.com/projects/{PROJECT_ID}/topics/{TOPIC_ID}`
1052
+ # @param sql_resource [::String]
1053
+ # The SQL name of the entry. SQL names are case-sensitive.
1054
+ #
1055
+ # Examples:
1056
+ #
1057
+ # * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}`
1058
+ # * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
1059
+ # * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}`
1060
+ # * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}`
1061
+ # * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`
1062
+ #
1063
+ # Identifiers (`*_ID`) should comply with the
1064
+ # [Lexical structure in Standard SQL]
1065
+ # (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
1066
+ # @param fully_qualified_name [::String]
1067
+ # Fully qualified name (FQN) of the resource.
1068
+ #
1069
+ # FQNs take two forms:
1070
+ #
1071
+ # * For non-regionalized resources:
1072
+ #
1073
+ # `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
1074
+ #
1075
+ # * For regionalized resources:
1076
+ #
1077
+ # `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
1078
+ #
1079
+ # Example for a DPMS table:
1080
+ #
1081
+ # `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
1082
+ # @yield [result, operation] Access the result along with the TransportOperation object
1083
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Entry]
1084
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1085
+ #
1086
+ # @return [::Google::Cloud::DataCatalog::V1::Entry]
1087
+ #
1088
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1089
+ def lookup_entry request, options = nil
1090
+ raise ::ArgumentError, "request must be provided" if request.nil?
1091
+
1092
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::LookupEntryRequest
1093
+
1094
+ # Converts hash and nil to an options object
1095
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1096
+
1097
+ # Customize the options with defaults
1098
+ call_metadata = @config.rpcs.lookup_entry.metadata.to_h
1099
+
1100
+ # Set x-goog-api-client and x-goog-user-project headers
1101
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1102
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1103
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1104
+ transports_version_send: [:rest]
1105
+
1106
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1107
+
1108
+ options.apply_defaults timeout: @config.rpcs.lookup_entry.timeout,
1109
+ metadata: call_metadata,
1110
+ retry_policy: @config.rpcs.lookup_entry.retry_policy
1111
+
1112
+ options.apply_defaults timeout: @config.timeout,
1113
+ metadata: @config.metadata,
1114
+ retry_policy: @config.retry_policy
1115
+
1116
+ @data_catalog_stub.lookup_entry request, options do |result, operation|
1117
+ yield result, operation if block_given?
1118
+ return result
1119
+ end
1120
+ rescue ::Gapic::Rest::Error => e
1121
+ raise ::Google::Cloud::Error.from_error(e)
1122
+ end
1123
+
1124
+ ##
1125
+ # Lists entries.
1126
+ #
1127
+ # Note: Currently, this method can list only custom entries.
1128
+ # To get a list of both custom and automatically created entries, use
1129
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client#search_catalog SearchCatalog}.
1130
+ #
1131
+ # @overload list_entries(request, options = nil)
1132
+ # Pass arguments to `list_entries` via a request object, either of type
1133
+ # {::Google::Cloud::DataCatalog::V1::ListEntriesRequest} or an equivalent Hash.
1134
+ #
1135
+ # @param request [::Google::Cloud::DataCatalog::V1::ListEntriesRequest, ::Hash]
1136
+ # A request object representing the call parameters. Required. To specify no
1137
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1138
+ # @param options [::Gapic::CallOptions, ::Hash]
1139
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1140
+ #
1141
+ # @overload list_entries(parent: nil, page_size: nil, page_token: nil, read_mask: nil)
1142
+ # Pass arguments to `list_entries` via keyword arguments. Note that at
1143
+ # least one keyword argument is required. To specify no parameters, or to keep all
1144
+ # the default parameter values, pass an empty Hash as a request object (see above).
1145
+ #
1146
+ # @param parent [::String]
1147
+ # Required. The name of the entry group that contains the entries to list.
1148
+ #
1149
+ # Can be provided in URL format.
1150
+ # @param page_size [::Integer]
1151
+ # The maximum number of items to return. Default is 10. Maximum limit is
1152
+ # 1000. Throws an invalid argument if `page_size` is more than 1000.
1153
+ # @param page_token [::String]
1154
+ # Pagination token that specifies the next page to return. If empty, the
1155
+ # first page is returned.
1156
+ # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
1157
+ # The fields to return for each entry. If empty or omitted, all
1158
+ # fields are returned.
1159
+ #
1160
+ # For example, to return a list of entries with only the `name` field,
1161
+ # set `read_mask` to only one path with the `name` value.
1162
+ # @yield [result, operation] Access the result along with the TransportOperation object
1163
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Entry>]
1164
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1165
+ #
1166
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Entry>]
1167
+ #
1168
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1169
+ def list_entries request, options = nil
1170
+ raise ::ArgumentError, "request must be provided" if request.nil?
1171
+
1172
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ListEntriesRequest
1173
+
1174
+ # Converts hash and nil to an options object
1175
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1176
+
1177
+ # Customize the options with defaults
1178
+ call_metadata = @config.rpcs.list_entries.metadata.to_h
1179
+
1180
+ # Set x-goog-api-client and x-goog-user-project headers
1181
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1182
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1183
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1184
+ transports_version_send: [:rest]
1185
+
1186
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1187
+
1188
+ options.apply_defaults timeout: @config.rpcs.list_entries.timeout,
1189
+ metadata: call_metadata,
1190
+ retry_policy: @config.rpcs.list_entries.retry_policy
1191
+
1192
+ options.apply_defaults timeout: @config.timeout,
1193
+ metadata: @config.metadata,
1194
+ retry_policy: @config.retry_policy
1195
+
1196
+ @data_catalog_stub.list_entries request, options do |result, operation|
1197
+ result = ::Gapic::Rest::PagedEnumerable.new @data_catalog_stub, :list_entries, "entries", request, result, options
1198
+ yield result, operation if block_given?
1199
+ return result
1200
+ end
1201
+ rescue ::Gapic::Rest::Error => e
1202
+ raise ::Google::Cloud::Error.from_error(e)
1203
+ end
1204
+
1205
+ ##
1206
+ # Modifies entry overview, part of the business context of an
1207
+ # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
1208
+ #
1209
+ # To call this method, you must have the `datacatalog.entries.updateOverview`
1210
+ # IAM permission on the corresponding project.
1211
+ #
1212
+ # @overload modify_entry_overview(request, options = nil)
1213
+ # Pass arguments to `modify_entry_overview` via a request object, either of type
1214
+ # {::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest} or an equivalent Hash.
1215
+ #
1216
+ # @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest, ::Hash]
1217
+ # A request object representing the call parameters. Required. To specify no
1218
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1219
+ # @param options [::Gapic::CallOptions, ::Hash]
1220
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1221
+ #
1222
+ # @overload modify_entry_overview(name: nil, entry_overview: nil)
1223
+ # Pass arguments to `modify_entry_overview` via keyword arguments. Note that at
1224
+ # least one keyword argument is required. To specify no parameters, or to keep all
1225
+ # the default parameter values, pass an empty Hash as a request object (see above).
1226
+ #
1227
+ # @param name [::String]
1228
+ # Required. The full resource name of the entry.
1229
+ # @param entry_overview [::Google::Cloud::DataCatalog::V1::EntryOverview, ::Hash]
1230
+ # Required. The new value for the Entry Overview.
1231
+ # @yield [result, operation] Access the result along with the TransportOperation object
1232
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::EntryOverview]
1233
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1234
+ #
1235
+ # @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
1236
+ #
1237
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1238
+ def modify_entry_overview request, options = nil
1239
+ raise ::ArgumentError, "request must be provided" if request.nil?
1240
+
1241
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest
1242
+
1243
+ # Converts hash and nil to an options object
1244
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1245
+
1246
+ # Customize the options with defaults
1247
+ call_metadata = @config.rpcs.modify_entry_overview.metadata.to_h
1248
+
1249
+ # Set x-goog-api-client and x-goog-user-project headers
1250
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1251
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1252
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1253
+ transports_version_send: [:rest]
1254
+
1255
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1256
+
1257
+ options.apply_defaults timeout: @config.rpcs.modify_entry_overview.timeout,
1258
+ metadata: call_metadata,
1259
+ retry_policy: @config.rpcs.modify_entry_overview.retry_policy
1260
+
1261
+ options.apply_defaults timeout: @config.timeout,
1262
+ metadata: @config.metadata,
1263
+ retry_policy: @config.retry_policy
1264
+
1265
+ @data_catalog_stub.modify_entry_overview request, options do |result, operation|
1266
+ yield result, operation if block_given?
1267
+ return result
1268
+ end
1269
+ rescue ::Gapic::Rest::Error => e
1270
+ raise ::Google::Cloud::Error.from_error(e)
1271
+ end
1272
+
1273
+ ##
1274
+ # Modifies contacts, part of the business context of an
1275
+ # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
1276
+ #
1277
+ # To call this method, you must have the `datacatalog.entries.updateContacts`
1278
+ # IAM permission on the corresponding project.
1279
+ #
1280
+ # @overload modify_entry_contacts(request, options = nil)
1281
+ # Pass arguments to `modify_entry_contacts` via a request object, either of type
1282
+ # {::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest} or an equivalent Hash.
1283
+ #
1284
+ # @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest, ::Hash]
1285
+ # A request object representing the call parameters. Required. To specify no
1286
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1287
+ # @param options [::Gapic::CallOptions, ::Hash]
1288
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1289
+ #
1290
+ # @overload modify_entry_contacts(name: nil, contacts: nil)
1291
+ # Pass arguments to `modify_entry_contacts` via keyword arguments. Note that at
1292
+ # least one keyword argument is required. To specify no parameters, or to keep all
1293
+ # the default parameter values, pass an empty Hash as a request object (see above).
1294
+ #
1295
+ # @param name [::String]
1296
+ # Required. The full resource name of the entry.
1297
+ # @param contacts [::Google::Cloud::DataCatalog::V1::Contacts, ::Hash]
1298
+ # Required. The new value for the Contacts.
1299
+ # @yield [result, operation] Access the result along with the TransportOperation object
1300
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Contacts]
1301
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1302
+ #
1303
+ # @return [::Google::Cloud::DataCatalog::V1::Contacts]
1304
+ #
1305
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1306
+ def modify_entry_contacts request, options = nil
1307
+ raise ::ArgumentError, "request must be provided" if request.nil?
1308
+
1309
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest
1310
+
1311
+ # Converts hash and nil to an options object
1312
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1313
+
1314
+ # Customize the options with defaults
1315
+ call_metadata = @config.rpcs.modify_entry_contacts.metadata.to_h
1316
+
1317
+ # Set x-goog-api-client and x-goog-user-project headers
1318
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1319
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1320
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1321
+ transports_version_send: [:rest]
1322
+
1323
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1324
+
1325
+ options.apply_defaults timeout: @config.rpcs.modify_entry_contacts.timeout,
1326
+ metadata: call_metadata,
1327
+ retry_policy: @config.rpcs.modify_entry_contacts.retry_policy
1328
+
1329
+ options.apply_defaults timeout: @config.timeout,
1330
+ metadata: @config.metadata,
1331
+ retry_policy: @config.retry_policy
1332
+
1333
+ @data_catalog_stub.modify_entry_contacts request, options do |result, operation|
1334
+ yield result, operation if block_given?
1335
+ return result
1336
+ end
1337
+ rescue ::Gapic::Rest::Error => e
1338
+ raise ::Google::Cloud::Error.from_error(e)
1339
+ end
1340
+
1341
+ ##
1342
+ # Creates a tag template.
1343
+ #
1344
+ # You must enable the Data Catalog API in the project identified by the
1345
+ # `parent` parameter.
1346
+ # For more information, see [Data Catalog resource project]
1347
+ # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1348
+ #
1349
+ # @overload create_tag_template(request, options = nil)
1350
+ # Pass arguments to `create_tag_template` via a request object, either of type
1351
+ # {::Google::Cloud::DataCatalog::V1::CreateTagTemplateRequest} or an equivalent Hash.
1352
+ #
1353
+ # @param request [::Google::Cloud::DataCatalog::V1::CreateTagTemplateRequest, ::Hash]
1354
+ # A request object representing the call parameters. Required. To specify no
1355
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1356
+ # @param options [::Gapic::CallOptions, ::Hash]
1357
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1358
+ #
1359
+ # @overload create_tag_template(parent: nil, tag_template_id: nil, tag_template: nil)
1360
+ # Pass arguments to `create_tag_template` via keyword arguments. Note that at
1361
+ # least one keyword argument is required. To specify no parameters, or to keep all
1362
+ # the default parameter values, pass an empty Hash as a request object (see above).
1363
+ #
1364
+ # @param parent [::String]
1365
+ # Required. The name of the project and the template location
1366
+ # [region](https://cloud.google.com/data-catalog/docs/concepts/regions).
1367
+ # @param tag_template_id [::String]
1368
+ # Required. The ID of the tag template to create.
1369
+ #
1370
+ # The ID must contain only lowercase letters (a-z), numbers (0-9),
1371
+ # or underscores (_), and must start with a letter or underscore.
1372
+ # The maximum size is 64 bytes when encoded in UTF-8.
1373
+ # @param tag_template [::Google::Cloud::DataCatalog::V1::TagTemplate, ::Hash]
1374
+ # Required. The tag template to create.
1375
+ # @yield [result, operation] Access the result along with the TransportOperation object
1376
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplate]
1377
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1378
+ #
1379
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplate]
1380
+ #
1381
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1382
+ def create_tag_template request, options = nil
1383
+ raise ::ArgumentError, "request must be provided" if request.nil?
1384
+
1385
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::CreateTagTemplateRequest
1386
+
1387
+ # Converts hash and nil to an options object
1388
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1389
+
1390
+ # Customize the options with defaults
1391
+ call_metadata = @config.rpcs.create_tag_template.metadata.to_h
1392
+
1393
+ # Set x-goog-api-client and x-goog-user-project headers
1394
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1395
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1396
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1397
+ transports_version_send: [:rest]
1398
+
1399
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1400
+
1401
+ options.apply_defaults timeout: @config.rpcs.create_tag_template.timeout,
1402
+ metadata: call_metadata,
1403
+ retry_policy: @config.rpcs.create_tag_template.retry_policy
1404
+
1405
+ options.apply_defaults timeout: @config.timeout,
1406
+ metadata: @config.metadata,
1407
+ retry_policy: @config.retry_policy
1408
+
1409
+ @data_catalog_stub.create_tag_template request, options do |result, operation|
1410
+ yield result, operation if block_given?
1411
+ return result
1412
+ end
1413
+ rescue ::Gapic::Rest::Error => e
1414
+ raise ::Google::Cloud::Error.from_error(e)
1415
+ end
1416
+
1417
+ ##
1418
+ # Gets a tag template.
1419
+ #
1420
+ # @overload get_tag_template(request, options = nil)
1421
+ # Pass arguments to `get_tag_template` via a request object, either of type
1422
+ # {::Google::Cloud::DataCatalog::V1::GetTagTemplateRequest} or an equivalent Hash.
1423
+ #
1424
+ # @param request [::Google::Cloud::DataCatalog::V1::GetTagTemplateRequest, ::Hash]
1425
+ # A request object representing the call parameters. Required. To specify no
1426
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1427
+ # @param options [::Gapic::CallOptions, ::Hash]
1428
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1429
+ #
1430
+ # @overload get_tag_template(name: nil)
1431
+ # Pass arguments to `get_tag_template` via keyword arguments. Note that at
1432
+ # least one keyword argument is required. To specify no parameters, or to keep all
1433
+ # the default parameter values, pass an empty Hash as a request object (see above).
1434
+ #
1435
+ # @param name [::String]
1436
+ # Required. The name of the tag template to get.
1437
+ # @yield [result, operation] Access the result along with the TransportOperation object
1438
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplate]
1439
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1440
+ #
1441
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplate]
1442
+ #
1443
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1444
+ def get_tag_template request, options = nil
1445
+ raise ::ArgumentError, "request must be provided" if request.nil?
1446
+
1447
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::GetTagTemplateRequest
1448
+
1449
+ # Converts hash and nil to an options object
1450
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1451
+
1452
+ # Customize the options with defaults
1453
+ call_metadata = @config.rpcs.get_tag_template.metadata.to_h
1454
+
1455
+ # Set x-goog-api-client and x-goog-user-project headers
1456
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1457
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1458
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1459
+ transports_version_send: [:rest]
1460
+
1461
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1462
+
1463
+ options.apply_defaults timeout: @config.rpcs.get_tag_template.timeout,
1464
+ metadata: call_metadata,
1465
+ retry_policy: @config.rpcs.get_tag_template.retry_policy
1466
+
1467
+ options.apply_defaults timeout: @config.timeout,
1468
+ metadata: @config.metadata,
1469
+ retry_policy: @config.retry_policy
1470
+
1471
+ @data_catalog_stub.get_tag_template request, options do |result, operation|
1472
+ yield result, operation if block_given?
1473
+ return result
1474
+ end
1475
+ rescue ::Gapic::Rest::Error => e
1476
+ raise ::Google::Cloud::Error.from_error(e)
1477
+ end
1478
+
1479
+ ##
1480
+ # Updates a tag template.
1481
+ #
1482
+ # You can't update template fields with this method. These fields are
1483
+ # separate resources with their own create, update, and delete methods.
1484
+ #
1485
+ # You must enable the Data Catalog API in the project identified by
1486
+ # the `tag_template.name` parameter. For more information, see [Data Catalog
1487
+ # resource
1488
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1489
+ #
1490
+ # @overload update_tag_template(request, options = nil)
1491
+ # Pass arguments to `update_tag_template` via a request object, either of type
1492
+ # {::Google::Cloud::DataCatalog::V1::UpdateTagTemplateRequest} or an equivalent Hash.
1493
+ #
1494
+ # @param request [::Google::Cloud::DataCatalog::V1::UpdateTagTemplateRequest, ::Hash]
1495
+ # A request object representing the call parameters. Required. To specify no
1496
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1497
+ # @param options [::Gapic::CallOptions, ::Hash]
1498
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1499
+ #
1500
+ # @overload update_tag_template(tag_template: nil, update_mask: nil)
1501
+ # Pass arguments to `update_tag_template` via keyword arguments. Note that at
1502
+ # least one keyword argument is required. To specify no parameters, or to keep all
1503
+ # the default parameter values, pass an empty Hash as a request object (see above).
1504
+ #
1505
+ # @param tag_template [::Google::Cloud::DataCatalog::V1::TagTemplate, ::Hash]
1506
+ # Required. The template to update. The `name` field must be set.
1507
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1508
+ # Names of fields whose values to overwrite on a tag template. Currently,
1509
+ # only `display_name` and `is_publicly_readable` can be overwritten.
1510
+ #
1511
+ # If this parameter is absent or empty, all modifiable fields
1512
+ # are overwritten. If such fields are non-required and omitted in the
1513
+ # request body, their values are emptied.
1514
+ #
1515
+ # Note: Updating the `is_publicly_readable` field may require up to 12
1516
+ # hours to take effect in search results.
1517
+ # @yield [result, operation] Access the result along with the TransportOperation object
1518
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplate]
1519
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1520
+ #
1521
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplate]
1522
+ #
1523
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1524
+ def update_tag_template request, options = nil
1525
+ raise ::ArgumentError, "request must be provided" if request.nil?
1526
+
1527
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateRequest
1528
+
1529
+ # Converts hash and nil to an options object
1530
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1531
+
1532
+ # Customize the options with defaults
1533
+ call_metadata = @config.rpcs.update_tag_template.metadata.to_h
1534
+
1535
+ # Set x-goog-api-client and x-goog-user-project headers
1536
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1537
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1538
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1539
+ transports_version_send: [:rest]
1540
+
1541
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1542
+
1543
+ options.apply_defaults timeout: @config.rpcs.update_tag_template.timeout,
1544
+ metadata: call_metadata,
1545
+ retry_policy: @config.rpcs.update_tag_template.retry_policy
1546
+
1547
+ options.apply_defaults timeout: @config.timeout,
1548
+ metadata: @config.metadata,
1549
+ retry_policy: @config.retry_policy
1550
+
1551
+ @data_catalog_stub.update_tag_template request, options do |result, operation|
1552
+ yield result, operation if block_given?
1553
+ return result
1554
+ end
1555
+ rescue ::Gapic::Rest::Error => e
1556
+ raise ::Google::Cloud::Error.from_error(e)
1557
+ end
1558
+
1559
+ ##
1560
+ # Deletes a tag template and all tags that use it.
1561
+ #
1562
+ # You must enable the Data Catalog API in the project identified by
1563
+ # the `name` parameter. For more information, see [Data Catalog resource
1564
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1565
+ #
1566
+ # @overload delete_tag_template(request, options = nil)
1567
+ # Pass arguments to `delete_tag_template` via a request object, either of type
1568
+ # {::Google::Cloud::DataCatalog::V1::DeleteTagTemplateRequest} or an equivalent Hash.
1569
+ #
1570
+ # @param request [::Google::Cloud::DataCatalog::V1::DeleteTagTemplateRequest, ::Hash]
1571
+ # A request object representing the call parameters. Required. To specify no
1572
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1573
+ # @param options [::Gapic::CallOptions, ::Hash]
1574
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1575
+ #
1576
+ # @overload delete_tag_template(name: nil, force: nil)
1577
+ # Pass arguments to `delete_tag_template` via keyword arguments. Note that at
1578
+ # least one keyword argument is required. To specify no parameters, or to keep all
1579
+ # the default parameter values, pass an empty Hash as a request object (see above).
1580
+ #
1581
+ # @param name [::String]
1582
+ # Required. The name of the tag template to delete.
1583
+ # @param force [::Boolean]
1584
+ # Required. If true, deletes all tags that use this template.
1585
+ #
1586
+ # Currently, `true` is the only supported value.
1587
+ # @yield [result, operation] Access the result along with the TransportOperation object
1588
+ # @yieldparam result [::Google::Protobuf::Empty]
1589
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1590
+ #
1591
+ # @return [::Google::Protobuf::Empty]
1592
+ #
1593
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1594
+ def delete_tag_template request, options = nil
1595
+ raise ::ArgumentError, "request must be provided" if request.nil?
1596
+
1597
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateRequest
1598
+
1599
+ # Converts hash and nil to an options object
1600
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1601
+
1602
+ # Customize the options with defaults
1603
+ call_metadata = @config.rpcs.delete_tag_template.metadata.to_h
1604
+
1605
+ # Set x-goog-api-client and x-goog-user-project headers
1606
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1607
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1608
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1609
+ transports_version_send: [:rest]
1610
+
1611
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1612
+
1613
+ options.apply_defaults timeout: @config.rpcs.delete_tag_template.timeout,
1614
+ metadata: call_metadata,
1615
+ retry_policy: @config.rpcs.delete_tag_template.retry_policy
1616
+
1617
+ options.apply_defaults timeout: @config.timeout,
1618
+ metadata: @config.metadata,
1619
+ retry_policy: @config.retry_policy
1620
+
1621
+ @data_catalog_stub.delete_tag_template request, options do |result, operation|
1622
+ yield result, operation if block_given?
1623
+ return result
1624
+ end
1625
+ rescue ::Gapic::Rest::Error => e
1626
+ raise ::Google::Cloud::Error.from_error(e)
1627
+ end
1628
+
1629
+ ##
1630
+ # Creates a field in a tag template.
1631
+ #
1632
+ # You must enable the Data Catalog API in the project identified by
1633
+ # the `parent` parameter. For more information, see [Data Catalog resource
1634
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1635
+ #
1636
+ # @overload create_tag_template_field(request, options = nil)
1637
+ # Pass arguments to `create_tag_template_field` via a request object, either of type
1638
+ # {::Google::Cloud::DataCatalog::V1::CreateTagTemplateFieldRequest} or an equivalent Hash.
1639
+ #
1640
+ # @param request [::Google::Cloud::DataCatalog::V1::CreateTagTemplateFieldRequest, ::Hash]
1641
+ # A request object representing the call parameters. Required. To specify no
1642
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1643
+ # @param options [::Gapic::CallOptions, ::Hash]
1644
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1645
+ #
1646
+ # @overload create_tag_template_field(parent: nil, tag_template_field_id: nil, tag_template_field: nil)
1647
+ # Pass arguments to `create_tag_template_field` via keyword arguments. Note that at
1648
+ # least one keyword argument is required. To specify no parameters, or to keep all
1649
+ # the default parameter values, pass an empty Hash as a request object (see above).
1650
+ #
1651
+ # @param parent [::String]
1652
+ # Required. The name of the project and the template location
1653
+ # [region](https://cloud.google.com/data-catalog/docs/concepts/regions).
1654
+ # @param tag_template_field_id [::String]
1655
+ # Required. The ID of the tag template field to create.
1656
+ #
1657
+ # Note: Adding a required field to an existing template is *not* allowed.
1658
+ #
1659
+ # Field IDs can contain letters (both uppercase and lowercase), numbers
1660
+ # (0-9), underscores (_) and dashes (-). Field IDs must be at least 1
1661
+ # character long and at most 128 characters long. Field IDs must also be
1662
+ # unique within their template.
1663
+ # @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
1664
+ # Required. The tag template field to create.
1665
+ # @yield [result, operation] Access the result along with the TransportOperation object
1666
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1667
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1668
+ #
1669
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1670
+ #
1671
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1672
+ def create_tag_template_field request, options = nil
1673
+ raise ::ArgumentError, "request must be provided" if request.nil?
1674
+
1675
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::CreateTagTemplateFieldRequest
1676
+
1677
+ # Converts hash and nil to an options object
1678
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1679
+
1680
+ # Customize the options with defaults
1681
+ call_metadata = @config.rpcs.create_tag_template_field.metadata.to_h
1682
+
1683
+ # Set x-goog-api-client and x-goog-user-project headers
1684
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1685
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1686
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1687
+ transports_version_send: [:rest]
1688
+
1689
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1690
+
1691
+ options.apply_defaults timeout: @config.rpcs.create_tag_template_field.timeout,
1692
+ metadata: call_metadata,
1693
+ retry_policy: @config.rpcs.create_tag_template_field.retry_policy
1694
+
1695
+ options.apply_defaults timeout: @config.timeout,
1696
+ metadata: @config.metadata,
1697
+ retry_policy: @config.retry_policy
1698
+
1699
+ @data_catalog_stub.create_tag_template_field request, options do |result, operation|
1700
+ yield result, operation if block_given?
1701
+ return result
1702
+ end
1703
+ rescue ::Gapic::Rest::Error => e
1704
+ raise ::Google::Cloud::Error.from_error(e)
1705
+ end
1706
+
1707
+ ##
1708
+ # Updates a field in a tag template.
1709
+ #
1710
+ # You can't update the field type with this method.
1711
+ #
1712
+ # You must enable the Data Catalog API in the project
1713
+ # identified by the `name` parameter. For more information, see [Data Catalog
1714
+ # resource
1715
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1716
+ #
1717
+ # @overload update_tag_template_field(request, options = nil)
1718
+ # Pass arguments to `update_tag_template_field` via a request object, either of type
1719
+ # {::Google::Cloud::DataCatalog::V1::UpdateTagTemplateFieldRequest} or an equivalent Hash.
1720
+ #
1721
+ # @param request [::Google::Cloud::DataCatalog::V1::UpdateTagTemplateFieldRequest, ::Hash]
1722
+ # A request object representing the call parameters. Required. To specify no
1723
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1724
+ # @param options [::Gapic::CallOptions, ::Hash]
1725
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1726
+ #
1727
+ # @overload update_tag_template_field(name: nil, tag_template_field: nil, update_mask: nil)
1728
+ # Pass arguments to `update_tag_template_field` via keyword arguments. Note that at
1729
+ # least one keyword argument is required. To specify no parameters, or to keep all
1730
+ # the default parameter values, pass an empty Hash as a request object (see above).
1731
+ #
1732
+ # @param name [::String]
1733
+ # Required. The name of the tag template field.
1734
+ # @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
1735
+ # Required. The template to update.
1736
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1737
+ # Optional. Names of fields whose values to overwrite on an individual field
1738
+ # of a tag template. The following fields are modifiable:
1739
+ #
1740
+ # * `display_name`
1741
+ # * `type.enum_type`
1742
+ # * `is_required`
1743
+ #
1744
+ # If this parameter is absent or empty, all modifiable fields
1745
+ # are overwritten. If such fields are non-required and omitted in the request
1746
+ # body, their values are emptied with one exception: when updating an enum
1747
+ # type, the provided values are merged with the existing values. Therefore,
1748
+ # enum values can only be added, existing enum values cannot be deleted or
1749
+ # renamed.
1750
+ #
1751
+ # Additionally, updating a template field from optional to required is
1752
+ # *not* allowed.
1753
+ # @yield [result, operation] Access the result along with the TransportOperation object
1754
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1755
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1756
+ #
1757
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1758
+ #
1759
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1760
+ def update_tag_template_field request, options = nil
1761
+ raise ::ArgumentError, "request must be provided" if request.nil?
1762
+
1763
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateFieldRequest
1764
+
1765
+ # Converts hash and nil to an options object
1766
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1767
+
1768
+ # Customize the options with defaults
1769
+ call_metadata = @config.rpcs.update_tag_template_field.metadata.to_h
1770
+
1771
+ # Set x-goog-api-client and x-goog-user-project headers
1772
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1773
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1774
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1775
+ transports_version_send: [:rest]
1776
+
1777
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1778
+
1779
+ options.apply_defaults timeout: @config.rpcs.update_tag_template_field.timeout,
1780
+ metadata: call_metadata,
1781
+ retry_policy: @config.rpcs.update_tag_template_field.retry_policy
1782
+
1783
+ options.apply_defaults timeout: @config.timeout,
1784
+ metadata: @config.metadata,
1785
+ retry_policy: @config.retry_policy
1786
+
1787
+ @data_catalog_stub.update_tag_template_field request, options do |result, operation|
1788
+ yield result, operation if block_given?
1789
+ return result
1790
+ end
1791
+ rescue ::Gapic::Rest::Error => e
1792
+ raise ::Google::Cloud::Error.from_error(e)
1793
+ end
1794
+
1795
+ ##
1796
+ # Renames a field in a tag template.
1797
+ #
1798
+ # You must enable the Data Catalog API in the project identified by the
1799
+ # `name` parameter. For more information, see [Data Catalog resource project]
1800
+ # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1801
+ #
1802
+ # @overload rename_tag_template_field(request, options = nil)
1803
+ # Pass arguments to `rename_tag_template_field` via a request object, either of type
1804
+ # {::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldRequest} or an equivalent Hash.
1805
+ #
1806
+ # @param request [::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldRequest, ::Hash]
1807
+ # A request object representing the call parameters. Required. To specify no
1808
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1809
+ # @param options [::Gapic::CallOptions, ::Hash]
1810
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1811
+ #
1812
+ # @overload rename_tag_template_field(name: nil, new_tag_template_field_id: nil)
1813
+ # Pass arguments to `rename_tag_template_field` via keyword arguments. Note that at
1814
+ # least one keyword argument is required. To specify no parameters, or to keep all
1815
+ # the default parameter values, pass an empty Hash as a request object (see above).
1816
+ #
1817
+ # @param name [::String]
1818
+ # Required. The name of the tag template field.
1819
+ # @param new_tag_template_field_id [::String]
1820
+ # Required. The new ID of this tag template field. For example,
1821
+ # `my_new_field`.
1822
+ # @yield [result, operation] Access the result along with the TransportOperation object
1823
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1824
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1825
+ #
1826
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1827
+ #
1828
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1829
+ def rename_tag_template_field request, options = nil
1830
+ raise ::ArgumentError, "request must be provided" if request.nil?
1831
+
1832
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldRequest
1833
+
1834
+ # Converts hash and nil to an options object
1835
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1836
+
1837
+ # Customize the options with defaults
1838
+ call_metadata = @config.rpcs.rename_tag_template_field.metadata.to_h
1839
+
1840
+ # Set x-goog-api-client and x-goog-user-project headers
1841
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1842
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1843
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1844
+ transports_version_send: [:rest]
1845
+
1846
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1847
+
1848
+ options.apply_defaults timeout: @config.rpcs.rename_tag_template_field.timeout,
1849
+ metadata: call_metadata,
1850
+ retry_policy: @config.rpcs.rename_tag_template_field.retry_policy
1851
+
1852
+ options.apply_defaults timeout: @config.timeout,
1853
+ metadata: @config.metadata,
1854
+ retry_policy: @config.retry_policy
1855
+
1856
+ @data_catalog_stub.rename_tag_template_field request, options do |result, operation|
1857
+ yield result, operation if block_given?
1858
+ return result
1859
+ end
1860
+ rescue ::Gapic::Rest::Error => e
1861
+ raise ::Google::Cloud::Error.from_error(e)
1862
+ end
1863
+
1864
+ ##
1865
+ # Renames an enum value in a tag template.
1866
+ #
1867
+ # Within a single enum field, enum values must be unique.
1868
+ #
1869
+ # @overload rename_tag_template_field_enum_value(request, options = nil)
1870
+ # Pass arguments to `rename_tag_template_field_enum_value` via a request object, either of type
1871
+ # {::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest} or an equivalent Hash.
1872
+ #
1873
+ # @param request [::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest, ::Hash]
1874
+ # A request object representing the call parameters. Required. To specify no
1875
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1876
+ # @param options [::Gapic::CallOptions, ::Hash]
1877
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1878
+ #
1879
+ # @overload rename_tag_template_field_enum_value(name: nil, new_enum_value_display_name: nil)
1880
+ # Pass arguments to `rename_tag_template_field_enum_value` via keyword arguments. Note that at
1881
+ # least one keyword argument is required. To specify no parameters, or to keep all
1882
+ # the default parameter values, pass an empty Hash as a request object (see above).
1883
+ #
1884
+ # @param name [::String]
1885
+ # Required. The name of the enum field value.
1886
+ # @param new_enum_value_display_name [::String]
1887
+ # Required. The new display name of the enum value. For example,
1888
+ # `my_new_enum_value`.
1889
+ # @yield [result, operation] Access the result along with the TransportOperation object
1890
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1891
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1892
+ #
1893
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1894
+ #
1895
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1896
+ def rename_tag_template_field_enum_value request, options = nil
1897
+ raise ::ArgumentError, "request must be provided" if request.nil?
1898
+
1899
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest
1900
+
1901
+ # Converts hash and nil to an options object
1902
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1903
+
1904
+ # Customize the options with defaults
1905
+ call_metadata = @config.rpcs.rename_tag_template_field_enum_value.metadata.to_h
1906
+
1907
+ # Set x-goog-api-client and x-goog-user-project headers
1908
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1909
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1910
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1911
+ transports_version_send: [:rest]
1912
+
1913
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1914
+
1915
+ options.apply_defaults timeout: @config.rpcs.rename_tag_template_field_enum_value.timeout,
1916
+ metadata: call_metadata,
1917
+ retry_policy: @config.rpcs.rename_tag_template_field_enum_value.retry_policy
1918
+
1919
+ options.apply_defaults timeout: @config.timeout,
1920
+ metadata: @config.metadata,
1921
+ retry_policy: @config.retry_policy
1922
+
1923
+ @data_catalog_stub.rename_tag_template_field_enum_value request, options do |result, operation|
1924
+ yield result, operation if block_given?
1925
+ return result
1926
+ end
1927
+ rescue ::Gapic::Rest::Error => e
1928
+ raise ::Google::Cloud::Error.from_error(e)
1929
+ end
1930
+
1931
+ ##
1932
+ # Deletes a field in a tag template and all uses of this field from the tags
1933
+ # based on this template.
1934
+ #
1935
+ # You must enable the Data Catalog API in the project identified by
1936
+ # the `name` parameter. For more information, see [Data Catalog resource
1937
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
1938
+ #
1939
+ # @overload delete_tag_template_field(request, options = nil)
1940
+ # Pass arguments to `delete_tag_template_field` via a request object, either of type
1941
+ # {::Google::Cloud::DataCatalog::V1::DeleteTagTemplateFieldRequest} or an equivalent Hash.
1942
+ #
1943
+ # @param request [::Google::Cloud::DataCatalog::V1::DeleteTagTemplateFieldRequest, ::Hash]
1944
+ # A request object representing the call parameters. Required. To specify no
1945
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1946
+ # @param options [::Gapic::CallOptions, ::Hash]
1947
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1948
+ #
1949
+ # @overload delete_tag_template_field(name: nil, force: nil)
1950
+ # Pass arguments to `delete_tag_template_field` via keyword arguments. Note that at
1951
+ # least one keyword argument is required. To specify no parameters, or to keep all
1952
+ # the default parameter values, pass an empty Hash as a request object (see above).
1953
+ #
1954
+ # @param name [::String]
1955
+ # Required. The name of the tag template field to delete.
1956
+ # @param force [::Boolean]
1957
+ # Required. If true, deletes this field from any tags that use it.
1958
+ #
1959
+ # Currently, `true` is the only supported value.
1960
+ # @yield [result, operation] Access the result along with the TransportOperation object
1961
+ # @yieldparam result [::Google::Protobuf::Empty]
1962
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1963
+ #
1964
+ # @return [::Google::Protobuf::Empty]
1965
+ #
1966
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1967
+ def delete_tag_template_field request, options = nil
1968
+ raise ::ArgumentError, "request must be provided" if request.nil?
1969
+
1970
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateFieldRequest
1971
+
1972
+ # Converts hash and nil to an options object
1973
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1974
+
1975
+ # Customize the options with defaults
1976
+ call_metadata = @config.rpcs.delete_tag_template_field.metadata.to_h
1977
+
1978
+ # Set x-goog-api-client and x-goog-user-project headers
1979
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1980
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1981
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
1982
+ transports_version_send: [:rest]
1983
+
1984
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1985
+
1986
+ options.apply_defaults timeout: @config.rpcs.delete_tag_template_field.timeout,
1987
+ metadata: call_metadata,
1988
+ retry_policy: @config.rpcs.delete_tag_template_field.retry_policy
1989
+
1990
+ options.apply_defaults timeout: @config.timeout,
1991
+ metadata: @config.metadata,
1992
+ retry_policy: @config.retry_policy
1993
+
1994
+ @data_catalog_stub.delete_tag_template_field request, options do |result, operation|
1995
+ yield result, operation if block_given?
1996
+ return result
1997
+ end
1998
+ rescue ::Gapic::Rest::Error => e
1999
+ raise ::Google::Cloud::Error.from_error(e)
2000
+ end
2001
+
2002
+ ##
2003
+ # Creates a tag and assigns it to:
2004
+ #
2005
+ # * An {::Google::Cloud::DataCatalog::V1::Entry Entry} if the method name is
2006
+ # `projects.locations.entryGroups.entries.tags.create`.
2007
+ # * Or {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}if the method
2008
+ # name is `projects.locations.entryGroups.tags.create`.
2009
+ #
2010
+ # Note: The project identified by the `parent` parameter for the [tag]
2011
+ # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
2012
+ # and the [tag template]
2013
+ # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
2014
+ # used to create the tag must be in the same organization.
2015
+ #
2016
+ # @overload create_tag(request, options = nil)
2017
+ # Pass arguments to `create_tag` via a request object, either of type
2018
+ # {::Google::Cloud::DataCatalog::V1::CreateTagRequest} or an equivalent Hash.
2019
+ #
2020
+ # @param request [::Google::Cloud::DataCatalog::V1::CreateTagRequest, ::Hash]
2021
+ # A request object representing the call parameters. Required. To specify no
2022
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2023
+ # @param options [::Gapic::CallOptions, ::Hash]
2024
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2025
+ #
2026
+ # @overload create_tag(parent: nil, tag: nil)
2027
+ # Pass arguments to `create_tag` via keyword arguments. Note that at
2028
+ # least one keyword argument is required. To specify no parameters, or to keep all
2029
+ # the default parameter values, pass an empty Hash as a request object (see above).
2030
+ #
2031
+ # @param parent [::String]
2032
+ # Required. The name of the resource to attach this tag to.
2033
+ #
2034
+ # Tags can be attached to entries or entry groups. An entry can have up to
2035
+ # 1000 attached tags.
2036
+ #
2037
+ # Note: The tag and its child resources might not be stored in
2038
+ # the location specified in its name.
2039
+ # @param tag [::Google::Cloud::DataCatalog::V1::Tag, ::Hash]
2040
+ # Required. The tag to create.
2041
+ # @yield [result, operation] Access the result along with the TransportOperation object
2042
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Tag]
2043
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2044
+ #
2045
+ # @return [::Google::Cloud::DataCatalog::V1::Tag]
2046
+ #
2047
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2048
+ def create_tag request, options = nil
2049
+ raise ::ArgumentError, "request must be provided" if request.nil?
2050
+
2051
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::CreateTagRequest
2052
+
2053
+ # Converts hash and nil to an options object
2054
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2055
+
2056
+ # Customize the options with defaults
2057
+ call_metadata = @config.rpcs.create_tag.metadata.to_h
2058
+
2059
+ # Set x-goog-api-client and x-goog-user-project headers
2060
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2061
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2062
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2063
+ transports_version_send: [:rest]
2064
+
2065
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2066
+
2067
+ options.apply_defaults timeout: @config.rpcs.create_tag.timeout,
2068
+ metadata: call_metadata,
2069
+ retry_policy: @config.rpcs.create_tag.retry_policy
2070
+
2071
+ options.apply_defaults timeout: @config.timeout,
2072
+ metadata: @config.metadata,
2073
+ retry_policy: @config.retry_policy
2074
+
2075
+ @data_catalog_stub.create_tag request, options do |result, operation|
2076
+ yield result, operation if block_given?
2077
+ return result
2078
+ end
2079
+ rescue ::Gapic::Rest::Error => e
2080
+ raise ::Google::Cloud::Error.from_error(e)
2081
+ end
2082
+
2083
+ ##
2084
+ # Updates an existing tag.
2085
+ #
2086
+ # @overload update_tag(request, options = nil)
2087
+ # Pass arguments to `update_tag` via a request object, either of type
2088
+ # {::Google::Cloud::DataCatalog::V1::UpdateTagRequest} or an equivalent Hash.
2089
+ #
2090
+ # @param request [::Google::Cloud::DataCatalog::V1::UpdateTagRequest, ::Hash]
2091
+ # A request object representing the call parameters. Required. To specify no
2092
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2093
+ # @param options [::Gapic::CallOptions, ::Hash]
2094
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2095
+ #
2096
+ # @overload update_tag(tag: nil, update_mask: nil)
2097
+ # Pass arguments to `update_tag` via keyword arguments. Note that at
2098
+ # least one keyword argument is required. To specify no parameters, or to keep all
2099
+ # the default parameter values, pass an empty Hash as a request object (see above).
2100
+ #
2101
+ # @param tag [::Google::Cloud::DataCatalog::V1::Tag, ::Hash]
2102
+ # Required. The updated tag. The "name" field must be set.
2103
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2104
+ # Names of fields whose values to overwrite on a tag. Currently, a tag has
2105
+ # the only modifiable field with the name `fields`.
2106
+ #
2107
+ # In general, if this parameter is absent or empty, all modifiable fields
2108
+ # are overwritten. If such fields are non-required and omitted in the
2109
+ # request body, their values are emptied.
2110
+ # @yield [result, operation] Access the result along with the TransportOperation object
2111
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::Tag]
2112
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2113
+ #
2114
+ # @return [::Google::Cloud::DataCatalog::V1::Tag]
2115
+ #
2116
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2117
+ def update_tag request, options = nil
2118
+ raise ::ArgumentError, "request must be provided" if request.nil?
2119
+
2120
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UpdateTagRequest
2121
+
2122
+ # Converts hash and nil to an options object
2123
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2124
+
2125
+ # Customize the options with defaults
2126
+ call_metadata = @config.rpcs.update_tag.metadata.to_h
2127
+
2128
+ # Set x-goog-api-client and x-goog-user-project headers
2129
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2130
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2131
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2132
+ transports_version_send: [:rest]
2133
+
2134
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2135
+
2136
+ options.apply_defaults timeout: @config.rpcs.update_tag.timeout,
2137
+ metadata: call_metadata,
2138
+ retry_policy: @config.rpcs.update_tag.retry_policy
2139
+
2140
+ options.apply_defaults timeout: @config.timeout,
2141
+ metadata: @config.metadata,
2142
+ retry_policy: @config.retry_policy
2143
+
2144
+ @data_catalog_stub.update_tag request, options do |result, operation|
2145
+ yield result, operation if block_given?
2146
+ return result
2147
+ end
2148
+ rescue ::Gapic::Rest::Error => e
2149
+ raise ::Google::Cloud::Error.from_error(e)
2150
+ end
2151
+
2152
+ ##
2153
+ # Deletes a tag.
2154
+ #
2155
+ # @overload delete_tag(request, options = nil)
2156
+ # Pass arguments to `delete_tag` via a request object, either of type
2157
+ # {::Google::Cloud::DataCatalog::V1::DeleteTagRequest} or an equivalent Hash.
2158
+ #
2159
+ # @param request [::Google::Cloud::DataCatalog::V1::DeleteTagRequest, ::Hash]
2160
+ # A request object representing the call parameters. Required. To specify no
2161
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2162
+ # @param options [::Gapic::CallOptions, ::Hash]
2163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2164
+ #
2165
+ # @overload delete_tag(name: nil)
2166
+ # Pass arguments to `delete_tag` via keyword arguments. Note that at
2167
+ # least one keyword argument is required. To specify no parameters, or to keep all
2168
+ # the default parameter values, pass an empty Hash as a request object (see above).
2169
+ #
2170
+ # @param name [::String]
2171
+ # Required. The name of the tag to delete.
2172
+ # @yield [result, operation] Access the result along with the TransportOperation object
2173
+ # @yieldparam result [::Google::Protobuf::Empty]
2174
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2175
+ #
2176
+ # @return [::Google::Protobuf::Empty]
2177
+ #
2178
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2179
+ def delete_tag request, options = nil
2180
+ raise ::ArgumentError, "request must be provided" if request.nil?
2181
+
2182
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::DeleteTagRequest
2183
+
2184
+ # Converts hash and nil to an options object
2185
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2186
+
2187
+ # Customize the options with defaults
2188
+ call_metadata = @config.rpcs.delete_tag.metadata.to_h
2189
+
2190
+ # Set x-goog-api-client and x-goog-user-project headers
2191
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2192
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2193
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2194
+ transports_version_send: [:rest]
2195
+
2196
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2197
+
2198
+ options.apply_defaults timeout: @config.rpcs.delete_tag.timeout,
2199
+ metadata: call_metadata,
2200
+ retry_policy: @config.rpcs.delete_tag.retry_policy
2201
+
2202
+ options.apply_defaults timeout: @config.timeout,
2203
+ metadata: @config.metadata,
2204
+ retry_policy: @config.retry_policy
2205
+
2206
+ @data_catalog_stub.delete_tag request, options do |result, operation|
2207
+ yield result, operation if block_given?
2208
+ return result
2209
+ end
2210
+ rescue ::Gapic::Rest::Error => e
2211
+ raise ::Google::Cloud::Error.from_error(e)
2212
+ end
2213
+
2214
+ ##
2215
+ # Lists tags assigned to an {::Google::Cloud::DataCatalog::V1::Entry Entry}.
2216
+ # The {::Google::Cloud::DataCatalog::V1::Tag#column columns} in the response are
2217
+ # lowercased.
2218
+ #
2219
+ # @overload list_tags(request, options = nil)
2220
+ # Pass arguments to `list_tags` via a request object, either of type
2221
+ # {::Google::Cloud::DataCatalog::V1::ListTagsRequest} or an equivalent Hash.
2222
+ #
2223
+ # @param request [::Google::Cloud::DataCatalog::V1::ListTagsRequest, ::Hash]
2224
+ # A request object representing the call parameters. Required. To specify no
2225
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2226
+ # @param options [::Gapic::CallOptions, ::Hash]
2227
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2228
+ #
2229
+ # @overload list_tags(parent: nil, page_size: nil, page_token: nil)
2230
+ # Pass arguments to `list_tags` via keyword arguments. Note that at
2231
+ # least one keyword argument is required. To specify no parameters, or to keep all
2232
+ # the default parameter values, pass an empty Hash as a request object (see above).
2233
+ #
2234
+ # @param parent [::String]
2235
+ # Required. The name of the Data Catalog resource to list the tags of.
2236
+ #
2237
+ # The resource can be an {::Google::Cloud::DataCatalog::V1::Entry Entry}
2238
+ # or an {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}
2239
+ # (without `/entries/{entries}` at the end).
2240
+ # @param page_size [::Integer]
2241
+ # The maximum number of tags to return. Default is 10. Maximum limit is 1000.
2242
+ # @param page_token [::String]
2243
+ # Pagination token that specifies the next page to return. If empty, the
2244
+ # first page is returned.
2245
+ # @yield [result, operation] Access the result along with the TransportOperation object
2246
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Tag>]
2247
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2248
+ #
2249
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Tag>]
2250
+ #
2251
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2252
+ def list_tags request, options = nil
2253
+ raise ::ArgumentError, "request must be provided" if request.nil?
2254
+
2255
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ListTagsRequest
2256
+
2257
+ # Converts hash and nil to an options object
2258
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2259
+
2260
+ # Customize the options with defaults
2261
+ call_metadata = @config.rpcs.list_tags.metadata.to_h
2262
+
2263
+ # Set x-goog-api-client and x-goog-user-project headers
2264
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2265
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2266
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2267
+ transports_version_send: [:rest]
2268
+
2269
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2270
+
2271
+ options.apply_defaults timeout: @config.rpcs.list_tags.timeout,
2272
+ metadata: call_metadata,
2273
+ retry_policy: @config.rpcs.list_tags.retry_policy
2274
+
2275
+ options.apply_defaults timeout: @config.timeout,
2276
+ metadata: @config.metadata,
2277
+ retry_policy: @config.retry_policy
2278
+
2279
+ @data_catalog_stub.list_tags request, options do |result, operation|
2280
+ result = ::Gapic::Rest::PagedEnumerable.new @data_catalog_stub, :list_tags, "tags", request, result, options
2281
+ yield result, operation if block_given?
2282
+ return result
2283
+ end
2284
+ rescue ::Gapic::Rest::Error => e
2285
+ raise ::Google::Cloud::Error.from_error(e)
2286
+ end
2287
+
2288
+ ##
2289
+ # `ReconcileTags` creates or updates a list of tags on the entry.
2290
+ # If the
2291
+ # {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest#force_delete_missing ReconcileTagsRequest.force_delete_missing}
2292
+ # parameter is set, the operation deletes tags not included in the input tag
2293
+ # list.
2294
+ #
2295
+ # `ReconcileTags` returns a [long-running operation]
2296
+ # [google.longrunning.Operation] resource that can be queried with
2297
+ # Operations.GetOperation
2298
+ # to return [ReconcileTagsMetadata]
2299
+ # [google.cloud.datacatalog.v1.ReconcileTagsMetadata] and
2300
+ # a [ReconcileTagsResponse]
2301
+ # [google.cloud.datacatalog.v1.ReconcileTagsResponse] message.
2302
+ #
2303
+ # @overload reconcile_tags(request, options = nil)
2304
+ # Pass arguments to `reconcile_tags` via a request object, either of type
2305
+ # {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest} or an equivalent Hash.
2306
+ #
2307
+ # @param request [::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest, ::Hash]
2308
+ # A request object representing the call parameters. Required. To specify no
2309
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2310
+ # @param options [::Gapic::CallOptions, ::Hash]
2311
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2312
+ #
2313
+ # @overload reconcile_tags(parent: nil, tag_template: nil, force_delete_missing: nil, tags: nil)
2314
+ # Pass arguments to `reconcile_tags` via keyword arguments. Note that at
2315
+ # least one keyword argument is required. To specify no parameters, or to keep all
2316
+ # the default parameter values, pass an empty Hash as a request object (see above).
2317
+ #
2318
+ # @param parent [::String]
2319
+ # Required. Name of {::Google::Cloud::DataCatalog::V1::Entry Entry} to be tagged.
2320
+ # @param tag_template [::String]
2321
+ # Required. The name of the tag template, which is used for reconciliation.
2322
+ # @param force_delete_missing [::Boolean]
2323
+ # If set to `true`, deletes entry tags related to a tag template
2324
+ # not listed in the tags source from an entry. If set to `false`,
2325
+ # unlisted tags are retained.
2326
+ # @param tags [::Array<::Google::Cloud::DataCatalog::V1::Tag, ::Hash>]
2327
+ # A list of tags to apply to an entry. A tag can specify a
2328
+ # tag template, which must be the template specified in the
2329
+ # `ReconcileTagsRequest`.
2330
+ # The sole entry and each of its columns must be mentioned at most once.
2331
+ # @yield [result, operation] Access the result along with the TransportOperation object
2332
+ # @yieldparam result [::Gapic::Operation]
2333
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2334
+ #
2335
+ # @return [::Gapic::Operation]
2336
+ #
2337
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2338
+ def reconcile_tags request, options = nil
2339
+ raise ::ArgumentError, "request must be provided" if request.nil?
2340
+
2341
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest
2342
+
2343
+ # Converts hash and nil to an options object
2344
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2345
+
2346
+ # Customize the options with defaults
2347
+ call_metadata = @config.rpcs.reconcile_tags.metadata.to_h
2348
+
2349
+ # Set x-goog-api-client and x-goog-user-project headers
2350
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2351
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2352
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2353
+ transports_version_send: [:rest]
2354
+
2355
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2356
+
2357
+ options.apply_defaults timeout: @config.rpcs.reconcile_tags.timeout,
2358
+ metadata: call_metadata,
2359
+ retry_policy: @config.rpcs.reconcile_tags.retry_policy
2360
+
2361
+ options.apply_defaults timeout: @config.timeout,
2362
+ metadata: @config.metadata,
2363
+ retry_policy: @config.retry_policy
2364
+
2365
+ @data_catalog_stub.reconcile_tags request, options do |result, operation|
2366
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2367
+ yield result, operation if block_given?
2368
+ return result
2369
+ end
2370
+ rescue ::Gapic::Rest::Error => e
2371
+ raise ::Google::Cloud::Error.from_error(e)
2372
+ end
2373
+
2374
+ ##
2375
+ # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as starred by
2376
+ # the current user. Starring information is private to each user.
2377
+ #
2378
+ # @overload star_entry(request, options = nil)
2379
+ # Pass arguments to `star_entry` via a request object, either of type
2380
+ # {::Google::Cloud::DataCatalog::V1::StarEntryRequest} or an equivalent Hash.
2381
+ #
2382
+ # @param request [::Google::Cloud::DataCatalog::V1::StarEntryRequest, ::Hash]
2383
+ # A request object representing the call parameters. Required. To specify no
2384
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2385
+ # @param options [::Gapic::CallOptions, ::Hash]
2386
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2387
+ #
2388
+ # @overload star_entry(name: nil)
2389
+ # Pass arguments to `star_entry` via keyword arguments. Note that at
2390
+ # least one keyword argument is required. To specify no parameters, or to keep all
2391
+ # the default parameter values, pass an empty Hash as a request object (see above).
2392
+ #
2393
+ # @param name [::String]
2394
+ # Required. The name of the entry to mark as starred.
2395
+ # @yield [result, operation] Access the result along with the TransportOperation object
2396
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
2397
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2398
+ #
2399
+ # @return [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
2400
+ #
2401
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2402
+ def star_entry request, options = nil
2403
+ raise ::ArgumentError, "request must be provided" if request.nil?
2404
+
2405
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::StarEntryRequest
2406
+
2407
+ # Converts hash and nil to an options object
2408
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2409
+
2410
+ # Customize the options with defaults
2411
+ call_metadata = @config.rpcs.star_entry.metadata.to_h
2412
+
2413
+ # Set x-goog-api-client and x-goog-user-project headers
2414
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2415
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2416
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2417
+ transports_version_send: [:rest]
2418
+
2419
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2420
+
2421
+ options.apply_defaults timeout: @config.rpcs.star_entry.timeout,
2422
+ metadata: call_metadata,
2423
+ retry_policy: @config.rpcs.star_entry.retry_policy
2424
+
2425
+ options.apply_defaults timeout: @config.timeout,
2426
+ metadata: @config.metadata,
2427
+ retry_policy: @config.retry_policy
2428
+
2429
+ @data_catalog_stub.star_entry request, options do |result, operation|
2430
+ yield result, operation if block_given?
2431
+ return result
2432
+ end
2433
+ rescue ::Gapic::Rest::Error => e
2434
+ raise ::Google::Cloud::Error.from_error(e)
2435
+ end
2436
+
2437
+ ##
2438
+ # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as NOT starred by
2439
+ # the current user. Starring information is private to each user.
2440
+ #
2441
+ # @overload unstar_entry(request, options = nil)
2442
+ # Pass arguments to `unstar_entry` via a request object, either of type
2443
+ # {::Google::Cloud::DataCatalog::V1::UnstarEntryRequest} or an equivalent Hash.
2444
+ #
2445
+ # @param request [::Google::Cloud::DataCatalog::V1::UnstarEntryRequest, ::Hash]
2446
+ # A request object representing the call parameters. Required. To specify no
2447
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2448
+ # @param options [::Gapic::CallOptions, ::Hash]
2449
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2450
+ #
2451
+ # @overload unstar_entry(name: nil)
2452
+ # Pass arguments to `unstar_entry` via keyword arguments. Note that at
2453
+ # least one keyword argument is required. To specify no parameters, or to keep all
2454
+ # the default parameter values, pass an empty Hash as a request object (see above).
2455
+ #
2456
+ # @param name [::String]
2457
+ # Required. The name of the entry to mark as **not** starred.
2458
+ # @yield [result, operation] Access the result along with the TransportOperation object
2459
+ # @yieldparam result [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
2460
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2461
+ #
2462
+ # @return [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
2463
+ #
2464
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2465
+ def unstar_entry request, options = nil
2466
+ raise ::ArgumentError, "request must be provided" if request.nil?
2467
+
2468
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UnstarEntryRequest
2469
+
2470
+ # Converts hash and nil to an options object
2471
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2472
+
2473
+ # Customize the options with defaults
2474
+ call_metadata = @config.rpcs.unstar_entry.metadata.to_h
2475
+
2476
+ # Set x-goog-api-client and x-goog-user-project headers
2477
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2478
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2479
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2480
+ transports_version_send: [:rest]
2481
+
2482
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2483
+
2484
+ options.apply_defaults timeout: @config.rpcs.unstar_entry.timeout,
2485
+ metadata: call_metadata,
2486
+ retry_policy: @config.rpcs.unstar_entry.retry_policy
2487
+
2488
+ options.apply_defaults timeout: @config.timeout,
2489
+ metadata: @config.metadata,
2490
+ retry_policy: @config.retry_policy
2491
+
2492
+ @data_catalog_stub.unstar_entry request, options do |result, operation|
2493
+ yield result, operation if block_given?
2494
+ return result
2495
+ end
2496
+ rescue ::Gapic::Rest::Error => e
2497
+ raise ::Google::Cloud::Error.from_error(e)
2498
+ end
2499
+
2500
+ ##
2501
+ # Sets an access control policy for a resource. Replaces any existing
2502
+ # policy.
2503
+ #
2504
+ # Supported resources are:
2505
+ #
2506
+ # - Tag templates
2507
+ # - Entry groups
2508
+ #
2509
+ # Note: This method sets policies only within Data Catalog and can't be
2510
+ # used to manage policies in BigQuery, Pub/Sub, Dataproc Metastore, and any
2511
+ # external Google Cloud Platform resources synced with the Data Catalog.
2512
+ #
2513
+ # To call this method, you must have the following Google IAM permissions:
2514
+ #
2515
+ # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
2516
+ # templates.
2517
+ # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
2518
+ #
2519
+ # @overload set_iam_policy(request, options = nil)
2520
+ # Pass arguments to `set_iam_policy` via a request object, either of type
2521
+ # {::Google::Iam::V1::SetIamPolicyRequest} or an equivalent Hash.
2522
+ #
2523
+ # @param request [::Google::Iam::V1::SetIamPolicyRequest, ::Hash]
2524
+ # A request object representing the call parameters. Required. To specify no
2525
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2526
+ # @param options [::Gapic::CallOptions, ::Hash]
2527
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2528
+ #
2529
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
2530
+ # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
2531
+ # least one keyword argument is required. To specify no parameters, or to keep all
2532
+ # the default parameter values, pass an empty Hash as a request object (see above).
2533
+ #
2534
+ # @param resource [::String]
2535
+ # REQUIRED: The resource for which the policy is being specified.
2536
+ # See the operation documentation for the appropriate value for this field.
2537
+ # @param policy [::Google::Iam::V1::Policy, ::Hash]
2538
+ # REQUIRED: The complete policy to be applied to the `resource`. The size of
2539
+ # the policy is limited to a few 10s of KB. An empty policy is a
2540
+ # valid policy but certain Cloud Platform services (such as Projects)
2541
+ # might reject them.
2542
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2543
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
2544
+ # the fields in the mask will be modified. If no mask is provided, the
2545
+ # following default mask is used:
2546
+ #
2547
+ # `paths: "bindings, etag"`
2548
+ # @yield [result, operation] Access the result along with the TransportOperation object
2549
+ # @yieldparam result [::Google::Iam::V1::Policy]
2550
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2551
+ #
2552
+ # @return [::Google::Iam::V1::Policy]
2553
+ #
2554
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2555
+ def set_iam_policy request, options = nil
2556
+ raise ::ArgumentError, "request must be provided" if request.nil?
2557
+
2558
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::SetIamPolicyRequest
2559
+
2560
+ # Converts hash and nil to an options object
2561
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2562
+
2563
+ # Customize the options with defaults
2564
+ call_metadata = @config.rpcs.set_iam_policy.metadata.to_h
2565
+
2566
+ # Set x-goog-api-client and x-goog-user-project headers
2567
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2568
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2569
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2570
+ transports_version_send: [:rest]
2571
+
2572
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2573
+
2574
+ options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
2575
+ metadata: call_metadata,
2576
+ retry_policy: @config.rpcs.set_iam_policy.retry_policy
2577
+
2578
+ options.apply_defaults timeout: @config.timeout,
2579
+ metadata: @config.metadata,
2580
+ retry_policy: @config.retry_policy
2581
+
2582
+ @data_catalog_stub.set_iam_policy request, options do |result, operation|
2583
+ yield result, operation if block_given?
2584
+ return result
2585
+ end
2586
+ rescue ::Gapic::Rest::Error => e
2587
+ raise ::Google::Cloud::Error.from_error(e)
2588
+ end
2589
+
2590
+ ##
2591
+ # Gets the access control policy for a resource.
2592
+ #
2593
+ # May return:
2594
+ #
2595
+ # * A`NOT_FOUND` error if the resource doesn't exist or you don't have the
2596
+ # permission to view it.
2597
+ # * An empty policy if the resource exists but doesn't have a set policy.
2598
+ #
2599
+ # Supported resources are:
2600
+ #
2601
+ # - Tag templates
2602
+ # - Entry groups
2603
+ #
2604
+ # Note: This method doesn't get policies from Google Cloud Platform
2605
+ # resources ingested into Data Catalog.
2606
+ #
2607
+ # To call this method, you must have the following Google IAM permissions:
2608
+ #
2609
+ # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
2610
+ # templates.
2611
+ # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
2612
+ #
2613
+ # @overload get_iam_policy(request, options = nil)
2614
+ # Pass arguments to `get_iam_policy` via a request object, either of type
2615
+ # {::Google::Iam::V1::GetIamPolicyRequest} or an equivalent Hash.
2616
+ #
2617
+ # @param request [::Google::Iam::V1::GetIamPolicyRequest, ::Hash]
2618
+ # A request object representing the call parameters. Required. To specify no
2619
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2620
+ # @param options [::Gapic::CallOptions, ::Hash]
2621
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2622
+ #
2623
+ # @overload get_iam_policy(resource: nil, options: nil)
2624
+ # Pass arguments to `get_iam_policy` via keyword arguments. Note that at
2625
+ # least one keyword argument is required. To specify no parameters, or to keep all
2626
+ # the default parameter values, pass an empty Hash as a request object (see above).
2627
+ #
2628
+ # @param resource [::String]
2629
+ # REQUIRED: The resource for which the policy is being requested.
2630
+ # See the operation documentation for the appropriate value for this field.
2631
+ # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
2632
+ # OPTIONAL: A `GetPolicyOptions` object for specifying options to
2633
+ # `GetIamPolicy`.
2634
+ # @yield [result, operation] Access the result along with the TransportOperation object
2635
+ # @yieldparam result [::Google::Iam::V1::Policy]
2636
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2637
+ #
2638
+ # @return [::Google::Iam::V1::Policy]
2639
+ #
2640
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2641
+ def get_iam_policy request, options = nil
2642
+ raise ::ArgumentError, "request must be provided" if request.nil?
2643
+
2644
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::GetIamPolicyRequest
2645
+
2646
+ # Converts hash and nil to an options object
2647
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2648
+
2649
+ # Customize the options with defaults
2650
+ call_metadata = @config.rpcs.get_iam_policy.metadata.to_h
2651
+
2652
+ # Set x-goog-api-client and x-goog-user-project headers
2653
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2654
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2655
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2656
+ transports_version_send: [:rest]
2657
+
2658
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2659
+
2660
+ options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
2661
+ metadata: call_metadata,
2662
+ retry_policy: @config.rpcs.get_iam_policy.retry_policy
2663
+
2664
+ options.apply_defaults timeout: @config.timeout,
2665
+ metadata: @config.metadata,
2666
+ retry_policy: @config.retry_policy
2667
+
2668
+ @data_catalog_stub.get_iam_policy request, options do |result, operation|
2669
+ yield result, operation if block_given?
2670
+ return result
2671
+ end
2672
+ rescue ::Gapic::Rest::Error => e
2673
+ raise ::Google::Cloud::Error.from_error(e)
2674
+ end
2675
+
2676
+ ##
2677
+ # Gets your permissions on a resource.
2678
+ #
2679
+ # Returns an empty set of permissions if the resource doesn't exist.
2680
+ #
2681
+ # Supported resources are:
2682
+ #
2683
+ # - Tag templates
2684
+ # - Entry groups
2685
+ #
2686
+ # Note: This method gets policies only within Data Catalog and can't be
2687
+ # used to get policies from BigQuery, Pub/Sub, Dataproc Metastore, and any
2688
+ # external Google Cloud Platform resources ingested into Data Catalog.
2689
+ #
2690
+ # No Google IAM permissions are required to call this method.
2691
+ #
2692
+ # @overload test_iam_permissions(request, options = nil)
2693
+ # Pass arguments to `test_iam_permissions` via a request object, either of type
2694
+ # {::Google::Iam::V1::TestIamPermissionsRequest} or an equivalent Hash.
2695
+ #
2696
+ # @param request [::Google::Iam::V1::TestIamPermissionsRequest, ::Hash]
2697
+ # A request object representing the call parameters. Required. To specify no
2698
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2699
+ # @param options [::Gapic::CallOptions, ::Hash]
2700
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2701
+ #
2702
+ # @overload test_iam_permissions(resource: nil, permissions: nil)
2703
+ # Pass arguments to `test_iam_permissions` via keyword arguments. Note that at
2704
+ # least one keyword argument is required. To specify no parameters, or to keep all
2705
+ # the default parameter values, pass an empty Hash as a request object (see above).
2706
+ #
2707
+ # @param resource [::String]
2708
+ # REQUIRED: The resource for which the policy detail is being requested.
2709
+ # See the operation documentation for the appropriate value for this field.
2710
+ # @param permissions [::Array<::String>]
2711
+ # The set of permissions to check for the `resource`. Permissions with
2712
+ # wildcards (such as '*' or 'storage.*') are not allowed. For more
2713
+ # information see
2714
+ # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
2715
+ # @yield [result, operation] Access the result along with the TransportOperation object
2716
+ # @yieldparam result [::Google::Iam::V1::TestIamPermissionsResponse]
2717
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2718
+ #
2719
+ # @return [::Google::Iam::V1::TestIamPermissionsResponse]
2720
+ #
2721
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2722
+ def test_iam_permissions request, options = nil
2723
+ raise ::ArgumentError, "request must be provided" if request.nil?
2724
+
2725
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::TestIamPermissionsRequest
2726
+
2727
+ # Converts hash and nil to an options object
2728
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2729
+
2730
+ # Customize the options with defaults
2731
+ call_metadata = @config.rpcs.test_iam_permissions.metadata.to_h
2732
+
2733
+ # Set x-goog-api-client and x-goog-user-project headers
2734
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2735
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2736
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2737
+ transports_version_send: [:rest]
2738
+
2739
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2740
+
2741
+ options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
2742
+ metadata: call_metadata,
2743
+ retry_policy: @config.rpcs.test_iam_permissions.retry_policy
2744
+
2745
+ options.apply_defaults timeout: @config.timeout,
2746
+ metadata: @config.metadata,
2747
+ retry_policy: @config.retry_policy
2748
+
2749
+ @data_catalog_stub.test_iam_permissions request, options do |result, operation|
2750
+ yield result, operation if block_given?
2751
+ return result
2752
+ end
2753
+ rescue ::Gapic::Rest::Error => e
2754
+ raise ::Google::Cloud::Error.from_error(e)
2755
+ end
2756
+
2757
+ ##
2758
+ # Imports entries from a source, such as data previously dumped into a
2759
+ # Cloud Storage bucket, into Data Catalog. Import of entries
2760
+ # is a sync operation that reconciles the state of the third-party system
2761
+ # with the Data Catalog.
2762
+ #
2763
+ # `ImportEntries` accepts source data snapshots of a third-party system.
2764
+ # Snapshot should be delivered as a .wire or base65-encoded .txt file
2765
+ # containing a sequence of Protocol Buffer messages of
2766
+ # {::Google::Cloud::DataCatalog::V1::DumpItem DumpItem} type.
2767
+ #
2768
+ # `ImportEntries` returns a [long-running operation]
2769
+ # [google.longrunning.Operation] resource that can be queried with
2770
+ # Operations.GetOperation
2771
+ # to return
2772
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesMetadata ImportEntriesMetadata}
2773
+ # and an
2774
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesResponse ImportEntriesResponse}
2775
+ # message.
2776
+ #
2777
+ # @overload import_entries(request, options = nil)
2778
+ # Pass arguments to `import_entries` via a request object, either of type
2779
+ # {::Google::Cloud::DataCatalog::V1::ImportEntriesRequest} or an equivalent Hash.
2780
+ #
2781
+ # @param request [::Google::Cloud::DataCatalog::V1::ImportEntriesRequest, ::Hash]
2782
+ # A request object representing the call parameters. Required. To specify no
2783
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2784
+ # @param options [::Gapic::CallOptions, ::Hash]
2785
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2786
+ #
2787
+ # @overload import_entries(parent: nil, gcs_bucket_path: nil)
2788
+ # Pass arguments to `import_entries` via keyword arguments. Note that at
2789
+ # least one keyword argument is required. To specify no parameters, or to keep all
2790
+ # the default parameter values, pass an empty Hash as a request object (see above).
2791
+ #
2792
+ # @param parent [::String]
2793
+ # Required. Target entry group for ingested entries.
2794
+ # @param gcs_bucket_path [::String]
2795
+ # Path to a Cloud Storage bucket that contains a dump ready for ingestion.
2796
+ # @yield [result, operation] Access the result along with the TransportOperation object
2797
+ # @yieldparam result [::Gapic::Operation]
2798
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2799
+ #
2800
+ # @return [::Gapic::Operation]
2801
+ #
2802
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2803
+ def import_entries request, options = nil
2804
+ raise ::ArgumentError, "request must be provided" if request.nil?
2805
+
2806
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ImportEntriesRequest
2807
+
2808
+ # Converts hash and nil to an options object
2809
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2810
+
2811
+ # Customize the options with defaults
2812
+ call_metadata = @config.rpcs.import_entries.metadata.to_h
2813
+
2814
+ # Set x-goog-api-client and x-goog-user-project headers
2815
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2816
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2817
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
2818
+ transports_version_send: [:rest]
2819
+
2820
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2821
+
2822
+ options.apply_defaults timeout: @config.rpcs.import_entries.timeout,
2823
+ metadata: call_metadata,
2824
+ retry_policy: @config.rpcs.import_entries.retry_policy
2825
+
2826
+ options.apply_defaults timeout: @config.timeout,
2827
+ metadata: @config.metadata,
2828
+ retry_policy: @config.retry_policy
2829
+
2830
+ @data_catalog_stub.import_entries request, options do |result, operation|
2831
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2832
+ yield result, operation if block_given?
2833
+ return result
2834
+ end
2835
+ rescue ::Gapic::Rest::Error => e
2836
+ raise ::Google::Cloud::Error.from_error(e)
2837
+ end
2838
+
2839
+ ##
2840
+ # Configuration class for the DataCatalog REST API.
2841
+ #
2842
+ # This class represents the configuration for DataCatalog REST,
2843
+ # providing control over timeouts, retry behavior, logging, transport
2844
+ # parameters, and other low-level controls. Certain parameters can also be
2845
+ # applied individually to specific RPCs. See
2846
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client::Configuration::Rpcs}
2847
+ # for a list of RPCs that can be configured independently.
2848
+ #
2849
+ # Configuration can be applied globally to all clients, or to a single client
2850
+ # on construction.
2851
+ #
2852
+ # @example
2853
+ #
2854
+ # # Modify the global config, setting the timeout for
2855
+ # # search_catalog to 20 seconds,
2856
+ # # and all remaining timeouts to 10 seconds.
2857
+ # ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.configure do |config|
2858
+ # config.timeout = 10.0
2859
+ # config.rpcs.search_catalog.timeout = 20.0
2860
+ # end
2861
+ #
2862
+ # # Apply the above configuration only to a new client.
2863
+ # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new do |config|
2864
+ # config.timeout = 10.0
2865
+ # config.rpcs.search_catalog.timeout = 20.0
2866
+ # end
2867
+ #
2868
+ # @!attribute [rw] endpoint
2869
+ # The hostname or hostname:port of the service endpoint.
2870
+ # Defaults to `"datacatalog.googleapis.com"`.
2871
+ # @return [::String]
2872
+ # @!attribute [rw] credentials
2873
+ # Credentials to send with calls. You may provide any of the following types:
2874
+ # * (`String`) The path to a service account key file in JSON format
2875
+ # * (`Hash`) A service account key as a Hash
2876
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
2877
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2878
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2879
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2880
+ # * (`nil`) indicating no credentials
2881
+ # @return [::Object]
2882
+ # @!attribute [rw] scope
2883
+ # The OAuth scopes
2884
+ # @return [::Array<::String>]
2885
+ # @!attribute [rw] lib_name
2886
+ # The library name as recorded in instrumentation and logging
2887
+ # @return [::String]
2888
+ # @!attribute [rw] lib_version
2889
+ # The library version as recorded in instrumentation and logging
2890
+ # @return [::String]
2891
+ # @!attribute [rw] timeout
2892
+ # The call timeout in seconds.
2893
+ # @return [::Numeric]
2894
+ # @!attribute [rw] metadata
2895
+ # Additional headers to be sent with the call.
2896
+ # @return [::Hash{::Symbol=>::String}]
2897
+ # @!attribute [rw] retry_policy
2898
+ # The retry policy. The value is a hash with the following keys:
2899
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2900
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2901
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2902
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2903
+ # trigger a retry.
2904
+ # @return [::Hash]
2905
+ # @!attribute [rw] quota_project
2906
+ # A separate project against which to charge quota.
2907
+ # @return [::String]
2908
+ #
2909
+ class Configuration
2910
+ extend ::Gapic::Config
2911
+
2912
+ config_attr :endpoint, "datacatalog.googleapis.com", ::String
2913
+ config_attr :credentials, nil do |value|
2914
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
2915
+ allowed.any? { |klass| klass === value }
2916
+ end
2917
+ config_attr :scope, nil, ::String, ::Array, nil
2918
+ config_attr :lib_name, nil, ::String, nil
2919
+ config_attr :lib_version, nil, ::String, nil
2920
+ config_attr :timeout, nil, ::Numeric, nil
2921
+ config_attr :metadata, nil, ::Hash, nil
2922
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2923
+ config_attr :quota_project, nil, ::String, nil
2924
+
2925
+ # @private
2926
+ def initialize parent_config = nil
2927
+ @parent_config = parent_config unless parent_config.nil?
2928
+
2929
+ yield self if block_given?
2930
+ end
2931
+
2932
+ ##
2933
+ # Configurations for individual RPCs
2934
+ # @return [Rpcs]
2935
+ #
2936
+ def rpcs
2937
+ @rpcs ||= begin
2938
+ parent_rpcs = nil
2939
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
2940
+ Rpcs.new parent_rpcs
2941
+ end
2942
+ end
2943
+
2944
+ ##
2945
+ # Configuration RPC class for the DataCatalog API.
2946
+ #
2947
+ # Includes fields providing the configuration for each RPC in this service.
2948
+ # Each configuration object is of type `Gapic::Config::Method` and includes
2949
+ # the following configuration fields:
2950
+ #
2951
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
2952
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
2953
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
2954
+ # include the following keys:
2955
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2956
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2957
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2958
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2959
+ # trigger a retry.
2960
+ #
2961
+ class Rpcs
2962
+ ##
2963
+ # RPC-specific configuration for `search_catalog`
2964
+ # @return [::Gapic::Config::Method]
2965
+ #
2966
+ attr_reader :search_catalog
2967
+ ##
2968
+ # RPC-specific configuration for `create_entry_group`
2969
+ # @return [::Gapic::Config::Method]
2970
+ #
2971
+ attr_reader :create_entry_group
2972
+ ##
2973
+ # RPC-specific configuration for `get_entry_group`
2974
+ # @return [::Gapic::Config::Method]
2975
+ #
2976
+ attr_reader :get_entry_group
2977
+ ##
2978
+ # RPC-specific configuration for `update_entry_group`
2979
+ # @return [::Gapic::Config::Method]
2980
+ #
2981
+ attr_reader :update_entry_group
2982
+ ##
2983
+ # RPC-specific configuration for `delete_entry_group`
2984
+ # @return [::Gapic::Config::Method]
2985
+ #
2986
+ attr_reader :delete_entry_group
2987
+ ##
2988
+ # RPC-specific configuration for `list_entry_groups`
2989
+ # @return [::Gapic::Config::Method]
2990
+ #
2991
+ attr_reader :list_entry_groups
2992
+ ##
2993
+ # RPC-specific configuration for `create_entry`
2994
+ # @return [::Gapic::Config::Method]
2995
+ #
2996
+ attr_reader :create_entry
2997
+ ##
2998
+ # RPC-specific configuration for `update_entry`
2999
+ # @return [::Gapic::Config::Method]
3000
+ #
3001
+ attr_reader :update_entry
3002
+ ##
3003
+ # RPC-specific configuration for `delete_entry`
3004
+ # @return [::Gapic::Config::Method]
3005
+ #
3006
+ attr_reader :delete_entry
3007
+ ##
3008
+ # RPC-specific configuration for `get_entry`
3009
+ # @return [::Gapic::Config::Method]
3010
+ #
3011
+ attr_reader :get_entry
3012
+ ##
3013
+ # RPC-specific configuration for `lookup_entry`
3014
+ # @return [::Gapic::Config::Method]
3015
+ #
3016
+ attr_reader :lookup_entry
3017
+ ##
3018
+ # RPC-specific configuration for `list_entries`
3019
+ # @return [::Gapic::Config::Method]
3020
+ #
3021
+ attr_reader :list_entries
3022
+ ##
3023
+ # RPC-specific configuration for `modify_entry_overview`
3024
+ # @return [::Gapic::Config::Method]
3025
+ #
3026
+ attr_reader :modify_entry_overview
3027
+ ##
3028
+ # RPC-specific configuration for `modify_entry_contacts`
3029
+ # @return [::Gapic::Config::Method]
3030
+ #
3031
+ attr_reader :modify_entry_contacts
3032
+ ##
3033
+ # RPC-specific configuration for `create_tag_template`
3034
+ # @return [::Gapic::Config::Method]
3035
+ #
3036
+ attr_reader :create_tag_template
3037
+ ##
3038
+ # RPC-specific configuration for `get_tag_template`
3039
+ # @return [::Gapic::Config::Method]
3040
+ #
3041
+ attr_reader :get_tag_template
3042
+ ##
3043
+ # RPC-specific configuration for `update_tag_template`
3044
+ # @return [::Gapic::Config::Method]
3045
+ #
3046
+ attr_reader :update_tag_template
3047
+ ##
3048
+ # RPC-specific configuration for `delete_tag_template`
3049
+ # @return [::Gapic::Config::Method]
3050
+ #
3051
+ attr_reader :delete_tag_template
3052
+ ##
3053
+ # RPC-specific configuration for `create_tag_template_field`
3054
+ # @return [::Gapic::Config::Method]
3055
+ #
3056
+ attr_reader :create_tag_template_field
3057
+ ##
3058
+ # RPC-specific configuration for `update_tag_template_field`
3059
+ # @return [::Gapic::Config::Method]
3060
+ #
3061
+ attr_reader :update_tag_template_field
3062
+ ##
3063
+ # RPC-specific configuration for `rename_tag_template_field`
3064
+ # @return [::Gapic::Config::Method]
3065
+ #
3066
+ attr_reader :rename_tag_template_field
3067
+ ##
3068
+ # RPC-specific configuration for `rename_tag_template_field_enum_value`
3069
+ # @return [::Gapic::Config::Method]
3070
+ #
3071
+ attr_reader :rename_tag_template_field_enum_value
3072
+ ##
3073
+ # RPC-specific configuration for `delete_tag_template_field`
3074
+ # @return [::Gapic::Config::Method]
3075
+ #
3076
+ attr_reader :delete_tag_template_field
3077
+ ##
3078
+ # RPC-specific configuration for `create_tag`
3079
+ # @return [::Gapic::Config::Method]
3080
+ #
3081
+ attr_reader :create_tag
3082
+ ##
3083
+ # RPC-specific configuration for `update_tag`
3084
+ # @return [::Gapic::Config::Method]
3085
+ #
3086
+ attr_reader :update_tag
3087
+ ##
3088
+ # RPC-specific configuration for `delete_tag`
3089
+ # @return [::Gapic::Config::Method]
3090
+ #
3091
+ attr_reader :delete_tag
3092
+ ##
3093
+ # RPC-specific configuration for `list_tags`
3094
+ # @return [::Gapic::Config::Method]
3095
+ #
3096
+ attr_reader :list_tags
3097
+ ##
3098
+ # RPC-specific configuration for `reconcile_tags`
3099
+ # @return [::Gapic::Config::Method]
3100
+ #
3101
+ attr_reader :reconcile_tags
3102
+ ##
3103
+ # RPC-specific configuration for `star_entry`
3104
+ # @return [::Gapic::Config::Method]
3105
+ #
3106
+ attr_reader :star_entry
3107
+ ##
3108
+ # RPC-specific configuration for `unstar_entry`
3109
+ # @return [::Gapic::Config::Method]
3110
+ #
3111
+ attr_reader :unstar_entry
3112
+ ##
3113
+ # RPC-specific configuration for `set_iam_policy`
3114
+ # @return [::Gapic::Config::Method]
3115
+ #
3116
+ attr_reader :set_iam_policy
3117
+ ##
3118
+ # RPC-specific configuration for `get_iam_policy`
3119
+ # @return [::Gapic::Config::Method]
3120
+ #
3121
+ attr_reader :get_iam_policy
3122
+ ##
3123
+ # RPC-specific configuration for `test_iam_permissions`
3124
+ # @return [::Gapic::Config::Method]
3125
+ #
3126
+ attr_reader :test_iam_permissions
3127
+ ##
3128
+ # RPC-specific configuration for `import_entries`
3129
+ # @return [::Gapic::Config::Method]
3130
+ #
3131
+ attr_reader :import_entries
3132
+
3133
+ # @private
3134
+ def initialize parent_rpcs = nil
3135
+ search_catalog_config = parent_rpcs.search_catalog if parent_rpcs.respond_to? :search_catalog
3136
+ @search_catalog = ::Gapic::Config::Method.new search_catalog_config
3137
+ create_entry_group_config = parent_rpcs.create_entry_group if parent_rpcs.respond_to? :create_entry_group
3138
+ @create_entry_group = ::Gapic::Config::Method.new create_entry_group_config
3139
+ get_entry_group_config = parent_rpcs.get_entry_group if parent_rpcs.respond_to? :get_entry_group
3140
+ @get_entry_group = ::Gapic::Config::Method.new get_entry_group_config
3141
+ update_entry_group_config = parent_rpcs.update_entry_group if parent_rpcs.respond_to? :update_entry_group
3142
+ @update_entry_group = ::Gapic::Config::Method.new update_entry_group_config
3143
+ delete_entry_group_config = parent_rpcs.delete_entry_group if parent_rpcs.respond_to? :delete_entry_group
3144
+ @delete_entry_group = ::Gapic::Config::Method.new delete_entry_group_config
3145
+ list_entry_groups_config = parent_rpcs.list_entry_groups if parent_rpcs.respond_to? :list_entry_groups
3146
+ @list_entry_groups = ::Gapic::Config::Method.new list_entry_groups_config
3147
+ create_entry_config = parent_rpcs.create_entry if parent_rpcs.respond_to? :create_entry
3148
+ @create_entry = ::Gapic::Config::Method.new create_entry_config
3149
+ update_entry_config = parent_rpcs.update_entry if parent_rpcs.respond_to? :update_entry
3150
+ @update_entry = ::Gapic::Config::Method.new update_entry_config
3151
+ delete_entry_config = parent_rpcs.delete_entry if parent_rpcs.respond_to? :delete_entry
3152
+ @delete_entry = ::Gapic::Config::Method.new delete_entry_config
3153
+ get_entry_config = parent_rpcs.get_entry if parent_rpcs.respond_to? :get_entry
3154
+ @get_entry = ::Gapic::Config::Method.new get_entry_config
3155
+ lookup_entry_config = parent_rpcs.lookup_entry if parent_rpcs.respond_to? :lookup_entry
3156
+ @lookup_entry = ::Gapic::Config::Method.new lookup_entry_config
3157
+ list_entries_config = parent_rpcs.list_entries if parent_rpcs.respond_to? :list_entries
3158
+ @list_entries = ::Gapic::Config::Method.new list_entries_config
3159
+ modify_entry_overview_config = parent_rpcs.modify_entry_overview if parent_rpcs.respond_to? :modify_entry_overview
3160
+ @modify_entry_overview = ::Gapic::Config::Method.new modify_entry_overview_config
3161
+ modify_entry_contacts_config = parent_rpcs.modify_entry_contacts if parent_rpcs.respond_to? :modify_entry_contacts
3162
+ @modify_entry_contacts = ::Gapic::Config::Method.new modify_entry_contacts_config
3163
+ create_tag_template_config = parent_rpcs.create_tag_template if parent_rpcs.respond_to? :create_tag_template
3164
+ @create_tag_template = ::Gapic::Config::Method.new create_tag_template_config
3165
+ get_tag_template_config = parent_rpcs.get_tag_template if parent_rpcs.respond_to? :get_tag_template
3166
+ @get_tag_template = ::Gapic::Config::Method.new get_tag_template_config
3167
+ update_tag_template_config = parent_rpcs.update_tag_template if parent_rpcs.respond_to? :update_tag_template
3168
+ @update_tag_template = ::Gapic::Config::Method.new update_tag_template_config
3169
+ delete_tag_template_config = parent_rpcs.delete_tag_template if parent_rpcs.respond_to? :delete_tag_template
3170
+ @delete_tag_template = ::Gapic::Config::Method.new delete_tag_template_config
3171
+ create_tag_template_field_config = parent_rpcs.create_tag_template_field if parent_rpcs.respond_to? :create_tag_template_field
3172
+ @create_tag_template_field = ::Gapic::Config::Method.new create_tag_template_field_config
3173
+ update_tag_template_field_config = parent_rpcs.update_tag_template_field if parent_rpcs.respond_to? :update_tag_template_field
3174
+ @update_tag_template_field = ::Gapic::Config::Method.new update_tag_template_field_config
3175
+ rename_tag_template_field_config = parent_rpcs.rename_tag_template_field if parent_rpcs.respond_to? :rename_tag_template_field
3176
+ @rename_tag_template_field = ::Gapic::Config::Method.new rename_tag_template_field_config
3177
+ rename_tag_template_field_enum_value_config = parent_rpcs.rename_tag_template_field_enum_value if parent_rpcs.respond_to? :rename_tag_template_field_enum_value
3178
+ @rename_tag_template_field_enum_value = ::Gapic::Config::Method.new rename_tag_template_field_enum_value_config
3179
+ delete_tag_template_field_config = parent_rpcs.delete_tag_template_field if parent_rpcs.respond_to? :delete_tag_template_field
3180
+ @delete_tag_template_field = ::Gapic::Config::Method.new delete_tag_template_field_config
3181
+ create_tag_config = parent_rpcs.create_tag if parent_rpcs.respond_to? :create_tag
3182
+ @create_tag = ::Gapic::Config::Method.new create_tag_config
3183
+ update_tag_config = parent_rpcs.update_tag if parent_rpcs.respond_to? :update_tag
3184
+ @update_tag = ::Gapic::Config::Method.new update_tag_config
3185
+ delete_tag_config = parent_rpcs.delete_tag if parent_rpcs.respond_to? :delete_tag
3186
+ @delete_tag = ::Gapic::Config::Method.new delete_tag_config
3187
+ list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
3188
+ @list_tags = ::Gapic::Config::Method.new list_tags_config
3189
+ reconcile_tags_config = parent_rpcs.reconcile_tags if parent_rpcs.respond_to? :reconcile_tags
3190
+ @reconcile_tags = ::Gapic::Config::Method.new reconcile_tags_config
3191
+ star_entry_config = parent_rpcs.star_entry if parent_rpcs.respond_to? :star_entry
3192
+ @star_entry = ::Gapic::Config::Method.new star_entry_config
3193
+ unstar_entry_config = parent_rpcs.unstar_entry if parent_rpcs.respond_to? :unstar_entry
3194
+ @unstar_entry = ::Gapic::Config::Method.new unstar_entry_config
3195
+ set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
3196
+ @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
3197
+ get_iam_policy_config = parent_rpcs.get_iam_policy if parent_rpcs.respond_to? :get_iam_policy
3198
+ @get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
3199
+ test_iam_permissions_config = parent_rpcs.test_iam_permissions if parent_rpcs.respond_to? :test_iam_permissions
3200
+ @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
3201
+ import_entries_config = parent_rpcs.import_entries if parent_rpcs.respond_to? :import_entries
3202
+ @import_entries = ::Gapic::Config::Method.new import_entries_config
3203
+
3204
+ yield self if block_given?
3205
+ end
3206
+ end
3207
+ end
3208
+ end
3209
+ end
3210
+ end
3211
+ end
3212
+ end
3213
+ end
3214
+ end