google-apis-accesscontextmanager_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1065 @@
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 AccesscontextmanagerV1
23
+ # Access Context Manager API
24
+ #
25
+ # An API for setting attribute based access control to requests to GCP services.
26
+ #
27
+ # @example
28
+ # require 'google/apis/accesscontextmanager_v1'
29
+ #
30
+ # Accesscontextmanager = Google::Apis::AccesscontextmanagerV1 # Alias the module
31
+ # service = Accesscontextmanager::AccessContextManagerService.new
32
+ #
33
+ # @see https://cloud.google.com/access-context-manager/docs/reference/rest/
34
+ class AccessContextManagerService < 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://accesscontextmanager.googleapis.com/', '',
47
+ client_name: 'google-apis-accesscontextmanager_v1',
48
+ client_version: Google::Apis::AccesscontextmanagerV1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
51
+
52
+ # Create an `AccessPolicy`. Fails if this organization already has a `
53
+ # AccessPolicy`. The longrunning Operation will have a successful status once
54
+ # the `AccessPolicy` has propagated to long-lasting storage. Syntactic and basic
55
+ # semantic errors will be returned in `metadata` as a BadRequest proto.
56
+ # @param [Google::Apis::AccesscontextmanagerV1::AccessPolicy] access_policy_object
57
+ # @param [String] fields
58
+ # Selector specifying which fields to include in a partial response.
59
+ # @param [String] quota_user
60
+ # Available to use for quota purposes for server-side applications. Can be any
61
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
62
+ # @param [Google::Apis::RequestOptions] options
63
+ # Request-specific options
64
+ #
65
+ # @yield [result, err] Result & error if block supplied
66
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
67
+ # @yieldparam err [StandardError] error object if request failed
68
+ #
69
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
70
+ #
71
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
72
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
73
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
74
+ def create_access_policy(access_policy_object = nil, fields: nil, quota_user: nil, options: nil, &block)
75
+ command = make_simple_command(:post, 'v1/accessPolicies', options)
76
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::AccessPolicy::Representation
77
+ command.request_object = access_policy_object
78
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
79
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
80
+ command.query['fields'] = fields unless fields.nil?
81
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
82
+ execute_or_queue_command(command, &block)
83
+ end
84
+
85
+ # Delete an AccessPolicy by resource name. The longrunning Operation will have a
86
+ # successful status once the AccessPolicy has been removed from long-lasting
87
+ # storage.
88
+ # @param [String] name
89
+ # Required. Resource name for the access policy to delete. Format `
90
+ # accessPolicies/`policy_id``
91
+ # @param [String] fields
92
+ # Selector specifying which fields to include in a partial response.
93
+ # @param [String] quota_user
94
+ # Available to use for quota purposes for server-side applications. Can be any
95
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
96
+ # @param [Google::Apis::RequestOptions] options
97
+ # Request-specific options
98
+ #
99
+ # @yield [result, err] Result & error if block supplied
100
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
101
+ # @yieldparam err [StandardError] error object if request failed
102
+ #
103
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
104
+ #
105
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
106
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
107
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
108
+ def delete_access_policy(name, fields: nil, quota_user: nil, options: nil, &block)
109
+ command = make_simple_command(:delete, 'v1/{+name}', options)
110
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
111
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
112
+ command.params['name'] = name unless name.nil?
113
+ command.query['fields'] = fields unless fields.nil?
114
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
115
+ execute_or_queue_command(command, &block)
116
+ end
117
+
118
+ # Get an AccessPolicy by name.
119
+ # @param [String] name
120
+ # Required. Resource name for the access policy to get. Format `accessPolicies/`
121
+ # policy_id``
122
+ # @param [String] fields
123
+ # Selector specifying which fields to include in a partial response.
124
+ # @param [String] quota_user
125
+ # Available to use for quota purposes for server-side applications. Can be any
126
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
127
+ # @param [Google::Apis::RequestOptions] options
128
+ # Request-specific options
129
+ #
130
+ # @yield [result, err] Result & error if block supplied
131
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::AccessPolicy] parsed result object
132
+ # @yieldparam err [StandardError] error object if request failed
133
+ #
134
+ # @return [Google::Apis::AccesscontextmanagerV1::AccessPolicy]
135
+ #
136
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
137
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
138
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
139
+ def get_access_policy(name, fields: nil, quota_user: nil, options: nil, &block)
140
+ command = make_simple_command(:get, 'v1/{+name}', options)
141
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::AccessPolicy::Representation
142
+ command.response_class = Google::Apis::AccesscontextmanagerV1::AccessPolicy
143
+ command.params['name'] = name unless name.nil?
144
+ command.query['fields'] = fields unless fields.nil?
145
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
146
+ execute_or_queue_command(command, &block)
147
+ end
148
+
149
+ # List all AccessPolicies under a container.
150
+ # @param [Fixnum] page_size
151
+ # Number of AccessPolicy instances to include in the list. Default 100.
152
+ # @param [String] page_token
153
+ # Next page token for the next batch of AccessPolicy instances. Defaults to the
154
+ # first page of results.
155
+ # @param [String] parent
156
+ # Required. Resource name for the container to list AccessPolicy instances from.
157
+ # Format: `organizations/`org_id``
158
+ # @param [String] fields
159
+ # Selector specifying which fields to include in a partial response.
160
+ # @param [String] quota_user
161
+ # Available to use for quota purposes for server-side applications. Can be any
162
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
163
+ # @param [Google::Apis::RequestOptions] options
164
+ # Request-specific options
165
+ #
166
+ # @yield [result, err] Result & error if block supplied
167
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ListAccessPoliciesResponse] parsed result object
168
+ # @yieldparam err [StandardError] error object if request failed
169
+ #
170
+ # @return [Google::Apis::AccesscontextmanagerV1::ListAccessPoliciesResponse]
171
+ #
172
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
173
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
174
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
175
+ def list_access_policies(page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
176
+ command = make_simple_command(:get, 'v1/accessPolicies', options)
177
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ListAccessPoliciesResponse::Representation
178
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ListAccessPoliciesResponse
179
+ command.query['pageSize'] = page_size unless page_size.nil?
180
+ command.query['pageToken'] = page_token unless page_token.nil?
181
+ command.query['parent'] = parent unless parent.nil?
182
+ command.query['fields'] = fields unless fields.nil?
183
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
184
+ execute_or_queue_command(command, &block)
185
+ end
186
+
187
+ # Update an AccessPolicy. The longrunning Operation from this RPC will have a
188
+ # successful status once the changes to the AccessPolicy have propagated to long-
189
+ # lasting storage. Syntactic and basic semantic errors will be returned in `
190
+ # metadata` as a BadRequest proto.
191
+ # @param [String] name
192
+ # Output only. Resource name of the `AccessPolicy`. Format: `accessPolicies/`
193
+ # policy_id``
194
+ # @param [Google::Apis::AccesscontextmanagerV1::AccessPolicy] access_policy_object
195
+ # @param [String] update_mask
196
+ # Required. Mask to control which fields get updated. Must be non-empty.
197
+ # @param [String] fields
198
+ # Selector specifying which fields to include in a partial response.
199
+ # @param [String] quota_user
200
+ # Available to use for quota purposes for server-side applications. Can be any
201
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
202
+ # @param [Google::Apis::RequestOptions] options
203
+ # Request-specific options
204
+ #
205
+ # @yield [result, err] Result & error if block supplied
206
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
207
+ # @yieldparam err [StandardError] error object if request failed
208
+ #
209
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
210
+ #
211
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
212
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
213
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
214
+ def patch_access_policy(name, access_policy_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
215
+ command = make_simple_command(:patch, 'v1/{+name}', options)
216
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::AccessPolicy::Representation
217
+ command.request_object = access_policy_object
218
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
219
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
220
+ command.params['name'] = name unless name.nil?
221
+ command.query['updateMask'] = update_mask unless update_mask.nil?
222
+ command.query['fields'] = fields unless fields.nil?
223
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
224
+ execute_or_queue_command(command, &block)
225
+ end
226
+
227
+ # Create an Access Level. The longrunning operation from this RPC will have a
228
+ # successful status once the Access Level has propagated to long-lasting storage.
229
+ # Access Levels containing errors will result in an error response for the
230
+ # first error encountered.
231
+ # @param [String] parent
232
+ # Required. Resource name for the access policy which owns this Access Level.
233
+ # Format: `accessPolicies/`policy_id``
234
+ # @param [Google::Apis::AccesscontextmanagerV1::AccessLevel] access_level_object
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::AccesscontextmanagerV1::Operation] parsed result object
245
+ # @yieldparam err [StandardError] error object if request failed
246
+ #
247
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
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 create_access_policy_access_level(parent, access_level_object = nil, fields: nil, quota_user: nil, options: nil, &block)
253
+ command = make_simple_command(:post, 'v1/{+parent}/accessLevels', options)
254
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::AccessLevel::Representation
255
+ command.request_object = access_level_object
256
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
257
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
258
+ command.params['parent'] = parent unless parent.nil?
259
+ command.query['fields'] = fields unless fields.nil?
260
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
261
+ execute_or_queue_command(command, &block)
262
+ end
263
+
264
+ # Delete an Access Level by resource name. The longrunning operation from this
265
+ # RPC will have a successful status once the Access Level has been removed from
266
+ # long-lasting storage.
267
+ # @param [String] name
268
+ # Required. Resource name for the Access Level. Format: `accessPolicies/`
269
+ # policy_id`/accessLevels/`access_level_id``
270
+ # @param [String] fields
271
+ # Selector specifying which fields to include in a partial response.
272
+ # @param [String] quota_user
273
+ # Available to use for quota purposes for server-side applications. Can be any
274
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
275
+ # @param [Google::Apis::RequestOptions] options
276
+ # Request-specific options
277
+ #
278
+ # @yield [result, err] Result & error if block supplied
279
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
280
+ # @yieldparam err [StandardError] error object if request failed
281
+ #
282
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
283
+ #
284
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
285
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
286
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
287
+ def delete_access_policy_access_level(name, fields: nil, quota_user: nil, options: nil, &block)
288
+ command = make_simple_command(:delete, 'v1/{+name}', options)
289
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
290
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
291
+ command.params['name'] = name unless name.nil?
292
+ command.query['fields'] = fields unless fields.nil?
293
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
294
+ execute_or_queue_command(command, &block)
295
+ end
296
+
297
+ # Get an Access Level by resource name.
298
+ # @param [String] name
299
+ # Required. Resource name for the Access Level. Format: `accessPolicies/`
300
+ # policy_id`/accessLevels/`access_level_id``
301
+ # @param [String] access_level_format
302
+ # Whether to return `BasicLevels` in the Cloud Common Expression Language rather
303
+ # than as `BasicLevels`. Defaults to AS_DEFINED, where Access Levels are
304
+ # returned as `BasicLevels` or `CustomLevels` based on how they were created. If
305
+ # set to CEL, all Access Levels are returned as `CustomLevels`. In the CEL case,
306
+ # `BasicLevels` are translated to equivalent `CustomLevels`.
307
+ # @param [String] fields
308
+ # Selector specifying which fields to include in a partial response.
309
+ # @param [String] quota_user
310
+ # Available to use for quota purposes for server-side applications. Can be any
311
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
312
+ # @param [Google::Apis::RequestOptions] options
313
+ # Request-specific options
314
+ #
315
+ # @yield [result, err] Result & error if block supplied
316
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::AccessLevel] parsed result object
317
+ # @yieldparam err [StandardError] error object if request failed
318
+ #
319
+ # @return [Google::Apis::AccesscontextmanagerV1::AccessLevel]
320
+ #
321
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
322
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
323
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
324
+ def get_access_policy_access_level(name, access_level_format: nil, fields: nil, quota_user: nil, options: nil, &block)
325
+ command = make_simple_command(:get, 'v1/{+name}', options)
326
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::AccessLevel::Representation
327
+ command.response_class = Google::Apis::AccesscontextmanagerV1::AccessLevel
328
+ command.params['name'] = name unless name.nil?
329
+ command.query['accessLevelFormat'] = access_level_format unless access_level_format.nil?
330
+ command.query['fields'] = fields unless fields.nil?
331
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
332
+ execute_or_queue_command(command, &block)
333
+ end
334
+
335
+ # List all Access Levels for an access policy.
336
+ # @param [String] parent
337
+ # Required. Resource name for the access policy to list Access Levels from.
338
+ # Format: `accessPolicies/`policy_id``
339
+ # @param [String] access_level_format
340
+ # Whether to return `BasicLevels` in the Cloud Common Expression language, as `
341
+ # CustomLevels`, rather than as `BasicLevels`. Defaults to returning `
342
+ # AccessLevels` in the format they were defined.
343
+ # @param [Fixnum] page_size
344
+ # Number of Access Levels to include in the list. Default 100.
345
+ # @param [String] page_token
346
+ # Next page token for the next batch of Access Level instances. Defaults to the
347
+ # first page of results.
348
+ # @param [String] fields
349
+ # Selector specifying which fields to include in a partial response.
350
+ # @param [String] quota_user
351
+ # Available to use for quota purposes for server-side applications. Can be any
352
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
353
+ # @param [Google::Apis::RequestOptions] options
354
+ # Request-specific options
355
+ #
356
+ # @yield [result, err] Result & error if block supplied
357
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ListAccessLevelsResponse] parsed result object
358
+ # @yieldparam err [StandardError] error object if request failed
359
+ #
360
+ # @return [Google::Apis::AccesscontextmanagerV1::ListAccessLevelsResponse]
361
+ #
362
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
363
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
364
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
365
+ def list_access_policy_access_levels(parent, access_level_format: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
366
+ command = make_simple_command(:get, 'v1/{+parent}/accessLevels', options)
367
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ListAccessLevelsResponse::Representation
368
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ListAccessLevelsResponse
369
+ command.params['parent'] = parent unless parent.nil?
370
+ command.query['accessLevelFormat'] = access_level_format unless access_level_format.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 an Access Level. The longrunning operation from this RPC will have a
379
+ # successful status once the changes to the Access Level have propagated to long-
380
+ # lasting storage. Access Levels containing errors will result in an error
381
+ # response for the first error encountered.
382
+ # @param [String] name
383
+ # Required. Resource name for the Access Level. The `short_name` component must
384
+ # begin with a letter and only include alphanumeric and '_'. Format: `
385
+ # accessPolicies/`policy_id`/accessLevels/`short_name``. The maximum length of
386
+ # the `short_name` component is 50 characters.
387
+ # @param [Google::Apis::AccesscontextmanagerV1::AccessLevel] access_level_object
388
+ # @param [String] update_mask
389
+ # Required. Mask to control which fields get updated. Must be non-empty.
390
+ # @param [String] fields
391
+ # Selector specifying which fields to include in a partial response.
392
+ # @param [String] quota_user
393
+ # Available to use for quota purposes for server-side applications. Can be any
394
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
395
+ # @param [Google::Apis::RequestOptions] options
396
+ # Request-specific options
397
+ #
398
+ # @yield [result, err] Result & error if block supplied
399
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
400
+ # @yieldparam err [StandardError] error object if request failed
401
+ #
402
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
403
+ #
404
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
405
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
406
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
407
+ def patch_access_policy_access_level(name, access_level_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
408
+ command = make_simple_command(:patch, 'v1/{+name}', options)
409
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::AccessLevel::Representation
410
+ command.request_object = access_level_object
411
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
412
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
413
+ command.params['name'] = name unless name.nil?
414
+ command.query['updateMask'] = update_mask unless update_mask.nil?
415
+ command.query['fields'] = fields unless fields.nil?
416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
417
+ execute_or_queue_command(command, &block)
418
+ end
419
+
420
+ # Replace all existing Access Levels in an Access Policy with the Access Levels
421
+ # provided. This is done atomically. The longrunning operation from this RPC
422
+ # will have a successful status once all replacements have propagated to long-
423
+ # lasting storage. Replacements containing errors will result in an error
424
+ # response for the first error encountered. Replacement will be cancelled on
425
+ # error, existing Access Levels will not be affected. Operation.response field
426
+ # will contain ReplaceAccessLevelsResponse. Removing Access Levels contained in
427
+ # existing Service Perimeters will result in error.
428
+ # @param [String] parent
429
+ # Required. Resource name for the access policy which owns these Access Levels.
430
+ # Format: `accessPolicies/`policy_id``
431
+ # @param [Google::Apis::AccesscontextmanagerV1::ReplaceAccessLevelsRequest] replace_access_levels_request_object
432
+ # @param [String] fields
433
+ # Selector specifying which fields to include in a partial response.
434
+ # @param [String] quota_user
435
+ # Available to use for quota purposes for server-side applications. Can be any
436
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
437
+ # @param [Google::Apis::RequestOptions] options
438
+ # Request-specific options
439
+ #
440
+ # @yield [result, err] Result & error if block supplied
441
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
442
+ # @yieldparam err [StandardError] error object if request failed
443
+ #
444
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
445
+ #
446
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
447
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
448
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
449
+ def replace_access_policy_access_level_all(parent, replace_access_levels_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
450
+ command = make_simple_command(:post, 'v1/{+parent}/accessLevels:replaceAll', options)
451
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::ReplaceAccessLevelsRequest::Representation
452
+ command.request_object = replace_access_levels_request_object
453
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
454
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
455
+ command.params['parent'] = parent unless parent.nil?
456
+ command.query['fields'] = fields unless fields.nil?
457
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
458
+ execute_or_queue_command(command, &block)
459
+ end
460
+
461
+ # Commit the dry-run spec for all the Service Perimeters in an Access Policy. A
462
+ # commit operation on a Service Perimeter involves copying its `spec` field to
463
+ # that Service Perimeter's `status` field. Only Service Perimeters with `
464
+ # use_explicit_dry_run_spec` field set to true are affected by a commit
465
+ # operation. The longrunning operation from this RPC will have a successful
466
+ # status once the dry-run specs for all the Service Perimeters have been
467
+ # committed. If a commit fails, it will cause the longrunning operation to
468
+ # return an error response and the entire commit operation will be cancelled.
469
+ # When successful, Operation.response field will contain
470
+ # CommitServicePerimetersResponse. The `dry_run` and the `spec` fields will be
471
+ # cleared after a successful commit operation.
472
+ # @param [String] parent
473
+ # Required. Resource name for the parent Access Policy which owns all Service
474
+ # Perimeters in scope for the commit operation. Format: `accessPolicies/`
475
+ # policy_id``
476
+ # @param [Google::Apis::AccesscontextmanagerV1::CommitServicePerimetersRequest] commit_service_perimeters_request_object
477
+ # @param [String] fields
478
+ # Selector specifying which fields to include in a partial response.
479
+ # @param [String] quota_user
480
+ # Available to use for quota purposes for server-side applications. Can be any
481
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
482
+ # @param [Google::Apis::RequestOptions] options
483
+ # Request-specific options
484
+ #
485
+ # @yield [result, err] Result & error if block supplied
486
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
487
+ # @yieldparam err [StandardError] error object if request failed
488
+ #
489
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
490
+ #
491
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
492
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
493
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
494
+ def commit_service_perimeters(parent, commit_service_perimeters_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
495
+ command = make_simple_command(:post, 'v1/{+parent}/servicePerimeters:commit', options)
496
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::CommitServicePerimetersRequest::Representation
497
+ command.request_object = commit_service_perimeters_request_object
498
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
499
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
500
+ command.params['parent'] = parent unless parent.nil?
501
+ command.query['fields'] = fields unless fields.nil?
502
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
503
+ execute_or_queue_command(command, &block)
504
+ end
505
+
506
+ # Create a Service Perimeter. The longrunning operation from this RPC will have
507
+ # a successful status once the Service Perimeter has propagated to long-lasting
508
+ # storage. Service Perimeters containing errors will result in an error response
509
+ # for the first error encountered.
510
+ # @param [String] parent
511
+ # Required. Resource name for the access policy which owns this Service
512
+ # Perimeter. Format: `accessPolicies/`policy_id``
513
+ # @param [Google::Apis::AccesscontextmanagerV1::ServicePerimeter] service_perimeter_object
514
+ # @param [String] fields
515
+ # Selector specifying which fields to include in a partial response.
516
+ # @param [String] quota_user
517
+ # Available to use for quota purposes for server-side applications. Can be any
518
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
519
+ # @param [Google::Apis::RequestOptions] options
520
+ # Request-specific options
521
+ #
522
+ # @yield [result, err] Result & error if block supplied
523
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
524
+ # @yieldparam err [StandardError] error object if request failed
525
+ #
526
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
527
+ #
528
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
529
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
530
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
531
+ def create_access_policy_service_perimeter(parent, service_perimeter_object = nil, fields: nil, quota_user: nil, options: nil, &block)
532
+ command = make_simple_command(:post, 'v1/{+parent}/servicePerimeters', options)
533
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::ServicePerimeter::Representation
534
+ command.request_object = service_perimeter_object
535
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
536
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
537
+ command.params['parent'] = parent unless parent.nil?
538
+ command.query['fields'] = fields unless fields.nil?
539
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
540
+ execute_or_queue_command(command, &block)
541
+ end
542
+
543
+ # Delete a Service Perimeter by resource name. The longrunning operation from
544
+ # this RPC will have a successful status once the Service Perimeter has been
545
+ # removed from long-lasting storage.
546
+ # @param [String] name
547
+ # Required. Resource name for the Service Perimeter. Format: `accessPolicies/`
548
+ # policy_id`/servicePerimeters/`service_perimeter_id``
549
+ # @param [String] fields
550
+ # Selector specifying which fields to include in a partial response.
551
+ # @param [String] quota_user
552
+ # Available to use for quota purposes for server-side applications. Can be any
553
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
554
+ # @param [Google::Apis::RequestOptions] options
555
+ # Request-specific options
556
+ #
557
+ # @yield [result, err] Result & error if block supplied
558
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
559
+ # @yieldparam err [StandardError] error object if request failed
560
+ #
561
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
562
+ #
563
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
564
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
565
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
566
+ def delete_access_policy_service_perimeter(name, fields: nil, quota_user: nil, options: nil, &block)
567
+ command = make_simple_command(:delete, 'v1/{+name}', options)
568
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
569
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
570
+ command.params['name'] = name unless name.nil?
571
+ command.query['fields'] = fields unless fields.nil?
572
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
573
+ execute_or_queue_command(command, &block)
574
+ end
575
+
576
+ # Get a Service Perimeter by resource name.
577
+ # @param [String] name
578
+ # Required. Resource name for the Service Perimeter. Format: `accessPolicies/`
579
+ # policy_id`/servicePerimeters/`service_perimeters_id``
580
+ # @param [String] fields
581
+ # Selector specifying which fields to include in a partial response.
582
+ # @param [String] quota_user
583
+ # Available to use for quota purposes for server-side applications. Can be any
584
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
585
+ # @param [Google::Apis::RequestOptions] options
586
+ # Request-specific options
587
+ #
588
+ # @yield [result, err] Result & error if block supplied
589
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ServicePerimeter] parsed result object
590
+ # @yieldparam err [StandardError] error object if request failed
591
+ #
592
+ # @return [Google::Apis::AccesscontextmanagerV1::ServicePerimeter]
593
+ #
594
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
595
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
596
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
597
+ def get_access_policy_service_perimeter(name, fields: nil, quota_user: nil, options: nil, &block)
598
+ command = make_simple_command(:get, 'v1/{+name}', options)
599
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ServicePerimeter::Representation
600
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ServicePerimeter
601
+ command.params['name'] = name unless name.nil?
602
+ command.query['fields'] = fields unless fields.nil?
603
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
604
+ execute_or_queue_command(command, &block)
605
+ end
606
+
607
+ # List all Service Perimeters for an access policy.
608
+ # @param [String] parent
609
+ # Required. Resource name for the access policy to list Service Perimeters from.
610
+ # Format: `accessPolicies/`policy_id``
611
+ # @param [Fixnum] page_size
612
+ # Number of Service Perimeters to include in the list. Default 100.
613
+ # @param [String] page_token
614
+ # Next page token for the next batch of Service Perimeter instances. Defaults to
615
+ # the first page of results.
616
+ # @param [String] fields
617
+ # Selector specifying which fields to include in a partial response.
618
+ # @param [String] quota_user
619
+ # Available to use for quota purposes for server-side applications. Can be any
620
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
621
+ # @param [Google::Apis::RequestOptions] options
622
+ # Request-specific options
623
+ #
624
+ # @yield [result, err] Result & error if block supplied
625
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ListServicePerimetersResponse] parsed result object
626
+ # @yieldparam err [StandardError] error object if request failed
627
+ #
628
+ # @return [Google::Apis::AccesscontextmanagerV1::ListServicePerimetersResponse]
629
+ #
630
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
631
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
632
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
633
+ def list_access_policy_service_perimeters(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
634
+ command = make_simple_command(:get, 'v1/{+parent}/servicePerimeters', options)
635
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ListServicePerimetersResponse::Representation
636
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ListServicePerimetersResponse
637
+ command.params['parent'] = parent unless parent.nil?
638
+ command.query['pageSize'] = page_size unless page_size.nil?
639
+ command.query['pageToken'] = page_token unless page_token.nil?
640
+ command.query['fields'] = fields unless fields.nil?
641
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
642
+ execute_or_queue_command(command, &block)
643
+ end
644
+
645
+ # Update a Service Perimeter. The longrunning operation from this RPC will have
646
+ # a successful status once the changes to the Service Perimeter have propagated
647
+ # to long-lasting storage. Service Perimeter containing errors will result in an
648
+ # error response for the first error encountered.
649
+ # @param [String] name
650
+ # Required. Resource name for the ServicePerimeter. The `short_name` component
651
+ # must begin with a letter and only include alphanumeric and '_'. Format: `
652
+ # accessPolicies/`policy_id`/servicePerimeters/`short_name``
653
+ # @param [Google::Apis::AccesscontextmanagerV1::ServicePerimeter] service_perimeter_object
654
+ # @param [String] update_mask
655
+ # Required. Mask to control which fields get updated. Must be non-empty.
656
+ # @param [String] fields
657
+ # Selector specifying which fields to include in a partial response.
658
+ # @param [String] quota_user
659
+ # Available to use for quota purposes for server-side applications. Can be any
660
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
661
+ # @param [Google::Apis::RequestOptions] options
662
+ # Request-specific options
663
+ #
664
+ # @yield [result, err] Result & error if block supplied
665
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
666
+ # @yieldparam err [StandardError] error object if request failed
667
+ #
668
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
669
+ #
670
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
671
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
672
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
673
+ def patch_access_policy_service_perimeter(name, service_perimeter_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
674
+ command = make_simple_command(:patch, 'v1/{+name}', options)
675
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::ServicePerimeter::Representation
676
+ command.request_object = service_perimeter_object
677
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
678
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
679
+ command.params['name'] = name unless name.nil?
680
+ command.query['updateMask'] = update_mask unless update_mask.nil?
681
+ command.query['fields'] = fields unless fields.nil?
682
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
683
+ execute_or_queue_command(command, &block)
684
+ end
685
+
686
+ # Replace all existing Service Perimeters in an Access Policy with the Service
687
+ # Perimeters provided. This is done atomically. The longrunning operation from
688
+ # this RPC will have a successful status once all replacements have propagated
689
+ # to long-lasting storage. Replacements containing errors will result in an
690
+ # error response for the first error encountered. Replacement will be cancelled
691
+ # on error, existing Service Perimeters will not be affected. Operation.response
692
+ # field will contain ReplaceServicePerimetersResponse.
693
+ # @param [String] parent
694
+ # Required. Resource name for the access policy which owns these Service
695
+ # Perimeters. Format: `accessPolicies/`policy_id``
696
+ # @param [Google::Apis::AccesscontextmanagerV1::ReplaceServicePerimetersRequest] replace_service_perimeters_request_object
697
+ # @param [String] fields
698
+ # Selector specifying which fields to include in a partial response.
699
+ # @param [String] quota_user
700
+ # Available to use for quota purposes for server-side applications. Can be any
701
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
702
+ # @param [Google::Apis::RequestOptions] options
703
+ # Request-specific options
704
+ #
705
+ # @yield [result, err] Result & error if block supplied
706
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
707
+ # @yieldparam err [StandardError] error object if request failed
708
+ #
709
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
710
+ #
711
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
712
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
713
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
714
+ def replace_access_policy_service_perimeter_all(parent, replace_service_perimeters_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
715
+ command = make_simple_command(:post, 'v1/{+parent}/servicePerimeters:replaceAll', options)
716
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::ReplaceServicePerimetersRequest::Representation
717
+ command.request_object = replace_service_perimeters_request_object
718
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
719
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
720
+ command.params['parent'] = parent unless parent.nil?
721
+ command.query['fields'] = fields unless fields.nil?
722
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
723
+ execute_or_queue_command(command, &block)
724
+ end
725
+
726
+ # Starts asynchronous cancellation on a long-running operation. The server makes
727
+ # a best effort to cancel the operation, but success is not guaranteed. If the
728
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
729
+ # Clients can use Operations.GetOperation or other methods to check whether the
730
+ # cancellation succeeded or whether the operation completed despite cancellation.
731
+ # On successful cancellation, the operation is not deleted; instead, it becomes
732
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
733
+ # corresponding to `Code.CANCELLED`.
734
+ # @param [String] name
735
+ # The name of the operation resource to be cancelled.
736
+ # @param [Google::Apis::AccesscontextmanagerV1::CancelOperationRequest] cancel_operation_request_object
737
+ # @param [String] fields
738
+ # Selector specifying which fields to include in a partial response.
739
+ # @param [String] quota_user
740
+ # Available to use for quota purposes for server-side applications. Can be any
741
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
742
+ # @param [Google::Apis::RequestOptions] options
743
+ # Request-specific options
744
+ #
745
+ # @yield [result, err] Result & error if block supplied
746
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Empty] parsed result object
747
+ # @yieldparam err [StandardError] error object if request failed
748
+ #
749
+ # @return [Google::Apis::AccesscontextmanagerV1::Empty]
750
+ #
751
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
752
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
753
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
754
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
755
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
756
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::CancelOperationRequest::Representation
757
+ command.request_object = cancel_operation_request_object
758
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Empty::Representation
759
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Empty
760
+ command.params['name'] = name unless name.nil?
761
+ command.query['fields'] = fields unless fields.nil?
762
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
763
+ execute_or_queue_command(command, &block)
764
+ end
765
+
766
+ # Deletes a long-running operation. This method indicates that the client is no
767
+ # longer interested in the operation result. It does not cancel the operation.
768
+ # If the server doesn't support this method, it returns `google.rpc.Code.
769
+ # UNIMPLEMENTED`.
770
+ # @param [String] name
771
+ # The name of the operation resource to be deleted.
772
+ # @param [String] fields
773
+ # Selector specifying which fields to include in a partial response.
774
+ # @param [String] quota_user
775
+ # Available to use for quota purposes for server-side applications. Can be any
776
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
777
+ # @param [Google::Apis::RequestOptions] options
778
+ # Request-specific options
779
+ #
780
+ # @yield [result, err] Result & error if block supplied
781
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Empty] parsed result object
782
+ # @yieldparam err [StandardError] error object if request failed
783
+ #
784
+ # @return [Google::Apis::AccesscontextmanagerV1::Empty]
785
+ #
786
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
787
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
788
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
789
+ def delete_operation(name, fields: nil, quota_user: nil, options: nil, &block)
790
+ command = make_simple_command(:delete, 'v1/{+name}', options)
791
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Empty::Representation
792
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Empty
793
+ command.params['name'] = name unless name.nil?
794
+ command.query['fields'] = fields unless fields.nil?
795
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
796
+ execute_or_queue_command(command, &block)
797
+ end
798
+
799
+ # Gets the latest state of a long-running operation. Clients can use this method
800
+ # to poll the operation result at intervals as recommended by the API service.
801
+ # @param [String] name
802
+ # The name of the operation resource.
803
+ # @param [String] fields
804
+ # Selector specifying which fields to include in a partial response.
805
+ # @param [String] quota_user
806
+ # Available to use for quota purposes for server-side applications. Can be any
807
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
808
+ # @param [Google::Apis::RequestOptions] options
809
+ # Request-specific options
810
+ #
811
+ # @yield [result, err] Result & error if block supplied
812
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
813
+ # @yieldparam err [StandardError] error object if request failed
814
+ #
815
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
816
+ #
817
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
818
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
819
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
820
+ def get_operation(name, fields: nil, quota_user: nil, options: nil, &block)
821
+ command = make_simple_command(:get, 'v1/{+name}', options)
822
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
823
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
824
+ command.params['name'] = name unless name.nil?
825
+ command.query['fields'] = fields unless fields.nil?
826
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
827
+ execute_or_queue_command(command, &block)
828
+ end
829
+
830
+ # Lists operations that match the specified filter in the request. If the server
831
+ # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
832
+ # binding allows API services to override the binding to use different resource
833
+ # name schemes, such as `users/*/operations`. To override the binding, API
834
+ # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
835
+ # service configuration. For backwards compatibility, the default name includes
836
+ # the operations collection id, however overriding users must ensure the name
837
+ # binding is the parent resource, without the operations collection id.
838
+ # @param [String] name
839
+ # The name of the operation's parent resource.
840
+ # @param [String] filter
841
+ # The standard list filter.
842
+ # @param [Fixnum] page_size
843
+ # The standard list page size.
844
+ # @param [String] page_token
845
+ # The standard list page token.
846
+ # @param [String] fields
847
+ # Selector specifying which fields to include in a partial response.
848
+ # @param [String] quota_user
849
+ # Available to use for quota purposes for server-side applications. Can be any
850
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
851
+ # @param [Google::Apis::RequestOptions] options
852
+ # Request-specific options
853
+ #
854
+ # @yield [result, err] Result & error if block supplied
855
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ListOperationsResponse] parsed result object
856
+ # @yieldparam err [StandardError] error object if request failed
857
+ #
858
+ # @return [Google::Apis::AccesscontextmanagerV1::ListOperationsResponse]
859
+ #
860
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
861
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
862
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
863
+ def list_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
864
+ command = make_simple_command(:get, 'v1/{+name}', options)
865
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ListOperationsResponse::Representation
866
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ListOperationsResponse
867
+ command.params['name'] = name unless name.nil?
868
+ command.query['filter'] = filter unless filter.nil?
869
+ command.query['pageSize'] = page_size unless page_size.nil?
870
+ command.query['pageToken'] = page_token unless page_token.nil?
871
+ command.query['fields'] = fields unless fields.nil?
872
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
873
+ execute_or_queue_command(command, &block)
874
+ end
875
+
876
+ # Creates a GcpUserAccessBinding. If the client specifies a name, the server
877
+ # will ignore it. Fails if a resource already exists with the same group_key.
878
+ # Completion of this long-running operation does not necessarily signify that
879
+ # the new binding is deployed onto all affected users, which may take more time.
880
+ # @param [String] parent
881
+ # Required. Example: "organizations/256"
882
+ # @param [Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding] gcp_user_access_binding_object
883
+ # @param [String] fields
884
+ # Selector specifying which fields to include in a partial response.
885
+ # @param [String] quota_user
886
+ # Available to use for quota purposes for server-side applications. Can be any
887
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
888
+ # @param [Google::Apis::RequestOptions] options
889
+ # Request-specific options
890
+ #
891
+ # @yield [result, err] Result & error if block supplied
892
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
893
+ # @yieldparam err [StandardError] error object if request failed
894
+ #
895
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
896
+ #
897
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
898
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
899
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
900
+ def create_organization_gcp_user_access_binding(parent, gcp_user_access_binding_object = nil, fields: nil, quota_user: nil, options: nil, &block)
901
+ command = make_simple_command(:post, 'v1/{+parent}/gcpUserAccessBindings', options)
902
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding::Representation
903
+ command.request_object = gcp_user_access_binding_object
904
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
905
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
906
+ command.params['parent'] = parent unless parent.nil?
907
+ command.query['fields'] = fields unless fields.nil?
908
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
909
+ execute_or_queue_command(command, &block)
910
+ end
911
+
912
+ # Deletes a GcpUserAccessBinding. Completion of this long-running operation does
913
+ # not necessarily signify that the binding deletion is deployed onto all
914
+ # affected users, which may take more time.
915
+ # @param [String] name
916
+ # Required. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
917
+ # @param [String] fields
918
+ # Selector specifying which fields to include in a partial response.
919
+ # @param [String] quota_user
920
+ # Available to use for quota purposes for server-side applications. Can be any
921
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
922
+ # @param [Google::Apis::RequestOptions] options
923
+ # Request-specific options
924
+ #
925
+ # @yield [result, err] Result & error if block supplied
926
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
927
+ # @yieldparam err [StandardError] error object if request failed
928
+ #
929
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
930
+ #
931
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
932
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
933
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
934
+ def delete_organization_gcp_user_access_binding(name, fields: nil, quota_user: nil, options: nil, &block)
935
+ command = make_simple_command(:delete, 'v1/{+name}', options)
936
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
937
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
938
+ command.params['name'] = name unless name.nil?
939
+ command.query['fields'] = fields unless fields.nil?
940
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
941
+ execute_or_queue_command(command, &block)
942
+ end
943
+
944
+ # Gets the GcpUserAccessBinding with the given name.
945
+ # @param [String] name
946
+ # Required. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
947
+ # @param [String] fields
948
+ # Selector specifying which fields to include in a partial response.
949
+ # @param [String] quota_user
950
+ # Available to use for quota purposes for server-side applications. Can be any
951
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
952
+ # @param [Google::Apis::RequestOptions] options
953
+ # Request-specific options
954
+ #
955
+ # @yield [result, err] Result & error if block supplied
956
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding] parsed result object
957
+ # @yieldparam err [StandardError] error object if request failed
958
+ #
959
+ # @return [Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding]
960
+ #
961
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
962
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
963
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
964
+ def get_organization_gcp_user_access_binding(name, fields: nil, quota_user: nil, options: nil, &block)
965
+ command = make_simple_command(:get, 'v1/{+name}', options)
966
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding::Representation
967
+ command.response_class = Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding
968
+ command.params['name'] = name unless name.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Lists all GcpUserAccessBindings for a Google Cloud organization.
975
+ # @param [String] parent
976
+ # Required. Example: "organizations/256"
977
+ # @param [Fixnum] page_size
978
+ # Optional. Maximum number of items to return. The server may return fewer items.
979
+ # If left blank, the server may return any number of items.
980
+ # @param [String] page_token
981
+ # Optional. If left blank, returns the first page. To enumerate all items, use
982
+ # the next_page_token from your previous list operation.
983
+ # @param [String] fields
984
+ # Selector specifying which fields to include in a partial response.
985
+ # @param [String] quota_user
986
+ # Available to use for quota purposes for server-side applications. Can be any
987
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
988
+ # @param [Google::Apis::RequestOptions] options
989
+ # Request-specific options
990
+ #
991
+ # @yield [result, err] Result & error if block supplied
992
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::ListGcpUserAccessBindingsResponse] parsed result object
993
+ # @yieldparam err [StandardError] error object if request failed
994
+ #
995
+ # @return [Google::Apis::AccesscontextmanagerV1::ListGcpUserAccessBindingsResponse]
996
+ #
997
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
998
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
999
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1000
+ def list_organization_gcp_user_access_bindings(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1001
+ command = make_simple_command(:get, 'v1/{+parent}/gcpUserAccessBindings', options)
1002
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::ListGcpUserAccessBindingsResponse::Representation
1003
+ command.response_class = Google::Apis::AccesscontextmanagerV1::ListGcpUserAccessBindingsResponse
1004
+ command.params['parent'] = parent unless parent.nil?
1005
+ command.query['pageSize'] = page_size unless page_size.nil?
1006
+ command.query['pageToken'] = page_token unless page_token.nil?
1007
+ command.query['fields'] = fields unless fields.nil?
1008
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1009
+ execute_or_queue_command(command, &block)
1010
+ end
1011
+
1012
+ # Updates a GcpUserAccessBinding. Completion of this long-running operation does
1013
+ # not necessarily signify that the changed binding is deployed onto all affected
1014
+ # users, which may take more time.
1015
+ # @param [String] name
1016
+ # Immutable. Assigned by the server during creation. The last segment has an
1017
+ # arbitrary length and has only URI unreserved characters (as defined by [RFC
1018
+ # 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should
1019
+ # not be specified by the client during creation. Example: "organizations/256/
1020
+ # gcpUserAccessBindings/b3-BhcX_Ud5N"
1021
+ # @param [Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding] gcp_user_access_binding_object
1022
+ # @param [String] update_mask
1023
+ # Required. Only the fields specified in this mask are updated. Because name and
1024
+ # group_key cannot be changed, update_mask is required and must always be:
1025
+ # update_mask ` paths: "access_levels" `
1026
+ # @param [String] fields
1027
+ # Selector specifying which fields to include in a partial response.
1028
+ # @param [String] quota_user
1029
+ # Available to use for quota purposes for server-side applications. Can be any
1030
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1031
+ # @param [Google::Apis::RequestOptions] options
1032
+ # Request-specific options
1033
+ #
1034
+ # @yield [result, err] Result & error if block supplied
1035
+ # @yieldparam result [Google::Apis::AccesscontextmanagerV1::Operation] parsed result object
1036
+ # @yieldparam err [StandardError] error object if request failed
1037
+ #
1038
+ # @return [Google::Apis::AccesscontextmanagerV1::Operation]
1039
+ #
1040
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1041
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1042
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1043
+ def patch_organization_gcp_user_access_binding(name, gcp_user_access_binding_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1044
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1045
+ command.request_representation = Google::Apis::AccesscontextmanagerV1::GcpUserAccessBinding::Representation
1046
+ command.request_object = gcp_user_access_binding_object
1047
+ command.response_representation = Google::Apis::AccesscontextmanagerV1::Operation::Representation
1048
+ command.response_class = Google::Apis::AccesscontextmanagerV1::Operation
1049
+ command.params['name'] = name unless name.nil?
1050
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1051
+ command.query['fields'] = fields unless fields.nil?
1052
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1053
+ execute_or_queue_command(command, &block)
1054
+ end
1055
+
1056
+ protected
1057
+
1058
+ def apply_command_defaults(command)
1059
+ command.query['key'] = key unless key.nil?
1060
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1061
+ end
1062
+ end
1063
+ end
1064
+ end
1065
+ end