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.
@@ -251,7 +251,7 @@ module Google
251
251
  #
252
252
  # @param parent [::String]
253
253
  # Required. The project and location from which the `LbTrafficExtension`
254
- # resources are listed, specified in the following format:
254
+ # resources are listed. These values are specified in the following format:
255
255
  # `projects/{project}/locations/{location}`.
256
256
  # @param page_size [::Integer]
257
257
  # Optional. Requested page size. The server might return fewer items than
@@ -261,7 +261,7 @@ module Google
261
261
  # @param filter [::String]
262
262
  # Optional. Filtering results.
263
263
  # @param order_by [::String]
264
- # Optional. Hint for how to order the results.
264
+ # Optional. Hint about how to order the results.
265
265
  #
266
266
  # @yield [response, operation] Access the result along with the RPC operation
267
267
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::LbTrafficExtension>]
@@ -451,12 +451,11 @@ module Google
451
451
  # Optional. An optional request ID to identify requests. Specify a unique
452
452
  # request ID so that if you must retry your request, the server can ignore
453
453
  # the request if it has already been completed. The server guarantees
454
- # that for at least 60 minutes since the first request.
454
+ # that for 60 minutes since the first request.
455
455
  #
456
456
  # For example, consider a situation where you make an initial request and the
457
457
  # request times out. If you make the request again with the same request
458
- # ID, the server can check if original operation with the same request ID
459
- # was received, and if so, ignores the second request. This prevents
458
+ # ID, the server ignores the second request This prevents
460
459
  # clients from accidentally creating duplicate commitments.
461
460
  #
462
461
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -556,7 +555,7 @@ module Google
556
555
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
557
556
  # Optional. Used to specify the fields to be overwritten in the
558
557
  # `LbTrafficExtension` resource by the update.
559
- # The fields specified in the update_mask are relative to the resource, not
558
+ # The fields specified in the `update_mask` are relative to the resource, not
560
559
  # the full request. A field is overwritten if it is in the mask. If the
561
560
  # user does not specify a mask, then all fields are overwritten.
562
561
  # @param lb_traffic_extension [::Google::Cloud::NetworkServices::V1::LbTrafficExtension, ::Hash]
@@ -565,12 +564,11 @@ module Google
565
564
  # Optional. An optional request ID to identify requests. Specify a unique
566
565
  # request ID so that if you must retry your request, the server can ignore
567
566
  # the request if it has already been completed. The server guarantees
568
- # that for at least 60 minutes since the first request.
567
+ # that for 60 minutes since the first request.
569
568
  #
570
569
  # For example, consider a situation where you make an initial request and the
571
570
  # request times out. If you make the request again with the same request
572
- # ID, the server can check if original operation with the same request ID
573
- # was received, and if so, ignores the second request. This prevents
571
+ # ID, the server ignores the second request This prevents
574
572
  # clients from accidentally creating duplicate commitments.
575
573
  #
576
574
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -675,12 +673,11 @@ module Google
675
673
  # Optional. An optional request ID to identify requests. Specify a unique
676
674
  # request ID so that if you must retry your request, the server can ignore
677
675
  # the request if it has already been completed. The server guarantees
678
- # that for at least 60 minutes after the first request.
676
+ # that for 60 minutes after the first request.
679
677
  #
680
678
  # For example, consider a situation where you make an initial request and the
681
679
  # request times out. If you make the request again with the same request
682
- # ID, the server can check if original operation with the same request ID
683
- # was received, and if so, ignores the second request. This prevents
680
+ # ID, the server ignores the second request This prevents
684
681
  # clients from accidentally creating duplicate commitments.
685
682
  #
686
683
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -779,7 +776,7 @@ module Google
779
776
  #
780
777
  # @param parent [::String]
781
778
  # Required. The project and location from which the `LbRouteExtension`
782
- # resources are listed, specified in the following format:
779
+ # resources are listed. These values are specified in the following format:
783
780
  # `projects/{project}/locations/{location}`.
784
781
  # @param page_size [::Integer]
785
782
  # Optional. Requested page size. The server might return fewer items than
