google-cloud-network_services-v1 2.2.0 → 2.3.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.
@@ -246,7 +246,7 @@ module Google
246
246
  #
247
247
  # @param parent [::String]
248
248
  # Required. The project and location from which the `LbTrafficExtension`
249
- # resources are listed, specified in the following format:
249
+ # resources are listed. These values are specified in the following format:
250
250
  # `projects/{project}/locations/{location}`.
251
251
  # @param page_size [::Integer]
252
252
  # Optional. Requested page size. The server might return fewer items than
@@ -256,7 +256,7 @@ module Google
256
256
  # @param filter [::String]
257
257
  # Optional. Filtering results.
258
258
  # @param order_by [::String]
259
- # Optional. Hint for how to order the results.
259
+ # Optional. Hint about how to order the results.
260
260
  # @yield [result, operation] Access the result along with the TransportOperation object
261
261
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::LbTrafficExtension>]
262
262
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -432,12 +432,11 @@ module Google
432
432
  # Optional. An optional request ID to identify requests. Specify a unique
433
433
  # request ID so that if you must retry your request, the server can ignore
434
434
  # the request if it has already been completed. The server guarantees
435
- # that for at least 60 minutes since the first request.
435
+ # that for 60 minutes since the first request.
436
436
  #
437
437
  # For example, consider a situation where you make an initial request and the
438
438
  # request times out. If you make the request again with the same request
439
- # ID, the server can check if original operation with the same request ID
440
- # was received, and if so, ignores the second request. This prevents
439
+ # ID, the server ignores the second request This prevents
441
440
  # clients from accidentally creating duplicate commitments.
442
441
  #
443
442
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -530,7 +529,7 @@ module Google
530
529
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
531
530
  # Optional. Used to specify the fields to be overwritten in the
532
531
  # `LbTrafficExtension` resource by the update.
533
- # The fields specified in the update_mask are relative to the resource, not
532
+ # The fields specified in the `update_mask` are relative to the resource, not
534
533
  # the full request. A field is overwritten if it is in the mask. If the
535
534
  # user does not specify a mask, then all fields are overwritten.
536
535
  # @param lb_traffic_extension [::Google::Cloud::NetworkServices::V1::LbTrafficExtension, ::Hash]
@@ -539,12 +538,11 @@ module Google
539
538
  # Optional. An optional request ID to identify requests. Specify a unique
540
539
  # request ID so that if you must retry your request, the server can ignore
541
540
  # the request if it has already been completed. The server guarantees
542
- # that for at least 60 minutes since the first request.
541
+ # that for 60 minutes since the first request.
543
542
  #
544
543
  # For example, consider a situation where you make an initial request and the
545
544
  # request times out. If you make the request again with the same request
546
- # ID, the server can check if original operation with the same request ID
547
- # was received, and if so, ignores the second request. This prevents
545
+ # ID, the server ignores the second request This prevents
548
546
  # clients from accidentally creating duplicate commitments.
549
547
  #
550
548
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -642,12 +640,11 @@ module Google
642
640
  # Optional. An optional request ID to identify requests. Specify a unique
643
641
  # request ID so that if you must retry your request, the server can ignore
644
642
  # the request if it has already been completed. The server guarantees
645
- # that for at least 60 minutes after the first request.
643
+ # that for 60 minutes after the first request.
646
644
  #
647
645
  # For example, consider a situation where you make an initial request and the
648
646
  # request times out. If you make the request again with the same request
649
- # ID, the server can check if original operation with the same request ID
650
- # was received, and if so, ignores the second request. This prevents
647
+ # ID, the server ignores the second request This prevents
651
648
  # clients from accidentally creating duplicate commitments.
652
649
  #
653
650
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -739,7 +736,7 @@ module Google
739
736
  #
740
737
  # @param parent [::String]
741
738
  # Required. The project and location from which the `LbRouteExtension`
742
- # resources are listed, specified in the following format:
739
+ # resources are listed. These values are specified in the following format:
743
740
  # `projects/{project}/locations/{location}`.
