google-apis-dataplex_v1 0.19.0 → 0.21.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.
@@ -122,6 +122,121 @@ module Google
122
122
  execute_or_queue_command(command, &block)
123
123
  end
124
124
 
125
+ # Create a DataAttributeBinding resource.
126
+ # @param [String] parent
127
+ # Required. The resource name of the parent data taxonomy projects/`
128
+ # project_number`/locations/`location_id`
129
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding] google_cloud_dataplex_v1_data_attribute_binding_object
130
+ # @param [String] data_attribute_binding_id
131
+ # Required. DataAttributeBinding identifier. * Must contain only lowercase
132
+ # letters, numbers and hyphens. * Must start with a letter. * Must be between 1-
133
+ # 63 characters. * Must end with a number or a letter. * Must be unique within
134
+ # the Location.
135
+ # @param [Boolean] validate_only
136
+ # Optional. Only validate the request, but do not perform mutations. The default
137
+ # is false.
138
+ # @param [String] fields
139
+ # Selector specifying which fields to include in a partial response.
140
+ # @param [String] quota_user
141
+ # Available to use for quota purposes for server-side applications. Can be any
142
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
143
+ # @param [Google::Apis::RequestOptions] options
144
+ # Request-specific options
145
+ #
146
+ # @yield [result, err] Result & error if block supplied
147
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
148
+ # @yieldparam err [StandardError] error object if request failed
149
+ #
150
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
151
+ #
152
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
153
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
154
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
155
+ def create_project_location_data_attribute_binding(parent, google_cloud_dataplex_v1_data_attribute_binding_object = nil, data_attribute_binding_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
156
+ command = make_simple_command(:post, 'v1/{+parent}/dataAttributeBindings', options)
157
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding::Representation
158
+ command.request_object = google_cloud_dataplex_v1_data_attribute_binding_object
159
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
160
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
161
+ command.params['parent'] = parent unless parent.nil?
162
+ command.query['dataAttributeBindingId'] = data_attribute_binding_id unless data_attribute_binding_id.nil?
163
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
164
+ command.query['fields'] = fields unless fields.nil?
165
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
166
+ execute_or_queue_command(command, &block)
167
+ end
168
+
169
+ # Deletes a DataAttributeBinding resource. All attributes within the
170
+ # DataAttributeBinding must be deleted before the DataAttributeBinding can be
171
+ # deleted.
172
+ # @param [String] name
173
+ # Required. The resource name of the DataAttributeBinding: projects/`
174
+ # project_number`/locations/`location_id`/dataAttributeBindings/`
175
+ # data_attribute_binding_id`
176
+ # @param [String] etag
177
+ # Required. If the client provided etag value does not match the current etag
178
+ # value, the DeleteDataAttributeBindingRequest method returns an ABORTED error
179
+ # response. Etags must be used when calling the DeleteDataAttributeBinding.
180
+ # @param [String] fields
181
+ # Selector specifying which fields to include in a partial response.
182
+ # @param [String] quota_user
183
+ # Available to use for quota purposes for server-side applications. Can be any
184
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
185
+ # @param [Google::Apis::RequestOptions] options
186
+ # Request-specific options
187
+ #
188
+ # @yield [result, err] Result & error if block supplied
189
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
190
+ # @yieldparam err [StandardError] error object if request failed
191
+ #
192
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
193
+ #
194
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
195
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
196
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
197
+ def delete_project_location_data_attribute_binding(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
198
+ command = make_simple_command(:delete, 'v1/{+name}', options)
199
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
200
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
201
+ command.params['name'] = name unless name.nil?
202
+ command.query['etag'] = etag unless etag.nil?
203
+ command.query['fields'] = fields unless fields.nil?
204
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
205
+ execute_or_queue_command(command, &block)
206
+ end
207
+
208
+ # Retrieves a DataAttributeBinding resource.
209
+ # @param [String] name
210
+ # Required. The resource name of the DataAttributeBinding: projects/`
211
+ # project_number`/locations/`location_id`/dataAttributeBindings/`
212
+ # data_attribute_binding_id`
213
+ # @param [String] fields
214
+ # Selector specifying which fields to include in a partial response.
215
+ # @param [String] quota_user
216
+ # Available to use for quota purposes for server-side applications. Can be any
217
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
218
+ # @param [Google::Apis::RequestOptions] options
219
+ # Request-specific options
220
+ #
221
+ # @yield [result, err] Result & error if block supplied
222
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding] parsed result object
223
+ # @yieldparam err [StandardError] error object if request failed
224
+ #
225
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding]
226
+ #
227
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
228
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
229
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
230
+ def get_project_location_data_attribute_binding(name, fields: nil, quota_user: nil, options: nil, &block)
231
+ command = make_simple_command(:get, 'v1/{+name}', options)
232
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding::Representation
233
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding
234
+ command.params['name'] = name unless name.nil?
235
+ command.query['fields'] = fields unless fields.nil?
236
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
237
+ execute_or_queue_command(command, &block)
238
+ end
239
+
125
240
  # Gets the access control policy for a resource. Returns an empty policy if the
