google-apis-looker_v1 0.1.0

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