744
741
  # @param page_size [::Integer]
745
742
  # Optional. Requested page size. The server might return fewer items than
@@ -749,7 +746,7 @@ module Google
749
746
  # @param filter [::String]
750
747
  # Optional. Filtering results.
751
748
  # @param order_by [::String]
752
- # Optional. Hint for how to order the results.
749
+ # Optional. Hint about how to order the results.
753
750
  # @yield [result, operation] Access the result along with the TransportOperation object
754
751
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::LbRouteExtension>]
755
752
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -924,12 +921,11 @@ module Google
924
921
  # Optional. An optional request ID to identify requests. Specify a unique
925
922
  # request ID so that if you must retry your request, the server can ignore
926
923
  # the request if it has already been completed. The server guarantees
927
- # that for at least 60 minutes since the first request.
924
+ # that for 60 minutes since the first request.
928
925
  #
929
926
  # For example, consider a situation where you make an initial request and the
930
927
  # request times out. If you make the request again with the same request
931
- # ID, the server can check if original operation with the same request ID
932
- # was received, and if so, ignores the second request. This prevents
928
+ # ID, the server ignores the second request This prevents
933
929
  # clients from accidentally creating duplicate commitments.
934
930
  #
935
931
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1022,7 +1018,7 @@ module Google
1022
1018
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1023
1019
  # Optional. Used to specify the fields to be overwritten in the
1024
1020
  # `LbRouteExtension` resource by the update.
1025
- # The fields specified in the update_mask are relative to the resource, not
1021
+ # The fields specified in the `update_mask` are relative to the resource, not
1026
1022
  # the full request. A field is overwritten if it is in the mask. If the
1027
1023
  # user does not specify a mask, then all fields are overwritten.
1028
1024
  # @param lb_route_extension [::Google::Cloud::NetworkServices::V1::LbRouteExtension, ::Hash]
@@ -1031,12 +1027,11 @@ module Google
1031
1027
  # Optional. An optional request ID to identify requests. Specify a unique
1032
1028
  # request ID so that if you must retry your request, the server can ignore
1033
1029
  # the request if it has already been completed. The server guarantees
1034
- # that for at least 60 minutes since the first request.
1030
+ # that for 60 minutes since the first request.
1035
1031
  #
1036
1032
  # For example, consider a situation where you make an initial request and the
1037
1033
  # request times out. If you make the request again with the same request
1038
- # ID, the server can check if original operation with the same request ID
1039
- # was received, and if so, ignores the second request. This prevents
1034
+ # ID, the server ignores the second request This prevents
1040
1035
  # clients from accidentally creating duplicate commitments.
1041
1036
  #
1042
1037
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1134,12 +1129,11 @@ module Google
1134
1129
  # Optional. An optional request ID to identify requests. Specify a unique
1135
1130
  # request ID so that if you must retry your request, the server can ignore
1136
1131
  # the request if it has already been completed. The server guarantees
1137
- # that for at least 60 minutes after the first request.
1132
+ # that for 60 minutes after the first request.
1138
1133
  #
1139
1134
  # For example, consider a situation where you make an initial request and the
1140
1135
  # request times out. If you make the request again with the same request
1141
- # ID, the server can check if original operation with the same request ID
1142
- # was received, and if so, ignores the second request. This prevents
1136
+ # ID, the server ignores the second request This prevents
1143
1137
  # clients from accidentally creating duplicate commitments.
1144
1138
  #
1145
1139
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1211,6 +1205,497 @@ module Google
1211
1205
  raise ::Google::Cloud::Error.from_error(e)
1212
1206
  end
1213
1207
 
