google-apis-dataplex_v1 0.50.0 → 0.51.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.
@@ -124,6 +124,207 @@ module Google
124
124
  execute_or_queue_command(command, &block)
125
125
  end
126
126
 
127
+ # Looks up a single entry.
128
+ # @param [String] name
129
+ # Required. The project to which the request should be attributed in the
130
+ # following form: projects/`project`/locations/`location`.
131
+ # @param [Array<String>, String] aspect_types
132
+ # Optional. Limits the aspects returned to the provided aspect types. Only works
133
+ # if the CUSTOM view is selected.
134
+ # @param [String] entry
135
+ # Required. The resource name of the Entry: projects/`project`/locations/`
136
+ # location`/entryGroups/`entry_group`/entries/`entry`.
137
+ # @param [Array<String>, String] paths
138
+ # Optional. Limits the aspects returned to those associated with the provided
139
+ # paths within the Entry. Only works if the CUSTOM view is selected.
140
+ # @param [String] view
141
+ # Optional. View for controlling which parts of an entry are to be returned.
142
+ # @param [String] fields
143
+ # Selector specifying which fields to include in a partial response.
144
+ # @param [String] quota_user
145
+ # Available to use for quota purposes for server-side applications. Can be any
146
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
147
+ # @param [Google::Apis::RequestOptions] options
148
+ # Request-specific options
149
+ #
150
+ # @yield [result, err] Result & error if block supplied
151
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] parsed result object
152
+ # @yieldparam err [StandardError] error object if request failed
153
+ #
154
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry]
155
+ #
156
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
157
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
158
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
159
+ def lookup_project_location_entry(name, aspect_types: nil, entry: nil, paths: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
160
+ command = make_simple_command(:get, 'v1/{+name}:lookupEntry', options)
161
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
162
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry
163
+ command.params['name'] = name unless name.nil?
164
+ command.query['aspectTypes'] = aspect_types unless aspect_types.nil?
165
+ command.query['entry'] = entry unless entry.nil?
166
+ command.query['paths'] = paths unless paths.nil?
167
+ command.query['view'] = view unless view.nil?
168
+ command.query['fields'] = fields unless fields.nil?
169
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
170
+ execute_or_queue_command(command, &block)
171
+ end
172
+
173
+ # Searches for entries matching given query and scope.
174
+ # @param [String] name
175
+ # Required. The project to which the request should be attributed in the
176
+ # following form: projects/`project`/locations/`location`.
177
+ # @param [String] order_by
178
+ # Optional. Ordering of the results. Supported options to be added later.
179
+ # @param [Fixnum] page_size
180
+ # Optional. Pagination.
181
+ # @param [String] page_token
182
+ # @param [String] query
183
+ # Required. The query against which entries in scope should be matched.
184
+ # @param [String] scope
185
+ # Optional. The scope under which the search should be operating. Should either
186
+ # be organizations/ or projects/. If left unspecified, it will default to the
187
+ # organization where the project provided in name is located.
188
+ # @param [String] fields
189
+ # Selector specifying which fields to include in a partial response.
190
+ # @param [String] quota_user
191
+ # Available to use for quota purposes for server-side applications. Can be any
192
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
193
+ # @param [Google::Apis::RequestOptions] options
194
+ # Request-specific options
195
+ #
196
+ # @yield [result, err] Result & error if block supplied
197
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse] parsed result object
198
+ # @yieldparam err [StandardError] error object if request failed
199
+ #
200
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse]
201
+ #
202
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
203
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
204
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
205
+ def search_project_location_entries(name, order_by: nil, page_size: nil, page_token: nil, query: nil, scope: nil, fields: nil, quota_user: nil, options: nil, &block)
206
+ command = make_simple_command(:post, 'v1/{+name}:searchEntries', options)
207
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse::Representation
208
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse
209
+ command.params['name'] = name unless name.nil?
210
+ command.query['orderBy'] = order_by unless order_by.nil?
211
+ command.query['pageSize'] = page_size unless page_size.nil?
212
+ command.query['pageToken'] = page_token unless page_token.nil?
213
+ command.query['query'] = query unless query.nil?
214
+ command.query['scope'] = scope unless scope.nil?
215
+ command.query['fields'] = fields unless fields.nil?
216
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
217
+ execute_or_queue_command(command, &block)
218
+ end
219
+
220
+ # Creates an AspectType
221
+ # @param [String] parent
222
+ # Required. The resource name of the AspectType, of the form: projects/`
223
+ # project_number`/locations/`location_id` where location_id refers to a GCP
224
+ # region.
225
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType] google_cloud_dataplex_v1_aspect_type_object
226
+ # @param [String] aspect_type_id
227
+ # Required. AspectType identifier.
228
+ # @param [Boolean] validate_only
229
+ # Optional. Only validate the request, but do not perform mutations. The default
230
+ # is false.
231
+ # @param [String] fields
232
+ # Selector specifying which fields to include in a partial response.
233
+ # @param [String] quota_user
234
+ # Available to use for quota purposes for server-side applications. Can be any
235
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
236
+ # @param [Google::Apis::RequestOptions] options
237
+ # Request-specific options
238
+ #
239
+ # @yield [result, err] Result & error if block supplied
240
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
241
+ # @yieldparam err [StandardError] error object if request failed
242
+ #
243
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
244
+ #
245
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
246
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
247
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
248
+ def create_project_location_aspect_type(parent, google_cloud_dataplex_v1_aspect_type_object = nil, aspect_type_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
249
+ command = make_simple_command(:post, 'v1/{+parent}/aspectTypes', options)
250
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType::Representation
251
+ command.request_object = google_cloud_dataplex_v1_aspect_type_object
252
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
253
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
254
+ command.params['parent'] = parent unless parent.nil?
255
+ command.query['aspectTypeId'] = aspect_type_id unless aspect_type_id.nil?
256
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
257
+ command.query['fields'] = fields unless fields.nil?
258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
259
+ execute_or_queue_command(command, &block)
260
+ end
261
+
262
+ # Deletes a AspectType resource.
263
+ # @param [String] name
264
+ # Required. The resource name of the AspectType: projects/`project_number`/
265
+ # locations/`location_id`/aspectTypes/`aspect_type_id`.
266
+ # @param [String] etag
267
+ # Optional. If the client provided etag value does not match the current etag
268
+ # value, the DeleteAspectTypeRequest method returns an ABORTED error response
269
+ # @param [String] fields
270
+ # Selector specifying which fields to include in a partial response.
271
+ # @param [String] quota_user
272
+ # Available to use for quota purposes for server-side applications. Can be any
273
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
274
+ # @param [Google::Apis::RequestOptions] options
275
+ # Request-specific options
276
+ #
277
+ # @yield [result, err] Result & error if block supplied
278
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
279
+ # @yieldparam err [StandardError] error object if request failed
280
+ #
281
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
282
+ #
283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
286
+ def delete_project_location_aspect_type(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
287
+ command = make_simple_command(:delete, 'v1/{+name}', options)
288
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
289
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
290
+ command.params['name'] = name unless name.nil?
291
+ command.query['etag'] = etag unless etag.nil?
292
+ command.query['fields'] = fields unless fields.nil?
293
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
294
+ execute_or_queue_command(command, &block)
295
+ end
296
+
297
+ # Retrieves a AspectType resource.
298
+ # @param [String] name
299
+ # Required. The resource name of the AspectType: projects/`project_number`/
300
+ # locations/`location_id`/aspectTypes/`aspect_type_id`.
301
+ # @param [String] fields
302
+ # Selector specifying which fields to include in a partial response.
303
+ # @param [String] quota_user
304
+ # Available to use for quota purposes for server-side applications. Can be any
305
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
306
+ # @param [Google::Apis::RequestOptions] options
307
+ # Request-specific options
308
+ #
309
+ # @yield [result, err] Result & error if block supplied
310
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType] parsed result object
311
+ # @yieldparam err [StandardError] error object if request failed
312
+ #
313
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType]
314
+ #
315
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
316
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
317
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
318
+ def get_project_location_aspect_type(name, fields: nil, quota_user: nil, options: nil, &block)
319
+ command = make_simple_command(:get, 'v1/{+name}', options)
320
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType::Representation
321
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType
322
+ command.params['name'] = name unless name.nil?
323
+ command.query['fields'] = fields unless fields.nil?
324
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
325
+ execute_or_queue_command(command, &block)
326
+ end
327
+
127
328
  # Gets the access control policy for a resource. Returns an empty policy if the
