google-apis-networksecurity_v1 0.19.0 → 0.20.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -49,9 +49,716 @@ module Google
49
49
  @batch_path = 'batch'
50
50
  end
51
51
 
52
+ # Adds items to an address group.
53
+ # @param [String] address_group
54
+ # Required. A name of the AddressGroup to add items to. Must be in the format `
55
+ # projects|organization/*/locations/`location`/addressGroups/*`.
56
+ # @param [Google::Apis::NetworksecurityV1::AddAddressGroupItemsRequest] add_address_group_items_request_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::NetworksecurityV1::Operation] parsed result object
67
+ # @yieldparam err [StandardError] error object if request failed
68
+ #
69
+ # @return [Google::Apis::NetworksecurityV1::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 add_organization_location_address_group_items(address_group, add_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
75
+ command = make_simple_command(:post, 'v1/{+addressGroup}:addItems', options)
76
+ command.request_representation = Google::Apis::NetworksecurityV1::AddAddressGroupItemsRequest::Representation
77
+ command.request_object = add_address_group_items_request_object
78
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
79
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
80
+ command.params['addressGroup'] = address_group unless address_group.nil?
81
+ command.query['fields'] = fields unless fields.nil?
82
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
83
+ execute_or_queue_command(command, &block)
84
+ end
85
+
86
+ # Clones items from one address group to another.
87
+ # @param [String] address_group
88
+ # Required. A name of the AddressGroup to clone items to. Must be in the format `
89
+ # projects|organization/*/locations/`location`/addressGroups/*`.
90
+ # @param [Google::Apis::NetworksecurityV1::CloneAddressGroupItemsRequest] clone_address_group_items_request_object
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::NetworksecurityV1::Operation] parsed result object
101
+ # @yieldparam err [StandardError] error object if request failed
102
+ #
103
+ # @return [Google::Apis::NetworksecurityV1::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 clone_organization_location_address_group_items(address_group, clone_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
109
+ command = make_simple_command(:post, 'v1/{+addressGroup}:cloneItems', options)
110
+ command.request_representation = Google::Apis::NetworksecurityV1::CloneAddressGroupItemsRequest::Representation
111
+ command.request_object = clone_address_group_items_request_object
112
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
113
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
114
+ command.params['addressGroup'] = address_group unless address_group.nil?
115
+ command.query['fields'] = fields unless fields.nil?
116
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
117
+ execute_or_queue_command(command, &block)
118
+ end
119
+
120
+ # Creates a new address group in a given project and location.
121
+ # @param [String] parent
122
+ # Required. The parent resource of the AddressGroup. Must be in the format `
123
+ # projects/*/locations/`location``.
124
+ # @param [Google::Apis::NetworksecurityV1::AddressGroup] address_group_object
125
+ # @param [String] address_group_id
126
+ # Required. Short name of the AddressGroup resource to be created. This value
127
+ # should be 1-63 characters long, containing only letters, numbers, hyphens, and
128
+ # underscores, and should not start with a number. E.g. "authz_policy".
129
+ # @param [String] request_id
130
+ # Optional. An optional request ID to identify requests. Specify a unique
131
+ # request ID so that if you must retry your request, the server will know to
132
+ # ignore the request if it has already been completed. The server will guarantee
133
+ # that for at least 60 minutes since the first request. For example, consider a
134
+ # situation where you make an initial request and the request times out. If you
135
+ # make the request again with the same request ID, the server can check if
136
+ # original operation with the same request ID was received, and if so, will
137
+ # ignore the second request. This prevents clients from accidentally creating
138
+ # duplicate commitments. The request ID must be a valid UUID with the exception
139
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
140
+ # @param [String] fields
141
+ # Selector specifying which fields to include in a partial response.
142
+ # @param [String] quota_user
143
+ # Available to use for quota purposes for server-side applications. Can be any
144
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
145
+ # @param [Google::Apis::RequestOptions] options
146
+ # Request-specific options
147
+ #
148
+ # @yield [result, err] Result & error if block supplied
149
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
150
+ # @yieldparam err [StandardError] error object if request failed
151
+ #
152
+ # @return [Google::Apis::NetworksecurityV1::Operation]
153
+ #
154
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
155
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
156
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
157
+ def create_organization_location_address_group(parent, address_group_object = nil, address_group_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
158
+ command = make_simple_command(:post, 'v1/{+parent}/addressGroups', options)
159
+ command.request_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
160
+ command.request_object = address_group_object
161
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
162
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
163
+ command.params['parent'] = parent unless parent.nil?
164
+ command.query['addressGroupId'] = address_group_id unless address_group_id.nil?
165
+ command.query['requestId'] = request_id unless request_id.nil?
166
+ command.query['fields'] = fields unless fields.nil?
167
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
168
+ execute_or_queue_command(command, &block)
169
+ end
170
+
171
+ # Deletes an address group.
172
+ # @param [String] name
173
+ # Required. A name of the AddressGroup to delete. Must be in the format `
174
+ # projects/*/locations/`location`/addressGroups/*`.
175
+ # @param [String] request_id
176
+ # Optional. An optional request ID to identify requests. Specify a unique
177
+ # request ID so that if you must retry your request, the server will know to
178
+ # ignore the request if it has already been completed. The server will guarantee
179
+ # that for at least 60 minutes since the first request. For example, consider a
180
+ # situation where you make an initial request and the request times out. If you
181
+ # make the request again with the same request ID, the server can check if
182
+ # original operation with the same request ID was received, and if so, will
183
+ # ignore the second request. This prevents clients from accidentally creating
184
+ # duplicate commitments. The request ID must be a valid UUID with the exception
185
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
186
+ # @param [String] fields
187
+ # Selector specifying which fields to include in a partial response.
188
+ # @param [String] quota_user
189
+ # Available to use for quota purposes for server-side applications. Can be any
190
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
191
+ # @param [Google::Apis::RequestOptions] options
192
+ # Request-specific options
193
+ #
194
+ # @yield [result, err] Result & error if block supplied
195
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
196
+ # @yieldparam err [StandardError] error object if request failed
197
+ #
198
+ # @return [Google::Apis::NetworksecurityV1::Operation]
199
+ #
200
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
201
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
202
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
203
+ def delete_organization_location_address_group(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
204
+ command = make_simple_command(:delete, 'v1/{+name}', options)
205
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
206
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
207
+ command.params['name'] = name unless name.nil?
208
+ command.query['requestId'] = request_id unless request_id.nil?
209
+ command.query['fields'] = fields unless fields.nil?
210
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
211
+ execute_or_queue_command(command, &block)
212
+ end
213
+
214
+ # Gets details of a single address group.
215
+ # @param [String] name
216
+ # Required. A name of the AddressGroup to get. Must be in the format `projects/*/
217
+ # locations/`location`/addressGroups/*`.
218
+ # @param [String] fields
219
+ # Selector specifying which fields to include in a partial response.
220
+ # @param [String] quota_user
221
+ # Available to use for quota purposes for server-side applications. Can be any
222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
223
+ # @param [Google::Apis::RequestOptions] options
224
+ # Request-specific options
225
+ #
226
+ # @yield [result, err] Result & error if block supplied
227
+ # @yieldparam result [Google::Apis::NetworksecurityV1::AddressGroup] parsed result object
228
+ # @yieldparam err [StandardError] error object if request failed
229
+ #
230
+ # @return [Google::Apis::NetworksecurityV1::AddressGroup]
231
+ #
232
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
233
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
234
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
235
+ def get_organization_location_address_group(name, fields: nil, quota_user: nil, options: nil, &block)
236
+ command = make_simple_command(:get, 'v1/{+name}', options)
237
+ command.response_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
238
+ command.response_class = Google::Apis::NetworksecurityV1::AddressGroup
239
+ command.params['name'] = name unless name.nil?
240
+ command.query['fields'] = fields unless fields.nil?
241
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
242
+ execute_or_queue_command(command, &block)
243
+ end
244
+
245
+ # Lists address groups in a given project and location.
246
+ # @param [String] parent
247
+ # Required. The project and location from which the AddressGroups should be
248
+ # listed, specified in the format `projects/*/locations/`location``.
249
+ # @param [Fixnum] page_size
250
+ # Maximum number of AddressGroups to return per call.
251
+ # @param [String] page_token
252
+ # The value returned by the last `ListAddressGroupsResponse` Indicates that this
253
+ # is a continuation of a prior `ListAddressGroups` call, and that the system
254
+ # should return the next page of data.
255
+ # @param [String] fields
256
+ # Selector specifying which fields to include in a partial response.
257
+ # @param [String] quota_user
258
+ # Available to use for quota purposes for server-side applications. Can be any
259
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
260
+ # @param [Google::Apis::RequestOptions] options
261
+ # Request-specific options
262
+ #
263
+ # @yield [result, err] Result & error if block supplied
264
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListAddressGroupsResponse] parsed result object
265
+ # @yieldparam err [StandardError] error object if request failed
266
+ #
267
+ # @return [Google::Apis::NetworksecurityV1::ListAddressGroupsResponse]
268
+ #
269
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
270
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
271
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
272
+ def list_organization_location_address_groups(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
273
+ command = make_simple_command(:get, 'v1/{+parent}/addressGroups', options)
274
+ command.response_representation = Google::Apis::NetworksecurityV1::ListAddressGroupsResponse::Representation
275
+ command.response_class = Google::Apis::NetworksecurityV1::ListAddressGroupsResponse
276
+ command.params['parent'] = parent unless parent.nil?
277
+ command.query['pageSize'] = page_size unless page_size.nil?
278
+ command.query['pageToken'] = page_token unless page_token.nil?
279
+ command.query['fields'] = fields unless fields.nil?
280
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
281
+ execute_or_queue_command(command, &block)
282
+ end
283
+
284
+ # Lists references of an address group.
285
+ # @param [String] address_group
286
+ # Required. A name of the AddressGroup to clone items to. Must be in the format `
287
+ # projects|organization/*/locations/`location`/addressGroups/*`.
288
+ # @param [Fixnum] page_size
289
+ # The maximum number of references to return. If unspecified, server will pick
290
+ # an appropriate default. Server may return fewer items than requested. A caller
291
+ # should only rely on response's next_page_token to determine if there are more
292
+ # AddressGroupUsers left to be queried.
293
+ # @param [String] page_token
294
+ # The next_page_token value returned from a previous List request, if any.
295
+ # @param [String] fields
296
+ # Selector specifying which fields to include in a partial response.
297
+ # @param [String] quota_user
298
+ # Available to use for quota purposes for server-side applications. Can be any
299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
300
+ # @param [Google::Apis::RequestOptions] options
301
+ # Request-specific options
302
+ #
303
+ # @yield [result, err] Result & error if block supplied
304
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse] parsed result object
305
+ # @yieldparam err [StandardError] error object if request failed
306
+ #
307
+ # @return [Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse]
308
+ #
309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
312
+ def list_organization_location_address_group_references(address_group, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
313
+ command = make_simple_command(:get, 'v1/{+addressGroup}:listReferences', options)
314
+ command.response_representation = Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse::Representation
315
+ command.response_class = Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse
316
+ command.params['addressGroup'] = address_group unless address_group.nil?
317
+ command.query['pageSize'] = page_size unless page_size.nil?
318
+ command.query['pageToken'] = page_token unless page_token.nil?
319
+ command.query['fields'] = fields unless fields.nil?
320
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
321
+ execute_or_queue_command(command, &block)
322
+ end
323
+
324
+ # Updates parameters of an address group.
325
+ # @param [String] name
326
+ # Required. Name of the AddressGroup resource. It matches pattern `projects/*/
327
+ # locations/`location`/addressGroups/`.
328
+ # @param [Google::Apis::NetworksecurityV1::AddressGroup] address_group_object
329
+ # @param [String] request_id
330
+ # Optional. An optional request ID to identify requests. Specify a unique
331
+ # request ID so that if you must retry your request, the server will know to
332
+ # ignore the request if it has already been completed. The server will guarantee
333
+ # that for at least 60 minutes since the first request. For example, consider a
334
+ # situation where you make an initial request and the request times out. If you
335
+ # make the request again with the same request ID, the server can check if
336
+ # original operation with the same request ID was received, and if so, will
337
+ # ignore the second request. This prevents clients from accidentally creating
338
+ # duplicate commitments. The request ID must be a valid UUID with the exception
339
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
340
+ # @param [String] update_mask
341
+ # Optional. Field mask is used to specify the fields to be overwritten in the
342
+ # AddressGroup resource by the update. The fields specified in the update_mask
343
+ # are relative to the resource, not the full request. A field will be
344
+ # overwritten if it is in the mask. If the user does not provide a mask then all
345
+ # fields will be overwritten.
346
+ # @param [String] fields
347
+ # Selector specifying which fields to include in a partial response.
348
+ # @param [String] quota_user
349
+ # Available to use for quota purposes for server-side applications. Can be any
350
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
351
+ # @param [Google::Apis::RequestOptions] options
352
+ # Request-specific options
353
+ #
354
+ # @yield [result, err] Result & error if block supplied
355
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
356
+ # @yieldparam err [StandardError] error object if request failed
357
+ #
358
+ # @return [Google::Apis::NetworksecurityV1::Operation]
359
+ #
360
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
361
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
362
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
363
+ def patch_organization_location_address_group(name, address_group_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
364
+ command = make_simple_command(:patch, 'v1/{+name}', options)
365
+ command.request_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
366
+ command.request_object = address_group_object
367
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
368
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
369
+ command.params['name'] = name unless name.nil?
370
+ command.query['requestId'] = request_id unless request_id.nil?
371
+ command.query['updateMask'] = update_mask unless update_mask.nil?
372
+ command.query['fields'] = fields unless fields.nil?
373
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
374
+ execute_or_queue_command(command, &block)
375
+ end
376
+
377
+ # Removes items from an address group.
378
+ # @param [String] address_group
379
+ # Required. A name of the AddressGroup to remove items from. Must be in the
380
+ # format `projects|organization/*/locations/`location`/addressGroups/*`.
381
+ # @param [Google::Apis::NetworksecurityV1::RemoveAddressGroupItemsRequest] remove_address_group_items_request_object
382
+ # @param [String] fields
383
+ # Selector specifying which fields to include in a partial response.
384
+ # @param [String] quota_user
385
+ # Available to use for quota purposes for server-side applications. Can be any
386
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
387
+ # @param [Google::Apis::RequestOptions] options
388
+ # Request-specific options
389
+ #
390
+ # @yield [result, err] Result & error if block supplied
391
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
392
+ # @yieldparam err [StandardError] error object if request failed
393
+ #
394
+ # @return [Google::Apis::NetworksecurityV1::Operation]
395
+ #
396
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
397
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
398
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
399
+ def remove_organization_location_address_group_items(address_group, remove_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
400
+ command = make_simple_command(:post, 'v1/{+addressGroup}:removeItems', options)
401
+ command.request_representation = Google::Apis::NetworksecurityV1::RemoveAddressGroupItemsRequest::Representation
402
+ command.request_object = remove_address_group_items_request_object
403
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
404
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
405
+ command.params['addressGroup'] = address_group unless address_group.nil?
406
+ command.query['fields'] = fields unless fields.nil?
407
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
408
+ execute_or_queue_command(command, &block)
409
+ end
410
+
411
+ # Starts asynchronous cancellation on a long-running operation. The server makes
412
+ # a best effort to cancel the operation, but success is not guaranteed. If the
413
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
414
+ # Clients can use Operations.GetOperation or other methods to check whether the
415
+ # cancellation succeeded or whether the operation completed despite cancellation.
416
+ # On successful cancellation, the operation is not deleted; instead, it becomes
417
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
418
+ # corresponding to `Code.CANCELLED`.
419
+ # @param [String] name
420
+ # The name of the operation resource to be cancelled.
421
+ # @param [Google::Apis::NetworksecurityV1::CancelOperationRequest] cancel_operation_request_object
422
+ # @param [String] fields
423
+ # Selector specifying which fields to include in a partial response.
424
+ # @param [String] quota_user
425
+ # Available to use for quota purposes for server-side applications. Can be any
426
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
427
+ # @param [Google::Apis::RequestOptions] options
428
+ # Request-specific options
429
+ #
430
+ # @yield [result, err] Result & error if block supplied
431
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Empty] parsed result object
432
+ # @yieldparam err [StandardError] error object if request failed
433
+ #
434
+ # @return [Google::Apis::NetworksecurityV1::Empty]
435
+ #
436
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
437
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
438
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
439
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
440
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
441
+ command.request_representation = Google::Apis::NetworksecurityV1::CancelOperationRequest::Representation
442
+ command.request_object = cancel_operation_request_object
443
+ command.response_representation = Google::Apis::NetworksecurityV1::Empty::Representation
444
+ command.response_class = Google::Apis::NetworksecurityV1::Empty
445
+ command.params['name'] = name unless name.nil?
446
+ command.query['fields'] = fields unless fields.nil?
447
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
448
+ execute_or_queue_command(command, &block)
449
+ end
450
+
451
+ # Deletes a long-running operation. This method indicates that the client is no
452
+ # longer interested in the operation result. It does not cancel the operation.
453
+ # If the server doesn't support this method, it returns `google.rpc.Code.
454
+ # UNIMPLEMENTED`.
455
+ # @param [String] name
456
+ # The name of the operation resource to be deleted.
457
+ # @param [String] fields
458
+ # Selector specifying which fields to include in a partial response.
459
+ # @param [String] quota_user
460
+ # Available to use for quota purposes for server-side applications. Can be any
461
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
462
+ # @param [Google::Apis::RequestOptions] options
463
+ # Request-specific options
464
+ #
465
+ # @yield [result, err] Result & error if block supplied
466
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Empty] parsed result object
467
+ # @yieldparam err [StandardError] error object if request failed
468
+ #
469
+ # @return [Google::Apis::NetworksecurityV1::Empty]
470
+ #
471
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
472
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
473
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
474
+ def delete_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
475
+ command = make_simple_command(:delete, 'v1/{+name}', options)
476
+ command.response_representation = Google::Apis::NetworksecurityV1::Empty::Representation
477
+ command.response_class = Google::Apis::NetworksecurityV1::Empty
478
+ command.params['name'] = name unless name.nil?
479
+ command.query['fields'] = fields unless fields.nil?
480
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
481
+ execute_or_queue_command(command, &block)
482
+ end
483
+
484
+ # Gets the latest state of a long-running operation. Clients can use this method
485
+ # to poll the operation result at intervals as recommended by the API service.
486
+ # @param [String] name
487
+ # The name of the operation resource.
488
+ # @param [String] fields
489
+ # Selector specifying which fields to include in a partial response.
490
+ # @param [String] quota_user
491
+ # Available to use for quota purposes for server-side applications. Can be any
492
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
493
+ # @param [Google::Apis::RequestOptions] options
494
+ # Request-specific options
495
+ #
496
+ # @yield [result, err] Result & error if block supplied
497
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
498
+ # @yieldparam err [StandardError] error object if request failed
499
+ #
500
+ # @return [Google::Apis::NetworksecurityV1::Operation]
501
+ #
502
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
503
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
504
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
505
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
506
+ command = make_simple_command(:get, 'v1/{+name}', options)
507
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
508
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
509
+ command.params['name'] = name unless name.nil?
510
+ command.query['fields'] = fields unless fields.nil?
511
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
512
+ execute_or_queue_command(command, &block)
513
+ end
514
+
515
+ # Lists operations that match the specified filter in the request. If the server
516
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
517
+ # @param [String] name
518
+ # The name of the operation's parent resource.
519
+ # @param [String] filter
520
+ # The standard list filter.
521
+ # @param [Fixnum] page_size
522
+ # The standard list page size.
523
+ # @param [String] page_token
524
+ # The standard list page token.
525
+ # @param [String] fields
526
+ # Selector specifying which fields to include in a partial response.
527
+ # @param [String] quota_user
528
+ # Available to use for quota purposes for server-side applications. Can be any
529
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
530
+ # @param [Google::Apis::RequestOptions] options
531
+ # Request-specific options
532
+ #
533
+ # @yield [result, err] Result & error if block supplied
534
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListOperationsResponse] parsed result object
535
+ # @yieldparam err [StandardError] error object if request failed
536
+ #
537
+ # @return [Google::Apis::NetworksecurityV1::ListOperationsResponse]
538
+ #
539
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
540
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
541
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
542
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
543
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
544
+ command.response_representation = Google::Apis::NetworksecurityV1::ListOperationsResponse::Representation
545
+ command.response_class = Google::Apis::NetworksecurityV1::ListOperationsResponse
546
+ command.params['name'] = name unless name.nil?
547
+ command.query['filter'] = filter unless filter.nil?
548
+ command.query['pageSize'] = page_size unless page_size.nil?
549
+ command.query['pageToken'] = page_token unless page_token.nil?
550
+ command.query['fields'] = fields unless fields.nil?
551
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
552
+ execute_or_queue_command(command, &block)
553
+ end
554
+
52
555
  # Gets information about a location.
53
556
  # @param [String] name
54
- # Resource name for the location.
557
+ # Resource name for the location.
558
+ # @param [String] fields
559
+ # Selector specifying which fields to include in a partial response.
560
+ # @param [String] quota_user
561
+ # Available to use for quota purposes for server-side applications. Can be any
562
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
563
+ # @param [Google::Apis::RequestOptions] options
564
+ # Request-specific options
565
+ #
566
+ # @yield [result, err] Result & error if block supplied
567
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Location] parsed result object
568
+ # @yieldparam err [StandardError] error object if request failed
569
+ #
570
+ # @return [Google::Apis::NetworksecurityV1::Location]
571
+ #
572
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
573
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
574
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
575
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
576
+ command = make_simple_command(:get, 'v1/{+name}', options)
577
+ command.response_representation = Google::Apis::NetworksecurityV1::Location::Representation
578
+ command.response_class = Google::Apis::NetworksecurityV1::Location
579
+ command.params['name'] = name unless name.nil?
580
+ command.query['fields'] = fields unless fields.nil?
581
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
582
+ execute_or_queue_command(command, &block)
583
+ end
584
+
585
+ # Lists information about the supported locations for this service.
586
+ # @param [String] name
587
+ # The resource that owns the locations collection, if applicable.
588
+ # @param [String] filter
589
+ # A filter to narrow down results to a preferred subset. The filtering language
590
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
591
+ # in [AIP-160](https://google.aip.dev/160).
592
+ # @param [Fixnum] page_size
593
+ # The maximum number of results to return. If not set, the service selects a
594
+ # default.
595
+ # @param [String] page_token
596
+ # A page token received from the `next_page_token` field in the response. Send
597
+ # that page token to receive the subsequent page.
598
+ # @param [String] fields
599
+ # Selector specifying which fields to include in a partial response.
600
+ # @param [String] quota_user
601
+ # Available to use for quota purposes for server-side applications. Can be any
602
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
603
+ # @param [Google::Apis::RequestOptions] options
604
+ # Request-specific options
605
+ #
606
+ # @yield [result, err] Result & error if block supplied
607
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListLocationsResponse] parsed result object
608
+ # @yieldparam err [StandardError] error object if request failed
609
+ #
610
+ # @return [Google::Apis::NetworksecurityV1::ListLocationsResponse]
611
+ #
612
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
613
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
614
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
615
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
616
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
617
+ command.response_representation = Google::Apis::NetworksecurityV1::ListLocationsResponse::Representation
618
+ command.response_class = Google::Apis::NetworksecurityV1::ListLocationsResponse
619
+ command.params['name'] = name unless name.nil?
620
+ command.query['filter'] = filter unless filter.nil?
621
+ command.query['pageSize'] = page_size unless page_size.nil?
622
+ command.query['pageToken'] = page_token unless page_token.nil?
623
+ command.query['fields'] = fields unless fields.nil?
624
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
625
+ execute_or_queue_command(command, &block)
626
+ end
627
+
628
+ # Adds items to an address group.
629
+ # @param [String] address_group
630
+ # Required. A name of the AddressGroup to add items to. Must be in the format `
631
+ # projects|organization/*/locations/`location`/addressGroups/*`.
632
+ # @param [Google::Apis::NetworksecurityV1::AddAddressGroupItemsRequest] add_address_group_items_request_object
633
+ # @param [String] fields
634
+ # Selector specifying which fields to include in a partial response.
635
+ # @param [String] quota_user
636
+ # Available to use for quota purposes for server-side applications. Can be any
637
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
638
+ # @param [Google::Apis::RequestOptions] options
639
+ # Request-specific options
640
+ #
641
+ # @yield [result, err] Result & error if block supplied
642
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
643
+ # @yieldparam err [StandardError] error object if request failed
644
+ #
645
+ # @return [Google::Apis::NetworksecurityV1::Operation]
646
+ #
647
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
648
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
649
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
650
+ def add_project_location_address_group_items(address_group, add_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
651
+ command = make_simple_command(:post, 'v1/{+addressGroup}:addItems', options)
652
+ command.request_representation = Google::Apis::NetworksecurityV1::AddAddressGroupItemsRequest::Representation
653
+ command.request_object = add_address_group_items_request_object
654
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
655
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
656
+ command.params['addressGroup'] = address_group unless address_group.nil?
657
+ command.query['fields'] = fields unless fields.nil?
658
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
659
+ execute_or_queue_command(command, &block)
660
+ end
661
+
662
+ # Clones items from one address group to another.
663
+ # @param [String] address_group
664
+ # Required. A name of the AddressGroup to clone items to. Must be in the format `
665
+ # projects|organization/*/locations/`location`/addressGroups/*`.
666
+ # @param [Google::Apis::NetworksecurityV1::CloneAddressGroupItemsRequest] clone_address_group_items_request_object
667
+ # @param [String] fields
668
+ # Selector specifying which fields to include in a partial response.
669
+ # @param [String] quota_user
670
+ # Available to use for quota purposes for server-side applications. Can be any
671
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
672
+ # @param [Google::Apis::RequestOptions] options
673
+ # Request-specific options
674
+ #
675
+ # @yield [result, err] Result & error if block supplied
676
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
677
+ # @yieldparam err [StandardError] error object if request failed
678
+ #
679
+ # @return [Google::Apis::NetworksecurityV1::Operation]
680
+ #
681
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
682
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
683
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
684
+ def clone_project_location_address_group_items(address_group, clone_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
685
+ command = make_simple_command(:post, 'v1/{+addressGroup}:cloneItems', options)
686
+ command.request_representation = Google::Apis::NetworksecurityV1::CloneAddressGroupItemsRequest::Representation
687
+ command.request_object = clone_address_group_items_request_object
688
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
689
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
690
+ command.params['addressGroup'] = address_group unless address_group.nil?
691
+ command.query['fields'] = fields unless fields.nil?
692
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
693
+ execute_or_queue_command(command, &block)
694
+ end
695
+
696
+ # Creates a new address group in a given project and location.
697
+ # @param [String] parent
698
+ # Required. The parent resource of the AddressGroup. Must be in the format `
699
+ # projects/*/locations/`location``.
700
+ # @param [Google::Apis::NetworksecurityV1::AddressGroup] address_group_object
701
+ # @param [String] address_group_id
702
+ # Required. Short name of the AddressGroup resource to be created. This value
703
+ # should be 1-63 characters long, containing only letters, numbers, hyphens, and
704
+ # underscores, and should not start with a number. E.g. "authz_policy".
705
+ # @param [String] request_id
706
+ # Optional. An optional request ID to identify requests. Specify a unique
707
+ # request ID so that if you must retry your request, the server will know to
708
+ # ignore the request if it has already been completed. The server will guarantee
709
+ # that for at least 60 minutes since the first request. For example, consider a
710
+ # situation where you make an initial request and the request times out. If you
711
+ # make the request again with the same request ID, the server can check if
712
+ # original operation with the same request ID was received, and if so, will
713
+ # ignore the second request. This prevents clients from accidentally creating
714
+ # duplicate commitments. The request ID must be a valid UUID with the exception
715
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
716
+ # @param [String] fields
717
+ # Selector specifying which fields to include in a partial response.
718
+ # @param [String] quota_user
719
+ # Available to use for quota purposes for server-side applications. Can be any
720
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
721
+ # @param [Google::Apis::RequestOptions] options
722
+ # Request-specific options
723
+ #
724
+ # @yield [result, err] Result & error if block supplied
725
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
726
+ # @yieldparam err [StandardError] error object if request failed
727
+ #
728
+ # @return [Google::Apis::NetworksecurityV1::Operation]
729
+ #
730
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
731
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
732
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
733
+ def create_project_location_address_group(parent, address_group_object = nil, address_group_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
734
+ command = make_simple_command(:post, 'v1/{+parent}/addressGroups', options)
735
+ command.request_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
736
+ command.request_object = address_group_object
737
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
738
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
739
+ command.params['parent'] = parent unless parent.nil?
740
+ command.query['addressGroupId'] = address_group_id unless address_group_id.nil?
741
+ command.query['requestId'] = request_id unless request_id.nil?
742
+ command.query['fields'] = fields unless fields.nil?
743
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
744
+ execute_or_queue_command(command, &block)
745
+ end
746
+
747
+ # Deletes a single address group.
748
+ # @param [String] name
749
+ # Required. A name of the AddressGroup to delete. Must be in the format `
750
+ # projects/*/locations/`location`/addressGroups/*`.
751
+ # @param [String] request_id
752
+ # Optional. An optional request ID to identify requests. Specify a unique
753
+ # request ID so that if you must retry your request, the server will know to
754
+ # ignore the request if it has already been completed. The server will guarantee
755
+ # that for at least 60 minutes since the first request. For example, consider a
756
+ # situation where you make an initial request and the request times out. If you
757
+ # make the request again with the same request ID, the server can check if
758
+ # original operation with the same request ID was received, and if so, will
759
+ # ignore the second request. This prevents clients from accidentally creating
760
+ # duplicate commitments. The request ID must be a valid UUID with the exception
761
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
55
762
  # @param [String] fields
56
763
  # Selector specifying which fields to include in a partial response.
57
764
  # @param [String] quota_user
@@ -61,37 +768,111 @@ module Google
61
768
  # Request-specific options
62
769
  #
63
770
  # @yield [result, err] Result & error if block supplied
64
- # @yieldparam result [Google::Apis::NetworksecurityV1::Location] parsed result object
771
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
65
772
  # @yieldparam err [StandardError] error object if request failed
66
773
  #
67
- # @return [Google::Apis::NetworksecurityV1::Location]
774
+ # @return [Google::Apis::NetworksecurityV1::Operation]
68
775
  #
69
776
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
70
777
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
71
778
  # @raise [Google::Apis::AuthorizationError] Authorization is required
72
- def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
73
- command = make_simple_command(:get, 'v1/{+name}', options)
74
- command.response_representation = Google::Apis::NetworksecurityV1::Location::Representation
75
- command.response_class = Google::Apis::NetworksecurityV1::Location
779
+ def delete_project_location_address_group(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
780
+ command = make_simple_command(:delete, 'v1/{+name}', options)
781
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
782
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
76
783
  command.params['name'] = name unless name.nil?
784
+ command.query['requestId'] = request_id unless request_id.nil?
77
785
  command.query['fields'] = fields unless fields.nil?
78
786
  command.query['quotaUser'] = quota_user unless quota_user.nil?
79
787
  execute_or_queue_command(command, &block)
80
788
  end
81
789
 
82
- # Lists information about the supported locations for this service.
790
+ # Gets details of a single address group.
83
791
  # @param [String] name
84
- # The resource that owns the locations collection, if applicable.
85
- # @param [String] filter
86
- # A filter to narrow down results to a preferred subset. The filtering language
87
- # accepts strings like `"displayName=tokyo"`, and is documented in more detail
88
- # in [AIP-160](https://google.aip.dev/160).
792
+ # Required. A name of the AddressGroup to get. Must be in the format `projects/*/
793
+ # locations/`location`/addressGroups/*`.
794
+ # @param [String] fields
795
+ # Selector specifying which fields to include in a partial response.
796
+ # @param [String] quota_user
797
+ # Available to use for quota purposes for server-side applications. Can be any
798
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
799
+ # @param [Google::Apis::RequestOptions] options
800
+ # Request-specific options
801
+ #
802
+ # @yield [result, err] Result & error if block supplied
803
+ # @yieldparam result [Google::Apis::NetworksecurityV1::AddressGroup] parsed result object
804
+ # @yieldparam err [StandardError] error object if request failed
805
+ #
806
+ # @return [Google::Apis::NetworksecurityV1::AddressGroup]
807
+ #
808
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
809
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
810
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
811
+ def get_project_location_address_group(name, fields: nil, quota_user: nil, options: nil, &block)
812
+ command = make_simple_command(:get, 'v1/{+name}', options)
813
+ command.response_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
814
+ command.response_class = Google::Apis::NetworksecurityV1::AddressGroup
815
+ command.params['name'] = name unless name.nil?
816
+ command.query['fields'] = fields unless fields.nil?
817
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
818
+ execute_or_queue_command(command, &block)
819
+ end
820
+
821
+ # Gets the access control policy for a resource. Returns an empty policy if the
822
+ # resource exists and does not have a policy set.
823
+ # @param [String] resource
824
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
825
+ # names](https://cloud.google.com/apis/design/resource_names) for the
826
+ # appropriate value for this field.
827
+ # @param [Fixnum] options_requested_policy_version
828
+ # Optional. The maximum policy version that will be used to format the policy.
829
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
830
+ # rejected. Requests for policies with any conditional role bindings must
831
+ # specify version 3. Policies with no conditional role bindings may specify any
832
+ # valid value or leave the field unset. The policy in the response might use the
833
+ # policy version that you specified, or it might use a lower policy version. For
834
+ # example, if you specify version 3, but the policy has no conditional role
835
+ # bindings, the response uses version 1. To learn which resources support
836
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
837
+ # google.com/iam/help/conditions/resource-policies).
838
+ # @param [String] fields
839
+ # Selector specifying which fields to include in a partial response.
840
+ # @param [String] quota_user
841
+ # Available to use for quota purposes for server-side applications. Can be any
842
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
843
+ # @param [Google::Apis::RequestOptions] options
844
+ # Request-specific options
845
+ #
846
+ # @yield [result, err] Result & error if block supplied
847
+ # @yieldparam result [Google::Apis::NetworksecurityV1::GoogleIamV1Policy] parsed result object
848
+ # @yieldparam err [StandardError] error object if request failed
849
+ #
850
+ # @return [Google::Apis::NetworksecurityV1::GoogleIamV1Policy]
851
+ #
852
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
853
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
854
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
855
+ def get_project_location_address_group_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
856
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
857
+ command.response_representation = Google::Apis::NetworksecurityV1::GoogleIamV1Policy::Representation
858
+ command.response_class = Google::Apis::NetworksecurityV1::GoogleIamV1Policy
859
+ command.params['resource'] = resource unless resource.nil?
860
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
861
+ command.query['fields'] = fields unless fields.nil?
862
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
863
+ execute_or_queue_command(command, &block)
864
+ end
865
+
866
+ # Lists address groups in a given project and location.
867
+ # @param [String] parent
868
+ # Required. The project and location from which the AddressGroups should be
869
+ # listed, specified in the format `projects/*/locations/`location``.
89
870
  # @param [Fixnum] page_size
90
- # The maximum number of results to return. If not set, the service selects a
91
- # default.
871
+ # Maximum number of AddressGroups to return per call.
92
872
  # @param [String] page_token
93
- # A page token received from the `next_page_token` field in the response. Send
94
- # that page token to receive the subsequent page.
873
+ # The value returned by the last `ListAddressGroupsResponse` Indicates that this
874
+ # is a continuation of a prior `ListAddressGroups` call, and that the system
875
+ # should return the next page of data.
95
876
  # @param [String] fields
96
877
  # Selector specifying which fields to include in a partial response.
97
878
  # @param [String] quota_user
@@ -101,20 +882,59 @@ module Google
101
882
  # Request-specific options
102
883
  #
103
884
  # @yield [result, err] Result & error if block supplied
104
- # @yieldparam result [Google::Apis::NetworksecurityV1::ListLocationsResponse] parsed result object
885
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListAddressGroupsResponse] parsed result object
105
886
  # @yieldparam err [StandardError] error object if request failed
106
887
  #
107
- # @return [Google::Apis::NetworksecurityV1::ListLocationsResponse]
888
+ # @return [Google::Apis::NetworksecurityV1::ListAddressGroupsResponse]
108
889
  #
109
890
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
110
891
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
111
892
  # @raise [Google::Apis::AuthorizationError] Authorization is required
112
- def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
113
- command = make_simple_command(:get, 'v1/{+name}/locations', options)
114
- command.response_representation = Google::Apis::NetworksecurityV1::ListLocationsResponse::Representation
115
- command.response_class = Google::Apis::NetworksecurityV1::ListLocationsResponse
116
- command.params['name'] = name unless name.nil?
117
- command.query['filter'] = filter unless filter.nil?
893
+ def list_project_location_address_groups(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
894
+ command = make_simple_command(:get, 'v1/{+parent}/addressGroups', options)
895
+ command.response_representation = Google::Apis::NetworksecurityV1::ListAddressGroupsResponse::Representation
896
+ command.response_class = Google::Apis::NetworksecurityV1::ListAddressGroupsResponse
897
+ command.params['parent'] = parent unless parent.nil?
898
+ command.query['pageSize'] = page_size unless page_size.nil?
899
+ command.query['pageToken'] = page_token unless page_token.nil?
900
+ command.query['fields'] = fields unless fields.nil?
901
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
902
+ execute_or_queue_command(command, &block)
903
+ end
904
+
905
+ # Lists references of an address group.
906
+ # @param [String] address_group
907
+ # Required. A name of the AddressGroup to clone items to. Must be in the format `
908
+ # projects|organization/*/locations/`location`/addressGroups/*`.
909
+ # @param [Fixnum] page_size
910
+ # The maximum number of references to return. If unspecified, server will pick
911
+ # an appropriate default. Server may return fewer items than requested. A caller
912
+ # should only rely on response's next_page_token to determine if there are more
913
+ # AddressGroupUsers left to be queried.
914
+ # @param [String] page_token
915
+ # The next_page_token value returned from a previous List request, if any.
916
+ # @param [String] fields
917
+ # Selector specifying which fields to include in a partial response.
918
+ # @param [String] quota_user
919
+ # Available to use for quota purposes for server-side applications. Can be any
920
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
921
+ # @param [Google::Apis::RequestOptions] options
922
+ # Request-specific options
923
+ #
924
+ # @yield [result, err] Result & error if block supplied
925
+ # @yieldparam result [Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse] parsed result object
926
+ # @yieldparam err [StandardError] error object if request failed
927
+ #
928
+ # @return [Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse]
929
+ #
930
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
931
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
932
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
933
+ def list_project_location_address_group_references(address_group, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
934
+ command = make_simple_command(:get, 'v1/{+addressGroup}:listReferences', options)
935
+ command.response_representation = Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse::Representation
936
+ command.response_class = Google::Apis::NetworksecurityV1::ListAddressGroupReferencesResponse
937
+ command.params['addressGroup'] = address_group unless address_group.nil?
118
938
  command.query['pageSize'] = page_size unless page_size.nil?
119
939
  command.query['pageToken'] = page_token unless page_token.nil?
120
940
  command.query['fields'] = fields unless fields.nil?
@@ -122,6 +942,169 @@ module Google
122
942
  execute_or_queue_command(command, &block)
123
943
  end
124
944
 
945
+ # Updates the parameters of a single address group.
946
+ # @param [String] name
947
+ # Required. Name of the AddressGroup resource. It matches pattern `projects/*/
948
+ # locations/`location`/addressGroups/`.
949
+ # @param [Google::Apis::NetworksecurityV1::AddressGroup] address_group_object
950
+ # @param [String] request_id
951
+ # Optional. An optional request ID to identify requests. Specify a unique
952
+ # request ID so that if you must retry your request, the server will know to
953
+ # ignore the request if it has already been completed. The server will guarantee
954
+ # that for at least 60 minutes since the first request. For example, consider a
955
+ # situation where you make an initial request and the request times out. If you
956
+ # make the request again with the same request ID, the server can check if
957
+ # original operation with the same request ID was received, and if so, will
958
+ # ignore the second request. This prevents clients from accidentally creating
959
+ # duplicate commitments. The request ID must be a valid UUID with the exception
960
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
961
+ # @param [String] update_mask
962
+ # Optional. Field mask is used to specify the fields to be overwritten in the
963
+ # AddressGroup resource by the update. The fields specified in the update_mask
964
+ # are relative to the resource, not the full request. A field will be
965
+ # overwritten if it is in the mask. If the user does not provide a mask then all
966
+ # fields will be overwritten.
967
+ # @param [String] fields
968
+ # Selector specifying which fields to include in a partial response.
969
+ # @param [String] quota_user
970
+ # Available to use for quota purposes for server-side applications. Can be any
971
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
972
+ # @param [Google::Apis::RequestOptions] options
973
+ # Request-specific options
974
+ #
975
+ # @yield [result, err] Result & error if block supplied
976
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
977
+ # @yieldparam err [StandardError] error object if request failed
978
+ #
979
+ # @return [Google::Apis::NetworksecurityV1::Operation]
980
+ #
981
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
982
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
983
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
984
+ def patch_project_location_address_group(name, address_group_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
985
+ command = make_simple_command(:patch, 'v1/{+name}', options)
986
+ command.request_representation = Google::Apis::NetworksecurityV1::AddressGroup::Representation
987
+ command.request_object = address_group_object
988
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
989
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
990
+ command.params['name'] = name unless name.nil?
991
+ command.query['requestId'] = request_id unless request_id.nil?
992
+ command.query['updateMask'] = update_mask unless update_mask.nil?
993
+ command.query['fields'] = fields unless fields.nil?
994
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
995
+ execute_or_queue_command(command, &block)
996
+ end
997
+
998
+ # Removes items from an address group.
999
+ # @param [String] address_group
1000
+ # Required. A name of the AddressGroup to remove items from. Must be in the
1001
+ # format `projects|organization/*/locations/`location`/addressGroups/*`.
1002
+ # @param [Google::Apis::NetworksecurityV1::RemoveAddressGroupItemsRequest] remove_address_group_items_request_object
1003
+ # @param [String] fields
1004
+ # Selector specifying which fields to include in a partial response.
1005
+ # @param [String] quota_user
1006
+ # Available to use for quota purposes for server-side applications. Can be any
1007
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1008
+ # @param [Google::Apis::RequestOptions] options
1009
+ # Request-specific options
1010
+ #
1011
+ # @yield [result, err] Result & error if block supplied
1012
+ # @yieldparam result [Google::Apis::NetworksecurityV1::Operation] parsed result object
1013
+ # @yieldparam err [StandardError] error object if request failed
1014
+ #
1015
+ # @return [Google::Apis::NetworksecurityV1::Operation]
1016
+ #
1017
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1018
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1019
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1020
+ def remove_project_location_address_group_items(address_group, remove_address_group_items_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1021
+ command = make_simple_command(:post, 'v1/{+addressGroup}:removeItems', options)
1022
+ command.request_representation = Google::Apis::NetworksecurityV1::RemoveAddressGroupItemsRequest::Representation
1023
+ command.request_object = remove_address_group_items_request_object
1024
+ command.response_representation = Google::Apis::NetworksecurityV1::Operation::Representation
1025
+ command.response_class = Google::Apis::NetworksecurityV1::Operation
1026
+ command.params['addressGroup'] = address_group unless address_group.nil?
1027
+ command.query['fields'] = fields unless fields.nil?
1028
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1029
+ execute_or_queue_command(command, &block)
1030
+ end
1031
+
1032
+ # Sets the access control policy on the specified resource. Replaces any
1033
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1034
+ # PERMISSION_DENIED` errors.
1035
+ # @param [String] resource
1036
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1037
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1038
+ # appropriate value for this field.
1039
+ # @param [Google::Apis::NetworksecurityV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
1040
+ # @param [String] fields
1041
+ # Selector specifying which fields to include in a partial response.
1042
+ # @param [String] quota_user
1043
+ # Available to use for quota purposes for server-side applications. Can be any
1044
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1045
+ # @param [Google::Apis::RequestOptions] options
1046
+ # Request-specific options
1047
+ #
1048
+ # @yield [result, err] Result & error if block supplied
1049
+ # @yieldparam result [Google::Apis::NetworksecurityV1::GoogleIamV1Policy] parsed result object
1050
+ # @yieldparam err [StandardError] error object if request failed
1051
+ #
1052
+ # @return [Google::Apis::NetworksecurityV1::GoogleIamV1Policy]
1053
+ #
1054
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1055
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1056
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1057
+ def set_project_location_address_group_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1058
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1059
+ command.request_representation = Google::Apis::NetworksecurityV1::GoogleIamV1SetIamPolicyRequest::Representation
1060
+ command.request_object = google_iam_v1_set_iam_policy_request_object
1061
+ command.response_representation = Google::Apis::NetworksecurityV1::GoogleIamV1Policy::Representation
1062
+ command.response_class = Google::Apis::NetworksecurityV1::GoogleIamV1Policy
1063
+ command.params['resource'] = resource unless resource.nil?
1064
+ command.query['fields'] = fields unless fields.nil?
1065
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1066
+ execute_or_queue_command(command, &block)
1067
+ end
1068
+
1069
+ # Returns permissions that a caller has on the specified resource. If the
1070
+ # resource does not exist, this will return an empty set of permissions, not a `
1071
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1072
+ # permission-aware UIs and command-line tools, not for authorization checking.
1073
+ # This operation may "fail open" without warning.
1074
+ # @param [String] resource
1075
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1076
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1077
+ # appropriate value for this field.
1078
+ # @param [Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
1079
+ # @param [String] fields
1080
+ # Selector specifying which fields to include in a partial response.
1081
+ # @param [String] quota_user
1082
+ # Available to use for quota purposes for server-side applications. Can be any
1083
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1084
+ # @param [Google::Apis::RequestOptions] options
1085
+ # Request-specific options
1086
+ #
1087
+ # @yield [result, err] Result & error if block supplied
1088
+ # @yieldparam result [Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsResponse] parsed result object
1089
+ # @yieldparam err [StandardError] error object if request failed
1090
+ #
1091
+ # @return [Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsResponse]
1092
+ #
1093
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1094
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1095
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1096
+ def test_project_location_address_group_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1097
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1098
+ command.request_representation = Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsRequest::Representation
1099
+ command.request_object = google_iam_v1_test_iam_permissions_request_object
1100
+ command.response_representation = Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsResponse::Representation
1101
+ command.response_class = Google::Apis::NetworksecurityV1::GoogleIamV1TestIamPermissionsResponse
1102
+ command.params['resource'] = resource unless resource.nil?
1103
+ command.query['fields'] = fields unless fields.nil?
1104
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1105
+ execute_or_queue_command(command, &block)
1106
+ end
1107
+
125
1108
  # Creates a new AuthorizationPolicy in a given project and location.
126
1109
  # @param [String] parent
127
1110
  # Required. The parent resource of the AuthorizationPolicy. Must be in the