1208
+ ##
1209
+ # Lists `AuthzExtension` resources in a given project and location.
1210
+ #
1211
+ # @overload list_authz_extensions(request, options = nil)
1212
+ # Pass arguments to `list_authz_extensions` via a request object, either of type
1213
+ # {::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest} or an equivalent Hash.
1214
+ #
1215
+ # @param request [::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest, ::Hash]
1216
+ # A request object representing the call parameters. Required. To specify no
1217
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1218
+ # @param options [::Gapic::CallOptions, ::Hash]
1219
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1220
+ #
1221
+ # @overload list_authz_extensions(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1222
+ # Pass arguments to `list_authz_extensions` via keyword arguments. Note that at
1223
+ # least one keyword argument is required. To specify no parameters, or to keep all
1224
+ # the default parameter values, pass an empty Hash as a request object (see above).
1225
+ #
1226
+ # @param parent [::String]
1227
+ # Required. The project and location from which the `AuthzExtension`
1228
+ # resources are listed. These values are specified in the following format:
1229
+ # `projects/{project}/locations/{location}`.
1230
+ # @param page_size [::Integer]
1231
+ # Optional. Requested page size. The server might return fewer items than
1232
+ # requested. If unspecified, the server picks an appropriate default.
1233
+ # @param page_token [::String]
1234
+ # Optional. A token identifying a page of results that the server returns.
1235
+ # @param filter [::String]
1236
+ # Optional. Filtering results.
1237
+ # @param order_by [::String]
1238
+ # Optional. Hint about how to order the results.
1239
+ # @yield [result, operation] Access the result along with the TransportOperation object
1240
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AuthzExtension>]
1241
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1242
+ #
1243
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AuthzExtension>]
1244
+ #
1245
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1246
+ #
1247
+ # @example Basic example
1248
+ # require "google/cloud/network_services/v1"
1249
+ #
1250
+ # # Create a client object. The client can be reused for multiple calls.
1251
+ # client = Google::Cloud::NetworkServices::V1::DepService::Rest::Client.new
1252
+ #
1253
+ # # Create a request. To set request fields, pass in keyword arguments.
1254
+ # request = Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest.new
1255
+ #
1256
+ # # Call the list_authz_extensions method.
1257
+ # result = client.list_authz_extensions request
1258
+ #
1259
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1260
+ # # over elements, and API calls will be issued to fetch pages as needed.
1261
+ # result.each do |item|
1262
+ # # Each element is of type ::Google::Cloud::NetworkServices::V1::AuthzExtension.
1263
+ # p item
1264
+ # end
1265
+ #
1266
+ def list_authz_extensions request, options = nil
1267
+ raise ::ArgumentError, "request must be provided" if request.nil?
1268
+
1269
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest
1270
+
1271
+ # Converts hash and nil to an options object
1272
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1273
+
1274
+ # Customize the options with defaults
1275
+ call_metadata = @config.rpcs.list_authz_extensions.metadata.to_h
1276
+
1277
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1278
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1279
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1280
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
1281
+ transports_version_send: [:rest]
1282
+
1283
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1284
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1285
+
1286
+ options.apply_defaults timeout: @config.rpcs.list_authz_extensions.timeout,
1287
+ metadata: call_metadata,
1288
+ retry_policy: @config.rpcs.list_authz_extensions.retry_policy
1289
+
1290
+ options.apply_defaults timeout: @config.timeout,
1291
+ metadata: @config.metadata,
1292
+ retry_policy: @config.retry_policy
1293
+
1294
+ @dep_service_stub.list_authz_extensions request, options do |result, operation|
1295
+ result = ::Gapic::Rest::PagedEnumerable.new @dep_service_stub, :list_authz_extensions, "authz_extensions", request, result, options
1296
+ yield result, operation if block_given?
1297
+ throw :response, result
1298
+ end
1299
+ rescue ::Gapic::Rest::Error => e
1300
+ raise ::Google::Cloud::Error.from_error(e)
1301
+ end
1302
+
1303
+ ##
1304
+ # Gets details of the specified `AuthzExtension` resource.
1305
+ #
1306
+ # @overload get_authz_extension(request, options = nil)
1307
+ # Pass arguments to `get_authz_extension` via a request object, either of type
1308
+ # {::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest} or an equivalent Hash.
1309
+ #
1310
+ # @param request [::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest, ::Hash]
1311
+ # A request object representing the call parameters. Required. To specify no
1312
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1313
+ # @param options [::Gapic::CallOptions, ::Hash]
1314
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1315
+ #
1316
+ # @overload get_authz_extension(name: nil)
1317
+ # Pass arguments to `get_authz_extension` via keyword arguments. Note that at
1318
+ # least one keyword argument is required. To specify no parameters, or to keep all
1319
+ # the default parameter values, pass an empty Hash as a request object (see above).
1320
+ #
1321
+ # @param name [::String]
1322
+ # Required. A name of the `AuthzExtension` resource to get. Must be in
1323
+ # the format
1324
+ # `projects/{project}/locations/{location}/authzExtensions/{authz_extension}`.
1325
+ # @yield [result, operation] Access the result along with the TransportOperation object
1326
+ # @yieldparam result [::Google::Cloud::NetworkServices::V1::AuthzExtension]
1327
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1328
+ #
1329
+ # @return [::Google::Cloud::NetworkServices::V1::AuthzExtension]
1330
+ #
1331
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1332
+ #
1333
+ # @example Basic example
1334
+ # require "google/cloud/network_services/v1"
1335
+ #
1336
+ # # Create a client object. The client can be reused for multiple calls.
1337
+ # client = Google::Cloud::NetworkServices::V1::DepService::Rest::Client.new
1338
+ #
1339
+ # # Create a request. To set request fields, pass in keyword arguments.
1340
+ # request = Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest.new
1341
+ #
1342
+ # # Call the get_authz_extension method.
1343
+ # result = client.get_authz_extension request
1344
+ #
1345
+ # # The returned object is of type Google::Cloud::NetworkServices::V1::AuthzExtension.
1346
+ # p result
1347
+ #
1348
+ def get_authz_extension request, options = nil
1349
+ raise ::ArgumentError, "request must be provided" if request.nil?
1350
+
1351
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest
1352
+
1353
+ # Converts hash and nil to an options object
1354
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1355
+
1356
+ # Customize the options with defaults
1357
+ call_metadata = @config.rpcs.get_authz_extension.metadata.to_h
1358
+
1359
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1360
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1361
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1362
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
1363
+ transports_version_send: [:rest]
1364
+
1365
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1366
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1367
+
1368
+ options.apply_defaults timeout: @config.rpcs.get_authz_extension.timeout,
1369
+ metadata: call_metadata,
1370
+ retry_policy: @config.rpcs.get_authz_extension.retry_policy
1371
+
1372
+ options.apply_defaults timeout: @config.timeout,
1373
+ metadata: @config.metadata,
1374
+ retry_policy: @config.retry_policy
1375
+
1376
+ @dep_service_stub.get_authz_extension request, options do |result, operation|
1377
+ yield result, operation if block_given?
1378
+ end
1379
+ rescue ::Gapic::Rest::Error => e
1380
+ raise ::Google::Cloud::Error.from_error(e)
1381
+ end
1382
+
1383
+ ##
1384
+ # Creates a new `AuthzExtension` resource in a given project
1385
+ # and location.
1386
+ #
1387
+ # @overload create_authz_extension(request, options = nil)
1388
+ # Pass arguments to `create_authz_extension` via a request object, either of type
1389
+ # {::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest} or an equivalent Hash.
1390
+ #
1391
+ # @param request [::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest, ::Hash]
1392
+ # A request object representing the call parameters. Required. To specify no
1393
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1394
+ # @param options [::Gapic::CallOptions, ::Hash]
1395
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1396
+ #
1397
+ # @overload create_authz_extension(parent: nil, authz_extension_id: nil, authz_extension: nil, request_id: nil)
1398
+ # Pass arguments to `create_authz_extension` via keyword arguments. Note that at
1399
+ # least one keyword argument is required. To specify no parameters, or to keep all
1400
+ # the default parameter values, pass an empty Hash as a request object (see above).
1401
+ #
1402
+ # @param parent [::String]
1403
+ # Required. The parent resource of the `AuthzExtension` resource. Must
1404
+ # be in the format `projects/{project}/locations/{location}`.
1405
+ # @param authz_extension_id [::String]
1406
+ # Required. User-provided ID of the `AuthzExtension` resource to be
1407
+ # created.
1408
+ # @param authz_extension [::Google::Cloud::NetworkServices::V1::AuthzExtension, ::Hash]
1409
+ # Required. `AuthzExtension` resource to be created.
1410
+ # @param request_id [::String]
1411
+ # Optional. An optional request ID to identify requests. Specify a unique
1412
+ # request ID so that if you must retry your request, the server can ignore
1413
+ # the request if it has already been completed. The server guarantees
1414
+ # that for 60 minutes since the first request.
1415
+ #
1416
+ # For example, consider a situation where you make an initial request and the
1417
+ # request times out. If you make the request again with the same request
1418
+ # ID, the server ignores the second request This prevents
1419
+ # clients from accidentally creating duplicate commitments.
1420
+ #
1421
+ # The request ID must be a valid UUID with the exception that zero UUID is
1422
+ # not supported (00000000-0000-0000-0000-000000000000).
1423
+ # @yield [result, operation] Access the result along with the TransportOperation object
1424
+ # @yieldparam result [::Gapic::Operation]
1425
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1426
+ #
1427
+ # @return [::Gapic::Operation]
1428
+ #
1429
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1430
+ #
1431
+ # @example Basic example
1432
+ # require "google/cloud/network_services/v1"
1433
+ #
1434
+ # # Create a client object. The client can be reused for multiple calls.
1435
+ # client = Google::Cloud::NetworkServices::V1::DepService::Rest::Client.new
1436
+ #
1437
+ # # Create a request. To set request fields, pass in keyword arguments.
1438
+ # request = Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest.new
1439
+ #
1440
+ # # Call the create_authz_extension method.
1441
+ # result = client.create_authz_extension request
1442
+ #
1443
+ # # The returned object is of type Gapic::Operation. You can use it to
1444
+ # # check the status of an operation, cancel it, or wait for results.
1445
+ # # Here is how to wait for a response.
1446
+ # result.wait_until_done! timeout: 60
1447
+ # if result.response?
1448
+ # p result.response
1449
+ # else
1450
+ # puts "No response received."
1451
+ # end
1452
+ #
1453
+ def create_authz_extension request, options = nil
1454
+ raise ::ArgumentError, "request must be provided" if request.nil?
1455
+
1456
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest
1457
+
1458
+ # Converts hash and nil to an options object
1459
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1460
+
1461
+ # Customize the options with defaults
1462
+ call_metadata = @config.rpcs.create_authz_extension.metadata.to_h
1463
+
1464
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1465
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1466
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1467
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
1468
+ transports_version_send: [:rest]
1469
+
1470
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1471
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1472
+
1473
+ options.apply_defaults timeout: @config.rpcs.create_authz_extension.timeout,
1474
+ metadata: call_metadata,
1475
+ retry_policy: @config.rpcs.create_authz_extension.retry_policy
1476
+
1477
+ options.apply_defaults timeout: @config.timeout,
1478
+ metadata: @config.metadata,
1479
+ retry_policy: @config.retry_policy
1480
+
1481
+ @dep_service_stub.create_authz_extension request, options do |result, operation|
1482
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1483
+ yield result, operation if block_given?
1484
+ throw :response, result
1485
+ end
1486
+ rescue ::Gapic::Rest::Error => e
1487
+ raise ::Google::Cloud::Error.from_error(e)
1488
+ end
1489
+
1490
+ ##
1491
+ # Updates the parameters of the specified `AuthzExtension`
1492
+ # resource.
1493
+ #
1494
+ # @overload update_authz_extension(request, options = nil)
1495
+ # Pass arguments to `update_authz_extension` via a request object, either of type
1496
+ # {::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest} or an equivalent Hash.
1497
+ #
1498
+ # @param request [::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest, ::Hash]
1499
+ # A request object representing the call parameters. Required. To specify no
1500
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1501
+ # @param options [::Gapic::CallOptions, ::Hash]
1502
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1503
+ #
1504
+ # @overload update_authz_extension(update_mask: nil, authz_extension: nil, request_id: nil)
1505
+ # Pass arguments to `update_authz_extension` via keyword arguments. Note that at
1506
+ # least one keyword argument is required. To specify no parameters, or to keep all
1507
+ # the default parameter values, pass an empty Hash as a request object (see above).
1508
+ #
1509
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1510
+ # Required. Used to specify the fields to be overwritten in the
1511
+ # `AuthzExtension` resource by the update.
1512
+ # The fields specified in the `update_mask` are relative to the resource, not
1513
+ # the full request. A field is overwritten if it is in the mask. If the
1514
+ # user does not specify a mask, then all fields are overwritten.
1515
+ # @param authz_extension [::Google::Cloud::NetworkServices::V1::AuthzExtension, ::Hash]
1516
+ # Required. `AuthzExtension` resource being updated.
1517
+ # @param request_id [::String]
1518
+ # Optional. An optional request ID to identify requests. Specify a unique
1519
+ # request ID so that if you must retry your request, the server can ignore
1520
+ # the request if it has already been completed. The server guarantees
1521
+ # that for 60 minutes since the first request.
1522
+ #
1523
+ # For example, consider a situation where you make an initial request and the
1524
+ # request times out. If you make the request again with the same request
1525
+ # ID, the server ignores the second request This prevents
1526
+ # clients from accidentally creating duplicate commitments.
1527
+ #
1528
+ # The request ID must be a valid UUID with the exception that zero UUID is
1529
+ # not supported (00000000-0000-0000-0000-000000000000).
1530
+ # @yield [result, operation] Access the result along with the TransportOperation object
1531
+ # @yieldparam result [::Gapic::Operation]
1532
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1533
+ #
1534
+ # @return [::Gapic::Operation]
1535
+ #
1536
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1537
+ #
1538
+ # @example Basic example
1539
+ # require "google/cloud/network_services/v1"
1540
+ #
1541
+ # # Create a client object. The client can be reused for multiple calls.
1542
+ # client = Google::Cloud::NetworkServices::V1::DepService::Rest::Client.new
1543
+ #
1544
+ # # Create a request. To set request fields, pass in keyword arguments.
1545
+ # request = Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest.new
1546
+ #
1547
+ # # Call the update_authz_extension method.
1548
+ # result = client.update_authz_extension request
1549
+ #
1550
+ # # The returned object is of type Gapic::Operation. You can use it to
1551
+ # # check the status of an operation, cancel it, or wait for results.
1552
+ # # Here is how to wait for a response.
1553
+ # result.wait_until_done! timeout: 60
1554
+ # if result.response?
1555
+ # p result.response
1556
+ # else
1557
+ # puts "No response received."
1558
+ # end
1559
+ #
1560
+ def update_authz_extension request, options = nil
1561
+ raise ::ArgumentError, "request must be provided" if request.nil?
1562
+
1563
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest
1564
+
1565
+ # Converts hash and nil to an options object
1566
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1567
+
1568
+ # Customize the options with defaults
1569
+ call_metadata = @config.rpcs.update_authz_extension.metadata.to_h
1570
+
1571
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1572
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1573
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1574
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
1575
+ transports_version_send: [:rest]
1576
+
1577
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1578
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1579
+
1580
+ options.apply_defaults timeout: @config.rpcs.update_authz_extension.timeout,
1581
+ metadata: call_metadata,
1582
+ retry_policy: @config.rpcs.update_authz_extension.retry_policy
1583
+
1584
+ options.apply_defaults timeout: @config.timeout,
1585
+ metadata: @config.metadata,
1586
+ retry_policy: @config.retry_policy
1587
+
1588
+ @dep_service_stub.update_authz_extension request, options do |result, operation|
1589
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1590
+ yield result, operation if block_given?
1591
+ throw :response, result
1592
+ end
1593
+ rescue ::Gapic::Rest::Error => e
1594
+ raise ::Google::Cloud::Error.from_error(e)
1595
+ end
1596
+
1597
+ ##
1598
+ # Deletes the specified `AuthzExtension` resource.
1599
+ #
1600
+ # @overload delete_authz_extension(request, options = nil)
1601
+ # Pass arguments to `delete_authz_extension` via a request object, either of type
1602
+ # {::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest} or an equivalent Hash.
1603
+ #
1604
+ # @param request [::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest, ::Hash]
1605
+ # A request object representing the call parameters. Required. To specify no
1606
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1607
+ # @param options [::Gapic::CallOptions, ::Hash]
1608
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1609
+ #
1610
+ # @overload delete_authz_extension(name: nil, request_id: nil)
1611
+ # Pass arguments to `delete_authz_extension` via keyword arguments. Note that at
1612
+ # least one keyword argument is required. To specify no parameters, or to keep all
1613
+ # the default parameter values, pass an empty Hash as a request object (see above).
1614
+ #
1615
+ # @param name [::String]
1616
+ # Required. The name of the `AuthzExtension` resource to delete. Must
1617
+ # be in the format
1618
+ # `projects/{project}/locations/{location}/authzExtensions/{authz_extension}`.
1619
+ # @param request_id [::String]
1620
+ # Optional. An optional request ID to identify requests. Specify a unique
1621
+ # request ID so that if you must retry your request, the server can ignore
1622
+ # the request if it has already been completed. The server guarantees
1623
+ # that for 60 minutes after the first request.
1624
+ #
1625
+ # For example, consider a situation where you make an initial request and the
1626
+ # request times out. If you make the request again with the same request
1627
+ # ID, the server ignores the second request This prevents
1628
+ # clients from accidentally creating duplicate commitments.
1629
+ #
1630
+ # The request ID must be a valid UUID with the exception that zero UUID is
1631
+ # not supported (00000000-0000-0000-0000-000000000000).
1632
+ # @yield [result, operation] Access the result along with the TransportOperation object
1633
+ # @yieldparam result [::Gapic::Operation]
1634
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1635
+ #
1636
+ # @return [::Gapic::Operation]
1637
+ #
1638
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1639
+ #
1640
+ # @example Basic example
1641
+ # require "google/cloud/network_services/v1"
1642
+ #
1643
+ # # Create a client object. The client can be reused for multiple calls.
1644
+ # client = Google::Cloud::NetworkServices::V1::DepService::Rest::Client.new
1645
+ #
1646
+ # # Create a request. To set request fields, pass in keyword arguments.
1647
+ # request = Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest.new
1648
+ #
1649
+ # # Call the delete_authz_extension method.
1650
+ # result = client.delete_authz_extension request
1651
+ #
1652
+ # # The returned object is of type Gapic::Operation. You can use it to
1653
+ # # check the status of an operation, cancel it, or wait for results.
1654
+ # # Here is how to wait for a response.
1655
+ # result.wait_until_done! timeout: 60
1656
+ # if result.response?
1657
+ # p result.response
1658
+ # else
1659
+ # puts "No response received."
1660
+ # end
1661
+ #
1662
+ def delete_authz_extension request, options = nil
1663
+ raise ::ArgumentError, "request must be provided" if request.nil?
1664
+
1665
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest
1666
+
1667
+ # Converts hash and nil to an options object
1668
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1669
+
1670
+ # Customize the options with defaults
1671
+ call_metadata = @config.rpcs.delete_authz_extension.metadata.to_h
1672
+
1673
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1674
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1675
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1676
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
1677
+ transports_version_send: [:rest]
1678
+
1679
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1680
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1681
+
1682
+ options.apply_defaults timeout: @config.rpcs.delete_authz_extension.timeout,
1683
+ metadata: call_metadata,
1684
+ retry_policy: @config.rpcs.delete_authz_extension.retry_policy
1685
+
1686
+ options.apply_defaults timeout: @config.timeout,
1687
+ metadata: @config.metadata,
1688
+ retry_policy: @config.retry_policy
1689
+
1690
+ @dep_service_stub.delete_authz_extension request, options do |result, operation|
1691
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1692
+ yield result, operation if block_given?
1693
+ throw :response, result
1694
+ end
1695
+ rescue ::Gapic::Rest::Error => e
1696
+ raise ::Google::Cloud::Error.from_error(e)
1697
+ end
1698
+
1214
1699
  ##
