google-apis-accesscontextmanager_v1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,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