google-apis-looker_v1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,802 @@
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 LookerV1
23
+ # Looker (Google Cloud core) API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/looker_v1'
29
+ #
30
+ # Looker = Google::Apis::LookerV1 # Alias the module
31
+ # service = Looker::LookerService.new
32
+ #
33
+ # @see https://cloud.google.com/looker/docs/reference/rest/
34
+ class LookerService < 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://looker.googleapis.com/', '',
47
+ client_name: 'google-apis-looker_v1',
48
+ client_version: Google::Apis::LookerV1::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::LookerV1::Location] parsed result object
65
+ # @yieldparam err [StandardError] error object if request failed
66
+ #
67
+ # @return [Google::Apis::LookerV1::Location]
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::LookerV1::Location::Representation
75
+ command.response_class = Google::Apis::LookerV1::Location
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
88
+ # in [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::LookerV1::ListLocationsResponse] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::LookerV1::ListLocationsResponse]
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::LookerV1::ListLocationsResponse::Representation
115
+ command.response_class = Google::Apis::LookerV1::ListLocationsResponse
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 new Instance in a given project and location.
126
+ # @param [String] parent
127
+ # Required. Format: `projects/`project`/locations/`location``.
128
+ # @param [Google::Apis::LookerV1::Instance] instance_object
129
+ # @param [String] instance_id
130
+ # Required. The unique instance identifier. Must contain only lowercase letters,
131
+ # numbers, or hyphens, with the first character a letter and the last a letter
132
+ # or a number. 63 characters maximum.
133
+ # @param [String] fields
134
+ # Selector specifying which fields to include in a partial response.
135
+ # @param [String] quota_user
136
+ # Available to use for quota purposes for server-side applications. Can be any
137
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
138
+ # @param [Google::Apis::RequestOptions] options
139
+ # Request-specific options
140
+ #
141
+ # @yield [result, err] Result & error if block supplied
142
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
143
+ # @yieldparam err [StandardError] error object if request failed
144
+ #
145
+ # @return [Google::Apis::LookerV1::Operation]
146
+ #
147
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
148
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
149
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
150
+ def create_project_location_instance(parent, instance_object = nil, instance_id: nil, fields: nil, quota_user: nil, options: nil, &block)
151
+ command = make_simple_command(:post, 'v1/{+parent}/instances', options)
152
+ command.request_representation = Google::Apis::LookerV1::Instance::Representation
153
+ command.request_object = instance_object
154
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
155
+ command.response_class = Google::Apis::LookerV1::Operation
156
+ command.params['parent'] = parent unless parent.nil?
157
+ command.query['instanceId'] = instance_id unless instance_id.nil?
158
+ command.query['fields'] = fields unless fields.nil?
159
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
160
+ execute_or_queue_command(command, &block)
161
+ end
162
+
163
+ # Delete instance.
164
+ # @param [String] name
165
+ # Required. Format: `projects/`project`/locations/`location`/instances/`instance`
166
+ # `.
167
+ # @param [Boolean] force
168
+ # Whether to force cascading delete.
169
+ # @param [String] fields
170
+ # Selector specifying which fields to include in a partial response.
171
+ # @param [String] quota_user
172
+ # Available to use for quota purposes for server-side applications. Can be any
173
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
174
+ # @param [Google::Apis::RequestOptions] options
175
+ # Request-specific options
176
+ #
177
+ # @yield [result, err] Result & error if block supplied
178
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
179
+ # @yieldparam err [StandardError] error object if request failed
180
+ #
181
+ # @return [Google::Apis::LookerV1::Operation]
182
+ #
183
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
184
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
185
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
186
+ def delete_project_location_instance(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
187
+ command = make_simple_command(:delete, 'v1/{+name}', options)
188
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
189
+ command.response_class = Google::Apis::LookerV1::Operation
190
+ command.params['name'] = name unless name.nil?
191
+ command.query['force'] = force unless force.nil?
192
+ command.query['fields'] = fields unless fields.nil?
193
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
194
+ execute_or_queue_command(command, &block)
195
+ end
196
+
197
+ # Export instance.
198
+ # @param [String] name
199
+ # Required. Format: `projects/`project`/locations/`location`/instances/`instance`
200
+ # `.
201
+ # @param [Google::Apis::LookerV1::ExportInstanceRequest] export_instance_request_object
202
+ # @param [String] fields
203
+ # Selector specifying which fields to include in a partial response.
204
+ # @param [String] quota_user
205
+ # Available to use for quota purposes for server-side applications. Can be any
206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
207
+ # @param [Google::Apis::RequestOptions] options
208
+ # Request-specific options
209
+ #
210
+ # @yield [result, err] Result & error if block supplied
211
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
212
+ # @yieldparam err [StandardError] error object if request failed
213
+ #
214
+ # @return [Google::Apis::LookerV1::Operation]
215
+ #
216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
219
+ def export_instance(name, export_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
220
+ command = make_simple_command(:post, 'v1/{+name}:export', options)
221
+ command.request_representation = Google::Apis::LookerV1::ExportInstanceRequest::Representation
222
+ command.request_object = export_instance_request_object
223
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
224
+ command.response_class = Google::Apis::LookerV1::Operation
225
+ command.params['name'] = name unless name.nil?
226
+ command.query['fields'] = fields unless fields.nil?
227
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
228
+ execute_or_queue_command(command, &block)
229
+ end
230
+
231
+ # Gets details of a single Instance.
232
+ # @param [String] name
233
+ # Required. Format: `projects/`project`/locations/`location`/instances/`instance`
234
+ # `.
235
+ # @param [String] fields
236
+ # Selector specifying which fields to include in a partial response.
237
+ # @param [String] quota_user
238
+ # Available to use for quota purposes for server-side applications. Can be any
239
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
240
+ # @param [Google::Apis::RequestOptions] options
241
+ # Request-specific options
242
+ #
243
+ # @yield [result, err] Result & error if block supplied
244
+ # @yieldparam result [Google::Apis::LookerV1::Instance] parsed result object
245
+ # @yieldparam err [StandardError] error object if request failed
246
+ #
247
+ # @return [Google::Apis::LookerV1::Instance]
248
+ #
249
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
250
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
251
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
252
+ def get_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
253
+ command = make_simple_command(:get, 'v1/{+name}', options)
254
+ command.response_representation = Google::Apis::LookerV1::Instance::Representation
255
+ command.response_class = Google::Apis::LookerV1::Instance
256
+ command.params['name'] = name unless name.nil?
257
+ command.query['fields'] = fields unless fields.nil?
258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
259
+ execute_or_queue_command(command, &block)
260
+ end
261
+
262
+ # Gets the access control policy for a resource. Returns an empty policy if the
263
+ # resource exists and does not have a policy set.
264
+ # @param [String] resource
265
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
266
+ # names](https://cloud.google.com/apis/design/resource_names) for the
267
+ # appropriate value for this field.
268
+ # @param [Fixnum] options_requested_policy_version
269
+ # Optional. The maximum policy version that will be used to format the policy.
270
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
271
+ # rejected. Requests for policies with any conditional role bindings must
272
+ # specify version 3. Policies with no conditional role bindings may specify any
273
+ # valid value or leave the field unset. The policy in the response might use the
274
+ # policy version that you specified, or it might use a lower policy version. For
275
+ # example, if you specify version 3, but the policy has no conditional role
276
+ # bindings, the response uses version 1. To learn which resources support
277
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
278
+ # google.com/iam/help/conditions/resource-policies).
279
+ # @param [String] fields
280
+ # Selector specifying which fields to include in a partial response.
281
+ # @param [String] quota_user
282
+ # Available to use for quota purposes for server-side applications. Can be any
283
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
284
+ # @param [Google::Apis::RequestOptions] options
285
+ # Request-specific options
286
+ #
287
+ # @yield [result, err] Result & error if block supplied
288
+ # @yieldparam result [Google::Apis::LookerV1::Policy] parsed result object
289
+ # @yieldparam err [StandardError] error object if request failed
290
+ #
291
+ # @return [Google::Apis::LookerV1::Policy]
292
+ #
293
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
294
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
295
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
296
+ def get_project_location_instance_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
297
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
298
+ command.response_representation = Google::Apis::LookerV1::Policy::Representation
299
+ command.response_class = Google::Apis::LookerV1::Policy
300
+ command.params['resource'] = resource unless resource.nil?
301
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
302
+ command.query['fields'] = fields unless fields.nil?
303
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
304
+ execute_or_queue_command(command, &block)
305
+ end
306
+
307
+ # Import instance.
308
+ # @param [String] name
309
+ # Required. Format: `projects/`project`/locations/`location`/instances/`instance`
310
+ # `.
311
+ # @param [Google::Apis::LookerV1::ImportInstanceRequest] import_instance_request_object
312
+ # @param [String] fields
313
+ # Selector specifying which fields to include in a partial response.
314
+ # @param [String] quota_user
315
+ # Available to use for quota purposes for server-side applications. Can be any
316
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
317
+ # @param [Google::Apis::RequestOptions] options
318
+ # Request-specific options
319
+ #
320
+ # @yield [result, err] Result & error if block supplied
321
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
322
+ # @yieldparam err [StandardError] error object if request failed
323
+ #
324
+ # @return [Google::Apis::LookerV1::Operation]
325
+ #
326
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
327
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
328
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
329
+ def import_instance(name, import_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
330
+ command = make_simple_command(:post, 'v1/{+name}:import', options)
331
+ command.request_representation = Google::Apis::LookerV1::ImportInstanceRequest::Representation
332
+ command.request_object = import_instance_request_object
333
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
334
+ command.response_class = Google::Apis::LookerV1::Operation
335
+ command.params['name'] = name unless name.nil?
336
+ command.query['fields'] = fields unless fields.nil?
337
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
338
+ execute_or_queue_command(command, &block)
339
+ end
340
+
341
+ # Lists Instances in a given project and location.
342
+ # @param [String] parent
343
+ # Required. Format: `projects/`project`/locations/`location``.
344
+ # @param [Fixnum] page_size
345
+ # The maximum number of instances to return. If unspecified at most 256 will be
346
+ # returned. The maximum possible value is 2048.
347
+ # @param [String] page_token
348
+ # A page token received from a previous ListInstancesRequest.
349
+ # @param [String] fields
350
+ # Selector specifying which fields to include in a partial response.
351
+ # @param [String] quota_user
352
+ # Available to use for quota purposes for server-side applications. Can be any
353
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
354
+ # @param [Google::Apis::RequestOptions] options
355
+ # Request-specific options
356
+ #
357
+ # @yield [result, err] Result & error if block supplied
358
+ # @yieldparam result [Google::Apis::LookerV1::ListInstancesResponse] parsed result object
359
+ # @yieldparam err [StandardError] error object if request failed
360
+ #
361
+ # @return [Google::Apis::LookerV1::ListInstancesResponse]
362
+ #
363
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
364
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
365
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
366
+ def list_project_location_instances(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
367
+ command = make_simple_command(:get, 'v1/{+parent}/instances', options)
368
+ command.response_representation = Google::Apis::LookerV1::ListInstancesResponse::Representation
369
+ command.response_class = Google::Apis::LookerV1::ListInstancesResponse
370
+ command.params['parent'] = parent unless parent.nil?
371
+ command.query['pageSize'] = page_size unless page_size.nil?
372
+ command.query['pageToken'] = page_token unless page_token.nil?
373
+ command.query['fields'] = fields unless fields.nil?
374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
375
+ execute_or_queue_command(command, &block)
376
+ end
377
+
378
+ # Update Instance.
379
+ # @param [String] name
380
+ # Output only. Format: `projects/`project`/locations/`location`/instances/`
381
+ # instance``.
382
+ # @param [Google::Apis::LookerV1::Instance] instance_object
383
+ # @param [String] update_mask
384
+ # Required. Field mask used to specify the fields to be overwritten in the
385
+ # Instance resource by the update. The fields specified in the mask are relative
386
+ # to the resource, not the full request. A field will be overwritten if it is in
387
+ # the mask.
388
+ # @param [String] fields
389
+ # Selector specifying which fields to include in a partial response.
390
+ # @param [String] quota_user
391
+ # Available to use for quota purposes for server-side applications. Can be any
392
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
393
+ # @param [Google::Apis::RequestOptions] options
394
+ # Request-specific options
395
+ #
396
+ # @yield [result, err] Result & error if block supplied
397
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
398
+ # @yieldparam err [StandardError] error object if request failed
399
+ #
400
+ # @return [Google::Apis::LookerV1::Operation]
401
+ #
402
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
403
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
404
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
405
+ def patch_project_location_instance(name, instance_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
406
+ command = make_simple_command(:patch, 'v1/{+name}', options)
407
+ command.request_representation = Google::Apis::LookerV1::Instance::Representation
408
+ command.request_object = instance_object
409
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
410
+ command.response_class = Google::Apis::LookerV1::Operation
411
+ command.params['name'] = name unless name.nil?
412
+ command.query['updateMask'] = update_mask unless update_mask.nil?
413
+ command.query['fields'] = fields unless fields.nil?
414
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
415
+ execute_or_queue_command(command, &block)
416
+ end
417
+
418
+ # Restart instance.
419
+ # @param [String] name
420
+ # Required. Format: `projects/`project`/locations/`location`/instances/`instance`
421
+ # `.
422
+ # @param [Google::Apis::LookerV1::RestartInstanceRequest] restart_instance_request_object
423
+ # @param [String] fields
424
+ # Selector specifying which fields to include in a partial response.
425
+ # @param [String] quota_user
426
+ # Available to use for quota purposes for server-side applications. Can be any
427
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
428
+ # @param [Google::Apis::RequestOptions] options
429
+ # Request-specific options
430
+ #
431
+ # @yield [result, err] Result & error if block supplied
432
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
433
+ # @yieldparam err [StandardError] error object if request failed
434
+ #
435
+ # @return [Google::Apis::LookerV1::Operation]
436
+ #
437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
440
+ def restart_instance(name, restart_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
441
+ command = make_simple_command(:post, 'v1/{+name}:restart', options)
442
+ command.request_representation = Google::Apis::LookerV1::RestartInstanceRequest::Representation
443
+ command.request_object = restart_instance_request_object
444
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
445
+ command.response_class = Google::Apis::LookerV1::Operation
446
+ command.params['name'] = name unless name.nil?
447
+ command.query['fields'] = fields unless fields.nil?
448
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
449
+ execute_or_queue_command(command, &block)
450
+ end
451
+
452
+ # Sets the access control policy on the specified resource. Replaces any
453
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
454
+ # PERMISSION_DENIED` errors.
455
+ # @param [String] resource
456
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
457
+ # names](https://cloud.google.com/apis/design/resource_names) for the
458
+ # appropriate value for this field.
459
+ # @param [Google::Apis::LookerV1::SetIamPolicyRequest] set_iam_policy_request_object
460
+ # @param [String] fields
461
+ # Selector specifying which fields to include in a partial response.
462
+ # @param [String] quota_user
463
+ # Available to use for quota purposes for server-side applications. Can be any
464
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
465
+ # @param [Google::Apis::RequestOptions] options
466
+ # Request-specific options
467
+ #
468
+ # @yield [result, err] Result & error if block supplied
469
+ # @yieldparam result [Google::Apis::LookerV1::Policy] parsed result object
470
+ # @yieldparam err [StandardError] error object if request failed
471
+ #
472
+ # @return [Google::Apis::LookerV1::Policy]
473
+ #
474
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
475
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
476
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
477
+ def set_instance_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
478
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
479
+ command.request_representation = Google::Apis::LookerV1::SetIamPolicyRequest::Representation
480
+ command.request_object = set_iam_policy_request_object
481
+ command.response_representation = Google::Apis::LookerV1::Policy::Representation
482
+ command.response_class = Google::Apis::LookerV1::Policy
483
+ command.params['resource'] = resource unless resource.nil?
484
+ command.query['fields'] = fields unless fields.nil?
485
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
486
+ execute_or_queue_command(command, &block)
487
+ end
488
+
489
+ # Returns permissions that a caller has on the specified resource. If the
490
+ # resource does not exist, this will return an empty set of permissions, not a `
491
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
492
+ # permission-aware UIs and command-line tools, not for authorization checking.
493
+ # This operation may "fail open" without warning.
494
+ # @param [String] resource
495
+ # REQUIRED: The resource for which the policy detail is being requested. See [
496
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
497
+ # appropriate value for this field.
498
+ # @param [Google::Apis::LookerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
499
+ # @param [String] fields
500
+ # Selector specifying which fields to include in a partial response.
501
+ # @param [String] quota_user
502
+ # Available to use for quota purposes for server-side applications. Can be any
503
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
504
+ # @param [Google::Apis::RequestOptions] options
505
+ # Request-specific options
506
+ #
507
+ # @yield [result, err] Result & error if block supplied
508
+ # @yieldparam result [Google::Apis::LookerV1::TestIamPermissionsResponse] parsed result object
509
+ # @yieldparam err [StandardError] error object if request failed
510
+ #
511
+ # @return [Google::Apis::LookerV1::TestIamPermissionsResponse]
512
+ #
513
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
514
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
515
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
516
+ def test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
517
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
518
+ command.request_representation = Google::Apis::LookerV1::TestIamPermissionsRequest::Representation
519
+ command.request_object = test_iam_permissions_request_object
520
+ command.response_representation = Google::Apis::LookerV1::TestIamPermissionsResponse::Representation
521
+ command.response_class = Google::Apis::LookerV1::TestIamPermissionsResponse
522
+ command.params['resource'] = resource unless resource.nil?
523
+ command.query['fields'] = fields unless fields.nil?
524
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
525
+ execute_or_queue_command(command, &block)
526
+ end
527
+
528
+ # Gets the access control policy for a resource. Returns an empty policy if the
529
+ # resource exists and does not have a policy set.
530
+ # @param [String] resource
531
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
532
+ # names](https://cloud.google.com/apis/design/resource_names) for the
533
+ # appropriate value for this field.
534
+ # @param [Fixnum] options_requested_policy_version
535
+ # Optional. The maximum policy version that will be used to format the policy.
536
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
537
+ # rejected. Requests for policies with any conditional role bindings must
538
+ # specify version 3. Policies with no conditional role bindings may specify any
539
+ # valid value or leave the field unset. The policy in the response might use the
540
+ # policy version that you specified, or it might use a lower policy version. For
541
+ # example, if you specify version 3, but the policy has no conditional role
542
+ # bindings, the response uses version 1. To learn which resources support
543
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
544
+ # google.com/iam/help/conditions/resource-policies).
545
+ # @param [String] fields
546
+ # Selector specifying which fields to include in a partial response.
547
+ # @param [String] quota_user
548
+ # Available to use for quota purposes for server-side applications. Can be any
549
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
550
+ # @param [Google::Apis::RequestOptions] options
551
+ # Request-specific options
552
+ #
553
+ # @yield [result, err] Result & error if block supplied
554
+ # @yieldparam result [Google::Apis::LookerV1::Policy] parsed result object
555
+ # @yieldparam err [StandardError] error object if request failed
556
+ #
557
+ # @return [Google::Apis::LookerV1::Policy]
558
+ #
559
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
560
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
561
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
562
+ def get_project_location_instance_backup_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
563
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
564
+ command.response_representation = Google::Apis::LookerV1::Policy::Representation
565
+ command.response_class = Google::Apis::LookerV1::Policy
566
+ command.params['resource'] = resource unless resource.nil?
567
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
568
+ command.query['fields'] = fields unless fields.nil?
569
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
570
+ execute_or_queue_command(command, &block)
571
+ end
572
+
573
+ # Sets the access control policy on the specified resource. Replaces any
574
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
575
+ # PERMISSION_DENIED` errors.
576
+ # @param [String] resource
577
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
578
+ # names](https://cloud.google.com/apis/design/resource_names) for the
579
+ # appropriate value for this field.
580
+ # @param [Google::Apis::LookerV1::SetIamPolicyRequest] set_iam_policy_request_object
581
+ # @param [String] fields
582
+ # Selector specifying which fields to include in a partial response.
583
+ # @param [String] quota_user
584
+ # Available to use for quota purposes for server-side applications. Can be any
585
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
586
+ # @param [Google::Apis::RequestOptions] options
587
+ # Request-specific options
588
+ #
589
+ # @yield [result, err] Result & error if block supplied
590
+ # @yieldparam result [Google::Apis::LookerV1::Policy] parsed result object
591
+ # @yieldparam err [StandardError] error object if request failed
592
+ #
593
+ # @return [Google::Apis::LookerV1::Policy]
594
+ #
595
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
596
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
597
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
598
+ def set_backup_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
599
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
600
+ command.request_representation = Google::Apis::LookerV1::SetIamPolicyRequest::Representation
601
+ command.request_object = set_iam_policy_request_object
602
+ command.response_representation = Google::Apis::LookerV1::Policy::Representation
603
+ command.response_class = Google::Apis::LookerV1::Policy
604
+ command.params['resource'] = resource unless resource.nil?
605
+ command.query['fields'] = fields unless fields.nil?
606
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
607
+ execute_or_queue_command(command, &block)
608
+ end
609
+
610
+ # Returns permissions that a caller has on the specified resource. If the
611
+ # resource does not exist, this will return an empty set of permissions, not a `
612
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
613
+ # permission-aware UIs and command-line tools, not for authorization checking.
614
+ # This operation may "fail open" without warning.
615
+ # @param [String] resource
616
+ # REQUIRED: The resource for which the policy detail is being requested. See [
617
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
618
+ # appropriate value for this field.
619
+ # @param [Google::Apis::LookerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
620
+ # @param [String] fields
621
+ # Selector specifying which fields to include in a partial response.
622
+ # @param [String] quota_user
623
+ # Available to use for quota purposes for server-side applications. Can be any
624
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
625
+ # @param [Google::Apis::RequestOptions] options
626
+ # Request-specific options
627
+ #
628
+ # @yield [result, err] Result & error if block supplied
629
+ # @yieldparam result [Google::Apis::LookerV1::TestIamPermissionsResponse] parsed result object
630
+ # @yieldparam err [StandardError] error object if request failed
631
+ #
632
+ # @return [Google::Apis::LookerV1::TestIamPermissionsResponse]
633
+ #
634
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
635
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
636
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
637
+ def test_backup_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
638
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
639
+ command.request_representation = Google::Apis::LookerV1::TestIamPermissionsRequest::Representation
640
+ command.request_object = test_iam_permissions_request_object
641
+ command.response_representation = Google::Apis::LookerV1::TestIamPermissionsResponse::Representation
642
+ command.response_class = Google::Apis::LookerV1::TestIamPermissionsResponse
643
+ command.params['resource'] = resource unless resource.nil?
644
+ command.query['fields'] = fields unless fields.nil?
645
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
646
+ execute_or_queue_command(command, &block)
647
+ end
648
+
649
+ # Starts asynchronous cancellation on a long-running operation. The server makes
650
+ # a best effort to cancel the operation, but success is not guaranteed. If the
651
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
652
+ # Clients can use Operations.GetOperation or other methods to check whether the
653
+ # cancellation succeeded or whether the operation completed despite cancellation.
654
+ # On successful cancellation, the operation is not deleted; instead, it becomes
655
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
656
+ # corresponding to `Code.CANCELLED`.
657
+ # @param [String] name
658
+ # The name of the operation resource to be cancelled.
659
+ # @param [Google::Apis::LookerV1::CancelOperationRequest] cancel_operation_request_object
660
+ # @param [String] fields
661
+ # Selector specifying which fields to include in a partial response.
662
+ # @param [String] quota_user
663
+ # Available to use for quota purposes for server-side applications. Can be any
664
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
665
+ # @param [Google::Apis::RequestOptions] options
666
+ # Request-specific options
667
+ #
668
+ # @yield [result, err] Result & error if block supplied
669
+ # @yieldparam result [Google::Apis::LookerV1::Empty] parsed result object
670
+ # @yieldparam err [StandardError] error object if request failed
671
+ #
672
+ # @return [Google::Apis::LookerV1::Empty]
673
+ #
674
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
675
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
676
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
677
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
678
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
679
+ command.request_representation = Google::Apis::LookerV1::CancelOperationRequest::Representation
680
+ command.request_object = cancel_operation_request_object
681
+ command.response_representation = Google::Apis::LookerV1::Empty::Representation
682
+ command.response_class = Google::Apis::LookerV1::Empty
683
+ command.params['name'] = name unless name.nil?
684
+ command.query['fields'] = fields unless fields.nil?
685
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
686
+ execute_or_queue_command(command, &block)
687
+ end
688
+
689
+ # Deletes a long-running operation. This method indicates that the client is no
690
+ # longer interested in the operation result. It does not cancel the operation.
691
+ # If the server doesn't support this method, it returns `google.rpc.Code.
692
+ # UNIMPLEMENTED`.
693
+ # @param [String] name
694
+ # The name of the operation resource to be deleted.
695
+ # @param [String] fields
696
+ # Selector specifying which fields to include in a partial response.
697
+ # @param [String] quota_user
698
+ # Available to use for quota purposes for server-side applications. Can be any
699
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
700
+ # @param [Google::Apis::RequestOptions] options
701
+ # Request-specific options
702
+ #
703
+ # @yield [result, err] Result & error if block supplied
704
+ # @yieldparam result [Google::Apis::LookerV1::Empty] parsed result object
705
+ # @yieldparam err [StandardError] error object if request failed
706
+ #
707
+ # @return [Google::Apis::LookerV1::Empty]
708
+ #
709
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
710
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
711
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
712
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
713
+ command = make_simple_command(:delete, 'v1/{+name}', options)
714
+ command.response_representation = Google::Apis::LookerV1::Empty::Representation
715
+ command.response_class = Google::Apis::LookerV1::Empty
716
+ command.params['name'] = name unless name.nil?
717
+ command.query['fields'] = fields unless fields.nil?
718
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
719
+ execute_or_queue_command(command, &block)
720
+ end
721
+
722
+ # Gets the latest state of a long-running operation. Clients can use this method
723
+ # to poll the operation result at intervals as recommended by the API service.
724
+ # @param [String] name
725
+ # The name of the operation resource.
726
+ # @param [String] fields
727
+ # Selector specifying which fields to include in a partial response.
728
+ # @param [String] quota_user
729
+ # Available to use for quota purposes for server-side applications. Can be any
730
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
731
+ # @param [Google::Apis::RequestOptions] options
732
+ # Request-specific options
733
+ #
734
+ # @yield [result, err] Result & error if block supplied
735
+ # @yieldparam result [Google::Apis::LookerV1::Operation] parsed result object
736
+ # @yieldparam err [StandardError] error object if request failed
737
+ #
738
+ # @return [Google::Apis::LookerV1::Operation]
739
+ #
740
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
741
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
742
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
743
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
744
+ command = make_simple_command(:get, 'v1/{+name}', options)
745
+ command.response_representation = Google::Apis::LookerV1::Operation::Representation
746
+ command.response_class = Google::Apis::LookerV1::Operation
747
+ command.params['name'] = name unless name.nil?
748
+ command.query['fields'] = fields unless fields.nil?
749
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
750
+ execute_or_queue_command(command, &block)
751
+ end
752
+
753
+ # Lists operations that match the specified filter in the request. If the server
754
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
755
+ # @param [String] name
756
+ # The name of the operation's parent resource.
757
+ # @param [String] filter
758
+ # The standard list filter.
759
+ # @param [Fixnum] page_size
760
+ # The standard list page size.
761
+ # @param [String] page_token
762
+ # The standard list page token.
763
+ # @param [String] fields
764
+ # Selector specifying which fields to include in a partial response.
765
+ # @param [String] quota_user
766
+ # Available to use for quota purposes for server-side applications. Can be any
767
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
768
+ # @param [Google::Apis::RequestOptions] options
769
+ # Request-specific options
770
+ #
771
+ # @yield [result, err] Result & error if block supplied
772
+ # @yieldparam result [Google::Apis::LookerV1::ListOperationsResponse] parsed result object
773
+ # @yieldparam err [StandardError] error object if request failed
774
+ #
775
+ # @return [Google::Apis::LookerV1::ListOperationsResponse]
776
+ #
777
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
778
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
779
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
780
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
781
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
782
+ command.response_representation = Google::Apis::LookerV1::ListOperationsResponse::Representation
783
+ command.response_class = Google::Apis::LookerV1::ListOperationsResponse
784
+ command.params['name'] = name unless name.nil?
785
+ command.query['filter'] = filter unless filter.nil?
786
+ command.query['pageSize'] = page_size unless page_size.nil?
787
+ command.query['pageToken'] = page_token unless page_token.nil?
788
+ command.query['fields'] = fields unless fields.nil?
789
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
790
+ execute_or_queue_command(command, &block)
791
+ end
792
+
793
+ protected
794
+
795
+ def apply_command_defaults(command)
796
+ command.query['key'] = key unless key.nil?
797
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
798
+ end
799
+ end
800
+ end
801
+ end
802
+ end