126
241
  # resource exists and does not have a policy set.
127
242
  # @param [String] resource
@@ -167,6 +282,99 @@ module Google
167
282
  execute_or_queue_command(command, &block)
168
283
  end
169
284
 
285
+ # Lists DataAttributeBinding resources in a project and location.
286
+ # @param [String] parent
287
+ # Required. The resource name of the Location: projects/`project_number`/
288
+ # locations/`location_id`
289
+ # @param [String] filter
290
+ # Optional. Filter request. Filter using resource: filter=resource:"resource-
291
+ # name" Filter using attribute: filter=attributes:"attribute-name" Filter using
292
+ # attribute in paths list: filter=paths.attributes:"attribute-name"
293
+ # @param [String] order_by
294
+ # Optional. Order by fields for the result.
295
+ # @param [Fixnum] page_size
296
+ # Optional. Maximum number of DataAttributeBindings to return. The service may
297
+ # return fewer than this value. If unspecified, at most 10 DataAttributeBindings
298
+ # will be returned. The maximum value is 1000; values above 1000 will be coerced
299
+ # to 1000.
300
+ # @param [String] page_token
301
+ # Optional. Page token received from a previous ListDataAttributeBindings call.
302
+ # Provide this to retrieve the subsequent page. When paginating, all other
303
+ # parameters provided to ListDataAttributeBindings must match the call that
304
+ # provided the page token.
305
+ # @param [String] fields
306
+ # Selector specifying which fields to include in a partial response.
307
+ # @param [String] quota_user
308
+ # Available to use for quota purposes for server-side applications. Can be any
309
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
310
+ # @param [Google::Apis::RequestOptions] options
311
+ # Request-specific options
312
+ #
313
+ # @yield [result, err] Result & error if block supplied
314
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributeBindingsResponse] parsed result object
315
+ # @yieldparam err [StandardError] error object if request failed
316
+ #
317
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributeBindingsResponse]
318
+ #
319
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
320
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
321
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
322
+ def list_project_location_data_attribute_bindings(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
323
+ command = make_simple_command(:get, 'v1/{+parent}/dataAttributeBindings', options)
324
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributeBindingsResponse::Representation
325
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributeBindingsResponse
326
+ command.params['parent'] = parent unless parent.nil?
327
+ command.query['filter'] = filter unless filter.nil?
328
+ command.query['orderBy'] = order_by unless order_by.nil?
329
+ command.query['pageSize'] = page_size unless page_size.nil?
330
+ command.query['pageToken'] = page_token unless page_token.nil?
331
+ command.query['fields'] = fields unless fields.nil?
332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
333
+ execute_or_queue_command(command, &block)
334
+ end
335
+
336
+ # Updates a DataAttributeBinding resource.
337
+ # @param [String] name
338
+ # Output only. The relative resource name of the Data Attribute Binding, of the
339
+ # form: projects/`project_number`/locations/`location`/dataAttributeBindings/`
340
+ # data_attribute_binding_id`
341
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding] google_cloud_dataplex_v1_data_attribute_binding_object
342
+ # @param [String] update_mask
343
+ # Required. Mask of fields to update.
344
+ # @param [Boolean] validate_only
345
+ # Optional. Only validate the request, but do not perform mutations. The default
346
+ # is false.
347
+ # @param [String] fields
348
+ # Selector specifying which fields to include in a partial response.
349
+ # @param [String] quota_user
350
+ # Available to use for quota purposes for server-side applications. Can be any
351
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
352
+ # @param [Google::Apis::RequestOptions] options
353
+ # Request-specific options
354
+ #
355
+ # @yield [result, err] Result & error if block supplied
356
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
357
+ # @yieldparam err [StandardError] error object if request failed
358
+ #
359
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
360
+ #
361
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
362
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
363
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
364
+ def patch_project_location_data_attribute_binding(name, google_cloud_dataplex_v1_data_attribute_binding_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
365
+ command = make_simple_command(:patch, 'v1/{+name}', options)
366
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttributeBinding::Representation
367
+ command.request_object = google_cloud_dataplex_v1_data_attribute_binding_object
368
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
369
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
370
+ command.params['name'] = name unless name.nil?
371
+ command.query['updateMask'] = update_mask unless update_mask.nil?
372
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
373
+ command.query['fields'] = fields unless fields.nil?
374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
375
+ execute_or_queue_command(command, &block)
376
+ end
377
+
170
378
  # Sets the access control policy on the specified resource. Replaces any
171
379
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
172
380
  # errors.
@@ -243,17 +451,17 @@ module Google
243
451
  execute_or_queue_command(command, &block)
244
452
  end
245
453
 
246
- # Creates a dataScan resource.
454
+ # Creates a DataScan resource.
247
455
  # @param [String] parent
248
456
  # Required. The resource name of the parent location: projects/`project`/
249
- # locations/`location_id` where `project` refers to a project_id or
250
- # project_number and location_id refers to a GCP region.
457
+ # locations/`location_id` where project refers to a project_id or project_number
458
+ # and location_id refers to a GCP region.
251
459
  # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataScan] google_cloud_dataplex_v1_data_scan_object
252
460
  # @param [String] data_scan_id
253
- # Required. DataScan identifier. * Must contain only lowercase letters, numbers
254
- # and hyphens. * Must start with a letter. * Must end with a number or a letter.
255
- # * Must be between 1-63 characters. * Must be unique within the customer
256
- # project / location.
461
+ # Required. DataScan identifier. Must contain only lowercase letters, numbers
462
+ # and hyphens. Must start with a letter. Must end with a number or a letter.
463
+ # Must be between 1-63 characters. Must be unique within the customer project /
464
+ # location.
257
465
  # @param [String] fields
258
466
  # Selector specifying which fields to include in a partial response.
259
467
  # @param [String] quota_user
@@ -284,11 +492,11 @@ module Google
284
492
  execute_or_queue_command(command, &block)
285
493
  end
286
494
 
287
- # Delete the dataScan resource.
495
+ # Deletes a DataScan resource.
288
496
  # @param [String] name
289
497
  # Required. The resource name of the dataScan: projects/`project`/locations/`
290
- # location_id`/dataScans/`data_scan_id` where `project` refers to a project_id
291
- # or project_number and location_id refers to a GCP region.
498
+ # location_id`/dataScans/`data_scan_id` where project refers to a project_id or
499
+ # project_number and location_id refers to a GCP region.
292
500
  # @param [String] fields
293
501
  # Selector specifying which fields to include in a partial response.
294
502
  # @param [String] quota_user
@@ -316,14 +524,13 @@ module Google
316
524
  execute_or_queue_command(command, &block)
317
525
  end
318
526
 
319
- # Get dataScan resource.
527
+ # Gets a DataScan resource.
320
528
  # @param [String] name
321
529
  # Required. The resource name of the dataScan: projects/`project`/locations/`
322
- # location_id`/dataScans/`data_scan_id` where `project` refers to a project_id
323
- # or project_number and location_id refers to a GCP region.
530
+ # location_id`/dataScans/`data_scan_id` where project refers to a project_id or
531
+ # project_number and location_id refers to a GCP region.
324
532
  # @param [String] view
325
- # Optional. Used to select the subset of DataScan information to return.
326
- # Defaults to BASIC.
533
+ # Optional. Select the DataScan view to return. Defaults to BASIC.
327
534
  # @param [String] fields
328
535
  # Selector specifying which fields to include in a partial response.
329
536
  # @param [String] quota_user
@@ -397,10 +604,11 @@ module Google
397
604
  execute_or_queue_command(command, &block)
398
605
  end
399
606
 
400
- # Lists dataScans.
607
+ # Lists DataScans.
401
608
  # @param [String] parent
402
- # Required. projects/`project`/locations/`location_id` where `project` refers to
403
- # a project_id or project_number and location_id refers to a GCP region.
609
+ # Required. The resource name of the parent location: projects/`project`/
610
+ # locations/`location_id` where project refers to a project_id or project_number
611
+ # and location_id refers to a GCP region.
404
612
  # @param [String] filter
405
613
  # Optional. Filter request.
406
614
  # @param [String] order_by
@@ -445,12 +653,11 @@ module Google
445
653
  execute_or_queue_command(command, &block)
446
654
  end
447
655
 
448
- # Update the dataScan resource.
656
+ # Updates a DataScan resource.
449
657
  # @param [String] name
450
658
  # Output only. The relative resource name of the scan, of the form: projects/`
451
- # project`/locations/`location_id`/dataScans/`datascan_id`. where `project`
452
- # refers to a project_id or project_number and location_id refers to a GCP
453
- # region.
659
+ # project`/locations/`location_id`/dataScans/`datascan_id`, where project refers
660
+ # to a project_id or project_number and location_id refers to a GCP region.
454
661
  # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataScan] google_cloud_dataplex_v1_data_scan_object
455
662
  # @param [String] update_mask
456
663
  # Required. Mask of fields to update.
@@ -484,12 +691,12 @@ module Google
484
691
  execute_or_queue_command(command, &block)
485
692
  end
486
693
 
487
- # Run an on demand execution of a DataScan.
694
+ # Runs an on-demand execution of a DataScan
488
695
  # @param [String] name
489
696
  # Required. The resource name of the DataScan: projects/`project`/locations/`
490
- # location_id`/dataScans/`data_scan_id`. where `project` refers to a project_id
491
- # or project_number and location_id refers to a GCP region. Only on-demand
492
- # DataScans are allowed.
697
+ # location_id`/dataScans/`data_scan_id`. where project refers to a project_id or
698
+ # project_number and location_id refers to a GCP region.Only OnDemand data scans
699
+ # are allowed.
493
700
  # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1RunDataScanRequest] google_cloud_dataplex_v1_run_data_scan_request_object
494
701
  # @param [String] fields
495
702
  # Selector specifying which fields to include in a partial response.
@@ -596,15 +803,14 @@ module Google
596
803
  execute_or_queue_command(command, &block)
597
804
  end
598
805
 
599
- # Get DataScanJob resource.
806
+ # Gets a DataScanJob resource.
600
807
  # @param [String] name
601
808
  # Required. The resource name of the DataScanJob: projects/`project`/locations/`
602
- # location_id`/dataScans/`data_scan_id`/dataScanJobs/`data_scan_job_id` where `
603
- # project` refers to a project_id or project_number and location_id refers to a
809
+ # location_id`/dataScans/`data_scan_id`/dataScanJobs/`data_scan_job_id` where
810
+ # project refers to a project_id or project_number and location_id refers to a
604
811
  # GCP region.
605
812
  # @param [String] view
606
- # Optional. Used to select the subset of DataScan information to return.
607
- # Defaults to BASIC.
813
+ # Optional. Select the DataScanJob view to return. Defaults to BASIC.
608
814
  # @param [String] fields
609
815
  # Selector specifying which fields to include in a partial response.
610
816
  # @param [String] quota_user
@@ -633,10 +839,10 @@ module Google
633
839
  execute_or_queue_command(command, &block)
634
840
  end
635
841
 
636
- # Lists DataScanJobs under the given dataScan.
842
+ # Lists DataScanJobs under the given DataScan.
637
843
  # @param [String] parent
638
844
  # Required. The resource name of the parent environment: projects/`project`/
639
- # locations/`location_id`/dataScans/`data_scan_id` where `project` refers to a
845
+ # locations/`location_id`/dataScans/`data_scan_id` where project refers to a
640
846
  # project_id or project_number and location_id refers to a GCP region.
641
847
  # @param [Fixnum] page_size
642
848
  # Optional. Maximum number of DataScanJobs to return. The service may return
@@ -675,6 +881,118 @@ module Google
675
881
  execute_or_queue_command(command, &block)
676
882
  end
677
883
 
884
+ # Create a DataTaxonomy resource.
885
+ # @param [String] parent
886
+ # Required. The resource name of the data taxonomy location, of the form:
887
+ # projects/`project_number`/locations/`location_id` where location_id refers to
888
+ # a GCP region.
889
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy] google_cloud_dataplex_v1_data_taxonomy_object
890
+ # @param [String] data_taxonomy_id
891
+ # Required. DataTaxonomy identifier. * Must contain only lowercase letters,
892
+ # numbers and hyphens. * Must start with a letter. * Must be between 1-63
893
+ # characters. * Must end with a number or a letter. * Must be unique within the
894
+ # Project.
895
+ # @param [Boolean] validate_only
896
+ # Optional. Only validate the request, but do not perform mutations. The default
897
+ # is false.
898
+ # @param [String] fields
899
+ # Selector specifying which fields to include in a partial response.
900
+ # @param [String] quota_user
901
+ # Available to use for quota purposes for server-side applications. Can be any
902
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
903
+ # @param [Google::Apis::RequestOptions] options
904
+ # Request-specific options
905
+ #
906
+ # @yield [result, err] Result & error if block supplied
907
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
908
+ # @yieldparam err [StandardError] error object if request failed
909
+ #
910
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
911
+ #
912
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
913
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
914
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
915
+ def create_project_location_data_taxonomy(parent, google_cloud_dataplex_v1_data_taxonomy_object = nil, data_taxonomy_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
916
+ command = make_simple_command(:post, 'v1/{+parent}/dataTaxonomies', options)
917
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy::Representation
918
+ command.request_object = google_cloud_dataplex_v1_data_taxonomy_object
919
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
920
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
921
+ command.params['parent'] = parent unless parent.nil?
922
+ command.query['dataTaxonomyId'] = data_taxonomy_id unless data_taxonomy_id.nil?
923
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
924
+ command.query['fields'] = fields unless fields.nil?
925
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
926
+ execute_or_queue_command(command, &block)
927
+ end
928
+
929
+ # Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must
930
+ # be deleted before the DataTaxonomy can be deleted.
931
+ # @param [String] name
932
+ # Required. The resource name of the DataTaxonomy: projects/`project_number`/
933
+ # locations/`location_id`/dataTaxonomies/`data_taxonomy_id`
934
+ # @param [String] etag
935
+ # Optional. If the client provided etag value does not match the current etag
936
+ # value,the DeleteDataTaxonomy method returns an ABORTED error.
937
+ # @param [String] fields
938
+ # Selector specifying which fields to include in a partial response.
939
+ # @param [String] quota_user
940
+ # Available to use for quota purposes for server-side applications. Can be any
941
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
942
+ # @param [Google::Apis::RequestOptions] options
943
+ # Request-specific options
944
+ #
945
+ # @yield [result, err] Result & error if block supplied
946
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
947
+ # @yieldparam err [StandardError] error object if request failed
948
+ #
949
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
950
+ #
951
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
952
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
953
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
954
+ def delete_project_location_data_taxonomy(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
955
+ command = make_simple_command(:delete, 'v1/{+name}', options)
956
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
957
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
958
+ command.params['name'] = name unless name.nil?
959
+ command.query['etag'] = etag unless etag.nil?
960
+ command.query['fields'] = fields unless fields.nil?
961
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
962
+ execute_or_queue_command(command, &block)
963
+ end
964
+
965
+ # Retrieves a DataTaxonomy resource.
966
+ # @param [String] name
967
+ # Required. The resource name of the DataTaxonomy: projects/`project_number`/
968
+ # locations/`location_id`/dataTaxonomies/`data_taxonomy_id`
969
+ # @param [String] fields
970
+ # Selector specifying which fields to include in a partial response.
971
+ # @param [String] quota_user
972
+ # Available to use for quota purposes for server-side applications. Can be any
973
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
974
+ # @param [Google::Apis::RequestOptions] options
975
+ # Request-specific options
976
+ #
977
+ # @yield [result, err] Result & error if block supplied
978
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy] parsed result object
979
+ # @yieldparam err [StandardError] error object if request failed
980
+ #
981
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy]
982
+ #
983
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
984
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
985
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
986
+ def get_project_location_data_taxonomy(name, fields: nil, quota_user: nil, options: nil, &block)
987
+ command = make_simple_command(:get, 'v1/{+name}', options)
988
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy::Representation
989
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy
990
+ command.params['name'] = name unless name.nil?
991
+ command.query['fields'] = fields unless fields.nil?
992
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
993
+ execute_or_queue_command(command, &block)
994
+ end
995
+
678
996
  # Gets the access control policy for a resource. Returns an empty policy if the