@@ -789,7 +786,7 @@ module Google
789
786
  # @param filter [::String]
790
787
  # Optional. Filtering results.
791
788
  # @param order_by [::String]
792
- # Optional. Hint for how to order the results.
789
+ # Optional. Hint about how to order the results.
793
790
  #
794
791
  # @yield [response, operation] Access the result along with the RPC operation
795
792
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::LbRouteExtension>]
@@ -978,12 +975,11 @@ module Google
978
975
  # Optional. An optional request ID to identify requests. Specify a unique
979
976
  # request ID so that if you must retry your request, the server can ignore
980
977
  # the request if it has already been completed. The server guarantees
981
- # that for at least 60 minutes since the first request.
978
+ # that for 60 minutes since the first request.
982
979
  #
983
980
  # For example, consider a situation where you make an initial request and the
984
981
  # request times out. If you make the request again with the same request
985
- # ID, the server can check if original operation with the same request ID
986
- # was received, and if so, ignores the second request. This prevents
982
+ # ID, the server ignores the second request This prevents
987
983
  # clients from accidentally creating duplicate commitments.
988
984
  #
989
985
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1083,7 +1079,7 @@ module Google
1083
1079
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1084
1080
  # Optional. Used to specify the fields to be overwritten in the
1085
1081
  # `LbRouteExtension` resource by the update.
1086
- # The fields specified in the update_mask are relative to the resource, not
1082
+ # The fields specified in the `update_mask` are relative to the resource, not
1087
1083
  # the full request. A field is overwritten if it is in the mask. If the
1088
1084
  # user does not specify a mask, then all fields are overwritten.
1089
1085
  # @param lb_route_extension [::Google::Cloud::NetworkServices::V1::LbRouteExtension, ::Hash]
@@ -1092,12 +1088,11 @@ module Google
1092
1088
  # Optional. An optional request ID to identify requests. Specify a unique
1093
1089
  # request ID so that if you must retry your request, the server can ignore
1094
1090
  # the request if it has already been completed. The server guarantees
1095
- # that for at least 60 minutes since the first request.
1091
+ # that for 60 minutes since the first request.
1096
1092
  #
1097
1093
  # For example, consider a situation where you make an initial request and the
1098
1094
  # request times out. If you make the request again with the same request
1099
- # ID, the server can check if original operation with the same request ID
1100
- # was received, and if so, ignores the second request. This prevents
1095
+ # ID, the server ignores the second request This prevents
1101
1096
  # clients from accidentally creating duplicate commitments.
1102
1097
  #
1103
1098
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1202,12 +1197,11 @@ module Google
1202
1197
  # Optional. An optional request ID to identify requests. Specify a unique
1203
1198
  # request ID so that if you must retry your request, the server can ignore
1204
1199
  # the request if it has already been completed. The server guarantees
1205
- # that for at least 60 minutes after the first request.
1200
+ # that for 60 minutes after the first request.
1206
1201
  #
1207
1202
  # For example, consider a situation where you make an initial request and the
1208
1203
  # request times out. If you make the request again with the same request
1209
- # ID, the server can check if original operation with the same request ID
1210
- # was received, and if so, ignores the second request. This prevents
1204
+ # ID, the server ignores the second request This prevents
1211
1205
  # clients from accidentally creating duplicate commitments.
1212
1206
  #
1213
1207
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1286,6 +1280,532 @@ module Google
1286
1280
  raise ::Google::Cloud::Error.from_error(e)
1287
1281
  end
1288
1282
 