128
329
  # resource exists and does not have a policy set.
129
330
  # @param [String] resource
@@ -169,6 +370,98 @@ module Google
169
370
  execute_or_queue_command(command, &block)
170
371
  end
171
372
 
373
+ # Lists AspectType resources in a project and location.
374
+ # @param [String] parent
375
+ # Required. The resource name of the AspectType location, of the form: projects/`
376
+ # project_number`/locations/`location_id` where location_id refers to a GCP
377
+ # region.
378
+ # @param [String] filter
379
+ # Optional. Filter request. Filters are case-sensitive. The following formats
380
+ # are supported:labels.key1 = "value1" labels:key1 name = "value" These
381
+ # restrictions can be coinjoined with AND, OR and NOT conjunctions.
382
+ # @param [String] order_by
383
+ # Optional. Order by fields (name or create_time) for the result. If not
384
+ # specified, the ordering is undefined.
385
+ # @param [Fixnum] page_size
386
+ # Optional. Maximum number of AspectTypes to return. The service may return
387
+ # fewer than this value. If unspecified, at most 10 AspectTypes will be returned.
388
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
389
+ # @param [String] page_token
390
+ # Optional. Page token received from a previous ListAspectTypes call. Provide
391
+ # this to retrieve the subsequent page. When paginating, all other parameters
392
+ # provided to ListAspectTypes must match the call that provided the page token.
393
+ # @param [String] fields
394
+ # Selector specifying which fields to include in a partial response.
395
+ # @param [String] quota_user
396
+ # Available to use for quota purposes for server-side applications. Can be any
397
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
398
+ # @param [Google::Apis::RequestOptions] options
399
+ # Request-specific options
400
+ #
401
+ # @yield [result, err] Result & error if block supplied
402
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAspectTypesResponse] parsed result object
403
+ # @yieldparam err [StandardError] error object if request failed
404
+ #
405
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAspectTypesResponse]
406
+ #
407
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
408
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
409
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
410
+ def list_project_location_aspect_types(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
411
+ command = make_simple_command(:get, 'v1/{+parent}/aspectTypes', options)
412
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAspectTypesResponse::Representation
413
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAspectTypesResponse
414
+ command.params['parent'] = parent unless parent.nil?
415
+ command.query['filter'] = filter unless filter.nil?
416
+ command.query['orderBy'] = order_by unless order_by.nil?
417
+ command.query['pageSize'] = page_size unless page_size.nil?
418
+ command.query['pageToken'] = page_token unless page_token.nil?
419
+ command.query['fields'] = fields unless fields.nil?
420
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
421
+ execute_or_queue_command(command, &block)
422
+ end
423
+
424
+ # Updates a AspectType resource.
425
+ # @param [String] name
426
+ # Output only. The relative resource name of the AspectType, of the form:
427
+ # projects/`project_number`/locations/`location_id`/aspectTypes/`aspect_type_id`.
428
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType] google_cloud_dataplex_v1_aspect_type_object
429
+ # @param [String] update_mask
430
+ # Required. Mask of fields to update.
431
+ # @param [Boolean] validate_only
432
+ # Optional. Only validate the request, but do not perform mutations. The default
433
+ # is false.
434
+ # @param [String] fields
435
+ # Selector specifying which fields to include in a partial response.
436
+ # @param [String] quota_user
437
+ # Available to use for quota purposes for server-side applications. Can be any
438
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
439
+ # @param [Google::Apis::RequestOptions] options
440
+ # Request-specific options
441
+ #
442
+ # @yield [result, err] Result & error if block supplied
443
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
444
+ # @yieldparam err [StandardError] error object if request failed
445
+ #
446
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
447
+ #
448
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
449
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
450
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
451
+ def patch_project_location_aspect_type(name, google_cloud_dataplex_v1_aspect_type_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
452
+ command = make_simple_command(:patch, 'v1/{+name}', options)
453
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1AspectType::Representation
454
+ command.request_object = google_cloud_dataplex_v1_aspect_type_object
455
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
456
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
457
+ command.params['name'] = name unless name.nil?
458
+ command.query['updateMask'] = update_mask unless update_mask.nil?
459
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
460
+ command.query['fields'] = fields unless fields.nil?
461
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
462
+ execute_or_queue_command(command, &block)
463
+ end
464
+
172
465
  # Sets the access control policy on the specified resource. Replaces any
173
466
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
174
467
  # errors.
@@ -651,6 +944,41 @@ module Google
651
944
  execute_or_queue_command(command, &block)
652
945
  end
653
946
 
947
+ # Generates recommended DataQualityRule from a data profiling DataScan.
948
+ # @param [String] name
949
+ # Required. The name should be either * the name of a datascan with at least one
950
+ # successful completed data profiling job, or * the name of a successful
951
+ # completed data profiling datascan job.
952
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesRequest] google_cloud_dataplex_v1_generate_data_quality_rules_request_object
953
+ # @param [String] fields
954
+ # Selector specifying which fields to include in a partial response.
955
+ # @param [String] quota_user
956
+ # Available to use for quota purposes for server-side applications. Can be any
957
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
958
+ # @param [Google::Apis::RequestOptions] options
959
+ # Request-specific options
960
+ #
961
+ # @yield [result, err] Result & error if block supplied
962
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse] parsed result object
963
+ # @yieldparam err [StandardError] error object if request failed
964
+ #
965
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse]
966
+ #
967
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
968
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
969
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
970
+ def generate_project_location_data_scan_data_quality_rules(name, google_cloud_dataplex_v1_generate_data_quality_rules_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
971
+ command = make_simple_command(:post, 'v1/{+name}:generateDataQualityRules', options)
972
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesRequest::Representation
973
+ command.request_object = google_cloud_dataplex_v1_generate_data_quality_rules_request_object
974
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse::Representation
975
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse
976
+ command.params['name'] = name unless name.nil?
977
+ command.query['fields'] = fields unless fields.nil?
978
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
979
+ execute_or_queue_command(command, &block)
980
+ end
981
+
654
982
  # Gets a DataScan resource.
655
983
  # @param [String] name
656
984
  # Required. The resource name of the dataScan: projects/`project`/locations/`
@@ -934,6 +1262,41 @@ module Google
934
1262
  execute_or_queue_command(command, &block)
935
1263
  end
936
1264
 
1265
+ # Generates recommended DataQualityRule from a data profiling DataScan.
1266
+ # @param [String] name
1267
+ # Required. The name should be either * the name of a datascan with at least one
1268
+ # successful completed data profiling job, or * the name of a successful
1269
+ # completed data profiling datascan job.
1270
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesRequest] google_cloud_dataplex_v1_generate_data_quality_rules_request_object
1271
+ # @param [String] fields
1272
+ # Selector specifying which fields to include in a partial response.
1273
+ # @param [String] quota_user
1274
+ # Available to use for quota purposes for server-side applications. Can be any
1275
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1276
+ # @param [Google::Apis::RequestOptions] options
1277
+ # Request-specific options
1278
+ #
1279
+ # @yield [result, err] Result & error if block supplied
1280
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse] parsed result object
1281
+ # @yieldparam err [StandardError] error object if request failed
1282
+ #
1283
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse]
1284
+ #
1285
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1286
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1287
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1288
+ def generate_project_location_data_scan_job_data_quality_rules(name, google_cloud_dataplex_v1_generate_data_quality_rules_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1289
+ command = make_simple_command(:post, 'v1/{+name}:generateDataQualityRules', options)
1290
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesRequest::Representation
1291
+ command.request_object = google_cloud_dataplex_v1_generate_data_quality_rules_request_object
1292
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse::Representation
1293
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GenerateDataQualityRulesResponse
1294
+ command.params['name'] = name unless name.nil?
1295
+ command.query['fields'] = fields unless fields.nil?
1296
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1297
+ execute_or_queue_command(command, &block)
1298
+ end
1299
+
937
1300
  # Gets a DataScanJob resource.
938
1301
  # @param [String] name
939
1302
  # Required. The resource name of the DataScanJob: projects/`project`/locations/`
@@ -1668,11 +2031,119 @@ module Google
1668
2031
  execute_or_queue_command(command, &block)
1669
2032
  end
1670
2033
 
1671
- # Gets the access control policy for a resource. Returns an empty policy if the
1672
- # resource exists and does not have a policy set.
1673
- # @param [String] resource
1674
- # REQUIRED: The resource for which the policy is being requested. See Resource
1675
- # names (https://cloud.google.com/apis/design/resource_names) for the
2034
+ # Creates an EntryGroup
2035
+ # @param [String] parent
2036
+ # Required. The resource name of the entryGroup, of the form: projects/`
2037
+ # project_number`/locations/`location_id` where location_id refers to a GCP
2038
+ # region.
2039
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup] google_cloud_dataplex_v1_entry_group_object
2040
+ # @param [String] entry_group_id
2041
+ # Required. EntryGroup identifier.
2042
+ # @param [Boolean] validate_only
2043
+ # Optional. Only validate the request, but do not perform mutations. The default
2044
+ # is false.
2045
+ # @param [String] fields
2046
+ # Selector specifying which fields to include in a partial response.
2047
+ # @param [String] quota_user
2048
+ # Available to use for quota purposes for server-side applications. Can be any
2049
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2050
+ # @param [Google::Apis::RequestOptions] options
2051
+ # Request-specific options
2052
+ #
2053
+ # @yield [result, err] Result & error if block supplied
2054
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2055
+ # @yieldparam err [StandardError] error object if request failed
2056
+ #
2057
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2058
+ #
2059
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2060
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2061
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2062
+ def create_project_location_entry_group(parent, google_cloud_dataplex_v1_entry_group_object = nil, entry_group_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2063
+ command = make_simple_command(:post, 'v1/{+parent}/entryGroups', options)
2064
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup::Representation
2065
+ command.request_object = google_cloud_dataplex_v1_entry_group_object
2066
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2067
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2068
+ command.params['parent'] = parent unless parent.nil?
2069
+ command.query['entryGroupId'] = entry_group_id unless entry_group_id.nil?
2070
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2071
+ command.query['fields'] = fields unless fields.nil?
2072
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2073
+ execute_or_queue_command(command, &block)
2074
+ end
2075
+
2076
+ # Deletes a EntryGroup resource.
2077
+ # @param [String] name
2078
+ # Required. The resource name of the EntryGroup: projects/`project_number`/
2079
+ # locations/`location_id`/entryGroups/`entry_group_id`.
2080
+ # @param [String] etag
2081
+ # Optional. If the client provided etag value does not match the current etag
2082
+ # value, the DeleteEntryGroupRequest method returns an ABORTED error response
2083
+ # @param [String] fields
2084
+ # Selector specifying which fields to include in a partial response.
2085
+ # @param [String] quota_user
2086
+ # Available to use for quota purposes for server-side applications. Can be any
2087
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2088
+ # @param [Google::Apis::RequestOptions] options
2089
+ # Request-specific options
2090
+ #
2091
+ # @yield [result, err] Result & error if block supplied
2092
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2093
+ # @yieldparam err [StandardError] error object if request failed
2094
+ #
2095
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2096
+ #
2097
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2098
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2099
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2100
+ def delete_project_location_entry_group(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
2101
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2102
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2103
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2104
+ command.params['name'] = name unless name.nil?
2105
+ command.query['etag'] = etag unless etag.nil?
2106
+ command.query['fields'] = fields unless fields.nil?
2107
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2108
+ execute_or_queue_command(command, &block)
2109
+ end
2110
+
2111
+ # Retrieves a EntryGroup resource.
2112
+ # @param [String] name
2113
+ # Required. The resource name of the EntryGroup: projects/`project_number`/
2114
+ # locations/`location_id`/entryGroups/`entry_group_id`.
2115
+ # @param [String] fields
2116
+ # Selector specifying which fields to include in a partial response.
2117
+ # @param [String] quota_user
2118
+ # Available to use for quota purposes for server-side applications. Can be any
2119
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2120
+ # @param [Google::Apis::RequestOptions] options
2121
+ # Request-specific options
2122
+ #
2123
+ # @yield [result, err] Result & error if block supplied
2124
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup] parsed result object
2125
+ # @yieldparam err [StandardError] error object if request failed
2126
+ #
2127
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup]
2128
+ #
2129
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2130
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2131
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2132
+ def get_project_location_entry_group(name, fields: nil, quota_user: nil, options: nil, &block)
2133
+ command = make_simple_command(:get, 'v1/{+name}', options)
2134
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup::Representation
2135
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup
2136
+ command.params['name'] = name unless name.nil?
2137
+ command.query['fields'] = fields unless fields.nil?
2138
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2139
+ execute_or_queue_command(command, &block)
2140
+ end
2141
+
2142
+ # Gets the access control policy for a resource. Returns an empty policy if the
2143
+ # resource exists and does not have a policy set.
2144
+ # @param [String] resource
2145
+ # REQUIRED: The resource for which the policy is being requested. See Resource
2146
+ # names (https://cloud.google.com/apis/design/resource_names) for the
1676
2147
  # appropriate value for this field.