1215
1700
  # Configuration class for the DepService REST API.
1216
1701
  #
@@ -1414,6 +1899,31 @@ module Google
1414
1899
  # @return [::Gapic::Config::Method]
1415
1900
  #
1416
1901
  attr_reader :delete_lb_route_extension
1902
+ ##
1903
+ # RPC-specific configuration for `list_authz_extensions`
1904
+ # @return [::Gapic::Config::Method]
1905
+ #
1906
+ attr_reader :list_authz_extensions
1907
+ ##
1908
+ # RPC-specific configuration for `get_authz_extension`
1909
+ # @return [::Gapic::Config::Method]
1910
+ #
1911
+ attr_reader :get_authz_extension
1912
+ ##
1913
+ # RPC-specific configuration for `create_authz_extension`
1914
+ # @return [::Gapic::Config::Method]
1915
+ #
1916
+ attr_reader :create_authz_extension
1917
+ ##
1918
+ # RPC-specific configuration for `update_authz_extension`
1919
+ # @return [::Gapic::Config::Method]
1920
+ #
1921
+ attr_reader :update_authz_extension
1922
+ ##
1923
+ # RPC-specific configuration for `delete_authz_extension`
1924
+ # @return [::Gapic::Config::Method]
1925
+ #
1926
+ attr_reader :delete_authz_extension
1417
1927
 