1283
+ ##
1284
+ # Lists `AuthzExtension` resources in a given project and location.
1285
+ #
1286
+ # @overload list_authz_extensions(request, options = nil)
1287
+ # Pass arguments to `list_authz_extensions` via a request object, either of type
1288
+ # {::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest} or an equivalent Hash.
1289
+ #
1290
+ # @param request [::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest, ::Hash]
1291
+ # A request object representing the call parameters. Required. To specify no
1292
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1293
+ # @param options [::Gapic::CallOptions, ::Hash]
1294
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1295
+ #
1296
+ # @overload list_authz_extensions(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1297
+ # Pass arguments to `list_authz_extensions` via keyword arguments. Note that at
1298
+ # least one keyword argument is required. To specify no parameters, or to keep all
1299
+ # the default parameter values, pass an empty Hash as a request object (see above).
1300
+ #
1301
+ # @param parent [::String]
1302
+ # Required. The project and location from which the `AuthzExtension`
1303
+ # resources are listed. These values are specified in the following format:
1304
+ # `projects/{project}/locations/{location}`.
1305
+ # @param page_size [::Integer]
1306
+ # Optional. Requested page size. The server might return fewer items than
1307
+ # requested. If unspecified, the server picks an appropriate default.
1308
+ # @param page_token [::String]
1309
+ # Optional. A token identifying a page of results that the server returns.
1310
+ # @param filter [::String]
1311
+ # Optional. Filtering results.
1312
+ # @param order_by [::String]
1313
+ # Optional. Hint about how to order the results.
1314
+ #
1315
+ # @yield [response, operation] Access the result along with the RPC operation
1316
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AuthzExtension>]
1317
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1318
+ #
1319
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AuthzExtension>]
1320
+ #
1321
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1322
+ #
1323
+ # @example Basic example
1324
+ # require "google/cloud/network_services/v1"
1325
+ #
1326
+ # # Create a client object. The client can be reused for multiple calls.
1327
+ # client = Google::Cloud::NetworkServices::V1::DepService::Client.new
1328
+ #
1329
+ # # Create a request. To set request fields, pass in keyword arguments.
1330
+ # request = Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest.new
1331
+ #
1332
+ # # Call the list_authz_extensions method.
1333
+ # result = client.list_authz_extensions request
1334
+ #
1335
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1336
+ # # over elements, and API calls will be issued to fetch pages as needed.
1337
+ # result.each do |item|
1338
+ # # Each element is of type ::Google::Cloud::NetworkServices::V1::AuthzExtension.
1339
+ # p item
1340
+ # end
1341
+ #
1342
+ def list_authz_extensions request, options = nil
1343
+ raise ::ArgumentError, "request must be provided" if request.nil?
1344
+
1345
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::ListAuthzExtensionsRequest
1346
+
1347
+ # Converts hash and nil to an options object
1348
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1349
+
1350
+ # Customize the options with defaults
1351
+ metadata = @config.rpcs.list_authz_extensions.metadata.to_h
1352
+
1353
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1354
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1355
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1356
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
1357
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1358
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1359
+
1360
+ header_params = {}
1361
+ if request.parent
1362
+ header_params["parent"] = request.parent
1363
+ end
1364
+
1365
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1366
+ metadata[:"x-goog-request-params"] ||= request_params_header
1367
+
1368
+ options.apply_defaults timeout: @config.rpcs.list_authz_extensions.timeout,
1369
+ metadata: metadata,
1370
+ retry_policy: @config.rpcs.list_authz_extensions.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.call_rpc :list_authz_extensions, request, options: options do |response, operation|
1377
+ response = ::Gapic::PagedEnumerable.new @dep_service_stub, :list_authz_extensions, request, response, operation, options
1378
+ yield response, operation if block_given?
1379
+ throw :response, response
1380
+ end
1381
+ rescue ::GRPC::BadStatus => e
1382
+ raise ::Google::Cloud::Error.from_error(e)
1383
+ end
1384
+
1385
+ ##
1386
+ # Gets details of the specified `AuthzExtension` resource.
1387
+ #
1388
+ # @overload get_authz_extension(request, options = nil)
1389
+ # Pass arguments to `get_authz_extension` via a request object, either of type
1390
+ # {::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest} or an equivalent Hash.
1391
+ #
1392
+ # @param request [::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest, ::Hash]
1393
+ # A request object representing the call parameters. Required. To specify no
1394
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1395
+ # @param options [::Gapic::CallOptions, ::Hash]
1396
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1397
+ #
1398
+ # @overload get_authz_extension(name: nil)
1399
+ # Pass arguments to `get_authz_extension` via keyword arguments. Note that at
1400
+ # least one keyword argument is required. To specify no parameters, or to keep all
1401
+ # the default parameter values, pass an empty Hash as a request object (see above).
1402
+ #
1403
+ # @param name [::String]
1404
+ # Required. A name of the `AuthzExtension` resource to get. Must be in
1405
+ # the format
1406
+ # `projects/{project}/locations/{location}/authzExtensions/{authz_extension}`.
1407
+ #
1408
+ # @yield [response, operation] Access the result along with the RPC operation
1409
+ # @yieldparam response [::Google::Cloud::NetworkServices::V1::AuthzExtension]
1410
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1411
+ #
1412
+ # @return [::Google::Cloud::NetworkServices::V1::AuthzExtension]
1413
+ #
1414
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1415
+ #
1416
+ # @example Basic example
1417
+ # require "google/cloud/network_services/v1"
1418
+ #
1419
+ # # Create a client object. The client can be reused for multiple calls.
1420
+ # client = Google::Cloud::NetworkServices::V1::DepService::Client.new
1421
+ #
1422
+ # # Create a request. To set request fields, pass in keyword arguments.
1423
+ # request = Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest.new
1424
+ #
1425
+ # # Call the get_authz_extension method.
1426
+ # result = client.get_authz_extension request
1427
+ #
1428
+ # # The returned object is of type Google::Cloud::NetworkServices::V1::AuthzExtension.
1429
+ # p result
1430
+ #
1431
+ def get_authz_extension request, options = nil
1432
+ raise ::ArgumentError, "request must be provided" if request.nil?
1433
+
1434
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::GetAuthzExtensionRequest
1435
+
1436
+ # Converts hash and nil to an options object
1437
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1438
+
1439
+ # Customize the options with defaults
1440
+ metadata = @config.rpcs.get_authz_extension.metadata.to_h
1441
+
1442
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1443
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1444
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1445
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
1446
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1447
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1448
+
1449
+ header_params = {}
1450
+ if request.name
1451
+ header_params["name"] = request.name
1452
+ end
1453
+
1454
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1455
+ metadata[:"x-goog-request-params"] ||= request_params_header
1456
+
1457
+ options.apply_defaults timeout: @config.rpcs.get_authz_extension.timeout,
1458
+ metadata: metadata,
1459
+ retry_policy: @config.rpcs.get_authz_extension.retry_policy
1460
+
1461
+ options.apply_defaults timeout: @config.timeout,
1462
+ metadata: @config.metadata,
1463
+ retry_policy: @config.retry_policy
1464
+
1465
+ @dep_service_stub.call_rpc :get_authz_extension, request, options: options do |response, operation|
1466
+ yield response, operation if block_given?
1467
+ end
1468
+ rescue ::GRPC::BadStatus => e
1469
+ raise ::Google::Cloud::Error.from_error(e)
1470
+ end
1471
+
1472
+ ##
1473
+ # Creates a new `AuthzExtension` resource in a given project
1474
+ # and location.
1475
+ #
1476
+ # @overload create_authz_extension(request, options = nil)
1477
+ # Pass arguments to `create_authz_extension` via a request object, either of type
1478
+ # {::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest} or an equivalent Hash.
1479
+ #
1480
+ # @param request [::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest, ::Hash]
1481
+ # A request object representing the call parameters. Required. To specify no
1482
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1483
+ # @param options [::Gapic::CallOptions, ::Hash]
1484
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1485
+ #
1486
+ # @overload create_authz_extension(parent: nil, authz_extension_id: nil, authz_extension: nil, request_id: nil)
1487
+ # Pass arguments to `create_authz_extension` via keyword arguments. Note that at
1488
+ # least one keyword argument is required. To specify no parameters, or to keep all
1489
+ # the default parameter values, pass an empty Hash as a request object (see above).
1490
+ #
1491
+ # @param parent [::String]
1492
+ # Required. The parent resource of the `AuthzExtension` resource. Must
1493
+ # be in the format `projects/{project}/locations/{location}`.
1494
+ # @param authz_extension_id [::String]
1495
+ # Required. User-provided ID of the `AuthzExtension` resource to be
1496
+ # created.
1497
+ # @param authz_extension [::Google::Cloud::NetworkServices::V1::AuthzExtension, ::Hash]
1498
+ # Required. `AuthzExtension` resource to be created.
1499
+ # @param request_id [::String]
1500
+ # Optional. An optional request ID to identify requests. Specify a unique
1501
+ # request ID so that if you must retry your request, the server can ignore
1502
+ # the request if it has already been completed. The server guarantees
1503
+ # that for 60 minutes since the first request.
1504
+ #
1505
+ # For example, consider a situation where you make an initial request and the
1506
+ # request times out. If you make the request again with the same request
1507
+ # ID, the server ignores the second request This prevents
1508
+ # clients from accidentally creating duplicate commitments.
1509
+ #
1510
+ # The request ID must be a valid UUID with the exception that zero UUID is
1511
+ # not supported (00000000-0000-0000-0000-000000000000).
1512
+ #
1513
+ # @yield [response, operation] Access the result along with the RPC operation
1514
+ # @yieldparam response [::Gapic::Operation]
1515
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1516
+ #
1517
+ # @return [::Gapic::Operation]
1518
+ #
1519
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1520
+ #
1521
+ # @example Basic example
1522
+ # require "google/cloud/network_services/v1"
1523
+ #
1524
+ # # Create a client object. The client can be reused for multiple calls.
1525
+ # client = Google::Cloud::NetworkServices::V1::DepService::Client.new
1526
+ #
1527
+ # # Create a request. To set request fields, pass in keyword arguments.
1528
+ # request = Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest.new
1529
+ #
1530
+ # # Call the create_authz_extension method.
1531
+ # result = client.create_authz_extension request
1532
+ #
1533
+ # # The returned object is of type Gapic::Operation. You can use it to
1534
+ # # check the status of an operation, cancel it, or wait for results.
1535
+ # # Here is how to wait for a response.
1536
+ # result.wait_until_done! timeout: 60
1537
+ # if result.response?
1538
+ # p result.response
1539
+ # else
1540
+ # puts "No response received."
1541
+ # end
1542
+ #
1543
+ def create_authz_extension request, options = nil
1544
+ raise ::ArgumentError, "request must be provided" if request.nil?
1545
+
1546
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::CreateAuthzExtensionRequest
1547
+
1548
+ # Converts hash and nil to an options object
1549
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1550
+
1551
+ # Customize the options with defaults
1552
+ metadata = @config.rpcs.create_authz_extension.metadata.to_h
1553
+
1554
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1555
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1556
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1557
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
1558
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1559
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1560
+
1561
+ header_params = {}
1562
+ if request.parent
1563
+ header_params["parent"] = request.parent
1564
+ end
1565
+
1566
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1567
+ metadata[:"x-goog-request-params"] ||= request_params_header
1568
+
1569
+ options.apply_defaults timeout: @config.rpcs.create_authz_extension.timeout,
1570
+ metadata: metadata,
1571
+ retry_policy: @config.rpcs.create_authz_extension.retry_policy
1572
+
1573
+ options.apply_defaults timeout: @config.timeout,
1574
+ metadata: @config.metadata,
1575
+ retry_policy: @config.retry_policy
1576
+
1577
+ @dep_service_stub.call_rpc :create_authz_extension, request, options: options do |response, operation|
1578
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1579
+ yield response, operation if block_given?
1580
+ throw :response, response
1581
+ end
1582
+ rescue ::GRPC::BadStatus => e
1583
+ raise ::Google::Cloud::Error.from_error(e)
1584
+ end
1585
+
1586
+ ##
1587
+ # Updates the parameters of the specified `AuthzExtension`
1588
+ # resource.
1589
+ #
1590
+ # @overload update_authz_extension(request, options = nil)
1591
+ # Pass arguments to `update_authz_extension` via a request object, either of type
1592
+ # {::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest} or an equivalent Hash.
1593
+ #
1594
+ # @param request [::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest, ::Hash]
1595
+ # A request object representing the call parameters. Required. To specify no
1596
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1597
+ # @param options [::Gapic::CallOptions, ::Hash]
1598
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1599
+ #
1600
+ # @overload update_authz_extension(update_mask: nil, authz_extension: nil, request_id: nil)
1601
+ # Pass arguments to `update_authz_extension` via keyword arguments. Note that at
1602
+ # least one keyword argument is required. To specify no parameters, or to keep all
1603
+ # the default parameter values, pass an empty Hash as a request object (see above).
1604
+ #
1605
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1606
+ # Required. Used to specify the fields to be overwritten in the
1607
+ # `AuthzExtension` resource by the update.
1608
+ # The fields specified in the `update_mask` are relative to the resource, not
1609
+ # the full request. A field is overwritten if it is in the mask. If the
1610
+ # user does not specify a mask, then all fields are overwritten.
1611
+ # @param authz_extension [::Google::Cloud::NetworkServices::V1::AuthzExtension, ::Hash]
1612
+ # Required. `AuthzExtension` resource being updated.
1613
+ # @param request_id [::String]
1614
+ # Optional. An optional request ID to identify requests. Specify a unique
1615
+ # request ID so that if you must retry your request, the server can ignore
1616
+ # the request if it has already been completed. The server guarantees
1617
+ # that for 60 minutes since the first request.
1618
+ #
1619
+ # For example, consider a situation where you make an initial request and the
1620
+ # request times out. If you make the request again with the same request
1621
+ # ID, the server ignores the second request This prevents
1622
+ # clients from accidentally creating duplicate commitments.
1623
+ #
1624
+ # The request ID must be a valid UUID with the exception that zero UUID is
1625
+ # not supported (00000000-0000-0000-0000-000000000000).
1626
+ #
1627
+ # @yield [response, operation] Access the result along with the RPC operation
1628
+ # @yieldparam response [::Gapic::Operation]
1629
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1630
+ #
1631
+ # @return [::Gapic::Operation]
1632
+ #
1633
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1634
+ #
1635
+ # @example Basic example
1636
+ # require "google/cloud/network_services/v1"
1637
+ #
1638
+ # # Create a client object. The client can be reused for multiple calls.
1639
+ # client = Google::Cloud::NetworkServices::V1::DepService::Client.new
1640
+ #
1641
+ # # Create a request. To set request fields, pass in keyword arguments.
1642
+ # request = Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest.new
1643
+ #
1644
+ # # Call the update_authz_extension method.
1645
+ # result = client.update_authz_extension request
1646
+ #
1647
+ # # The returned object is of type Gapic::Operation. You can use it to
1648
+ # # check the status of an operation, cancel it, or wait for results.
1649
+ # # Here is how to wait for a response.
1650
+ # result.wait_until_done! timeout: 60
1651
+ # if result.response?
1652
+ # p result.response
1653
+ # else
1654
+ # puts "No response received."
1655
+ # end
1656
+ #
1657
+ def update_authz_extension request, options = nil
1658
+ raise ::ArgumentError, "request must be provided" if request.nil?
1659
+
1660
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::UpdateAuthzExtensionRequest
1661
+
1662
+ # Converts hash and nil to an options object
1663
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1664
+
1665
+ # Customize the options with defaults
1666
+ metadata = @config.rpcs.update_authz_extension.metadata.to_h
1667
+
1668
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1669
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1670
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1671
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
1672
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1673
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1674
+
1675
+ header_params = {}
1676
+ if request.authz_extension&.name
1677
+ header_params["authz_extension.name"] = request.authz_extension.name
1678
+ end
1679
+
1680
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1681
+ metadata[:"x-goog-request-params"] ||= request_params_header
1682
+
1683
+ options.apply_defaults timeout: @config.rpcs.update_authz_extension.timeout,
1684
+ metadata: metadata,
1685
+ retry_policy: @config.rpcs.update_authz_extension.retry_policy
1686
+
1687
+ options.apply_defaults timeout: @config.timeout,
1688
+ metadata: @config.metadata,
1689
+ retry_policy: @config.retry_policy
1690
+
1691
+ @dep_service_stub.call_rpc :update_authz_extension, request, options: options do |response, operation|
1692
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1693
+ yield response, operation if block_given?
1694
+ throw :response, response
1695
+ end
1696
+ rescue ::GRPC::BadStatus => e
1697
+ raise ::Google::Cloud::Error.from_error(e)
1698
+ end
1699
+
1700
+ ##
1701
+ # Deletes the specified `AuthzExtension` resource.
1702
+ #
1703
+ # @overload delete_authz_extension(request, options = nil)
1704
+ # Pass arguments to `delete_authz_extension` via a request object, either of type
1705
+ # {::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest} or an equivalent Hash.
1706
+ #
1707
+ # @param request [::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest, ::Hash]
1708
+ # A request object representing the call parameters. Required. To specify no
1709
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1710
+ # @param options [::Gapic::CallOptions, ::Hash]
1711
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1712
+ #
1713
+ # @overload delete_authz_extension(name: nil, request_id: nil)
1714
+ # Pass arguments to `delete_authz_extension` via keyword arguments. Note that at
1715
+ # least one keyword argument is required. To specify no parameters, or to keep all
1716
+ # the default parameter values, pass an empty Hash as a request object (see above).
1717
+ #
1718
+ # @param name [::String]
1719
+ # Required. The name of the `AuthzExtension` resource to delete. Must
1720
+ # be in the format
1721
+ # `projects/{project}/locations/{location}/authzExtensions/{authz_extension}`.
1722
+ # @param request_id [::String]
1723
+ # Optional. An optional request ID to identify requests. Specify a unique
1724
+ # request ID so that if you must retry your request, the server can ignore
1725
+ # the request if it has already been completed. The server guarantees
1726
+ # that for 60 minutes after the first request.
1727
+ #
1728
+ # For example, consider a situation where you make an initial request and the
1729
+ # request times out. If you make the request again with the same request
1730
+ # ID, the server ignores the second request This prevents
1731
+ # clients from accidentally creating duplicate commitments.
1732
+ #
1733
+ # The request ID must be a valid UUID with the exception that zero UUID is
1734
+ # not supported (00000000-0000-0000-0000-000000000000).
1735
+ #
1736
+ # @yield [response, operation] Access the result along with the RPC operation
1737
+ # @yieldparam response [::Gapic::Operation]
1738
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1739
+ #
1740
+ # @return [::Gapic::Operation]
1741
+ #
1742
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1743
+ #
1744
+ # @example Basic example
1745
+ # require "google/cloud/network_services/v1"
1746
+ #
1747
+ # # Create a client object. The client can be reused for multiple calls.
1748
+ # client = Google::Cloud::NetworkServices::V1::DepService::Client.new
1749
+ #
1750
+ # # Create a request. To set request fields, pass in keyword arguments.
1751
+ # request = Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest.new
1752
+ #
1753
+ # # Call the delete_authz_extension method.
1754
+ # result = client.delete_authz_extension request
1755
+ #
1756
+ # # The returned object is of type Gapic::Operation. You can use it to
1757
+ # # check the status of an operation, cancel it, or wait for results.
1758
+ # # Here is how to wait for a response.
1759
+ # result.wait_until_done! timeout: 60
1760
+ # if result.response?
1761
+ # p result.response
1762
+ # else
1763
+ # puts "No response received."
1764
+ # end
1765
+ #
1766
+ def delete_authz_extension request, options = nil
1767
+ raise ::ArgumentError, "request must be provided" if request.nil?
1768
+
1769
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::DeleteAuthzExtensionRequest
1770
+
1771
+ # Converts hash and nil to an options object
1772
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1773
+
1774
+ # Customize the options with defaults
1775
+ metadata = @config.rpcs.delete_authz_extension.metadata.to_h
1776
+
1777
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1778
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1779
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1780
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
1781
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1782
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1783
+
1784
+ header_params = {}
1785
+ if request.name
1786
+ header_params["name"] = request.name
1787
+ end
1788
+
1789
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1790
+ metadata[:"x-goog-request-params"] ||= request_params_header
1791
+
1792
+ options.apply_defaults timeout: @config.rpcs.delete_authz_extension.timeout,
1793
+ metadata: metadata,
1794
+ retry_policy: @config.rpcs.delete_authz_extension.retry_policy
1795
+
1796
+ options.apply_defaults timeout: @config.timeout,
1797
+ metadata: @config.metadata,
1798
+ retry_policy: @config.retry_policy
1799
+
1800
+ @dep_service_stub.call_rpc :delete_authz_extension, request, options: options do |response, operation|
1801
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1802
+ yield response, operation if block_given?
1803
+ throw :response, response
1804
+ end
1805
+ rescue ::GRPC::BadStatus => e
1806
+ raise ::Google::Cloud::Error.from_error(e)
1807
+ end
1808
+
1289
1809
  ##