679
997
  # resource exists and does not have a policy set.
680
998
  # @param [String] resource
@@ -720,6 +1038,97 @@ module Google
720
1038
  execute_or_queue_command(command, &block)
721
1039
  end
722
1040
 
1041
+ # Lists DataTaxonomy resources in a project and location.
1042
+ # @param [String] parent
1043
+ # Required. The resource name of the DataTaxonomy location, of the form:
1044
+ # projects/`project_number`/locations/`location_id` where location_id refers to
1045
+ # a GCP region.
1046
+ # @param [String] filter
1047
+ # Optional. Filter request.
1048
+ # @param [String] order_by
1049
+ # Optional. Order by fields for the result.
1050
+ # @param [Fixnum] page_size
1051
+ # Optional. Maximum number of DataTaxonomies to return. The service may return
1052
+ # fewer than this value. If unspecified, at most 10 DataTaxonomies will be
1053
+ # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
1054
+ # @param [String] page_token
1055
+ # Optional. Page token received from a previous ListDataTaxonomies call. Provide
1056
+ # this to retrieve the subsequent page. When paginating, all other parameters
1057
+ # provided to ListDataTaxonomies must match the call that provided the page
1058
+ # token.
1059
+ # @param [String] fields
1060
+ # Selector specifying which fields to include in a partial response.
1061
+ # @param [String] quota_user
1062
+ # Available to use for quota purposes for server-side applications. Can be any
1063
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1064
+ # @param [Google::Apis::RequestOptions] options
1065
+ # Request-specific options
1066
+ #
1067
+ # @yield [result, err] Result & error if block supplied
1068
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataTaxonomiesResponse] parsed result object
1069
+ # @yieldparam err [StandardError] error object if request failed
1070
+ #
1071
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataTaxonomiesResponse]
1072
+ #
1073
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1074
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1075
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1076
+ def list_project_location_data_taxonomies(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1077
+ command = make_simple_command(:get, 'v1/{+parent}/dataTaxonomies', options)
1078
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataTaxonomiesResponse::Representation
1079
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataTaxonomiesResponse
1080
+ command.params['parent'] = parent unless parent.nil?
1081
+ command.query['filter'] = filter unless filter.nil?
1082
+ command.query['orderBy'] = order_by unless order_by.nil?
1083
+ command.query['pageSize'] = page_size unless page_size.nil?
1084
+ command.query['pageToken'] = page_token unless page_token.nil?
1085
+ command.query['fields'] = fields unless fields.nil?
1086
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1087
+ execute_or_queue_command(command, &block)
1088
+ end
1089
+
1090
+ # Updates a DataTaxonomy resource.
1091
+ # @param [String] name
1092
+ # Output only. The relative resource name of the DataTaxonomy, of the form:
1093
+ # projects/`project_number`/locations/`location_id`/dataTaxonomies/`
1094
+ # data_taxonomy_id`.
1095
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy] google_cloud_dataplex_v1_data_taxonomy_object
1096
+ # @param [String] update_mask
1097
+ # Required. Mask of fields to update.
1098
+ # @param [Boolean] validate_only
1099
+ # Optional. Only validate the request, but do not perform mutations. The default
1100
+ # is false.
1101
+ # @param [String] fields
1102
+ # Selector specifying which fields to include in a partial response.
1103
+ # @param [String] quota_user
1104
+ # Available to use for quota purposes for server-side applications. Can be any
1105
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1106
+ # @param [Google::Apis::RequestOptions] options
1107
+ # Request-specific options
1108
+ #
1109
+ # @yield [result, err] Result & error if block supplied
1110
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1111
+ # @yieldparam err [StandardError] error object if request failed
1112
+ #
1113
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1114
+ #
1115
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1116
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1117
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1118
+ def patch_project_location_data_taxonomy(name, google_cloud_dataplex_v1_data_taxonomy_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1119
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1120
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataTaxonomy::Representation
1121
+ command.request_object = google_cloud_dataplex_v1_data_taxonomy_object
1122
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1123
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1124
+ command.params['name'] = name unless name.nil?
1125
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1126
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1127
+ command.query['fields'] = fields unless fields.nil?
1128
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1129
+ execute_or_queue_command(command, &block)
1130
+ end
1131
+
723
1132
  # Sets the access control policy on the specified resource. Replaces any
724
1133
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
725
1134
  # errors.
@@ -796,6 +1205,118 @@ module Google
796
1205
  execute_or_queue_command(command, &block)
797
1206
  end
798
1207
 
1208
+ # Create a DataAttribute resource.
1209
+ # @param [String] parent
1210
+ # Required. The resource name of the parent data taxonomy projects/`
1211
+ # project_number`/locations/`location_id`/dataTaxonomies/`data_taxonomy_id`
1212
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute] google_cloud_dataplex_v1_data_attribute_object
1213
+ # @param [String] data_attribute_id
1214
+ # Required. DataAttribute identifier. * Must contain only lowercase letters,
1215
+ # numbers and hyphens. * Must start with a letter. * Must be between 1-63
1216
+ # characters. * Must end with a number or a letter. * Must be unique within the
1217
+ # DataTaxonomy.
1218
+ # @param [Boolean] validate_only
1219
+ # Optional. Only validate the request, but do not perform mutations. The default
1220
+ # is false.
1221
+ # @param [String] fields
1222
+ # Selector specifying which fields to include in a partial response.
1223
+ # @param [String] quota_user
1224
+ # Available to use for quota purposes for server-side applications. Can be any
1225
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1226
+ # @param [Google::Apis::RequestOptions] options
1227
+ # Request-specific options
1228
+ #
1229
+ # @yield [result, err] Result & error if block supplied
1230
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1231
+ # @yieldparam err [StandardError] error object if request failed
1232
+ #
1233
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1234
+ #
1235
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1236
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1237
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1238
+ def create_project_location_data_taxonomy_attribute(parent, google_cloud_dataplex_v1_data_attribute_object = nil, data_attribute_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1239
+ command = make_simple_command(:post, 'v1/{+parent}/attributes', options)
1240
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute::Representation
1241
+ command.request_object = google_cloud_dataplex_v1_data_attribute_object
1242
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1243
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1244
+ command.params['parent'] = parent unless parent.nil?
1245
+ command.query['dataAttributeId'] = data_attribute_id unless data_attribute_id.nil?
1246
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1247
+ command.query['fields'] = fields unless fields.nil?
1248
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1249
+ execute_or_queue_command(command, &block)
1250
+ end
1251
+
1252
+ # Deletes a Data Attribute resource.
1253
+ # @param [String] name
1254
+ # Required. The resource name of the DataAttribute: projects/`project_number`/
1255
+ # locations/`location_id`/dataTaxonomies/`dataTaxonomy`/attributes/`
1256
+ # data_attribute_id`
1257
+ # @param [String] etag
1258
+ # Optional. If the client provided etag value does not match the current etag
1259
+ # value, the DeleteDataAttribute method returns an ABORTED error response.
1260
+ # @param [String] fields
1261
+ # Selector specifying which fields to include in a partial response.
1262
+ # @param [String] quota_user
1263
+ # Available to use for quota purposes for server-side applications. Can be any
1264
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1265
+ # @param [Google::Apis::RequestOptions] options
1266
+ # Request-specific options
1267
+ #
1268
+ # @yield [result, err] Result & error if block supplied
1269
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1270
+ # @yieldparam err [StandardError] error object if request failed
1271
+ #
1272
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1273
+ #
1274
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1275
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1276
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1277
+ def delete_project_location_data_taxonomy_attribute(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
1278
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1279
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1280
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1281
+ command.params['name'] = name unless name.nil?
1282
+ command.query['etag'] = etag unless etag.nil?
1283
+ command.query['fields'] = fields unless fields.nil?
1284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1285
+ execute_or_queue_command(command, &block)
1286
+ end
1287
+
1288
+ # Retrieves a Data Attribute resource.
1289
+ # @param [String] name
1290
+ # Required. The resource name of the dataAttribute: projects/`project_number`/
1291
+ # locations/`location_id`/dataTaxonomies/`dataTaxonomy`/attributes/`
1292
+ # data_attribute_id`
1293
+ # @param [String] fields
1294
+ # Selector specifying which fields to include in a partial response.
1295
+ # @param [String] quota_user
1296
+ # Available to use for quota purposes for server-side applications. Can be any
1297
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1298
+ # @param [Google::Apis::RequestOptions] options
1299
+ # Request-specific options
1300
+ #
1301
+ # @yield [result, err] Result & error if block supplied
1302
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute] parsed result object
1303
+ # @yieldparam err [StandardError] error object if request failed
1304
+ #
1305
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute]
1306
+ #
1307
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1308
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1309
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1310
+ def get_project_location_data_taxonomy_attribute(name, fields: nil, quota_user: nil, options: nil, &block)
1311
+ command = make_simple_command(:get, 'v1/{+name}', options)
1312
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute::Representation
1313
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute
1314
+ command.params['name'] = name unless name.nil?
1315
+ command.query['fields'] = fields unless fields.nil?
1316
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1317
+ execute_or_queue_command(command, &block)
1318
+ end
1319
+
799
1320
  # Gets the access control policy for a resource. Returns an empty policy if the