1418
1928
  # @private
1419
1929
  def initialize parent_rpcs = nil
@@ -1437,6 +1947,16 @@ module Google
1437
1947
  @update_lb_route_extension = ::Gapic::Config::Method.new update_lb_route_extension_config
1438
1948
  delete_lb_route_extension_config = parent_rpcs.delete_lb_route_extension if parent_rpcs.respond_to? :delete_lb_route_extension
1439
1949
  @delete_lb_route_extension = ::Gapic::Config::Method.new delete_lb_route_extension_config
1950
+ list_authz_extensions_config = parent_rpcs.list_authz_extensions if parent_rpcs.respond_to? :list_authz_extensions
1951
+ @list_authz_extensions = ::Gapic::Config::Method.new list_authz_extensions_config
1952
+ get_authz_extension_config = parent_rpcs.get_authz_extension if parent_rpcs.respond_to? :get_authz_extension
1953
+ @get_authz_extension = ::Gapic::Config::Method.new get_authz_extension_config
1954
+ create_authz_extension_config = parent_rpcs.create_authz_extension if parent_rpcs.respond_to? :create_authz_extension
1955
+ @create_authz_extension = ::Gapic::Config::Method.new create_authz_extension_config
1956
+ update_authz_extension_config = parent_rpcs.update_authz_extension if parent_rpcs.respond_to? :update_authz_extension
1957
+ @update_authz_extension = ::Gapic::Config::Method.new update_authz_extension_config
1958
+ delete_authz_extension_config = parent_rpcs.delete_authz_extension if parent_rpcs.respond_to? :delete_authz_extension
1959
+ @delete_authz_extension = ::Gapic::Config::Method.new delete_authz_extension_config
1440
1960
 
1441
1961
  yield self if block_given?
1442
1962
  end