google-apis-dataplex_v1 0.1.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.
@@ -0,0 +1,2793 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module DataplexV1
23
+ # Cloud Dataplex API
24
+ #
25
+ # Dataplex API is used to manage the lifecycle of data lakes.
26
+ #
27
+ # @example
28
+ # require 'google/apis/dataplex_v1'
29
+ #
30
+ # Dataplex = Google::Apis::DataplexV1 # Alias the module
31
+ # service = Dataplex::CloudDataplexService.new
32
+ #
33
+ # @see https://cloud.google.com/dataplex/docs
34
+ class CloudDataplexService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://dataplex.googleapis.com/', '',
47
+ client_name: 'google-apis-dataplex_v1',
48
+ client_version: Google::Apis::DataplexV1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
51
+
52
+ # Gets information about a location.
53
+ # @param [String] name
54
+ # Resource name for the location.
55
+ # @param [String] fields
56
+ # Selector specifying which fields to include in a partial response.
57
+ # @param [String] quota_user
58
+ # Available to use for quota purposes for server-side applications. Can be any
59
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
60
+ # @param [Google::Apis::RequestOptions] options
61
+ # Request-specific options
62
+ #
63
+ # @yield [result, err] Result & error if block supplied
64
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudLocationLocation] parsed result object
65
+ # @yieldparam err [StandardError] error object if request failed
66
+ #
67
+ # @return [Google::Apis::DataplexV1::GoogleCloudLocationLocation]
68
+ #
69
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
70
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
71
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
72
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
73
+ command = make_simple_command(:get, 'v1/{+name}', options)
74
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudLocationLocation::Representation
75
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudLocationLocation
76
+ command.params['name'] = name unless name.nil?
77
+ command.query['fields'] = fields unless fields.nil?
78
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
79
+ execute_or_queue_command(command, &block)
80
+ end
81
+
82
+ # Lists information about the supported locations for this service.
83
+ # @param [String] name
84
+ # The resource that owns the locations collection, if applicable.
85
+ # @param [String] filter
86
+ # A filter to narrow down results to a preferred subset. The filtering language
87
+ # accepts strings like "displayName=tokyo", and is documented in more detail in
88
+ # AIP-160 (https://google.aip.dev/160).
89
+ # @param [Fixnum] page_size
90
+ # The maximum number of results to return. If not set, the service selects a
91
+ # default.
92
+ # @param [String] page_token
93
+ # A page token received from the next_page_token field in the response. Send
94
+ # that page token to receive the subsequent page.
95
+ # @param [String] fields
96
+ # Selector specifying which fields to include in a partial response.
97
+ # @param [String] quota_user
98
+ # Available to use for quota purposes for server-side applications. Can be any
99
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [Google::Apis::RequestOptions] options
101
+ # Request-specific options
102
+ #
103
+ # @yield [result, err] Result & error if block supplied
104
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudLocationListLocationsResponse] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::DataplexV1::GoogleCloudLocationListLocationsResponse]
108
+ #
109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
112
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
113
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
114
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudLocationListLocationsResponse::Representation
115
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudLocationListLocationsResponse
116
+ command.params['name'] = name unless name.nil?
117
+ command.query['filter'] = filter unless filter.nil?
118
+ command.query['pageSize'] = page_size unless page_size.nil?
119
+ command.query['pageToken'] = page_token unless page_token.nil?
120
+ command.query['fields'] = fields unless fields.nil?
121
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
122
+ execute_or_queue_command(command, &block)
123
+ end
124
+
125
+ # Creates a lake resource.
126
+ # @param [String] parent
127
+ # Required. The resource name of the lake location, of the form: projects/`
128
+ # project_number`/locations/`location_id` where location_id refers to a GCP
129
+ # region.
130
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake] google_cloud_dataplex_v1_lake_object
131
+ # @param [String] lake_id
132
+ # Required. Lake identifier. This ID will be used to generate names such as
133
+ # database and dataset names when publishing metadata to Hive Metastore and
134
+ # BigQuery. * Must contain only lowercase letters, numbers and hyphens. * Must
135
+ # start with a letter. * Must end with a number or a letter. * Must be between 1-
136
+ # 63 characters. * Must be unique within the customer project / location.
137
+ # @param [Boolean] validate_only
138
+ # Optional. Only validate the request, but do not perform mutations. The default
139
+ # is false.
140
+ # @param [String] fields
141
+ # Selector specifying which fields to include in a partial response.
142
+ # @param [String] quota_user
143
+ # Available to use for quota purposes for server-side applications. Can be any
144
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
145
+ # @param [Google::Apis::RequestOptions] options
146
+ # Request-specific options
147
+ #
148
+ # @yield [result, err] Result & error if block supplied
149
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
150
+ # @yieldparam err [StandardError] error object if request failed
151
+ #
152
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
153
+ #
154
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
155
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
156
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
157
+ def create_project_location_lake(parent, google_cloud_dataplex_v1_lake_object = nil, lake_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
158
+ command = make_simple_command(:post, 'v1/{+parent}/lakes', options)
159
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake::Representation
160
+ command.request_object = google_cloud_dataplex_v1_lake_object
161
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
162
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
163
+ command.params['parent'] = parent unless parent.nil?
164
+ command.query['lakeId'] = lake_id unless lake_id.nil?
165
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
166
+ command.query['fields'] = fields unless fields.nil?
167
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
168
+ execute_or_queue_command(command, &block)
169
+ end
170
+
171
+ # Deletes a lake resource. All zones within the lake must be deleted before the
172
+ # lake can be deleted.
173
+ # @param [String] name
174
+ # Required. The resource name of the lake: projects/`project_number`/locations/`
175
+ # location_id`/lakes/`lake_id`
176
+ # @param [String] fields
177
+ # Selector specifying which fields to include in a partial response.
178
+ # @param [String] quota_user
179
+ # Available to use for quota purposes for server-side applications. Can be any
180
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
181
+ # @param [Google::Apis::RequestOptions] options
182
+ # Request-specific options
183
+ #
184
+ # @yield [result, err] Result & error if block supplied
185
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
186
+ # @yieldparam err [StandardError] error object if request failed
187
+ #
188
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
189
+ #
190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
193
+ def delete_project_location_lake(name, fields: nil, quota_user: nil, options: nil, &block)
194
+ command = make_simple_command(:delete, 'v1/{+name}', options)
195
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
196
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
197
+ command.params['name'] = name unless name.nil?
198
+ command.query['fields'] = fields unless fields.nil?
199
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
200
+ execute_or_queue_command(command, &block)
201
+ end
202
+
203
+ # Retrieves a lake resource.
204
+ # @param [String] name
205
+ # Required. The resource name of the lake: projects/`project_number`/locations/`
206
+ # location_id`/lakes/`lake_id`
207
+ # @param [String] fields
208
+ # Selector specifying which fields to include in a partial response.
209
+ # @param [String] quota_user
210
+ # Available to use for quota purposes for server-side applications. Can be any
211
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
212
+ # @param [Google::Apis::RequestOptions] options
213
+ # Request-specific options
214
+ #
215
+ # @yield [result, err] Result & error if block supplied
216
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake] parsed result object
217
+ # @yieldparam err [StandardError] error object if request failed
218
+ #
219
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake]
220
+ #
221
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
222
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
223
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
224
+ def get_project_location_lake(name, fields: nil, quota_user: nil, options: nil, &block)
225
+ command = make_simple_command(:get, 'v1/{+name}', options)
226
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake::Representation
227
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake
228
+ command.params['name'] = name unless name.nil?
229
+ command.query['fields'] = fields unless fields.nil?
230
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
231
+ execute_or_queue_command(command, &block)
232
+ end
233
+
234
+ # Gets the access control policy for a resource. Returns an empty policy if the
235
+ # resource exists and does not have a policy set.
236
+ # @param [String] resource
237
+ # REQUIRED: The resource for which the policy is being requested. See the
238
+ # operation documentation for the appropriate value for this field.
239
+ # @param [Fixnum] options_requested_policy_version
240
+ # Optional. The maximum policy version that will be used to format the policy.
241
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
242
+ # rejected.Requests for policies with any conditional role bindings must specify
243
+ # version 3. Policies with no conditional role bindings may specify any valid
244
+ # value or leave the field unset.The policy in the response might use the policy
245
+ # version that you specified, or it might use a lower policy version. For
246
+ # example, if you specify version 3, but the policy has no conditional role
247
+ # bindings, the response uses version 1.To learn which resources support
248
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
249
+ # google.com/iam/help/conditions/resource-policies).
250
+ # @param [String] fields
251
+ # Selector specifying which fields to include in a partial response.
252
+ # @param [String] quota_user
253
+ # Available to use for quota purposes for server-side applications. Can be any
254
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
255
+ # @param [Google::Apis::RequestOptions] options
256
+ # Request-specific options
257
+ #
258
+ # @yield [result, err] Result & error if block supplied
259
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
260
+ # @yieldparam err [StandardError] error object if request failed
261
+ #
262
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
263
+ #
264
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
265
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
266
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
267
+ def get_project_location_lake_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
268
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
269
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
270
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
271
+ command.params['resource'] = resource unless resource.nil?
272
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
273
+ command.query['fields'] = fields unless fields.nil?
274
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
275
+ execute_or_queue_command(command, &block)
276
+ end
277
+
278
+ # Lists lake resources in a project and location.
279
+ # @param [String] parent
280
+ # Required. The resource name of the lake location, of the form: projects/`
281
+ # project_number`/locations/`location_id` where location_id refers to a GCP
282
+ # region.
283
+ # @param [String] filter
284
+ # Optional. Filter request.
285
+ # @param [String] order_by
286
+ # Optional. Order by fields for the result.
287
+ # @param [Fixnum] page_size
288
+ # Optional. Maximum number of Lakes to return. The service may return fewer than
289
+ # this value. If unspecified, at most 10 lakes will be returned. The maximum
290
+ # value is 1000; values above 1000 will be coerced to 1000.
291
+ # @param [String] page_token
292
+ # Optional. Page token received from a previous ListLakes call. Provide this to
293
+ # retrieve the subsequent page. When paginating, all other parameters provided
294
+ # to ListLakes must match the call that provided the page token.
295
+ # @param [String] fields
296
+ # Selector specifying which fields to include in a partial response.
297
+ # @param [String] quota_user
298
+ # Available to use for quota purposes for server-side applications. Can be any
299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
300
+ # @param [Google::Apis::RequestOptions] options
301
+ # Request-specific options
302
+ #
303
+ # @yield [result, err] Result & error if block supplied
304
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListLakesResponse] parsed result object
305
+ # @yieldparam err [StandardError] error object if request failed
306
+ #
307
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListLakesResponse]
308
+ #
309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
312
+ def list_project_location_lakes(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
313
+ command = make_simple_command(:get, 'v1/{+parent}/lakes', options)
314
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListLakesResponse::Representation
315
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListLakesResponse
316
+ command.params['parent'] = parent unless parent.nil?
317
+ command.query['filter'] = filter unless filter.nil?
318
+ command.query['orderBy'] = order_by unless order_by.nil?
319
+ command.query['pageSize'] = page_size unless page_size.nil?
320
+ command.query['pageToken'] = page_token unless page_token.nil?
321
+ command.query['fields'] = fields unless fields.nil?
322
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
323
+ execute_or_queue_command(command, &block)
324
+ end
325
+
326
+ # Updates a lake resource.
327
+ # @param [String] name
328
+ # Output only. The relative resource name of the lake, of the form: projects/`
329
+ # project_number`/locations/`location_id`/lakes/`lake_id`.
330
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake] google_cloud_dataplex_v1_lake_object
331
+ # @param [String] update_mask
332
+ # Required. Mask of fields to update.
333
+ # @param [Boolean] validate_only
334
+ # Optional. Only validate the request, but do not perform mutations. The default
335
+ # is false.
336
+ # @param [String] fields
337
+ # Selector specifying which fields to include in a partial response.
338
+ # @param [String] quota_user
339
+ # Available to use for quota purposes for server-side applications. Can be any
340
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
341
+ # @param [Google::Apis::RequestOptions] options
342
+ # Request-specific options
343
+ #
344
+ # @yield [result, err] Result & error if block supplied
345
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
346
+ # @yieldparam err [StandardError] error object if request failed
347
+ #
348
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
349
+ #
350
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
351
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
352
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
353
+ def patch_project_location_lake(name, google_cloud_dataplex_v1_lake_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
354
+ command = make_simple_command(:patch, 'v1/{+name}', options)
355
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Lake::Representation
356
+ command.request_object = google_cloud_dataplex_v1_lake_object
357
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
358
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
359
+ command.params['name'] = name unless name.nil?
360
+ command.query['updateMask'] = update_mask unless update_mask.nil?
361
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
362
+ command.query['fields'] = fields unless fields.nil?
363
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
364
+ execute_or_queue_command(command, &block)
365
+ end
366
+
367
+ # Sets the access control policy on the specified resource. Replaces any
368
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
369
+ # errors.
370
+ # @param [String] resource
371
+ # REQUIRED: The resource for which the policy is being specified. See the
372
+ # operation documentation for the appropriate value for this field.
373
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
374
+ # @param [String] fields
375
+ # Selector specifying which fields to include in a partial response.
376
+ # @param [String] quota_user
377
+ # Available to use for quota purposes for server-side applications. Can be any
378
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
379
+ # @param [Google::Apis::RequestOptions] options
380
+ # Request-specific options
381
+ #
382
+ # @yield [result, err] Result & error if block supplied
383
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
384
+ # @yieldparam err [StandardError] error object if request failed
385
+ #
386
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
387
+ #
388
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
389
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
390
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
391
+ def set_project_location_lake_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
392
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
393
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
394
+ command.request_object = google_iam_v1_set_iam_policy_request_object
395
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
396
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
397
+ command.params['resource'] = resource unless resource.nil?
398
+ command.query['fields'] = fields unless fields.nil?
399
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
400
+ execute_or_queue_command(command, &block)
401
+ end
402
+
403
+ # Returns permissions that a caller has on the specified resource. If the
404
+ # resource does not exist, this will return an empty set of permissions, not a
405
+ # NOT_FOUND error.Note: This operation is designed to be used for building
406
+ # permission-aware UIs and command-line tools, not for authorization checking.
407
+ # This operation may "fail open" without warning.
408
+ # @param [String] resource
409
+ # REQUIRED: The resource for which the policy detail is being requested. See the
410
+ # operation documentation for the appropriate value for this field.
411
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
412
+ # @param [String] fields
413
+ # Selector specifying which fields to include in a partial response.
414
+ # @param [String] quota_user
415
+ # Available to use for quota purposes for server-side applications. Can be any
416
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
417
+ # @param [Google::Apis::RequestOptions] options
418
+ # Request-specific options
419
+ #
420
+ # @yield [result, err] Result & error if block supplied
421
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
422
+ # @yieldparam err [StandardError] error object if request failed
423
+ #
424
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
425
+ #
426
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
427
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
428
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
429
+ def test_project_location_lake_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
430
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
431
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
432
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
433
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
434
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
435
+ command.params['resource'] = resource unless resource.nil?
436
+ command.query['fields'] = fields unless fields.nil?
437
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
438
+ execute_or_queue_command(command, &block)
439
+ end
440
+
441
+ # Lists action resources in a lake.
442
+ # @param [String] parent
443
+ # Required. The resource name of the parent lake: projects/`project_number`/
444
+ # locations/`location_id`/lakes/`lake_id`
445
+ # @param [Fixnum] page_size
446
+ # Optional. Maximum number of actions to return. The service may return fewer
447
+ # than this value. If unspecified, at most 10 actions will be returned. The
448
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
449
+ # @param [String] page_token
450
+ # Optional. Page token received from a previous ListLakeActions call. Provide
451
+ # this to retrieve the subsequent page. When paginating, all other parameters
452
+ # provided to ListLakeActions must match the call that provided the page token.
453
+ # @param [String] fields
454
+ # Selector specifying which fields to include in a partial response.
455
+ # @param [String] quota_user
456
+ # Available to use for quota purposes for server-side applications. Can be any
457
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
458
+ # @param [Google::Apis::RequestOptions] options
459
+ # Request-specific options
460
+ #
461
+ # @yield [result, err] Result & error if block supplied
462
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse] parsed result object
463
+ # @yieldparam err [StandardError] error object if request failed
464
+ #
465
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse]
466
+ #
467
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
468
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
469
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
470
+ def list_project_location_lake_actions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
471
+ command = make_simple_command(:get, 'v1/{+parent}/actions', options)
472
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse::Representation
473
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse
474
+ command.params['parent'] = parent unless parent.nil?
475
+ command.query['pageSize'] = page_size unless page_size.nil?
476
+ command.query['pageToken'] = page_token unless page_token.nil?
477
+ command.query['fields'] = fields unless fields.nil?
478
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
479
+ execute_or_queue_command(command, &block)
480
+ end
481
+
482
+ # Gets the access control policy for a resource. Returns an empty policy if the
483
+ # resource exists and does not have a policy set.
484
+ # @param [String] resource
485
+ # REQUIRED: The resource for which the policy is being requested. See the
486
+ # operation documentation for the appropriate value for this field.
487
+ # @param [Fixnum] options_requested_policy_version
488
+ # Optional. The maximum policy version that will be used to format the policy.
489
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
490
+ # rejected.Requests for policies with any conditional role bindings must specify
491
+ # version 3. Policies with no conditional role bindings may specify any valid
492
+ # value or leave the field unset.The policy in the response might use the policy
493
+ # version that you specified, or it might use a lower policy version. For
494
+ # example, if you specify version 3, but the policy has no conditional role
495
+ # bindings, the response uses version 1.To learn which resources support
496
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
497
+ # google.com/iam/help/conditions/resource-policies).
498
+ # @param [String] fields
499
+ # Selector specifying which fields to include in a partial response.
500
+ # @param [String] quota_user
501
+ # Available to use for quota purposes for server-side applications. Can be any
502
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
503
+ # @param [Google::Apis::RequestOptions] options
504
+ # Request-specific options
505
+ #
506
+ # @yield [result, err] Result & error if block supplied
507
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
508
+ # @yieldparam err [StandardError] error object if request failed
509
+ #
510
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
511
+ #
512
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
513
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
514
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
515
+ def get_project_location_lake_content_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
516
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
517
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
518
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
519
+ command.params['resource'] = resource unless resource.nil?
520
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
521
+ command.query['fields'] = fields unless fields.nil?
522
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
523
+ execute_or_queue_command(command, &block)
524
+ end
525
+
526
+ # Sets the access control policy on the specified resource. Replaces any
527
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
528
+ # errors.
529
+ # @param [String] resource
530
+ # REQUIRED: The resource for which the policy is being specified. See the
531
+ # operation documentation for the appropriate value for this field.
532
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
533
+ # @param [String] fields
534
+ # Selector specifying which fields to include in a partial response.
535
+ # @param [String] quota_user
536
+ # Available to use for quota purposes for server-side applications. Can be any
537
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
538
+ # @param [Google::Apis::RequestOptions] options
539
+ # Request-specific options
540
+ #
541
+ # @yield [result, err] Result & error if block supplied
542
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
543
+ # @yieldparam err [StandardError] error object if request failed
544
+ #
545
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
546
+ #
547
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
548
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
549
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
550
+ def set_project_location_lake_content_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
551
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
552
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
553
+ command.request_object = google_iam_v1_set_iam_policy_request_object
554
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
555
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
556
+ command.params['resource'] = resource unless resource.nil?
557
+ command.query['fields'] = fields unless fields.nil?
558
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
559
+ execute_or_queue_command(command, &block)
560
+ end
561
+
562
+ # Returns permissions that a caller has on the specified resource. If the
563
+ # resource does not exist, this will return an empty set of permissions, not a
564
+ # NOT_FOUND error.Note: This operation is designed to be used for building
565
+ # permission-aware UIs and command-line tools, not for authorization checking.
566
+ # This operation may "fail open" without warning.
567
+ # @param [String] resource
568
+ # REQUIRED: The resource for which the policy detail is being requested. See the
569
+ # operation documentation for the appropriate value for this field.
570
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
571
+ # @param [String] fields
572
+ # Selector specifying which fields to include in a partial response.
573
+ # @param [String] quota_user
574
+ # Available to use for quota purposes for server-side applications. Can be any
575
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
576
+ # @param [Google::Apis::RequestOptions] options
577
+ # Request-specific options
578
+ #
579
+ # @yield [result, err] Result & error if block supplied
580
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
581
+ # @yieldparam err [StandardError] error object if request failed
582
+ #
583
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
584
+ #
585
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
586
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
587
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
588
+ def test_project_location_lake_content_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
589
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
590
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
591
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
592
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
593
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
594
+ command.params['resource'] = resource unless resource.nil?
595
+ command.query['fields'] = fields unless fields.nil?
596
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
597
+ execute_or_queue_command(command, &block)
598
+ end
599
+
600
+ # Create a content.
601
+ # @param [String] parent
602
+ # Required. The resource name of the parent lake: projects/`project_id`/
603
+ # locations/`location_id`/lakes/`lake_id`
604
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content] google_cloud_dataplex_v1_content_object
605
+ # @param [Boolean] validate_only
606
+ # Optional. Only validate the request, but do not perform mutations. The default
607
+ # is false.
608
+ # @param [String] fields
609
+ # Selector specifying which fields to include in a partial response.
610
+ # @param [String] quota_user
611
+ # Available to use for quota purposes for server-side applications. Can be any
612
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
613
+ # @param [Google::Apis::RequestOptions] options
614
+ # Request-specific options
615
+ #
616
+ # @yield [result, err] Result & error if block supplied
617
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content] parsed result object
618
+ # @yieldparam err [StandardError] error object if request failed
619
+ #
620
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content]
621
+ #
622
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
623
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
624
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
625
+ def create_project_location_lake_contentitem(parent, google_cloud_dataplex_v1_content_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
626
+ command = make_simple_command(:post, 'v1/{+parent}/contentitems', options)
627
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content::Representation
628
+ command.request_object = google_cloud_dataplex_v1_content_object
629
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content::Representation
630
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content
631
+ command.params['parent'] = parent unless parent.nil?
632
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
633
+ command.query['fields'] = fields unless fields.nil?
634
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
635
+ execute_or_queue_command(command, &block)
636
+ end
637
+
638
+ # Delete a content.
639
+ # @param [String] name
640
+ # Required. The resource name of the content: projects/`project_id`/locations/`
641
+ # location_id`/lakes/`lake_id`/content/`content_id`
642
+ # @param [String] fields
643
+ # Selector specifying which fields to include in a partial response.
644
+ # @param [String] quota_user
645
+ # Available to use for quota purposes for server-side applications. Can be any
646
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
647
+ # @param [Google::Apis::RequestOptions] options
648
+ # Request-specific options
649
+ #
650
+ # @yield [result, err] Result & error if block supplied
651
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
652
+ # @yieldparam err [StandardError] error object if request failed
653
+ #
654
+ # @return [Google::Apis::DataplexV1::Empty]
655
+ #
656
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
657
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
658
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
659
+ def delete_project_location_lake_contentitem(name, fields: nil, quota_user: nil, options: nil, &block)
660
+ command = make_simple_command(:delete, 'v1/{+name}', options)
661
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
662
+ command.response_class = Google::Apis::DataplexV1::Empty
663
+ command.params['name'] = name unless name.nil?
664
+ command.query['fields'] = fields unless fields.nil?
665
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
666
+ execute_or_queue_command(command, &block)
667
+ end
668
+
669
+ # Get a content resource.
670
+ # @param [String] name
671
+ # Required. The resource name of the content: projects/`project_id`/locations/`
672
+ # location_id`/lakes/`lake_id`/content/`content_id`
673
+ # @param [String] view
674
+ # Optional. Specify content view to make a partial request.
675
+ # @param [String] fields
676
+ # Selector specifying which fields to include in a partial response.
677
+ # @param [String] quota_user
678
+ # Available to use for quota purposes for server-side applications. Can be any
679
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
680
+ # @param [Google::Apis::RequestOptions] options
681
+ # Request-specific options
682
+ #
683
+ # @yield [result, err] Result & error if block supplied
684
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content] parsed result object
685
+ # @yieldparam err [StandardError] error object if request failed
686
+ #
687
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content]
688
+ #
689
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
690
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
691
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
692
+ def get_project_location_lake_contentitem(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
693
+ command = make_simple_command(:get, 'v1/{+name}', options)
694
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content::Representation
695
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content
696
+ command.params['name'] = name unless name.nil?
697
+ command.query['view'] = view unless view.nil?
698
+ command.query['fields'] = fields unless fields.nil?
699
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
700
+ execute_or_queue_command(command, &block)
701
+ end
702
+
703
+ # List content.
704
+ # @param [String] parent
705
+ # Required. The resource name of the parent lake: projects/`project_id`/
706
+ # locations/`location_id`/lakes/`lake_id`
707
+ # @param [String] filter
708
+ # Optional. Filter request. Filters are case-sensitive. The following formats
709
+ # are supported:labels.key1 = "value1" labels:key1 type = "NOTEBOOK" type = "
710
+ # SQL_SCRIPT"These restrictions can be coinjoined with AND, OR and NOT
711
+ # conjunctions.
712
+ # @param [Fixnum] page_size
713
+ # Optional. Maximum number of content to return. The service may return fewer
714
+ # than this value. If unspecified, at most 10 content will be returned. The
715
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
716
+ # @param [String] page_token
717
+ # Optional. Page token received from a previous ListContent call. Provide this
718
+ # to retrieve the subsequent page. When paginating, all other parameters
719
+ # provided to ListContent must match the call that provided the page token.
720
+ # @param [String] fields
721
+ # Selector specifying which fields to include in a partial response.
722
+ # @param [String] quota_user
723
+ # Available to use for quota purposes for server-side applications. Can be any
724
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
725
+ # @param [Google::Apis::RequestOptions] options
726
+ # Request-specific options
727
+ #
728
+ # @yield [result, err] Result & error if block supplied
729
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListContentResponse] parsed result object
730
+ # @yieldparam err [StandardError] error object if request failed
731
+ #
732
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListContentResponse]
733
+ #
734
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
735
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
736
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
737
+ def list_project_location_lake_contentitems(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
738
+ command = make_simple_command(:get, 'v1/{+parent}/contentitems', options)
739
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListContentResponse::Representation
740
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListContentResponse
741
+ command.params['parent'] = parent unless parent.nil?
742
+ command.query['filter'] = filter unless filter.nil?
743
+ command.query['pageSize'] = page_size unless page_size.nil?
744
+ command.query['pageToken'] = page_token unless page_token.nil?
745
+ command.query['fields'] = fields unless fields.nil?
746
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
747
+ execute_or_queue_command(command, &block)
748
+ end
749
+
750
+ # Update a content. Only supports full resource update.
751
+ # @param [String] name
752
+ # Output only. The relative resource name of the content, of the form: projects/`
753
+ # project_id`/locations/`location_id`/lakes/`lake_id`/content/`content_id`
754
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content] google_cloud_dataplex_v1_content_object
755
+ # @param [String] update_mask
756
+ # Required. Mask of fields to update.
757
+ # @param [Boolean] validate_only
758
+ # Optional. Only validate the request, but do not perform mutations. The default
759
+ # is false.
760
+ # @param [String] fields
761
+ # Selector specifying which fields to include in a partial response.
762
+ # @param [String] quota_user
763
+ # Available to use for quota purposes for server-side applications. Can be any
764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
765
+ # @param [Google::Apis::RequestOptions] options
766
+ # Request-specific options
767
+ #
768
+ # @yield [result, err] Result & error if block supplied
769
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content] parsed result object
770
+ # @yieldparam err [StandardError] error object if request failed
771
+ #
772
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Content]
773
+ #
774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
777
+ def patch_project_location_lake_contentitem(name, google_cloud_dataplex_v1_content_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
778
+ command = make_simple_command(:patch, 'v1/{+name}', options)
779
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content::Representation
780
+ command.request_object = google_cloud_dataplex_v1_content_object
781
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content::Representation
782
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Content
783
+ command.params['name'] = name unless name.nil?
784
+ command.query['updateMask'] = update_mask unless update_mask.nil?
785
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
786
+ command.query['fields'] = fields unless fields.nil?
787
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
788
+ execute_or_queue_command(command, &block)
789
+ end
790
+
791
+ # Create an environment resource.
792
+ # @param [String] parent
793
+ # Required. The resource name of the parent lake: projects/`project_id`/
794
+ # locations/`location_id`/lakes/`lake_id`
795
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment] google_cloud_dataplex_v1_environment_object
796
+ # @param [String] environment_id
797
+ # Required. Environment identifier. * Must contain only lowercase letters,
798
+ # numbers and hyphens. * Must start with a letter. * Must be between 1-63
799
+ # characters. * Must end with a number or a letter. * Must be unique within the
800
+ # lake.
801
+ # @param [Boolean] validate_only
802
+ # Optional. Only validate the request, but do not perform mutations. The default
803
+ # is false.
804
+ # @param [String] fields
805
+ # Selector specifying which fields to include in a partial response.
806
+ # @param [String] quota_user
807
+ # Available to use for quota purposes for server-side applications. Can be any
808
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
809
+ # @param [Google::Apis::RequestOptions] options
810
+ # Request-specific options
811
+ #
812
+ # @yield [result, err] Result & error if block supplied
813
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
814
+ # @yieldparam err [StandardError] error object if request failed
815
+ #
816
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
817
+ #
818
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
819
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
820
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
821
+ def create_project_location_lake_environment(parent, google_cloud_dataplex_v1_environment_object = nil, environment_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
822
+ command = make_simple_command(:post, 'v1/{+parent}/environments', options)
823
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment::Representation
824
+ command.request_object = google_cloud_dataplex_v1_environment_object
825
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
826
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
827
+ command.params['parent'] = parent unless parent.nil?
828
+ command.query['environmentId'] = environment_id unless environment_id.nil?
829
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
830
+ command.query['fields'] = fields unless fields.nil?
831
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
832
+ execute_or_queue_command(command, &block)
833
+ end
834
+
835
+ # Delete the environment resource. All the child resources must have been
836
+ # deleted before environment deletion can be initiated.
837
+ # @param [String] name
838
+ # Required. The resource name of the environment: projects/`project_id`/
839
+ # locations/`location_id`/lakes/`lake_id`/environments/`environment_id``
840
+ # @param [String] fields
841
+ # Selector specifying which fields to include in a partial response.
842
+ # @param [String] quota_user
843
+ # Available to use for quota purposes for server-side applications. Can be any
844
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
845
+ # @param [Google::Apis::RequestOptions] options
846
+ # Request-specific options
847
+ #
848
+ # @yield [result, err] Result & error if block supplied
849
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
850
+ # @yieldparam err [StandardError] error object if request failed
851
+ #
852
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
853
+ #
854
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
855
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
856
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
857
+ def delete_project_location_lake_environment(name, fields: nil, quota_user: nil, options: nil, &block)
858
+ command = make_simple_command(:delete, 'v1/{+name}', options)
859
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
860
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
861
+ command.params['name'] = name unless name.nil?
862
+ command.query['fields'] = fields unless fields.nil?
863
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
864
+ execute_or_queue_command(command, &block)
865
+ end
866
+
867
+ # Get environment resource.
868
+ # @param [String] name
869
+ # Required. The resource name of the environment: projects/`project_id`/
870
+ # locations/`location_id`/lakes/`lake_id`/environments/`environment_id`
871
+ # @param [String] fields
872
+ # Selector specifying which fields to include in a partial response.
873
+ # @param [String] quota_user
874
+ # Available to use for quota purposes for server-side applications. Can be any
875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
876
+ # @param [Google::Apis::RequestOptions] options
877
+ # Request-specific options
878
+ #
879
+ # @yield [result, err] Result & error if block supplied
880
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment]
884
+ #
885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
888
+ def get_project_location_lake_environment(name, fields: nil, quota_user: nil, options: nil, &block)
889
+ command = make_simple_command(:get, 'v1/{+name}', options)
890
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment::Representation
891
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment
892
+ command.params['name'] = name unless name.nil?
893
+ command.query['fields'] = fields unless fields.nil?
894
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
895
+ execute_or_queue_command(command, &block)
896
+ end
897
+
898
+ # Gets the access control policy for a resource. Returns an empty policy if the
899
+ # resource exists and does not have a policy set.
900
+ # @param [String] resource
901
+ # REQUIRED: The resource for which the policy is being requested. See the
902
+ # operation documentation for the appropriate value for this field.
903
+ # @param [Fixnum] options_requested_policy_version
904
+ # Optional. The maximum policy version that will be used to format the policy.
905
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
906
+ # rejected.Requests for policies with any conditional role bindings must specify
907
+ # version 3. Policies with no conditional role bindings may specify any valid
908
+ # value or leave the field unset.The policy in the response might use the policy
909
+ # version that you specified, or it might use a lower policy version. For
910
+ # example, if you specify version 3, but the policy has no conditional role
911
+ # bindings, the response uses version 1.To learn which resources support
912
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
913
+ # google.com/iam/help/conditions/resource-policies).
914
+ # @param [String] fields
915
+ # Selector specifying which fields to include in a partial response.
916
+ # @param [String] quota_user
917
+ # Available to use for quota purposes for server-side applications. Can be any
918
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
919
+ # @param [Google::Apis::RequestOptions] options
920
+ # Request-specific options
921
+ #
922
+ # @yield [result, err] Result & error if block supplied
923
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
924
+ # @yieldparam err [StandardError] error object if request failed
925
+ #
926
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
927
+ #
928
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
929
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
930
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
931
+ def get_project_location_lake_environment_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
932
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
933
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
934
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
935
+ command.params['resource'] = resource unless resource.nil?
936
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
937
+ command.query['fields'] = fields unless fields.nil?
938
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
939
+ execute_or_queue_command(command, &block)
940
+ end
941
+
942
+ # Lists environments under the given lake.
943
+ # @param [String] parent
944
+ # Required. The resource name of the parent lake: projects/`project_id`/
945
+ # locations/`location_id`/lakes/`lake_id`
946
+ # @param [String] filter
947
+ # Optional. Filter request.
948
+ # @param [String] order_by
949
+ # Optional. Order by fields for the result.
950
+ # @param [Fixnum] page_size
951
+ # Optional. Maximum number of environments to return. The service may return
952
+ # fewer than this value. If unspecified, at most 10 environments will be
953
+ # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
954
+ # @param [String] page_token
955
+ # Optional. Page token received from a previous ListEnvironments call. Provide
956
+ # this to retrieve the subsequent page. When paginating, all other parameters
957
+ # provided to ListEnvironments must match the call that provided the page token.
958
+ # @param [String] fields
959
+ # Selector specifying which fields to include in a partial response.
960
+ # @param [String] quota_user
961
+ # Available to use for quota purposes for server-side applications. Can be any
962
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
963
+ # @param [Google::Apis::RequestOptions] options
964
+ # Request-specific options
965
+ #
966
+ # @yield [result, err] Result & error if block supplied
967
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEnvironmentsResponse] parsed result object
968
+ # @yieldparam err [StandardError] error object if request failed
969
+ #
970
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEnvironmentsResponse]
971
+ #
972
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
973
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
974
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
975
+ def list_project_location_lake_environments(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
976
+ command = make_simple_command(:get, 'v1/{+parent}/environments', options)
977
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEnvironmentsResponse::Representation
978
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEnvironmentsResponse
979
+ command.params['parent'] = parent unless parent.nil?
980
+ command.query['filter'] = filter unless filter.nil?
981
+ command.query['orderBy'] = order_by unless order_by.nil?
982
+ command.query['pageSize'] = page_size unless page_size.nil?
983
+ command.query['pageToken'] = page_token unless page_token.nil?
984
+ command.query['fields'] = fields unless fields.nil?
985
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
986
+ execute_or_queue_command(command, &block)
987
+ end
988
+
989
+ # Update the environment resource.
990
+ # @param [String] name
991
+ # Output only. The relative resource name of the environment, of the form:
992
+ # projects/`project_id`/locations/`location_id`/lakes/`lake_id`/environment/`
993
+ # environment_id`
994
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment] google_cloud_dataplex_v1_environment_object
995
+ # @param [String] update_mask
996
+ # Required. Mask of fields to update.
997
+ # @param [Boolean] validate_only
998
+ # Optional. Only validate the request, but do not perform mutations. The default
999
+ # is false.
1000
+ # @param [String] fields
1001
+ # Selector specifying which fields to include in a partial response.
1002
+ # @param [String] quota_user
1003
+ # Available to use for quota purposes for server-side applications. Can be any
1004
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1005
+ # @param [Google::Apis::RequestOptions] options
1006
+ # Request-specific options
1007
+ #
1008
+ # @yield [result, err] Result & error if block supplied
1009
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1010
+ # @yieldparam err [StandardError] error object if request failed
1011
+ #
1012
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1013
+ #
1014
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1015
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1016
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1017
+ def patch_project_location_lake_environment(name, google_cloud_dataplex_v1_environment_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1018
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1019
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Environment::Representation
1020
+ command.request_object = google_cloud_dataplex_v1_environment_object
1021
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1022
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1023
+ command.params['name'] = name unless name.nil?
1024
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1025
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1026
+ command.query['fields'] = fields unless fields.nil?
1027
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1028
+ execute_or_queue_command(command, &block)
1029
+ end
1030
+
1031
+ # Sets the access control policy on the specified resource. Replaces any
1032
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
1033
+ # errors.
1034
+ # @param [String] resource
1035
+ # REQUIRED: The resource for which the policy is being specified. See the
1036
+ # operation documentation for the appropriate value for this field.
1037
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
1038
+ # @param [String] fields
1039
+ # Selector specifying which fields to include in a partial response.
1040
+ # @param [String] quota_user
1041
+ # Available to use for quota purposes for server-side applications. Can be any
1042
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1043
+ # @param [Google::Apis::RequestOptions] options
1044
+ # Request-specific options
1045
+ #
1046
+ # @yield [result, err] Result & error if block supplied
1047
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
1048
+ # @yieldparam err [StandardError] error object if request failed
1049
+ #
1050
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
1051
+ #
1052
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1053
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1054
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1055
+ def set_project_location_lake_environment_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1056
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1057
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
1058
+ command.request_object = google_iam_v1_set_iam_policy_request_object
1059
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
1060
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
1061
+ command.params['resource'] = resource unless resource.nil?
1062
+ command.query['fields'] = fields unless fields.nil?
1063
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1064
+ execute_or_queue_command(command, &block)
1065
+ end
1066
+
1067
+ # Returns permissions that a caller has on the specified resource. If the
1068
+ # resource does not exist, this will return an empty set of permissions, not a
1069
+ # NOT_FOUND error.Note: This operation is designed to be used for building
1070
+ # permission-aware UIs and command-line tools, not for authorization checking.
1071
+ # This operation may "fail open" without warning.
1072
+ # @param [String] resource
1073
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1074
+ # operation documentation for the appropriate value for this field.
1075
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
1076
+ # @param [String] fields
1077
+ # Selector specifying which fields to include in a partial response.
1078
+ # @param [String] quota_user
1079
+ # Available to use for quota purposes for server-side applications. Can be any
1080
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1081
+ # @param [Google::Apis::RequestOptions] options
1082
+ # Request-specific options
1083
+ #
1084
+ # @yield [result, err] Result & error if block supplied
1085
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
1086
+ # @yieldparam err [StandardError] error object if request failed
1087
+ #
1088
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
1089
+ #
1090
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1091
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1092
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1093
+ def test_project_location_lake_environment_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1094
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1095
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
1096
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
1097
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
1098
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
1099
+ command.params['resource'] = resource unless resource.nil?
1100
+ command.query['fields'] = fields unless fields.nil?
1101
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1102
+ execute_or_queue_command(command, &block)
1103
+ end
1104
+
1105
+ # Lists session resources in an environment.
1106
+ # @param [String] parent
1107
+ # Required. The resource name of the parent environment: projects/`
1108
+ # project_number`/locations/`location_id`/lakes/`lake_id`/environment/`
1109
+ # environment_id`
1110
+ # @param [Fixnum] page_size
1111
+ # Optional. Maximum number of sessions to return. The service may return fewer
1112
+ # than this value. If unspecified, at most 10 sessions will be returned. The
1113
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
1114
+ # @param [String] page_token
1115
+ # Optional. Page token received from a previous ListSessions call. Provide this
1116
+ # to retrieve the subsequent page. When paginating, all other parameters
1117
+ # provided to ListSessions must match the call that provided the page token.
1118
+ # @param [String] fields
1119
+ # Selector specifying which fields to include in a partial response.
1120
+ # @param [String] quota_user
1121
+ # Available to use for quota purposes for server-side applications. Can be any
1122
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1123
+ # @param [Google::Apis::RequestOptions] options
1124
+ # Request-specific options
1125
+ #
1126
+ # @yield [result, err] Result & error if block supplied
1127
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListSessionsResponse] parsed result object
1128
+ # @yieldparam err [StandardError] error object if request failed
1129
+ #
1130
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListSessionsResponse]
1131
+ #
1132
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1133
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1134
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1135
+ def list_project_location_lake_environment_sessions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1136
+ command = make_simple_command(:get, 'v1/{+parent}/sessions', options)
1137
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListSessionsResponse::Representation
1138
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListSessionsResponse
1139
+ command.params['parent'] = parent unless parent.nil?
1140
+ command.query['pageSize'] = page_size unless page_size.nil?
1141
+ command.query['pageToken'] = page_token unless page_token.nil?
1142
+ command.query['fields'] = fields unless fields.nil?
1143
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1144
+ execute_or_queue_command(command, &block)
1145
+ end
1146
+
1147
+ # Creates a task resource within a lake.
1148
+ # @param [String] parent
1149
+ # Required. The resource name of the parent lake: projects/`project_number`/
1150
+ # locations/`location_id`/lakes/`lake_id`
1151
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Task] google_cloud_dataplex_v1_task_object
1152
+ # @param [String] task_id
1153
+ # Required. Task identifier.
1154
+ # @param [Boolean] validate_only
1155
+ # Optional. Only validate the request, but do not perform mutations. The default
1156
+ # is false.
1157
+ # @param [String] fields
1158
+ # Selector specifying which fields to include in a partial response.
1159
+ # @param [String] quota_user
1160
+ # Available to use for quota purposes for server-side applications. Can be any
1161
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1162
+ # @param [Google::Apis::RequestOptions] options
1163
+ # Request-specific options
1164
+ #
1165
+ # @yield [result, err] Result & error if block supplied
1166
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1167
+ # @yieldparam err [StandardError] error object if request failed
1168
+ #
1169
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1170
+ #
1171
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1172
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1173
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1174
+ def create_project_location_lake_task(parent, google_cloud_dataplex_v1_task_object = nil, task_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1175
+ command = make_simple_command(:post, 'v1/{+parent}/tasks', options)
1176
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Task::Representation
1177
+ command.request_object = google_cloud_dataplex_v1_task_object
1178
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1179
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1180
+ command.params['parent'] = parent unless parent.nil?
1181
+ command.query['taskId'] = task_id unless task_id.nil?
1182
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1183
+ command.query['fields'] = fields unless fields.nil?
1184
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1185
+ execute_or_queue_command(command, &block)
1186
+ end
1187
+
1188
+ # Delete the task resource.
1189
+ # @param [String] name
1190
+ # Required. The resource name of the task: projects/`project_number`/locations/`
1191
+ # location_id`/lakes/`lake_id` /task/`task_id``
1192
+ # @param [String] fields
1193
+ # Selector specifying which fields to include in a partial response.
1194
+ # @param [String] quota_user
1195
+ # Available to use for quota purposes for server-side applications. Can be any
1196
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1197
+ # @param [Google::Apis::RequestOptions] options
1198
+ # Request-specific options
1199
+ #
1200
+ # @yield [result, err] Result & error if block supplied
1201
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1202
+ # @yieldparam err [StandardError] error object if request failed
1203
+ #
1204
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1205
+ #
1206
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1207
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1208
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1209
+ def delete_project_location_lake_task(name, fields: nil, quota_user: nil, options: nil, &block)
1210
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1211
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1212
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1213
+ command.params['name'] = name unless name.nil?
1214
+ command.query['fields'] = fields unless fields.nil?
1215
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1216
+ execute_or_queue_command(command, &block)
1217
+ end
1218
+
1219
+ # Get task resource.
1220
+ # @param [String] name
1221
+ # Required. The resource name of the task: projects/`project_number`/locations/`
1222
+ # location_id`/lakes/`lake_id` /tasks/`tasks_id`
1223
+ # @param [String] fields
1224
+ # Selector specifying which fields to include in a partial response.
1225
+ # @param [String] quota_user
1226
+ # Available to use for quota purposes for server-side applications. Can be any
1227
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1228
+ # @param [Google::Apis::RequestOptions] options
1229
+ # Request-specific options
1230
+ #
1231
+ # @yield [result, err] Result & error if block supplied
1232
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Task] parsed result object
1233
+ # @yieldparam err [StandardError] error object if request failed
1234
+ #
1235
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Task]
1236
+ #
1237
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1238
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1239
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1240
+ def get_project_location_lake_task(name, fields: nil, quota_user: nil, options: nil, &block)
1241
+ command = make_simple_command(:get, 'v1/{+name}', options)
1242
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Task::Representation
1243
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Task
1244
+ command.params['name'] = name unless name.nil?
1245
+ command.query['fields'] = fields unless fields.nil?
1246
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1247
+ execute_or_queue_command(command, &block)
1248
+ end
1249
+
1250
+ # Gets the access control policy for a resource. Returns an empty policy if the
1251
+ # resource exists and does not have a policy set.
1252
+ # @param [String] resource
1253
+ # REQUIRED: The resource for which the policy is being requested. See the
1254
+ # operation documentation for the appropriate value for this field.
1255
+ # @param [Fixnum] options_requested_policy_version
1256
+ # Optional. The maximum policy version that will be used to format the policy.
1257
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1258
+ # rejected.Requests for policies with any conditional role bindings must specify
1259
+ # version 3. Policies with no conditional role bindings may specify any valid
1260
+ # value or leave the field unset.The policy in the response might use the policy
1261
+ # version that you specified, or it might use a lower policy version. For
1262
+ # example, if you specify version 3, but the policy has no conditional role
1263
+ # bindings, the response uses version 1.To learn which resources support
1264
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
1265
+ # google.com/iam/help/conditions/resource-policies).
1266
+ # @param [String] fields
1267
+ # Selector specifying which fields to include in a partial response.
1268
+ # @param [String] quota_user
1269
+ # Available to use for quota purposes for server-side applications. Can be any
1270
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1271
+ # @param [Google::Apis::RequestOptions] options
1272
+ # Request-specific options
1273
+ #
1274
+ # @yield [result, err] Result & error if block supplied
1275
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
1276
+ # @yieldparam err [StandardError] error object if request failed
1277
+ #
1278
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
1279
+ #
1280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1283
+ def get_project_location_lake_task_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1284
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1285
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
1286
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
1287
+ command.params['resource'] = resource unless resource.nil?
1288
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1289
+ command.query['fields'] = fields unless fields.nil?
1290
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1291
+ execute_or_queue_command(command, &block)
1292
+ end
1293
+
1294
+ # Lists tasks under the given lake.
1295
+ # @param [String] parent
1296
+ # Required. The resource name of the parent lake: projects/`project_number`/
1297
+ # locations/`location_id`/lakes/`lake_id`
1298
+ # @param [String] filter
1299
+ # Optional. Filter request.
1300
+ # @param [String] order_by
1301
+ # Optional. Order by fields for the result.
1302
+ # @param [Fixnum] page_size
1303
+ # Optional. Maximum number of tasks to return. The service may return fewer than
1304
+ # this value. If unspecified, at most 10 tasks will be returned. The maximum
1305
+ # value is 1000; values above 1000 will be coerced to 1000.
1306
+ # @param [String] page_token
1307
+ # Optional. Page token received from a previous ListZones call. Provide this to
1308
+ # retrieve the subsequent page. When paginating, all other parameters provided
1309
+ # to ListZones must match the call that provided the page token.
1310
+ # @param [String] fields
1311
+ # Selector specifying which fields to include in a partial response.
1312
+ # @param [String] quota_user
1313
+ # Available to use for quota purposes for server-side applications. Can be any
1314
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1315
+ # @param [Google::Apis::RequestOptions] options
1316
+ # Request-specific options
1317
+ #
1318
+ # @yield [result, err] Result & error if block supplied
1319
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListTasksResponse] parsed result object
1320
+ # @yieldparam err [StandardError] error object if request failed
1321
+ #
1322
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListTasksResponse]
1323
+ #
1324
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1325
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1326
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1327
+ def list_project_location_lake_tasks(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1328
+ command = make_simple_command(:get, 'v1/{+parent}/tasks', options)
1329
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListTasksResponse::Representation
1330
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListTasksResponse
1331
+ command.params['parent'] = parent unless parent.nil?
1332
+ command.query['filter'] = filter unless filter.nil?
1333
+ command.query['orderBy'] = order_by unless order_by.nil?
1334
+ command.query['pageSize'] = page_size unless page_size.nil?
1335
+ command.query['pageToken'] = page_token unless page_token.nil?
1336
+ command.query['fields'] = fields unless fields.nil?
1337
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1338
+ execute_or_queue_command(command, &block)
1339
+ end
1340
+
1341
+ # Update the task resource.
1342
+ # @param [String] name
1343
+ # Output only. The relative resource name of the task, of the form: projects/`
1344
+ # project_number`/locations/`location_id`/lakes/`lake_id`/ tasks/`task_id`.
1345
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Task] google_cloud_dataplex_v1_task_object
1346
+ # @param [String] update_mask
1347
+ # Required. Mask of fields to update.
1348
+ # @param [Boolean] validate_only
1349
+ # Optional. Only validate the request, but do not perform mutations. The default
1350
+ # is false.
1351
+ # @param [String] fields
1352
+ # Selector specifying which fields to include in a partial response.
1353
+ # @param [String] quota_user
1354
+ # Available to use for quota purposes for server-side applications. Can be any
1355
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1356
+ # @param [Google::Apis::RequestOptions] options
1357
+ # Request-specific options
1358
+ #
1359
+ # @yield [result, err] Result & error if block supplied
1360
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1361
+ # @yieldparam err [StandardError] error object if request failed
1362
+ #
1363
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1364
+ #
1365
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1366
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1367
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1368
+ def patch_project_location_lake_task(name, google_cloud_dataplex_v1_task_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1369
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1370
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Task::Representation
1371
+ command.request_object = google_cloud_dataplex_v1_task_object
1372
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1373
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1374
+ command.params['name'] = name unless name.nil?
1375
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1376
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1377
+ command.query['fields'] = fields unless fields.nil?
1378
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1379
+ execute_or_queue_command(command, &block)
1380
+ end
1381
+
1382
+ # Sets the access control policy on the specified resource. Replaces any
1383
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
1384
+ # errors.
1385
+ # @param [String] resource
1386
+ # REQUIRED: The resource for which the policy is being specified. See the
1387
+ # operation documentation for the appropriate value for this field.
1388
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
1389
+ # @param [String] fields
1390
+ # Selector specifying which fields to include in a partial response.
1391
+ # @param [String] quota_user
1392
+ # Available to use for quota purposes for server-side applications. Can be any
1393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1394
+ # @param [Google::Apis::RequestOptions] options
1395
+ # Request-specific options
1396
+ #
1397
+ # @yield [result, err] Result & error if block supplied
1398
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
1399
+ # @yieldparam err [StandardError] error object if request failed
1400
+ #
1401
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
1402
+ #
1403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1406
+ def set_project_location_lake_task_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1407
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1408
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
1409
+ command.request_object = google_iam_v1_set_iam_policy_request_object
1410
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
1411
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
1412
+ command.params['resource'] = resource unless resource.nil?
1413
+ command.query['fields'] = fields unless fields.nil?
1414
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1415
+ execute_or_queue_command(command, &block)
1416
+ end
1417
+
1418
+ # Returns permissions that a caller has on the specified resource. If the
1419
+ # resource does not exist, this will return an empty set of permissions, not a
1420
+ # NOT_FOUND error.Note: This operation is designed to be used for building
1421
+ # permission-aware UIs and command-line tools, not for authorization checking.
1422
+ # This operation may "fail open" without warning.
1423
+ # @param [String] resource
1424
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1425
+ # operation documentation for the appropriate value for this field.
1426
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
1427
+ # @param [String] fields
1428
+ # Selector specifying which fields to include in a partial response.
1429
+ # @param [String] quota_user
1430
+ # Available to use for quota purposes for server-side applications. Can be any
1431
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1432
+ # @param [Google::Apis::RequestOptions] options
1433
+ # Request-specific options
1434
+ #
1435
+ # @yield [result, err] Result & error if block supplied
1436
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
1437
+ # @yieldparam err [StandardError] error object if request failed
1438
+ #
1439
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
1440
+ #
1441
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1442
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1443
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1444
+ def test_project_location_lake_task_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1445
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1446
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
1447
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
1448
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
1449
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
1450
+ command.params['resource'] = resource unless resource.nil?
1451
+ command.query['fields'] = fields unless fields.nil?
1452
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1453
+ execute_or_queue_command(command, &block)
1454
+ end
1455
+
1456
+ # Cancel jobs running for the task resource.
1457
+ # @param [String] name
1458
+ # Required. The resource name of the job: projects/`project_number`/locations/`
1459
+ # location_id`/lakes/`lake_id` /task/`task_id`/job/`job_id``
1460
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1CancelJobRequest] google_cloud_dataplex_v1_cancel_job_request_object
1461
+ # @param [String] fields
1462
+ # Selector specifying which fields to include in a partial response.
1463
+ # @param [String] quota_user
1464
+ # Available to use for quota purposes for server-side applications. Can be any
1465
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1466
+ # @param [Google::Apis::RequestOptions] options
1467
+ # Request-specific options
1468
+ #
1469
+ # @yield [result, err] Result & error if block supplied
1470
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
1471
+ # @yieldparam err [StandardError] error object if request failed
1472
+ #
1473
+ # @return [Google::Apis::DataplexV1::Empty]
1474
+ #
1475
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1476
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1477
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1478
+ def cancel_project_location_lake_task_job(name, google_cloud_dataplex_v1_cancel_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1479
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1480
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1CancelJobRequest::Representation
1481
+ command.request_object = google_cloud_dataplex_v1_cancel_job_request_object
1482
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
1483
+ command.response_class = Google::Apis::DataplexV1::Empty
1484
+ command.params['name'] = name unless name.nil?
1485
+ command.query['fields'] = fields unless fields.nil?
1486
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1487
+ execute_or_queue_command(command, &block)
1488
+ end
1489
+
1490
+ # Get job resource.
1491
+ # @param [String] name
1492
+ # Required. The resource name of the job: projects/`project_number`/locations/`
1493
+ # location_id`/lakes/`lake_id` /tasks/`task_id`/jobs/`job_id`
1494
+ # @param [String] fields
1495
+ # Selector specifying which fields to include in a partial response.
1496
+ # @param [String] quota_user
1497
+ # Available to use for quota purposes for server-side applications. Can be any
1498
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1499
+ # @param [Google::Apis::RequestOptions] options
1500
+ # Request-specific options
1501
+ #
1502
+ # @yield [result, err] Result & error if block supplied
1503
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Job] parsed result object
1504
+ # @yieldparam err [StandardError] error object if request failed
1505
+ #
1506
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Job]
1507
+ #
1508
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1509
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1510
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1511
+ def get_project_location_lake_task_job(name, fields: nil, quota_user: nil, options: nil, &block)
1512
+ command = make_simple_command(:get, 'v1/{+name}', options)
1513
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Job::Representation
1514
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Job
1515
+ command.params['name'] = name unless name.nil?
1516
+ command.query['fields'] = fields unless fields.nil?
1517
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1518
+ execute_or_queue_command(command, &block)
1519
+ end
1520
+
1521
+ # Lists Jobs under the given task.
1522
+ # @param [String] parent
1523
+ # Required. The resource name of the parent environment: projects/`
1524
+ # project_number`/locations/`location_id`/lakes/`lake_id`/tasks/`task_id`
1525
+ # @param [Fixnum] page_size
1526
+ # Optional. Maximum number of jobs to return. The service may return fewer than
1527
+ # this value. If unspecified, at most 10 jobs will be returned. The maximum
1528
+ # value is 1000; values above 1000 will be coerced to 1000.
1529
+ # @param [String] page_token
1530
+ # Optional. Page token received from a previous ListJobs call. Provide this to
1531
+ # retrieve the subsequent page. When paginating, all other parameters provided
1532
+ # to ListJobs must match the call that provided the page token.
1533
+ # @param [String] fields
1534
+ # Selector specifying which fields to include in a partial response.
1535
+ # @param [String] quota_user
1536
+ # Available to use for quota purposes for server-side applications. Can be any
1537
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1538
+ # @param [Google::Apis::RequestOptions] options
1539
+ # Request-specific options
1540
+ #
1541
+ # @yield [result, err] Result & error if block supplied
1542
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListJobsResponse] parsed result object
1543
+ # @yieldparam err [StandardError] error object if request failed
1544
+ #
1545
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListJobsResponse]
1546
+ #
1547
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1548
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1549
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1550
+ def list_project_location_lake_task_jobs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1551
+ command = make_simple_command(:get, 'v1/{+parent}/jobs', options)
1552
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListJobsResponse::Representation
1553
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListJobsResponse
1554
+ command.params['parent'] = parent unless parent.nil?
1555
+ command.query['pageSize'] = page_size unless page_size.nil?
1556
+ command.query['pageToken'] = page_token unless page_token.nil?
1557
+ command.query['fields'] = fields unless fields.nil?
1558
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1559
+ execute_or_queue_command(command, &block)
1560
+ end
1561
+
1562
+ # Creates a zone resource within a lake.
1563
+ # @param [String] parent
1564
+ # Required. The resource name of the parent lake: projects/`project_number`/
1565
+ # locations/`location_id`/lakes/`lake_id`
1566
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone] google_cloud_dataplex_v1_zone_object
1567
+ # @param [Boolean] validate_only
1568
+ # Optional. Only validate the request, but do not perform mutations. The default
1569
+ # is false.
1570
+ # @param [String] zone_id
1571
+ # Required. Zone identifier. This ID will be used to generate names such as
1572
+ # database and dataset names when publishing metadata to Hive Metastore and
1573
+ # BigQuery. * Must contain only lowercase letters, numbers and hyphens. * Must
1574
+ # start with a letter. * Must end with a number or a letter. * Must be between 1-
1575
+ # 63 characters. * Must be unique across all lakes from all locations in a
1576
+ # project. * Must not be one of the reserved IDs (i.e. "default", "global-temp")
1577
+ # @param [String] fields
1578
+ # Selector specifying which fields to include in a partial response.
1579
+ # @param [String] quota_user
1580
+ # Available to use for quota purposes for server-side applications. Can be any
1581
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1582
+ # @param [Google::Apis::RequestOptions] options
1583
+ # Request-specific options
1584
+ #
1585
+ # @yield [result, err] Result & error if block supplied
1586
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1587
+ # @yieldparam err [StandardError] error object if request failed
1588
+ #
1589
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1590
+ #
1591
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1592
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1593
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1594
+ def create_project_location_lake_zone(parent, google_cloud_dataplex_v1_zone_object = nil, validate_only: nil, zone_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1595
+ command = make_simple_command(:post, 'v1/{+parent}/zones', options)
1596
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone::Representation
1597
+ command.request_object = google_cloud_dataplex_v1_zone_object
1598
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1599
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1600
+ command.params['parent'] = parent unless parent.nil?
1601
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1602
+ command.query['zoneId'] = zone_id unless zone_id.nil?
1603
+ command.query['fields'] = fields unless fields.nil?
1604
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1605
+ execute_or_queue_command(command, &block)
1606
+ end
1607
+
1608
+ # Deletes a zone resource. All assets within a zone must be deleted before the
1609
+ # zone can be deleted.
1610
+ # @param [String] name
1611
+ # Required. The resource name of the zone: projects/`project_number`/locations/`
1612
+ # location_id`/lakes/`lake_id` /zones/`zone_id``
1613
+ # @param [String] fields
1614
+ # Selector specifying which fields to include in a partial response.
1615
+ # @param [String] quota_user
1616
+ # Available to use for quota purposes for server-side applications. Can be any
1617
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1618
+ # @param [Google::Apis::RequestOptions] options
1619
+ # Request-specific options
1620
+ #
1621
+ # @yield [result, err] Result & error if block supplied
1622
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1623
+ # @yieldparam err [StandardError] error object if request failed
1624
+ #
1625
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1626
+ #
1627
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1628
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1629
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1630
+ def delete_project_location_lake_zone(name, fields: nil, quota_user: nil, options: nil, &block)
1631
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1632
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1633
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1634
+ command.params['name'] = name unless name.nil?
1635
+ command.query['fields'] = fields unless fields.nil?
1636
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1637
+ execute_or_queue_command(command, &block)
1638
+ end
1639
+
1640
+ # Retrieves a zone resource.
1641
+ # @param [String] name
1642
+ # Required. The resource name of the zone: projects/`project_number`/locations/`
1643
+ # location_id`/lakes/`lake_id` /zones/`zone_id`
1644
+ # @param [String] fields
1645
+ # Selector specifying which fields to include in a partial response.
1646
+ # @param [String] quota_user
1647
+ # Available to use for quota purposes for server-side applications. Can be any
1648
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1649
+ # @param [Google::Apis::RequestOptions] options
1650
+ # Request-specific options
1651
+ #
1652
+ # @yield [result, err] Result & error if block supplied
1653
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone] parsed result object
1654
+ # @yieldparam err [StandardError] error object if request failed
1655
+ #
1656
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone]
1657
+ #
1658
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1659
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1660
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1661
+ def get_project_location_lake_zone(name, fields: nil, quota_user: nil, options: nil, &block)
1662
+ command = make_simple_command(:get, 'v1/{+name}', options)
1663
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone::Representation
1664
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone
1665
+ command.params['name'] = name unless name.nil?
1666
+ command.query['fields'] = fields unless fields.nil?
1667
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1668
+ execute_or_queue_command(command, &block)
1669
+ end
1670
+
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 the
1675
+ # operation documentation for the appropriate value for this field.
1676
+ # @param [Fixnum] options_requested_policy_version
1677
+ # Optional. The maximum policy version that will be used to format the policy.
1678
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1679
+ # rejected.Requests for policies with any conditional role bindings must specify
1680
+ # version 3. Policies with no conditional role bindings may specify any valid
1681
+ # value or leave the field unset.The policy in the response might use the policy
1682
+ # version that you specified, or it might use a lower policy version. For
1683
+ # example, if you specify version 3, but the policy has no conditional role
1684
+ # bindings, the response uses version 1.To learn which resources support
1685
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
1686
+ # google.com/iam/help/conditions/resource-policies).
1687
+ # @param [String] fields
1688
+ # Selector specifying which fields to include in a partial response.
1689
+ # @param [String] quota_user
1690
+ # Available to use for quota purposes for server-side applications. Can be any
1691
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1692
+ # @param [Google::Apis::RequestOptions] options
1693
+ # Request-specific options
1694
+ #
1695
+ # @yield [result, err] Result & error if block supplied
1696
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
1697
+ # @yieldparam err [StandardError] error object if request failed
1698
+ #
1699
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
1700
+ #
1701
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1702
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1703
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1704
+ def get_project_location_lake_zone_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1705
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1706
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
1707
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
1708
+ command.params['resource'] = resource unless resource.nil?
1709
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1710
+ command.query['fields'] = fields unless fields.nil?
1711
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1712
+ execute_or_queue_command(command, &block)
1713
+ end
1714
+
1715
+ # Lists zone resources in a lake.
1716
+ # @param [String] parent
1717
+ # Required. The resource name of the parent lake: projects/`project_number`/
1718
+ # locations/`location_id`/lakes/`lake_id`
1719
+ # @param [String] filter
1720
+ # Optional. Filter request.
1721
+ # @param [String] order_by
1722
+ # Optional. Order by fields for the result.
1723
+ # @param [Fixnum] page_size
1724
+ # Optional. Maximum number of zones to return. The service may return fewer than
1725
+ # this value. If unspecified, at most 10 zones will be returned. The maximum
1726
+ # value is 1000; values above 1000 will be coerced to 1000.
1727
+ # @param [String] page_token
1728
+ # Optional. Page token received from a previous ListZones call. Provide this to
1729
+ # retrieve the subsequent page. When paginating, all other parameters provided
1730
+ # to ListZones must match the call that provided the page token.
1731
+ # @param [String] fields
1732
+ # Selector specifying which fields to include in a partial response.
1733
+ # @param [String] quota_user
1734
+ # Available to use for quota purposes for server-side applications. Can be any
1735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1736
+ # @param [Google::Apis::RequestOptions] options
1737
+ # Request-specific options
1738
+ #
1739
+ # @yield [result, err] Result & error if block supplied
1740
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListZonesResponse] parsed result object
1741
+ # @yieldparam err [StandardError] error object if request failed
1742
+ #
1743
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListZonesResponse]
1744
+ #
1745
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1746
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1747
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1748
+ def list_project_location_lake_zones(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1749
+ command = make_simple_command(:get, 'v1/{+parent}/zones', options)
1750
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListZonesResponse::Representation
1751
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListZonesResponse
1752
+ command.params['parent'] = parent unless parent.nil?
1753
+ command.query['filter'] = filter unless filter.nil?
1754
+ command.query['orderBy'] = order_by unless order_by.nil?
1755
+ command.query['pageSize'] = page_size unless page_size.nil?
1756
+ command.query['pageToken'] = page_token unless page_token.nil?
1757
+ command.query['fields'] = fields unless fields.nil?
1758
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1759
+ execute_or_queue_command(command, &block)
1760
+ end
1761
+
1762
+ # Updates a zone resource.
1763
+ # @param [String] name
1764
+ # Output only. The relative resource name of the zone, of the form: projects/`
1765
+ # project_number`/locations/`location_id`/lakes/`lake_id`/zones/`zone_id`.
1766
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone] google_cloud_dataplex_v1_zone_object
1767
+ # @param [String] update_mask
1768
+ # Required. Mask of fields to update.
1769
+ # @param [Boolean] validate_only
1770
+ # Optional. Only validate the request, but do not perform mutations. The default
1771
+ # is false.
1772
+ # @param [String] fields
1773
+ # Selector specifying which fields to include in a partial response.
1774
+ # @param [String] quota_user
1775
+ # Available to use for quota purposes for server-side applications. Can be any
1776
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1777
+ # @param [Google::Apis::RequestOptions] options
1778
+ # Request-specific options
1779
+ #
1780
+ # @yield [result, err] Result & error if block supplied
1781
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1782
+ # @yieldparam err [StandardError] error object if request failed
1783
+ #
1784
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1785
+ #
1786
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1787
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1788
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1789
+ def patch_project_location_lake_zone(name, google_cloud_dataplex_v1_zone_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1790
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1791
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Zone::Representation
1792
+ command.request_object = google_cloud_dataplex_v1_zone_object
1793
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1794
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1795
+ command.params['name'] = name unless name.nil?
1796
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1797
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1798
+ command.query['fields'] = fields unless fields.nil?
1799
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1800
+ execute_or_queue_command(command, &block)
1801
+ end
1802
+
1803
+ # Sets the access control policy on the specified resource. Replaces any
1804
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
1805
+ # errors.
1806
+ # @param [String] resource
1807
+ # REQUIRED: The resource for which the policy is being specified. See the
1808
+ # operation documentation for the appropriate value for this field.
1809
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
1810
+ # @param [String] fields
1811
+ # Selector specifying which fields to include in a partial response.
1812
+ # @param [String] quota_user
1813
+ # Available to use for quota purposes for server-side applications. Can be any
1814
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1815
+ # @param [Google::Apis::RequestOptions] options
1816
+ # Request-specific options
1817
+ #
1818
+ # @yield [result, err] Result & error if block supplied
1819
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
1820
+ # @yieldparam err [StandardError] error object if request failed
1821
+ #
1822
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
1823
+ #
1824
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1825
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1826
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1827
+ def set_project_location_lake_zone_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1828
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1829
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
1830
+ command.request_object = google_iam_v1_set_iam_policy_request_object
1831
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
1832
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
1833
+ command.params['resource'] = resource unless resource.nil?
1834
+ command.query['fields'] = fields unless fields.nil?
1835
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1836
+ execute_or_queue_command(command, &block)
1837
+ end
1838
+
1839
+ # Returns permissions that a caller has on the specified resource. If the
1840
+ # resource does not exist, this will return an empty set of permissions, not a
1841
+ # NOT_FOUND error.Note: This operation is designed to be used for building
1842
+ # permission-aware UIs and command-line tools, not for authorization checking.
1843
+ # This operation may "fail open" without warning.
1844
+ # @param [String] resource
1845
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1846
+ # operation documentation for the appropriate value for this field.
1847
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
1848
+ # @param [String] fields
1849
+ # Selector specifying which fields to include in a partial response.
1850
+ # @param [String] quota_user
1851
+ # Available to use for quota purposes for server-side applications. Can be any
1852
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1853
+ # @param [Google::Apis::RequestOptions] options
1854
+ # Request-specific options
1855
+ #
1856
+ # @yield [result, err] Result & error if block supplied
1857
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
1858
+ # @yieldparam err [StandardError] error object if request failed
1859
+ #
1860
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
1861
+ #
1862
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1863
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1864
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1865
+ def test_project_location_lake_zone_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1866
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1867
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
1868
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
1869
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
1870
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
1871
+ command.params['resource'] = resource unless resource.nil?
1872
+ command.query['fields'] = fields unless fields.nil?
1873
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1874
+ execute_or_queue_command(command, &block)
1875
+ end
1876
+
1877
+ # Lists action resources in a zone.
1878
+ # @param [String] parent
1879
+ # Required. The resource name of the parent zone: projects/`project_number`/
1880
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`
1881
+ # @param [Fixnum] page_size
1882
+ # Optional. Maximum number of actions to return. The service may return fewer
1883
+ # than this value. If unspecified, at most 10 actions will be returned. The
1884
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
1885
+ # @param [String] page_token
1886
+ # Optional. Page token received from a previous ListZoneActions call. Provide
1887
+ # this to retrieve the subsequent page. When paginating, all other parameters
1888
+ # provided to ListZoneActions must match the call that provided the page token.
1889
+ # @param [String] fields
1890
+ # Selector specifying which fields to include in a partial response.
1891
+ # @param [String] quota_user
1892
+ # Available to use for quota purposes for server-side applications. Can be any
1893
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1894
+ # @param [Google::Apis::RequestOptions] options
1895
+ # Request-specific options
1896
+ #
1897
+ # @yield [result, err] Result & error if block supplied
1898
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse] parsed result object
1899
+ # @yieldparam err [StandardError] error object if request failed
1900
+ #
1901
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse]
1902
+ #
1903
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1904
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1905
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1906
+ def list_project_location_lake_zone_actions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1907
+ command = make_simple_command(:get, 'v1/{+parent}/actions', options)
1908
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse::Representation
1909
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse
1910
+ command.params['parent'] = parent unless parent.nil?
1911
+ command.query['pageSize'] = page_size unless page_size.nil?
1912
+ command.query['pageToken'] = page_token unless page_token.nil?
1913
+ command.query['fields'] = fields unless fields.nil?
1914
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1915
+ execute_or_queue_command(command, &block)
1916
+ end
1917
+
1918
+ # Creates an asset resource.
1919
+ # @param [String] parent
1920
+ # Required. The resource name of the parent zone: projects/`project_number`/
1921
+ # locations/`location_id`/lakes/`lake_id` /zones/`zone_id``
1922
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset] google_cloud_dataplex_v1_asset_object
1923
+ # @param [String] asset_id
1924
+ # Required. Asset identifier. This ID will be used to generate names such as
1925
+ # table names when publishing metadata to Hive Metastore and BigQuery. * Must
1926
+ # contain only lowercase letters, numbers and hyphens. * Must start with a
1927
+ # letter. * Must end with a number or a letter. * Must be between 1-63
1928
+ # characters. * Must be unique within the zone.
1929
+ # @param [Boolean] validate_only
1930
+ # Optional. Only validate the request, but do not perform mutations. The default
1931
+ # is false.
1932
+ # @param [String] fields
1933
+ # Selector specifying which fields to include in a partial response.
1934
+ # @param [String] quota_user
1935
+ # Available to use for quota purposes for server-side applications. Can be any
1936
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1937
+ # @param [Google::Apis::RequestOptions] options
1938
+ # Request-specific options
1939
+ #
1940
+ # @yield [result, err] Result & error if block supplied
1941
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1942
+ # @yieldparam err [StandardError] error object if request failed
1943
+ #
1944
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1945
+ #
1946
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1947
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1948
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1949
+ def create_project_location_lake_zone_asset(parent, google_cloud_dataplex_v1_asset_object = nil, asset_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1950
+ command = make_simple_command(:post, 'v1/{+parent}/assets', options)
1951
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset::Representation
1952
+ command.request_object = google_cloud_dataplex_v1_asset_object
1953
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1954
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1955
+ command.params['parent'] = parent unless parent.nil?
1956
+ command.query['assetId'] = asset_id unless asset_id.nil?
1957
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1958
+ command.query['fields'] = fields unless fields.nil?
1959
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1960
+ execute_or_queue_command(command, &block)
1961
+ end
1962
+
1963
+ # Deletes an asset resource. The referenced storage resource is detached (
1964
+ # default) or deleted based on the associated Lifecycle policy.
1965
+ # @param [String] name
1966
+ # Required. The resource name of the asset: projects/`project_number`/locations/`
1967
+ # location_id`/lakes/`lake_id` /zones/`zone_id`/assets/`asset_id`
1968
+ # @param [String] fields
1969
+ # Selector specifying which fields to include in a partial response.
1970
+ # @param [String] quota_user
1971
+ # Available to use for quota purposes for server-side applications. Can be any
1972
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1973
+ # @param [Google::Apis::RequestOptions] options
1974
+ # Request-specific options
1975
+ #
1976
+ # @yield [result, err] Result & error if block supplied
1977
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
1978
+ # @yieldparam err [StandardError] error object if request failed
1979
+ #
1980
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
1981
+ #
1982
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1983
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1984
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1985
+ def delete_project_location_lake_zone_asset(name, fields: nil, quota_user: nil, options: nil, &block)
1986
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1987
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
1988
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
1989
+ command.params['name'] = name unless name.nil?
1990
+ command.query['fields'] = fields unless fields.nil?
1991
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1992
+ execute_or_queue_command(command, &block)
1993
+ end
1994
+
1995
+ # Retrieves an asset resource.
1996
+ # @param [String] name
1997
+ # Required. The resource name of the asset: projects/`project_number`/locations/`
1998
+ # location_id`/lakes/`lake_id` /zones/`zone_id`/assets/`asset_id`
1999
+ # @param [String] fields
2000
+ # Selector specifying which fields to include in a partial response.
2001
+ # @param [String] quota_user
2002
+ # Available to use for quota purposes for server-side applications. Can be any
2003
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2004
+ # @param [Google::Apis::RequestOptions] options
2005
+ # Request-specific options
2006
+ #
2007
+ # @yield [result, err] Result & error if block supplied
2008
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset] parsed result object
2009
+ # @yieldparam err [StandardError] error object if request failed
2010
+ #
2011
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset]
2012
+ #
2013
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2014
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2015
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2016
+ def get_project_location_lake_zone_asset(name, fields: nil, quota_user: nil, options: nil, &block)
2017
+ command = make_simple_command(:get, 'v1/{+name}', options)
2018
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset::Representation
2019
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset
2020
+ command.params['name'] = name unless name.nil?
2021
+ command.query['fields'] = fields unless fields.nil?
2022
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2023
+ execute_or_queue_command(command, &block)
2024
+ end
2025
+
2026
+ # Gets the access control policy for a resource. Returns an empty policy if the
2027
+ # resource exists and does not have a policy set.
2028
+ # @param [String] resource
2029
+ # REQUIRED: The resource for which the policy is being requested. See the
2030
+ # operation documentation for the appropriate value for this field.
2031
+ # @param [Fixnum] options_requested_policy_version
2032
+ # Optional. The maximum policy version that will be used to format the policy.
2033
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2034
+ # rejected.Requests for policies with any conditional role bindings must specify
2035
+ # version 3. Policies with no conditional role bindings may specify any valid
2036
+ # value or leave the field unset.The policy in the response might use the policy
2037
+ # version that you specified, or it might use a lower policy version. For
2038
+ # example, if you specify version 3, but the policy has no conditional role
2039
+ # bindings, the response uses version 1.To learn which resources support
2040
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
2041
+ # google.com/iam/help/conditions/resource-policies).
2042
+ # @param [String] fields
2043
+ # Selector specifying which fields to include in a partial response.
2044
+ # @param [String] quota_user
2045
+ # Available to use for quota purposes for server-side applications. Can be any
2046
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2047
+ # @param [Google::Apis::RequestOptions] options
2048
+ # Request-specific options
2049
+ #
2050
+ # @yield [result, err] Result & error if block supplied
2051
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
2052
+ # @yieldparam err [StandardError] error object if request failed
2053
+ #
2054
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
2055
+ #
2056
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2057
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2058
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2059
+ def get_project_location_lake_zone_asset_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2060
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2061
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
2062
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
2063
+ command.params['resource'] = resource unless resource.nil?
2064
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2065
+ command.query['fields'] = fields unless fields.nil?
2066
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2067
+ execute_or_queue_command(command, &block)
2068
+ end
2069
+
2070
+ # Lists asset resources in a zone.
2071
+ # @param [String] parent
2072
+ # Required. The resource name of the parent zone: projects/`project_number`/
2073
+ # locations/`location_id`/lakes/`lake_id` /zones/`zone_id``
2074
+ # @param [String] filter
2075
+ # Optional. Filter request.
2076
+ # @param [String] order_by
2077
+ # Optional. Order by fields for the result.
2078
+ # @param [Fixnum] page_size
2079
+ # Optional. Maximum number of asset to return. The service may return fewer than
2080
+ # this value. If unspecified, at most 10 assets will be returned. The maximum
2081
+ # value is 1000; values above 1000 will be coerced to 1000.
2082
+ # @param [String] page_token
2083
+ # Optional. Page token received from a previous ListAssets call. Provide this to
2084
+ # retrieve the subsequent page. When paginating, all other parameters provided
2085
+ # to ListAssets must match the call that provided the page token.
2086
+ # @param [String] fields
2087
+ # Selector specifying which fields to include in a partial response.
2088
+ # @param [String] quota_user
2089
+ # Available to use for quota purposes for server-side applications. Can be any
2090
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2091
+ # @param [Google::Apis::RequestOptions] options
2092
+ # Request-specific options
2093
+ #
2094
+ # @yield [result, err] Result & error if block supplied
2095
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAssetsResponse] parsed result object
2096
+ # @yieldparam err [StandardError] error object if request failed
2097
+ #
2098
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAssetsResponse]
2099
+ #
2100
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2101
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2102
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2103
+ def list_project_location_lake_zone_assets(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2104
+ command = make_simple_command(:get, 'v1/{+parent}/assets', options)
2105
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAssetsResponse::Representation
2106
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListAssetsResponse
2107
+ command.params['parent'] = parent unless parent.nil?
2108
+ command.query['filter'] = filter unless filter.nil?
2109
+ command.query['orderBy'] = order_by unless order_by.nil?
2110
+ command.query['pageSize'] = page_size unless page_size.nil?
2111
+ command.query['pageToken'] = page_token unless page_token.nil?
2112
+ command.query['fields'] = fields unless fields.nil?
2113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2114
+ execute_or_queue_command(command, &block)
2115
+ end
2116
+
2117
+ # Updates an asset resource.
2118
+ # @param [String] name
2119
+ # Output only. The relative resource name of the asset, of the form: projects/`
2120
+ # project_number`/locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/assets/
2121
+ # `asset_id`.
2122
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset] google_cloud_dataplex_v1_asset_object
2123
+ # @param [String] update_mask
2124
+ # Required. Mask of fields to update.
2125
+ # @param [Boolean] validate_only
2126
+ # Optional. Only validate the request, but do not perform mutations. The default
2127
+ # is false.
2128
+ # @param [String] fields
2129
+ # Selector specifying which fields to include in a partial response.
2130
+ # @param [String] quota_user
2131
+ # Available to use for quota purposes for server-side applications. Can be any
2132
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2133
+ # @param [Google::Apis::RequestOptions] options
2134
+ # Request-specific options
2135
+ #
2136
+ # @yield [result, err] Result & error if block supplied
2137
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2138
+ # @yieldparam err [StandardError] error object if request failed
2139
+ #
2140
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2141
+ #
2142
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2143
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2144
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2145
+ def patch_project_location_lake_zone_asset(name, google_cloud_dataplex_v1_asset_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2146
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2147
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Asset::Representation
2148
+ command.request_object = google_cloud_dataplex_v1_asset_object
2149
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2150
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2151
+ command.params['name'] = name unless name.nil?
2152
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2153
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2154
+ command.query['fields'] = fields unless fields.nil?
2155
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2156
+ execute_or_queue_command(command, &block)
2157
+ end
2158
+
2159
+ # Sets the access control policy on the specified resource. Replaces any
2160
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
2161
+ # errors.
2162
+ # @param [String] resource
2163
+ # REQUIRED: The resource for which the policy is being specified. See the
2164
+ # operation documentation for the appropriate value for this field.
2165
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
2166
+ # @param [String] fields
2167
+ # Selector specifying which fields to include in a partial response.
2168
+ # @param [String] quota_user
2169
+ # Available to use for quota purposes for server-side applications. Can be any
2170
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2171
+ # @param [Google::Apis::RequestOptions] options
2172
+ # Request-specific options
2173
+ #
2174
+ # @yield [result, err] Result & error if block supplied
2175
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
2176
+ # @yieldparam err [StandardError] error object if request failed
2177
+ #
2178
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
2179
+ #
2180
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2181
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2182
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2183
+ def set_project_location_lake_zone_asset_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2184
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2185
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest::Representation
2186
+ command.request_object = google_iam_v1_set_iam_policy_request_object
2187
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
2188
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
2189
+ command.params['resource'] = resource unless resource.nil?
2190
+ command.query['fields'] = fields unless fields.nil?
2191
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2192
+ execute_or_queue_command(command, &block)
2193
+ end
2194
+
2195
+ # Returns permissions that a caller has on the specified resource. If the
2196
+ # resource does not exist, this will return an empty set of permissions, not a
2197
+ # NOT_FOUND error.Note: This operation is designed to be used for building
2198
+ # permission-aware UIs and command-line tools, not for authorization checking.
2199
+ # This operation may "fail open" without warning.
2200
+ # @param [String] resource
2201
+ # REQUIRED: The resource for which the policy detail is being requested. See the
2202
+ # operation documentation for the appropriate value for this field.
2203
+ # @param [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
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::GoogleIamV1TestIamPermissionsResponse] parsed result object
2214
+ # @yieldparam err [StandardError] error object if request failed
2215
+ #
2216
+ # @return [Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse]
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 test_project_location_lake_zone_asset_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2222
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2223
+ command.request_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsRequest::Representation
2224
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
2225
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse::Representation
2226
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1TestIamPermissionsResponse
2227
+ command.params['resource'] = resource unless resource.nil?
2228
+ command.query['fields'] = fields unless fields.nil?
2229
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2230
+ execute_or_queue_command(command, &block)
2231
+ end
2232
+
2233
+ # Lists action resources in an asset.
2234
+ # @param [String] parent
2235
+ # Required. The resource name of the parent asset: projects/`project_number`/
2236
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/assets/`asset_id`
2237
+ # @param [Fixnum] page_size
2238
+ # Optional. Maximum number of actions to return. The service may return fewer
2239
+ # than this value. If unspecified, at most 10 actions will be returned. The
2240
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
2241
+ # @param [String] page_token
2242
+ # Optional. Page token received from a previous ListAssetActions call. Provide
2243
+ # this to retrieve the subsequent page. When paginating, all other parameters
2244
+ # provided to ListAssetActions must match the call that provided the page token.
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::GoogleCloudDataplexV1ListActionsResponse] parsed result object
2255
+ # @yieldparam err [StandardError] error object if request failed
2256
+ #
2257
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse]
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 list_project_location_lake_zone_asset_actions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2263
+ command = make_simple_command(:get, 'v1/{+parent}/actions', options)
2264
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse::Representation
2265
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListActionsResponse
2266
+ command.params['parent'] = parent unless parent.nil?
2267
+ command.query['pageSize'] = page_size unless page_size.nil?
2268
+ command.query['pageToken'] = page_token unless page_token.nil?
2269
+ command.query['fields'] = fields unless fields.nil?
2270
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2271
+ execute_or_queue_command(command, &block)
2272
+ end
2273
+
2274
+ # Create a metadata entity.
2275
+ # @param [String] parent
2276
+ # Required. The resource name of the parent zone: projects/`project_number`/
2277
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`.
2278
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity] google_cloud_dataplex_v1_entity_object
2279
+ # @param [Boolean] validate_only
2280
+ # Optional. Only validate the request, but do not perform mutations. The default
2281
+ # is false.
2282
+ # @param [String] fields
2283
+ # Selector specifying which fields to include in a partial response.
2284
+ # @param [String] quota_user
2285
+ # Available to use for quota purposes for server-side applications. Can be any
2286
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2287
+ # @param [Google::Apis::RequestOptions] options
2288
+ # Request-specific options
2289
+ #
2290
+ # @yield [result, err] Result & error if block supplied
2291
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity] parsed result object
2292
+ # @yieldparam err [StandardError] error object if request failed
2293
+ #
2294
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity]
2295
+ #
2296
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2297
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2298
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2299
+ def create_project_location_lake_zone_entity(parent, google_cloud_dataplex_v1_entity_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2300
+ command = make_simple_command(:post, 'v1/{+parent}/entities', options)
2301
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity::Representation
2302
+ command.request_object = google_cloud_dataplex_v1_entity_object
2303
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity::Representation
2304
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity
2305
+ command.params['parent'] = parent unless parent.nil?
2306
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2307
+ command.query['fields'] = fields unless fields.nil?
2308
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2309
+ execute_or_queue_command(command, &block)
2310
+ end
2311
+
2312
+ # Delete a metadata entity.
2313
+ # @param [String] name
2314
+ # Required. The resource name of the entity: projects/`project_number`/locations/
2315
+ # `location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`.
2316
+ # @param [String] etag
2317
+ # Required. The etag associated with the partition if it was previously
2318
+ # retrieved.
2319
+ # @param [String] fields
2320
+ # Selector specifying which fields to include in a partial response.
2321
+ # @param [String] quota_user
2322
+ # Available to use for quota purposes for server-side applications. Can be any
2323
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2324
+ # @param [Google::Apis::RequestOptions] options
2325
+ # Request-specific options
2326
+ #
2327
+ # @yield [result, err] Result & error if block supplied
2328
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
2329
+ # @yieldparam err [StandardError] error object if request failed
2330
+ #
2331
+ # @return [Google::Apis::DataplexV1::Empty]
2332
+ #
2333
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2334
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2335
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2336
+ def delete_project_location_lake_zone_entity(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
2337
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2338
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
2339
+ command.response_class = Google::Apis::DataplexV1::Empty
2340
+ command.params['name'] = name unless name.nil?
2341
+ command.query['etag'] = etag unless etag.nil?
2342
+ command.query['fields'] = fields unless fields.nil?
2343
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2344
+ execute_or_queue_command(command, &block)
2345
+ end
2346
+
2347
+ # Get a metadata entity.
2348
+ # @param [String] name
2349
+ # Required. The resource name of the entity: projects/`project_number`/locations/
2350
+ # `location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`.
2351
+ # @param [String] view
2352
+ # Optional. Used to select the subset of entity information to return. Defaults
2353
+ # to BASIC.
2354
+ # @param [String] fields
2355
+ # Selector specifying which fields to include in a partial response.
2356
+ # @param [String] quota_user
2357
+ # Available to use for quota purposes for server-side applications. Can be any
2358
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2359
+ # @param [Google::Apis::RequestOptions] options
2360
+ # Request-specific options
2361
+ #
2362
+ # @yield [result, err] Result & error if block supplied
2363
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity] parsed result object
2364
+ # @yieldparam err [StandardError] error object if request failed
2365
+ #
2366
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity]
2367
+ #
2368
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2369
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2370
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2371
+ def get_project_location_lake_zone_entity(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
2372
+ command = make_simple_command(:get, 'v1/{+name}', options)
2373
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity::Representation
2374
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity
2375
+ command.params['name'] = name unless name.nil?
2376
+ command.query['view'] = view unless view.nil?
2377
+ command.query['fields'] = fields unless fields.nil?
2378
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2379
+ execute_or_queue_command(command, &block)
2380
+ end
2381
+
2382
+ # List metadata entities in a zone.
2383
+ # @param [String] parent
2384
+ # Required. The resource name of the parent zone: projects/`project_number`/
2385
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`.
2386
+ # @param [String] filter
2387
+ # Optional. The following filter parameters can be added to the URL to limit the
2388
+ # entities returned by the API: Entity ID: ?filter="id=entityID" Asset ID: ?
2389
+ # filter="asset=assetID" Data path ?filter="data_path=gs://my-bucket" Is HIVE
2390
+ # compatible: ?filter=”hive_compatible=true” Is BigQuery compatible: ?filter=”
2391
+ # bigquery_compatible=true”
2392
+ # @param [Fixnum] page_size
2393
+ # Optional. Maximum number of entities to return. The service may return fewer
2394
+ # than this value. If unspecified, 100 entities will be returned by default. The
2395
+ # maximum value is 500; larger values will will be truncated to 500.
2396
+ # @param [String] page_token
2397
+ # Optional. Page token received from a previous ListEntities call. Provide this
2398
+ # to retrieve the subsequent page. When paginating, all other parameters
2399
+ # provided to ListEntities must match the call that provided the page token.
2400
+ # @param [String] view
2401
+ # Required. Specify the entity view to make a partial list request.
2402
+ # @param [String] fields
2403
+ # Selector specifying which fields to include in a partial response.
2404
+ # @param [String] quota_user
2405
+ # Available to use for quota purposes for server-side applications. Can be any
2406
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2407
+ # @param [Google::Apis::RequestOptions] options
2408
+ # Request-specific options
2409
+ #
2410
+ # @yield [result, err] Result & error if block supplied
2411
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntitiesResponse] parsed result object
2412
+ # @yieldparam err [StandardError] error object if request failed
2413
+ #
2414
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntitiesResponse]
2415
+ #
2416
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2417
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2418
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2419
+ def list_project_location_lake_zone_entities(parent, filter: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
2420
+ command = make_simple_command(:get, 'v1/{+parent}/entities', options)
2421
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntitiesResponse::Representation
2422
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEntitiesResponse
2423
+ command.params['parent'] = parent unless parent.nil?
2424
+ command.query['filter'] = filter unless filter.nil?
2425
+ command.query['pageSize'] = page_size unless page_size.nil?
2426
+ command.query['pageToken'] = page_token unless page_token.nil?
2427
+ command.query['view'] = view unless view.nil?
2428
+ command.query['fields'] = fields unless fields.nil?
2429
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2430
+ execute_or_queue_command(command, &block)
2431
+ end
2432
+
2433
+ # Update a metadata entity. Only supports full resource update.
2434
+ # @param [String] name
2435
+ # Output only. The resource name of the entity, of the form: projects/`
2436
+ # project_number`/locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/
2437
+ # entities/`id`.
2438
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity] google_cloud_dataplex_v1_entity_object
2439
+ # @param [Boolean] validate_only
2440
+ # Optional. Only validate the request, but do not perform mutations. The default
2441
+ # is false.
2442
+ # @param [String] fields
2443
+ # Selector specifying which fields to include in a partial response.
2444
+ # @param [String] quota_user
2445
+ # Available to use for quota purposes for server-side applications. Can be any
2446
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2447
+ # @param [Google::Apis::RequestOptions] options
2448
+ # Request-specific options
2449
+ #
2450
+ # @yield [result, err] Result & error if block supplied
2451
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity] parsed result object
2452
+ # @yieldparam err [StandardError] error object if request failed
2453
+ #
2454
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity]
2455
+ #
2456
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2457
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2458
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2459
+ def update_project_location_lake_zone_entity(name, google_cloud_dataplex_v1_entity_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2460
+ command = make_simple_command(:put, 'v1/{+name}', options)
2461
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity::Representation
2462
+ command.request_object = google_cloud_dataplex_v1_entity_object
2463
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity::Representation
2464
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Entity
2465
+ command.params['name'] = name unless name.nil?
2466
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2467
+ command.query['fields'] = fields unless fields.nil?
2468
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2469
+ execute_or_queue_command(command, &block)
2470
+ end
2471
+
2472
+ # Create a metadata partition.
2473
+ # @param [String] parent
2474
+ # Required. The resource name of the parent zone: projects/`project_number`/
2475
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`.
2476
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition] google_cloud_dataplex_v1_partition_object
2477
+ # @param [Boolean] validate_only
2478
+ # Optional. Only validate the request, but do not perform mutations. The default
2479
+ # is false.
2480
+ # @param [String] fields
2481
+ # Selector specifying which fields to include in a partial response.
2482
+ # @param [String] quota_user
2483
+ # Available to use for quota purposes for server-side applications. Can be any
2484
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2485
+ # @param [Google::Apis::RequestOptions] options
2486
+ # Request-specific options
2487
+ #
2488
+ # @yield [result, err] Result & error if block supplied
2489
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition] parsed result object
2490
+ # @yieldparam err [StandardError] error object if request failed
2491
+ #
2492
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition]
2493
+ #
2494
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2495
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2496
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2497
+ def create_project_location_lake_zone_entity_partition(parent, google_cloud_dataplex_v1_partition_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2498
+ command = make_simple_command(:post, 'v1/{+parent}/partitions', options)
2499
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition::Representation
2500
+ command.request_object = google_cloud_dataplex_v1_partition_object
2501
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition::Representation
2502
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition
2503
+ command.params['parent'] = parent unless parent.nil?
2504
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2505
+ command.query['fields'] = fields unless fields.nil?
2506
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2507
+ execute_or_queue_command(command, &block)
2508
+ end
2509
+
2510
+ # Delete a metadata partition.
2511
+ # @param [String] name
2512
+ # Required. The resource name of the partition. format: projects/`project_number`
2513
+ # /locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`/
2514
+ # partitions/`partition_value_path`. The `partition_value_path` segment consists
2515
+ # of an ordered sequence of partition values separated by "/". All values must
2516
+ # be provided.
2517
+ # @param [String] etag
2518
+ # Optional. The etag associated with the partition if it was previously
2519
+ # retrieved.
2520
+ # @param [String] fields
2521
+ # Selector specifying which fields to include in a partial response.
2522
+ # @param [String] quota_user
2523
+ # Available to use for quota purposes for server-side applications. Can be any
2524
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2525
+ # @param [Google::Apis::RequestOptions] options
2526
+ # Request-specific options
2527
+ #
2528
+ # @yield [result, err] Result & error if block supplied
2529
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
2530
+ # @yieldparam err [StandardError] error object if request failed
2531
+ #
2532
+ # @return [Google::Apis::DataplexV1::Empty]
2533
+ #
2534
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2535
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2536
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2537
+ def delete_project_location_lake_zone_entity_partition(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
2538
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2539
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
2540
+ command.response_class = Google::Apis::DataplexV1::Empty
2541
+ command.params['name'] = name unless name.nil?
2542
+ command.query['etag'] = etag unless etag.nil?
2543
+ command.query['fields'] = fields unless fields.nil?
2544
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2545
+ execute_or_queue_command(command, &block)
2546
+ end
2547
+
2548
+ # Get a metadata partition of an entity.
2549
+ # @param [String] name
2550
+ # Required. The resource name of the partition: projects/`project_number`/
2551
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`/
2552
+ # partitions/`partition_value_path`. The `partition_value_path` segment consists
2553
+ # of an ordered sequence of partition values separated by "/". All values must
2554
+ # be provided.
2555
+ # @param [String] fields
2556
+ # Selector specifying which fields to include in a partial response.
2557
+ # @param [String] quota_user
2558
+ # Available to use for quota purposes for server-side applications. Can be any
2559
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2560
+ # @param [Google::Apis::RequestOptions] options
2561
+ # Request-specific options
2562
+ #
2563
+ # @yield [result, err] Result & error if block supplied
2564
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition] parsed result object
2565
+ # @yieldparam err [StandardError] error object if request failed
2566
+ #
2567
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition]
2568
+ #
2569
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2570
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2571
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2572
+ def get_project_location_lake_zone_entity_partition(name, fields: nil, quota_user: nil, options: nil, &block)
2573
+ command = make_simple_command(:get, 'v1/{+name}', options)
2574
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition::Representation
2575
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Partition
2576
+ command.params['name'] = name unless name.nil?
2577
+ command.query['fields'] = fields unless fields.nil?
2578
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2579
+ execute_or_queue_command(command, &block)
2580
+ end
2581
+
2582
+ # List metadata partitions of an entity.
2583
+ # @param [String] parent
2584
+ # Required. The resource name of the parent entity: projects/`project_number`/
2585
+ # locations/`location_id`/lakes/`lake_id`/zones/`zone_id`/entities/`entity_id`.
2586
+ # @param [String] filter
2587
+ # Optional. Filter the partitions returned to the caller using a key vslue pair
2588
+ # expression. The filter expression supports: logical operators: AND, OR
2589
+ # comparison operators: <, >, >=, <= ,=, != LIKE operators: The right hand of a
2590
+ # LIKE operator supports “.” and “*” for wildcard searches, for example "value1
2591
+ # LIKE ".*oo.*" parenthetical grouping: ( )Sample filter expression: `?filter="
2592
+ # key1 < value1 OR key2 > value2"Notes: Keys to the left of operators are case
2593
+ # insensitive. Partition results are sorted first by creation time, then by
2594
+ # lexicographic order. Up to 20 key value filter pairs are allowed, but due to
2595
+ # performance considerations, only the first 10 will be used as a filter.
2596
+ # @param [Fixnum] page_size
2597
+ # Optional. Maximum number of partitions to return. The service may return fewer
2598
+ # than this value. If unspecified, 100 partitions will be returned by default.
2599
+ # The maximum page size is 500; larger values will will be truncated to 500.
2600
+ # @param [String] page_token
2601
+ # Optional. Page token received from a previous ListPartitions call. Provide
2602
+ # this to retrieve the subsequent page. When paginating, all other parameters
2603
+ # provided to ListPartitions must match the call that provided the page token.
2604
+ # @param [String] fields
2605
+ # Selector specifying which fields to include in a partial response.
2606
+ # @param [String] quota_user
2607
+ # Available to use for quota purposes for server-side applications. Can be any
2608
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2609
+ # @param [Google::Apis::RequestOptions] options
2610
+ # Request-specific options
2611
+ #
2612
+ # @yield [result, err] Result & error if block supplied
2613
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListPartitionsResponse] parsed result object
2614
+ # @yieldparam err [StandardError] error object if request failed
2615
+ #
2616
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListPartitionsResponse]
2617
+ #
2618
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2619
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2620
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2621
+ def list_project_location_lake_zone_entity_partitions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2622
+ command = make_simple_command(:get, 'v1/{+parent}/partitions', options)
2623
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListPartitionsResponse::Representation
2624
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListPartitionsResponse
2625
+ command.params['parent'] = parent unless parent.nil?
2626
+ command.query['filter'] = filter unless filter.nil?
2627
+ command.query['pageSize'] = page_size unless page_size.nil?
2628
+ command.query['pageToken'] = page_token unless page_token.nil?
2629
+ command.query['fields'] = fields unless fields.nil?
2630
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2631
+ execute_or_queue_command(command, &block)
2632
+ end
2633
+
2634
+ # Starts asynchronous cancellation on a long-running operation. The server makes
2635
+ # a best effort to cancel the operation, but success is not guaranteed. If the
2636
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
2637
+ # Clients can use Operations.GetOperation or other methods to check whether the
2638
+ # cancellation succeeded or whether the operation completed despite cancellation.
2639
+ # On successful cancellation, the operation is not deleted; instead, it becomes
2640
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
2641
+ # corresponding to Code.CANCELLED.
2642
+ # @param [String] name
2643
+ # The name of the operation resource to be cancelled.
2644
+ # @param [Google::Apis::DataplexV1::GoogleLongrunningCancelOperationRequest] google_longrunning_cancel_operation_request_object
2645
+ # @param [String] fields
2646
+ # Selector specifying which fields to include in a partial response.
2647
+ # @param [String] quota_user
2648
+ # Available to use for quota purposes for server-side applications. Can be any
2649
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2650
+ # @param [Google::Apis::RequestOptions] options
2651
+ # Request-specific options
2652
+ #
2653
+ # @yield [result, err] Result & error if block supplied
2654
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
2655
+ # @yieldparam err [StandardError] error object if request failed
2656
+ #
2657
+ # @return [Google::Apis::DataplexV1::Empty]
2658
+ #
2659
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2660
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2661
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2662
+ def cancel_project_location_operation(name, google_longrunning_cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2663
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
2664
+ command.request_representation = Google::Apis::DataplexV1::GoogleLongrunningCancelOperationRequest::Representation
2665
+ command.request_object = google_longrunning_cancel_operation_request_object
2666
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
2667
+ command.response_class = Google::Apis::DataplexV1::Empty
2668
+ command.params['name'] = name unless name.nil?
2669
+ command.query['fields'] = fields unless fields.nil?
2670
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2671
+ execute_or_queue_command(command, &block)
2672
+ end
2673
+
2674
+ # Deletes a long-running operation. This method indicates that the client is no
2675
+ # longer interested in the operation result. It does not cancel the operation.
2676
+ # If the server doesn't support this method, it returns google.rpc.Code.
2677
+ # UNIMPLEMENTED.
2678
+ # @param [String] name
2679
+ # The name of the operation resource to be deleted.
2680
+ # @param [String] fields
2681
+ # Selector specifying which fields to include in a partial response.
2682
+ # @param [String] quota_user
2683
+ # Available to use for quota purposes for server-side applications. Can be any
2684
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2685
+ # @param [Google::Apis::RequestOptions] options
2686
+ # Request-specific options
2687
+ #
2688
+ # @yield [result, err] Result & error if block supplied
2689
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
2690
+ # @yieldparam err [StandardError] error object if request failed
2691
+ #
2692
+ # @return [Google::Apis::DataplexV1::Empty]
2693
+ #
2694
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2695
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2696
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2697
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2698
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2699
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
2700
+ command.response_class = Google::Apis::DataplexV1::Empty
2701
+ command.params['name'] = name unless name.nil?
2702
+ command.query['fields'] = fields unless fields.nil?
2703
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2704
+ execute_or_queue_command(command, &block)
2705
+ end
2706
+
2707
+ # Gets the latest state of a long-running operation. Clients can use this method
2708
+ # to poll the operation result at intervals as recommended by the API service.
2709
+ # @param [String] name
2710
+ # The name of the operation resource.
2711
+ # @param [String] fields
2712
+ # Selector specifying which fields to include in a partial response.
2713
+ # @param [String] quota_user
2714
+ # Available to use for quota purposes for server-side applications. Can be any
2715
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2716
+ # @param [Google::Apis::RequestOptions] options
2717
+ # Request-specific options
2718
+ #
2719
+ # @yield [result, err] Result & error if block supplied
2720
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
2721
+ # @yieldparam err [StandardError] error object if request failed
2722
+ #
2723
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
2724
+ #
2725
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2726
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2727
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2728
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2729
+ command = make_simple_command(:get, 'v1/{+name}', options)
2730
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
2731
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
2732
+ command.params['name'] = name unless name.nil?
2733
+ command.query['fields'] = fields unless fields.nil?
2734
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2735
+ execute_or_queue_command(command, &block)
2736
+ end
2737
+
2738
+ # Lists operations that match the specified filter in the request. If the server
2739
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
2740
+ # allows API services to override the binding to use different resource name
2741
+ # schemes, such as users/*/operations. To override the binding, API services can
2742
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
2743
+ # configuration. For backwards compatibility, the default name includes the
2744
+ # operations collection id, however overriding users must ensure the name
2745
+ # binding is the parent resource, without the operations collection id.
2746
+ # @param [String] name
2747
+ # The name of the operation's parent resource.
2748
+ # @param [String] filter
2749
+ # The standard list filter.
2750
+ # @param [Fixnum] page_size
2751
+ # The standard list page size.
2752
+ # @param [String] page_token
2753
+ # The standard list page token.
2754
+ # @param [String] fields
2755
+ # Selector specifying which fields to include in a partial response.
2756
+ # @param [String] quota_user
2757
+ # Available to use for quota purposes for server-side applications. Can be any
2758
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2759
+ # @param [Google::Apis::RequestOptions] options
2760
+ # Request-specific options
2761
+ #
2762
+ # @yield [result, err] Result & error if block supplied
2763
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningListOperationsResponse] parsed result object
2764
+ # @yieldparam err [StandardError] error object if request failed
2765
+ #
2766
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningListOperationsResponse]
2767
+ #
2768
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2769
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2770
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2771
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2772
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
2773
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningListOperationsResponse::Representation
2774
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningListOperationsResponse
2775
+ command.params['name'] = name unless name.nil?
2776
+ command.query['filter'] = filter unless filter.nil?
2777
+ command.query['pageSize'] = page_size unless page_size.nil?
2778
+ command.query['pageToken'] = page_token unless page_token.nil?
2779
+ command.query['fields'] = fields unless fields.nil?
2780
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2781
+ execute_or_queue_command(command, &block)
2782
+ end
2783
+
2784
+ protected
2785
+
2786
+ def apply_command_defaults(command)
2787
+ command.query['key'] = key unless key.nil?
2788
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2789
+ end
2790
+ end
2791
+ end
2792
+ end
2793
+ end