1290
1810
  # Configuration class for the DepService API.
1291
1811
  #
@@ -1502,6 +2022,31 @@ module Google
1502
2022
  # @return [::Gapic::Config::Method]
1503
2023
  #
1504
2024
  attr_reader :delete_lb_route_extension
2025
+ ##
2026
+ # RPC-specific configuration for `list_authz_extensions`
2027
+ # @return [::Gapic::Config::Method]
2028
+ #
2029
+ attr_reader :list_authz_extensions
2030
+ ##
2031
+ # RPC-specific configuration for `get_authz_extension`
2032
+ # @return [::Gapic::Config::Method]
2033
+ #
2034
+ attr_reader :get_authz_extension
2035
+ ##
2036
+ # RPC-specific configuration for `create_authz_extension`
2037
+ # @return [::Gapic::Config::Method]
2038
+ #
2039
+ attr_reader :create_authz_extension
2040
+ ##
2041
+ # RPC-specific configuration for `update_authz_extension`
2042
+ # @return [::Gapic::Config::Method]
2043
+ #
2044
+ attr_reader :update_authz_extension
2045
+ ##
2046
+ # RPC-specific configuration for `delete_authz_extension`
2047
+ # @return [::Gapic::Config::Method]
2048
+ #
2049
+ attr_reader :delete_authz_extension
1505
2050
 