800
1321
  # resource exists and does not have a policy set.
801
1322
  # @param [String] resource
@@ -841,6 +1362,96 @@ module Google
841
1362
  execute_or_queue_command(command, &block)
842
1363
  end
843
1364
 
1365
+ # Lists Data Attribute resources in a DataTaxonomy.
1366
+ # @param [String] parent
1367
+ # Required. The resource name of the DataTaxonomy: projects/`project_number`/
1368
+ # locations/`location_id`/dataTaxonomies/`data_taxonomy_id`
1369
+ # @param [String] filter
1370
+ # Optional. Filter request.
1371
+ # @param [String] order_by
1372
+ # Optional. Order by fields for the result.
1373
+ # @param [Fixnum] page_size
1374
+ # Optional. Maximum number of DataAttributes to return. The service may return
1375
+ # fewer than this value. If unspecified, at most 10 dataAttributes will be
1376
+ # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
1377
+ # @param [String] page_token
1378
+ # Optional. Page token received from a previous ListDataAttributes call. Provide
1379
+ # this to retrieve the subsequent page. When paginating, all other parameters
1380
+ # provided to ListDataAttributes must match the call that provided the page
1381
+ # token.
1382
+ # @param [String] fields
1383
+ # Selector specifying which fields to include in a partial response.
1384
+ # @param [String] quota_user
1385
+ # Available to use for quota purposes for server-side applications. Can be any
1386
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1387
+ # @param [Google::Apis::RequestOptions] options
1388
+ # Request-specific options
1389
+ #
1390
+ # @yield [result, err] Result & error if block supplied
1391
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributesResponse] parsed result object
1392
+ # @yieldparam err [StandardError] error object if request failed
1393
+ #
1394
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributesResponse]
1395
+ #
1396
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1397
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1398
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1399
+ def list_project_location_data_taxonomy_attributes(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1400
+ command = make_simple_command(:get, 'v1/{+parent}/attributes', options)
1401
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributesResponse::Representation
1402
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListDataAttributesResponse
1403
+ command.params['parent'] = parent unless parent.nil?
1404
+ command.query['filter'] = filter unless filter.nil?
1405
+ command.query['orderBy'] = order_by unless order_by.nil?
1406
+ command.query['pageSize'] = page_size unless page_size.nil?
1407
+ command.query['pageToken'] = page_token unless page_token.nil?
1408
+ command.query['fields'] = fields unless fields.nil?
1409
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1410
+ execute_or_queue_command(command, &block)
1411
+ end
1412
+
1413
+ # Updates a DataAttribute resource.
1414
+ # @param [String] name
1415
+ # Output only. The relative resource name of the dataAttribute, of the form:
1416
+ # projects/`project_number`/locations/`location_id`/dataTaxonomies/`dataTaxonomy`
1417
+ # /attributes/`data_attribute_id`.
1418
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute] google_cloud_dataplex_v1_data_attribute_object
1419
+ # @param [String] update_mask
1420
+ # Required. Mask of fields to update.
1421
+ # @param [Boolean] validate_only
1422
+ # Optional. Only validate the request, but do not perform mutations. The default
1423
+ # is false.
1424
+ # @param [String] fields
1425
+ # Selector specifying which fields to include in a partial response.
1426
+ # @param [String] quota_user
1427
+ # Available to use for quota purposes for server-side applications. Can be any
1428
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1429
+ # @param [Google::Apis::RequestOptions] options
1430
+ # Request-specific options
1431
+ #
1432
+ # @yield [result, err] Result & error if block supplied
1433
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1434
+ # @yieldparam err [StandardError] error object if request failed
1435
+ #
1436
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1437
+ #
1438
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1439
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1440
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1441
+ def patch_project_location_data_taxonomy_attribute(name, google_cloud_dataplex_v1_data_attribute_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1442
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1443
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1DataAttribute::Representation
1444
+ command.request_object = google_cloud_dataplex_v1_data_attribute_object
1445
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1446
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1447
+ command.params['name'] = name unless name.nil?
1448
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1449
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1450
+ command.query['fields'] = fields unless fields.nil?
1451
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1452
+ execute_or_queue_command(command, &block)
1453
+ end
1454
+
844
1455
  # Sets the access control policy on the specified resource. Replaces any
845
1456
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
846
1457
  # errors.