1677
2148
  # @param [Fixnum] options_requested_policy_version
1678
2149
  # Optional. The maximum policy version that will be used to format the policy.
@@ -1713,6 +2184,95 @@ module Google
1713
2184
  execute_or_queue_command(command, &block)
1714
2185
  end
1715
2186
 
2187
+ # Lists EntryGroup resources in a project and location.
2188
+ # @param [String] parent
2189
+ # Required. The resource name of the entryGroup location, of the form: projects/`
2190
+ # project_number`/locations/`location_id` where location_id refers to a GCP
2191
+ # region.
2192
+ # @param [String] filter
2193
+ # Optional. Filter request.
2194
+ # @param [String] order_by
2195
+ # Optional. Order by fields for the result.
2196
+ # @param [Fixnum] page_size
2197
+ # Optional. Maximum number of EntryGroups to return. The service may return
2198
+ # fewer than this value. If unspecified, at most 10 EntryGroups will be returned.
2199
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
2200
+ # @param [String] page_token
2201
+ # Optional. Page token received from a previous ListEntryGroups call. Provide
2202
+ # this to retrieve the subsequent page. When paginating, all other parameters
2203
+ # provided to ListEntryGroups must match the call that provided the page token.
2204
+ # @param [String] fields
2205
+ # Selector specifying which fields to include in a partial response.
2206
+ # @param [String] quota_user
2207
+ # Available to use for quota purposes for server-side applications. Can be any
2208
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2209
+ # @param [Google::Apis::RequestOptions] options
2210
+ # Request-specific options
2211
+ #
2212
+ # @yield [result, err] Result & error if block supplied
2213
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryGroupsResponse] parsed result object
2214
+ # @yieldparam err [StandardError] error object if request failed
2215
+ #
2216
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryGroupsResponse]
2217
+ #
2218
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2219
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2220
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2221
+ def list_project_location_entry_groups(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2222
+ command = make_simple_command(:get, 'v1/{+parent}/entryGroups', options)
2223
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryGroupsResponse::Representation
2224
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryGroupsResponse
2225
+ command.params['parent'] = parent unless parent.nil?
2226
+ command.query['filter'] = filter unless filter.nil?
2227
+ command.query['orderBy'] = order_by unless order_by.nil?
2228
+ command.query['pageSize'] = page_size unless page_size.nil?
2229
+ command.query['pageToken'] = page_token unless page_token.nil?
2230
+ command.query['fields'] = fields unless fields.nil?
2231
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2232
+ execute_or_queue_command(command, &block)
2233
+ end
2234
+
2235
+ # Updates a EntryGroup resource.
2236
+ # @param [String] name
2237
+ # Output only. The relative resource name of the EntryGroup, of the form:
2238
+ # projects/`project_number`/locations/`location_id`/entryGroups/`entry_group_id`.
2239
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup] google_cloud_dataplex_v1_entry_group_object
2240
+ # @param [String] update_mask
2241
+ # Required. Mask of fields to update.
2242
+ # @param [Boolean] validate_only
2243
+ # Optional. Only validate the request, but do not perform mutations. The default
2244
+ # is false.
2245
+ # @param [String] fields
2246
+ # Selector specifying which fields to include in a partial response.
2247
+ # @param [String] quota_user
2248
+ # Available to use for quota purposes for server-side applications. Can be any
2249
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2250
+ # @param [Google::Apis::RequestOptions] options
2251
+ # Request-specific options
2252
+ #
2253
+ # @yield [result, err] Result & error if block supplied
2254
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2255
+ # @yieldparam err [StandardError] error object if request failed
2256
+ #
2257
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2258
+ #
2259
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2260
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2261
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2262
+ def patch_project_location_entry_group(name, google_cloud_dataplex_v1_entry_group_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2263
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2264
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryGroup::Representation
2265
+ command.request_object = google_cloud_dataplex_v1_entry_group_object
2266
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2267
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2268
+ command.params['name'] = name unless name.nil?
2269
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2270
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2271
+ command.query['fields'] = fields unless fields.nil?
2272
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2273
+ execute_or_queue_command(command, &block)
2274
+ end
2275
+
1716
2276
  # Sets the access control policy on the specified resource. Replaces any
1717
2277
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
1718
2278
  # errors.
@@ -1789,6 +2349,336 @@ module Google
1789
2349
  execute_or_queue_command(command, &block)
1790
2350
  end
1791
2351
 
2352
+ # Creates an Entry.
2353
+ # @param [String] parent
2354
+ # Required. The resource name of the parent Entry Group: projects/`project`/
2355
+ # locations/`location`/entryGroups/`entry_group`.
2356
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] google_cloud_dataplex_v1_entry_object
2357
+ # @param [String] entry_id
2358
+ # Required. Entry identifier. It has to be unique within an Entry Group.Entries
2359
+ # corresponding to Google Cloud resources use Entry ID format based on Full
2360
+ # Resource Names (https://cloud.google.com/apis/design/resource_names#
2361
+ # full_resource_name). The format is a Full Resource Name of the resource
2362
+ # without the prefix double slashes in the API Service Name part of Full
2363
+ # Resource Name. This allows retrieval of entries using their associated
2364
+ # resource name.For example if the Full Resource Name of a resource is //library.
2365
+ # googleapis.com/shelves/shelf1/books/book2, then the suggested entry_id is
2366
+ # library.googleapis.com/shelves/shelf1/books/book2.It is also suggested to
2367
+ # follow the same convention for entries corresponding to resources from other
2368
+ # providers or systems than Google Cloud.The maximum size of the field is 4000
2369
+ # characters.
2370
+ # @param [String] fields
2371
+ # Selector specifying which fields to include in a partial response.
2372
+ # @param [String] quota_user
2373
+ # Available to use for quota purposes for server-side applications. Can be any
2374
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2375
+ # @param [Google::Apis::RequestOptions] options
2376
+ # Request-specific options
2377
+ #
2378
+ # @yield [result, err] Result & error if block supplied
2379
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] parsed result object
2380
+ # @yieldparam err [StandardError] error object if request failed
2381
+ #
2382
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry]
2383
+ #
2384
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2385
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2386
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2387
+ def create_project_location_entry_group_entry(parent, google_cloud_dataplex_v1_entry_object = nil, entry_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2388
+ command = make_simple_command(:post, 'v1/{+parent}/entries', options)
2389
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2390
+ command.request_object = google_cloud_dataplex_v1_entry_object
2391
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2392
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry
2393
+ command.params['parent'] = parent unless parent.nil?
2394
+ command.query['entryId'] = entry_id unless entry_id.nil?
2395
+ command.query['fields'] = fields unless fields.nil?
2396
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2397
+ execute_or_queue_command(command, &block)
2398
+ end
2399
+
2400
+ # Deletes an Entry.
2401
+ # @param [String] name
2402
+ # Required. The resource name of the Entry: projects/`project`/locations/`
2403
+ # location`/entryGroups/`entry_group`/entries/`entry`.
2404
+ # @param [String] fields
2405
+ # Selector specifying which fields to include in a partial response.
2406
+ # @param [String] quota_user
2407
+ # Available to use for quota purposes for server-side applications. Can be any
2408
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2409
+ # @param [Google::Apis::RequestOptions] options
2410
+ # Request-specific options
2411
+ #
2412
+ # @yield [result, err] Result & error if block supplied
2413
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] parsed result object
2414
+ # @yieldparam err [StandardError] error object if request failed
2415
+ #
2416
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry]
2417
+ #
2418
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2419
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2420
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2421
+ def delete_project_location_entry_group_entry(name, fields: nil, quota_user: nil, options: nil, &block)
2422
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2423
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2424
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry
2425
+ command.params['name'] = name unless name.nil?
2426
+ command.query['fields'] = fields unless fields.nil?
2427
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2428
+ execute_or_queue_command(command, &block)
2429
+ end
2430
+
2431
+ # Gets a single entry.
2432
+ # @param [String] name
2433
+ # Required. The resource name of the Entry: projects/`project`/locations/`
2434
+ # location`/entryGroups/`entry_group`/entries/`entry`.
2435
+ # @param [Array<String>, String] aspect_types
2436
+ # Optional. Limits the aspects returned to the provided aspect types. Only works
2437
+ # if the CUSTOM view is selected.
2438
+ # @param [Array<String>, String] paths
2439
+ # Optional. Limits the aspects returned to those associated with the provided
2440
+ # paths within the Entry. Only works if the CUSTOM view is selected.
2441
+ # @param [String] view
2442
+ # Optional. View for controlling which parts of an entry are to be returned.
2443
+ # @param [String] fields
2444
+ # Selector specifying which fields to include in a partial response.
2445
+ # @param [String] quota_user
2446
+ # Available to use for quota purposes for server-side applications. Can be any
2447
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2448
+ # @param [Google::Apis::RequestOptions] options
2449
+ # Request-specific options
2450
+ #
2451
+ # @yield [result, err] Result & error if block supplied
2452
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] parsed result object
2453
+ # @yieldparam err [StandardError] error object if request failed
2454
+ #
2455
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry]
2456
+ #
2457
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2458
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2459
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2460
+ def get_project_location_entry_group_entry(name, aspect_types: nil, paths: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
2461
+ command = make_simple_command(:get, 'v1/{+name}', options)
2462
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2463
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry
2464
+ command.params['name'] = name unless name.nil?
2465
+ command.query['aspectTypes'] = aspect_types unless aspect_types.nil?
2466
+ command.query['paths'] = paths unless paths.nil?
2467
+ command.query['view'] = view unless view.nil?
2468
+ command.query['fields'] = fields unless fields.nil?
2469
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2470
+ execute_or_queue_command(command, &block)
2471
+ end
2472
+
2473
+ # Lists entries within an entry group.
2474
+ # @param [String] parent
2475
+ # Required. The resource name of the parent Entry Group: projects/`project`/
2476
+ # locations/`location`/entryGroups/`entry_group`.
2477
+ # @param [String] filter
2478
+ # Optional. A filter on the entries to return. Filters are case-sensitive. The
2479
+ # request can be filtered by the following fields: entry_type, display_name. The
2480
+ # comparison operators are =, !=, <, >, <=, >= (strings are compared according
2481
+ # to lexical order) The logical operators AND, OR, NOT can be used in the filter.
2482
+ # Example filter expressions: "display_name=AnExampleDisplayName" "entry_type=
2483
+ # projects/example-project/locations/global/entryTypes/example-entry_type" "
2484
+ # entry_type=projects/a* OR "entry_type=projects/k*" "NOT display_name=
2485
+ # AnotherExampleDisplayName"
2486
+ # @param [Fixnum] page_size
2487
+ # @param [String] page_token
2488
+ # Optional. The pagination token returned by a previous request.
2489
+ # @param [String] fields
2490
+ # Selector specifying which fields to include in a partial response.
2491
+ # @param [String] quota_user
2492
+ # Available to use for quota purposes for server-side applications. Can be any
2493
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2494
+ # @param [Google::Apis::RequestOptions] options
2495
+ # Request-specific options
2496
+ #
2497
+ # @yield [result, err] Result & error if block supplied
2498
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntriesResponse] parsed result object
2499
+ # @yieldparam err [StandardError] error object if request failed
2500
+ #
2501
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntriesResponse]
2502
+ #
2503
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2504
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2505
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2506
+ def list_project_location_entry_group_entries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2507
+ command = make_simple_command(:get, 'v1/{+parent}/entries', options)
2508
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntriesResponse::Representation
2509
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntriesResponse
2510
+ command.params['parent'] = parent unless parent.nil?
2511
+ command.query['filter'] = filter unless filter.nil?
2512
+ command.query['pageSize'] = page_size unless page_size.nil?
2513
+ command.query['pageToken'] = page_token unless page_token.nil?
2514
+ command.query['fields'] = fields unless fields.nil?
2515
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2516
+ execute_or_queue_command(command, &block)
2517
+ end
2518
+
2519
+ # Updates an Entry.
2520
+ # @param [String] name
2521
+ # Identifier. The relative resource name of the Entry, of the form: projects/`
2522
+ # project`/locations/`location`/entryGroups/`entry_group`/entries/`entry`.
2523
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] google_cloud_dataplex_v1_entry_object
2524
+ # @param [Boolean] allow_missing
2525
+ # Optional. If set to true and the entry does not exist, it will be created.
2526
+ # @param [Array<String>, String] aspect_keys
2527
+ # Optional. The map keys of the Aspects which should be modified. Supports the
2528
+ # following syntaxes: * - matches aspect on given type and empty path * @path -
2529
+ # matches aspect on given type and specified path * * - matches aspects on given
2530
+ # type for all paths * *@path - matches aspects of all types on the given
2531
+ # pathExisting aspects matching the syntax will not be removed unless
2532
+ # delete_missing_aspects is set to true.If this field is left empty, it will be
2533
+ # treated as specifying exactly those Aspects present in the request.
2534
+ # @param [Boolean] delete_missing_aspects
2535
+ # Optional. If set to true and the aspect_keys specify aspect ranges, any
2536
+ # existing aspects from that range not provided in the request will be deleted.
2537
+ # @param [String] update_mask
2538
+ # Optional. Mask of fields to update. To update Aspects, the update_mask must
2539
+ # contain the value "aspects".If the update_mask is empty, all modifiable fields
2540
+ # present in the request will be updated.
2541
+ # @param [String] fields
2542
+ # Selector specifying which fields to include in a partial response.
2543
+ # @param [String] quota_user
2544
+ # Available to use for quota purposes for server-side applications. Can be any
2545
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2546
+ # @param [Google::Apis::RequestOptions] options
2547
+ # Request-specific options
2548
+ #
2549
+ # @yield [result, err] Result & error if block supplied
2550
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry] parsed result object
2551
+ # @yieldparam err [StandardError] error object if request failed
2552
+ #
2553
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry]
2554
+ #
2555
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2556
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2557
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2558
+ def patch_project_location_entry_group_entry(name, google_cloud_dataplex_v1_entry_object = nil, allow_missing: nil, aspect_keys: nil, delete_missing_aspects: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2559
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2560
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2561
+ command.request_object = google_cloud_dataplex_v1_entry_object
2562
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry::Representation
2563
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entry
2564
+ command.params['name'] = name unless name.nil?
2565
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
2566
+ command.query['aspectKeys'] = aspect_keys unless aspect_keys.nil?
2567
+ command.query['deleteMissingAspects'] = delete_missing_aspects unless delete_missing_aspects.nil?
2568
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2569
+ command.query['fields'] = fields unless fields.nil?
2570
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2571
+ execute_or_queue_command(command, &block)
2572
+ end
2573
+
2574
+ # Creates an EntryType
2575
+ # @param [String] parent
2576
+ # Required. The resource name of the EntryType, of the form: projects/`
2577
+ # project_number`/locations/`location_id` where location_id refers to a GCP
2578
+ # region.
2579
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType] google_cloud_dataplex_v1_entry_type_object
2580
+ # @param [String] entry_type_id
2581
+ # Required. EntryType identifier.
2582
+ # @param [Boolean] validate_only
2583
+ # Optional. Only validate the request, but do not perform mutations. The default
2584
+ # is false.
2585
+ # @param [String] fields
2586
+ # Selector specifying which fields to include in a partial response.
2587
+ # @param [String] quota_user
2588
+ # Available to use for quota purposes for server-side applications. Can be any
2589
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2590
+ # @param [Google::Apis::RequestOptions] options
2591
+ # Request-specific options
2592
+ #
2593
+ # @yield [result, err] Result & error if block supplied
2594
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2595
+ # @yieldparam err [StandardError] error object if request failed
2596
+ #
2597
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2598
+ #
2599
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2600
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2601
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2602
+ def create_project_location_entry_type(parent, google_cloud_dataplex_v1_entry_type_object = nil, entry_type_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2603
+ command = make_simple_command(:post, 'v1/{+parent}/entryTypes', options)
2604
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType::Representation
2605
+ command.request_object = google_cloud_dataplex_v1_entry_type_object
2606
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2607
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2608
+ command.params['parent'] = parent unless parent.nil?
2609
+ command.query['entryTypeId'] = entry_type_id unless entry_type_id.nil?
2610
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2611
+ command.query['fields'] = fields unless fields.nil?
2612
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2613
+ execute_or_queue_command(command, &block)
2614
+ end
2615
+
2616
+ # Deletes a EntryType resource.
2617
+ # @param [String] name
2618
+ # Required. The resource name of the EntryType: projects/`project_number`/
2619
+ # locations/`location_id`/entryTypes/`entry_type_id`.
2620
+ # @param [String] etag
2621
+ # Optional. If the client provided etag value does not match the current etag
2622
+ # value, the DeleteEntryTypeRequest method returns an ABORTED error response
2623
+ # @param [String] fields
2624
+ # Selector specifying which fields to include in a partial response.
2625
+ # @param [String] quota_user
2626
+ # Available to use for quota purposes for server-side applications. Can be any
2627
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2628
+ # @param [Google::Apis::RequestOptions] options
2629
+ # Request-specific options
2630
+ #
2631
+ # @yield [result, err] Result & error if block supplied
2632
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2633
+ # @yieldparam err [StandardError] error object if request failed
2634
+ #
2635
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2636
+ #
2637
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2638
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2639
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2640
+ def delete_project_location_entry_type(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
2641
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2642
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2643
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2644
+ command.params['name'] = name unless name.nil?
2645
+ command.query['etag'] = etag unless etag.nil?
2646
+ command.query['fields'] = fields unless fields.nil?
2647
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2648
+ execute_or_queue_command(command, &block)
2649
+ end
2650
+
2651
+ # Retrieves a EntryType resource.
2652
+ # @param [String] name
2653
+ # Required. The resource name of the EntryType: projects/`project_number`/
2654
+ # locations/`location_id`/entryTypes/`entry_type_id`.
2655
+ # @param [String] fields
2656
+ # Selector specifying which fields to include in a partial response.
2657
+ # @param [String] quota_user
2658
+ # Available to use for quota purposes for server-side applications. Can be any
2659
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2660
+ # @param [Google::Apis::RequestOptions] options
2661
+ # Request-specific options
2662
+ #
2663
+ # @yield [result, err] Result & error if block supplied
2664
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType] parsed result object
2665
+ # @yieldparam err [StandardError] error object if request failed
2666
+ #
2667
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType]
2668
+ #
2669
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2670
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2671
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2672
+ def get_project_location_entry_type(name, fields: nil, quota_user: nil, options: nil, &block)
2673
+ command = make_simple_command(:get, 'v1/{+name}', options)
2674
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType::Representation
2675
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType
2676
+ command.params['name'] = name unless name.nil?
2677
+ command.query['fields'] = fields unless fields.nil?
2678
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2679
+ execute_or_queue_command(command, &block)
2680
+ end
2681
+
1792
2682
  # Gets the access control policy for a resource. Returns an empty policy if the