1506
2051
  # @private
1507
2052
  def initialize parent_rpcs = nil
@@ -1525,6 +2070,16 @@ module Google
1525
2070
  @update_lb_route_extension = ::Gapic::Config::Method.new update_lb_route_extension_config
1526
2071
  delete_lb_route_extension_config = parent_rpcs.delete_lb_route_extension if parent_rpcs.respond_to? :delete_lb_route_extension
1527
2072
  @delete_lb_route_extension = ::Gapic::Config::Method.new delete_lb_route_extension_config
2073
+ list_authz_extensions_config = parent_rpcs.list_authz_extensions if parent_rpcs.respond_to? :list_authz_extensions
2074
+ @list_authz_extensions = ::Gapic::Config::Method.new list_authz_extensions_config
2075
+ get_authz_extension_config = parent_rpcs.get_authz_extension if parent_rpcs.respond_to? :get_authz_extension
2076
+ @get_authz_extension = ::Gapic::Config::Method.new get_authz_extension_config
2077
+ create_authz_extension_config = parent_rpcs.create_authz_extension if parent_rpcs.respond_to? :create_authz_extension
2078
+ @create_authz_extension = ::Gapic::Config::Method.new create_authz_extension_config
2079
+ update_authz_extension_config = parent_rpcs.update_authz_extension if parent_rpcs.respond_to? :update_authz_extension
2080
+ @update_authz_extension = ::Gapic::Config::Method.new update_authz_extension_config
2081
+ delete_authz_extension_config = parent_rpcs.delete_authz_extension if parent_rpcs.respond_to? :delete_authz_extension
2082
+ @delete_authz_extension = ::Gapic::Config::Method.new delete_authz_extension_config
1528
2083
 
1529
2084
  yield self if block_given?
1530
2085
  end