google-apis-networksecurity_v1 0.19.0 → 0.20.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.
@@ -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