1793
2683
  # resource exists and does not have a policy set.
1794
2684
  # @param [String] resource
@@ -1834,6 +2724,98 @@ module Google
1834
2724
  execute_or_queue_command(command, &block)
1835
2725
  end
1836
2726
 
2727
+ # Lists EntryType resources in a project and location.
2728
+ # @param [String] parent
2729
+ # Required. The resource name of the EntryType location, of the form: projects/`
2730
+ # project_number`/locations/`location_id` where location_id refers to a GCP
2731
+ # region.
2732
+ # @param [String] filter
2733
+ # Optional. Filter request. Filters are case-sensitive. The following formats
2734
+ # are supported:labels.key1 = "value1" labels:key1 name = "value" These
2735
+ # restrictions can be coinjoined with AND, OR and NOT conjunctions.
2736
+ # @param [String] order_by
2737
+ # Optional. Order by fields (name or create_time) for the result. If not
2738
+ # specified, the ordering is undefined.
2739
+ # @param [Fixnum] page_size
2740
+ # Optional. Maximum number of EntryTypes to return. The service may return fewer
2741
+ # than this value. If unspecified, at most 10 EntryTypes will be returned. The
2742
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
2743
+ # @param [String] page_token
2744
+ # Optional. Page token received from a previous ListEntryTypes call. Provide
2745
+ # this to retrieve the subsequent page. When paginating, all other parameters
2746
+ # provided to ListEntryTypes must match the call that provided the page token.
2747
+ # @param [String] fields
2748
+ # Selector specifying which fields to include in a partial response.
2749
+ # @param [String] quota_user
2750
+ # Available to use for quota purposes for server-side applications. Can be any
2751
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2752
+ # @param [Google::Apis::RequestOptions] options
2753
+ # Request-specific options
2754
+ #
2755
+ # @yield [result, err] Result & error if block supplied
2756
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryTypesResponse] parsed result object
2757
+ # @yieldparam err [StandardError] error object if request failed
2758
+ #
2759
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryTypesResponse]
2760
+ #
2761
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2762
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2763
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2764
+ def list_project_location_entry_types(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2765
+ command = make_simple_command(:get, 'v1/{+parent}/entryTypes', options)
2766
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryTypesResponse::Representation
2767
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntryTypesResponse
2768
+ command.params['parent'] = parent unless parent.nil?
2769
+ command.query['filter'] = filter unless filter.nil?
2770
+ command.query['orderBy'] = order_by unless order_by.nil?
2771
+ command.query['pageSize'] = page_size unless page_size.nil?
2772
+ command.query['pageToken'] = page_token unless page_token.nil?
2773
+ command.query['fields'] = fields unless fields.nil?
2774
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2775
+ execute_or_queue_command(command, &block)
2776
+ end
2777
+
2778
+ # Updates a EntryType resource.
2779
+ # @param [String] name
2780
+ # Output only. The relative resource name of the EntryType, of the form:
2781
+ # projects/`project_number`/locations/`location_id`/entryTypes/`entry_type_id`.
2782
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType] google_cloud_dataplex_v1_entry_type_object
2783
+ # @param [String] update_mask
2784
+ # Required. Mask of fields to update.
2785
+ # @param [Boolean] validate_only
2786
+ # Optional. Only validate the request, but do not perform mutations. The default
2787
+ # is false.
2788
+ # @param [String] fields
2789
+ # Selector specifying which fields to include in a partial response.
2790
+ # @param [String] quota_user
2791
+ # Available to use for quota purposes for server-side applications. Can be any
2792
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2793
+ # @param [Google::Apis::RequestOptions] options
2794
+ # Request-specific options
2795
+ #
2796
+ # @yield [result, err] Result & error if block supplied
2797
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2798
+ # @yieldparam err [StandardError] error object if request failed
2799
+ #
2800
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2801
+ #
2802
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2803
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2804
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2805
+ def patch_project_location_entry_type(name, google_cloud_dataplex_v1_entry_type_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2806
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2807
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryType::Representation
2808
+ command.request_object = google_cloud_dataplex_v1_entry_type_object
2809
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2810
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2811
+ command.params['name'] = name unless name.nil?
2812
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2813
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2814
+ command.query['fields'] = fields unless fields.nil?
2815
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2816
+ execute_or_queue_command(command, &block)
2817
+ end
2818
+
1837
2819
  # Sets the access control policy on the specified resource. Replaces any
1838
2820
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
1839
2821
  # errors.