google-apis-dataplex_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (12) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +13 -0
  3. data/CHANGELOG.md +7 -0
  4. data/LICENSE.md +202 -0
  5. data/OVERVIEW.md +96 -0
  6. data/lib/google/apis/dataplex_v1/classes.rb +3783 -0
  7. data/lib/google/apis/dataplex_v1/gem_version.rb +28 -0
  8. data/lib/google/apis/dataplex_v1/representations.rb +1567 -0
  9. data/lib/google/apis/dataplex_v1/service.rb +2793 -0
  10. data/lib/google/apis/dataplex_v1.rb +36 -0
  11. data/lib/google-apis-dataplex_v1.rb +15 -0
  12. metadata +82 -0
data/lib/google/apis/dataplex_v1/service.rb ADDED
@@ -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