google-apis-dataplex_v1 0.50.0 → 0.51.0

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