google-cloud-network_services-v1 2.9.0 → 2.10.1

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.
Files changed (35) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/network_services/v1/dep_service/client.rb +2 -0
  4. data/lib/google/cloud/network_services/v1/dep_service/operations.rb +2 -0
  5. data/lib/google/cloud/network_services/v1/dep_service/rest/client.rb +2 -0
  6. data/lib/google/cloud/network_services/v1/dep_service/rest/operations.rb +2 -0
  7. data/lib/google/cloud/network_services/v1/network_services/client.rb +551 -26
  8. data/lib/google/cloud/network_services/v1/network_services/operations.rb +2 -0
  9. data/lib/google/cloud/network_services/v1/network_services/paths.rb +38 -0
  10. data/lib/google/cloud/network_services/v1/network_services/rest/client.rb +516 -26
  11. data/lib/google/cloud/network_services/v1/network_services/rest/operations.rb +2 -0
  12. data/lib/google/cloud/network_services/v1/network_services/rest/service_stub.rb +307 -0
  13. data/lib/google/cloud/network_services/v1/version.rb +1 -1
  14. data/lib/google/cloud/networkservices/v1/agent_gateway_pb.rb +41 -0
  15. data/lib/google/cloud/networkservices/v1/dep_pb.rb +2 -1
  16. data/lib/google/cloud/networkservices/v1/gateway_pb.rb +1 -1
  17. data/lib/google/cloud/networkservices/v1/http_route_pb.rb +2 -1
  18. data/lib/google/cloud/networkservices/v1/mesh_pb.rb +1 -1
  19. data/lib/google/cloud/networkservices/v1/network_services_pb.rb +2 -1
  20. data/lib/google/cloud/networkservices/v1/network_services_services_pb.rb +10 -0
  21. data/lib/google/cloud/networkservices/v1/service_binding_pb.rb +2 -1
  22. data/lib/google/cloud/networkservices/v1/tls_route_pb.rb +1 -1
  23. data/proto_docs/google/api/client.rb +4 -0
  24. data/proto_docs/google/cloud/networkservices/v1/agent_gateway.rb +302 -0
  25. data/proto_docs/google/cloud/networkservices/v1/common.rb +4 -4
  26. data/proto_docs/google/cloud/networkservices/v1/dep.rb +110 -7
  27. data/proto_docs/google/cloud/networkservices/v1/endpoint_policy.rb +5 -5
  28. data/proto_docs/google/cloud/networkservices/v1/extensibility.rb +90 -33
  29. data/proto_docs/google/cloud/networkservices/v1/gateway.rb +11 -1
  30. data/proto_docs/google/cloud/networkservices/v1/grpc_route.rb +7 -7
  31. data/proto_docs/google/cloud/networkservices/v1/http_route.rb +13 -7
  32. data/proto_docs/google/cloud/networkservices/v1/mesh.rb +5 -5
  33. data/proto_docs/google/cloud/networkservices/v1/tcp_route.rb +7 -7
  34. data/proto_docs/google/cloud/networkservices/v1/tls_route.rb +15 -7
  35. metadata +5 -3
@@ -246,7 +246,7 @@ module Google
246
246
  #
247
247
  # @param parent [::String]
248
248
  # Required. The project and location from which the EndpointPolicies should
249
- # be listed, specified in the format `projects/*/locations/global`.
249
+ # be listed, specified in the format `projects/*/locations/*`.
250
250
  # @param page_size [::Integer]
251
251
  # Maximum number of EndpointPolicies to return per call.
252
252
  # @param page_token [::String]
@@ -342,7 +342,7 @@ module Google
342
342
  #
343
343
  # @param name [::String]
344
344
  # Required. A name of the EndpointPolicy to get. Must be in the format
345
- # `projects/*/locations/global/endpointPolicies/*`.
345
+ # `projects/*/locations/*/endpointPolicies/*`.
346
346
  # @yield [result, operation] Access the result along with the TransportOperation object
347
347
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::EndpointPolicy]
348
348
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -421,7 +421,7 @@ module Google
421
421
  #
422
422
  # @param parent [::String]
423
423
  # Required. The parent resource of the EndpointPolicy. Must be in the
424
- # format `projects/*/locations/global`.
424
+ # format `projects/*/locations/*`.
425
425
  # @param endpoint_policy_id [::String]
426
426
  # Required. Short name of the EndpointPolicy resource to be created.
427
427
  # E.g. "CustomECS".
@@ -607,7 +607,7 @@ module Google
607
607
  #
608
608
  # @param name [::String]
609
609
  # Required. A name of the EndpointPolicy to delete. Must be in the format
610
- # `projects/*/locations/global/endpointPolicies/*`.
610
+ # `projects/*/locations/*/endpointPolicies/*`.
611
611
  # @yield [result, operation] Access the result along with the TransportOperation object
612
612
  # @yieldparam result [::Gapic::Operation]
613
613
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1956,7 +1956,7 @@ module Google
1956
1956
  #
1957
1957
  # @param parent [::String]
1958
1958
  # Required. The project and location from which the GrpcRoutes should be
1959
- # listed, specified in the format `projects/*/locations/global`.
1959
+ # listed, specified in the format `projects/*/locations/*`.
1960
1960
  # @param page_size [::Integer]
1961
1961
  # Maximum number of GrpcRoutes to return per call.
1962
1962
  # @param page_token [::String]
@@ -2051,7 +2051,7 @@ module Google
2051
2051
  #
2052
2052
  # @param name [::String]
2053
2053
  # Required. A name of the GrpcRoute to get. Must be in the format
2054
- # `projects/*/locations/global/grpcRoutes/*`.
2054
+ # `projects/*/locations/*/grpcRoutes/*`.
2055
2055
  # @yield [result, operation] Access the result along with the TransportOperation object
2056
2056
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::GrpcRoute]
2057
2057
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2130,7 +2130,7 @@ module Google
2130
2130
  #
2131
2131
  # @param parent [::String]
2132
2132
  # Required. The parent resource of the GrpcRoute. Must be in the
2133
- # format `projects/*/locations/global`.
2133
+ # format `projects/*/locations/*`.
2134
2134
  # @param grpc_route_id [::String]
2135
2135
  # Required. Short name of the GrpcRoute resource to be created.
2136
2136
  # @param grpc_route [::Google::Cloud::NetworkServices::V1::GrpcRoute, ::Hash]
@@ -2315,7 +2315,7 @@ module Google
2315
2315
  #
2316
2316
  # @param name [::String]
2317
2317
  # Required. A name of the GrpcRoute to delete. Must be in the format
2318
- # `projects/*/locations/global/grpcRoutes/*`.
2318
+ # `projects/*/locations/*/grpcRoutes/*`.
2319
2319
  # @yield [result, operation] Access the result along with the TransportOperation object
2320
2320
  # @yieldparam result [::Gapic::Operation]
2321
2321
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2396,14 +2396,14 @@ module Google
2396
2396
  # @param options [::Gapic::CallOptions, ::Hash]
2397
2397
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2398
2398
  #
2399
- # @overload list_http_routes(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil)
2399
+ # @overload list_http_routes(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil, filter: nil)
2400
2400
  # Pass arguments to `list_http_routes` via keyword arguments. Note that at
2401
2401
  # least one keyword argument is required. To specify no parameters, or to keep all
2402
2402
  # the default parameter values, pass an empty Hash as a request object (see above).
2403
2403
  #
2404
2404
  # @param parent [::String]
2405
2405
  # Required. The project and location from which the HttpRoutes should be
2406
- # listed, specified in the format `projects/*/locations/global`.
2406
+ # listed, specified in the format `projects/*/locations/*`.
2407
2407
  # @param page_size [::Integer]
2408
2408
  # Maximum number of HttpRoutes to return per call.
2409
2409
  # @param page_token [::String]
@@ -2414,6 +2414,8 @@ module Google
2414
2414
  # Optional. If true, allow partial responses for multi-regional Aggregated
2415
2415
  # List requests. Otherwise if one of the locations is down or unreachable,
2416
2416
  # the Aggregated List request will fail.
2417
+ # @param filter [::String]
2418
+ # Optional. Filter expression to restrict the list.
2417
2419
  # @yield [result, operation] Access the result along with the TransportOperation object
2418
2420
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::HttpRoute>]
2419
2421
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2498,7 +2500,7 @@ module Google
2498
2500
  #
2499
2501
  # @param name [::String]
2500
2502
  # Required. A name of the HttpRoute to get. Must be in the format
2501
- # `projects/*/locations/global/httpRoutes/*`.
2503
+ # `projects/*/locations/*/httpRoutes/*`.
2502
2504
  # @yield [result, operation] Access the result along with the TransportOperation object
2503
2505
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::HttpRoute]
2504
2506
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2570,18 +2572,20 @@ module Google
2570
2572
  # @param options [::Gapic::CallOptions, ::Hash]
2571
2573
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2572
2574
  #
2573
- # @overload create_http_route(parent: nil, http_route_id: nil, http_route: nil)
2575
+ # @overload create_http_route(parent: nil, http_route_id: nil, http_route: nil, request_id: nil)
2574
2576
  # Pass arguments to `create_http_route` via keyword arguments. Note that at
2575
2577
  # least one keyword argument is required. To specify no parameters, or to keep all
2576
2578
  # the default parameter values, pass an empty Hash as a request object (see above).
2577
2579
  #
2578
2580
  # @param parent [::String]
2579
2581
  # Required. The parent resource of the HttpRoute. Must be in the
2580
- # format `projects/*/locations/global`.
2582
+ # format `projects/*/locations/*`.
2581
2583
  # @param http_route_id [::String]
2582
2584
  # Required. Short name of the HttpRoute resource to be created.
2583
2585
  # @param http_route [::Google::Cloud::NetworkServices::V1::HttpRoute, ::Hash]
2584
2586
  # Required. HttpRoute resource to be created.
2587
+ # @param request_id [::String]
2588
+ # Optional. Idempotent request UUID.
2585
2589
  # @yield [result, operation] Access the result along with the TransportOperation object
2586
2590
  # @yieldparam result [::Gapic::Operation]
2587
2591
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2762,7 +2766,7 @@ module Google
2762
2766
  #
2763
2767
  # @param name [::String]
2764
2768
  # Required. A name of the HttpRoute to delete. Must be in the format
2765
- # `projects/*/locations/global/httpRoutes/*`.
2769
+ # `projects/*/locations/*/httpRoutes/*`.
2766
2770
  # @yield [result, operation] Access the result along with the TransportOperation object
2767
2771
  # @yieldparam result [::Gapic::Operation]
2768
2772
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2850,7 +2854,7 @@ module Google
2850
2854
  #
2851
2855
  # @param parent [::String]
2852
2856
  # Required. The project and location from which the TcpRoutes should be
2853
- # listed, specified in the format `projects/*/locations/global`.
2857
+ # listed, specified in the format `projects/*/locations/*`.
2854
2858
  # @param page_size [::Integer]
2855
2859
  # Maximum number of TcpRoutes to return per call.
2856
2860
  # @param page_token [::String]
@@ -2945,7 +2949,7 @@ module Google
2945
2949
  #
2946
2950
  # @param name [::String]
2947
2951
  # Required. A name of the TcpRoute to get. Must be in the format
2948
- # `projects/*/locations/global/tcpRoutes/*`.
2952
+ # `projects/*/locations/*/tcpRoutes/*`.
2949
2953
  # @yield [result, operation] Access the result along with the TransportOperation object
2950
2954
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::TcpRoute]
2951
2955
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3024,7 +3028,7 @@ module Google
3024
3028
  #
3025
3029
  # @param parent [::String]
3026
3030
  # Required. The parent resource of the TcpRoute. Must be in the
3027
- # format `projects/*/locations/global`.
3031
+ # format `projects/*/locations/*`.
3028
3032
  # @param tcp_route_id [::String]
3029
3033
  # Required. Short name of the TcpRoute resource to be created.
3030
3034
  # @param tcp_route [::Google::Cloud::NetworkServices::V1::TcpRoute, ::Hash]
@@ -3209,7 +3213,7 @@ module Google
3209
3213
  #
3210
3214
  # @param name [::String]
3211
3215
  # Required. A name of the TcpRoute to delete. Must be in the format
3212
- # `projects/*/locations/global/tcpRoutes/*`.
3216
+ # `projects/*/locations/*/tcpRoutes/*`.
3213
3217
  # @yield [result, operation] Access the result along with the TransportOperation object
3214
3218
  # @yieldparam result [::Gapic::Operation]
3215
3219
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3297,7 +3301,7 @@ module Google
3297
3301
  #
3298
3302
  # @param parent [::String]
3299
3303
  # Required. The project and location from which the TlsRoutes should be
3300
- # listed, specified in the format `projects/*/locations/global`.
3304
+ # listed, specified in the format `projects/*/locations/*`.
3301
3305
  # @param page_size [::Integer]
3302
3306
  # Maximum number of TlsRoutes to return per call.
3303
3307
  # @param page_token [::String]
@@ -3392,7 +3396,7 @@ module Google
3392
3396
  #
3393
3397
  # @param name [::String]
3394
3398
  # Required. A name of the TlsRoute to get. Must be in the format
3395
- # `projects/*/locations/global/tlsRoutes/*`.
3399
+ # `projects/*/locations/*/tlsRoutes/*`.
3396
3400
  # @yield [result, operation] Access the result along with the TransportOperation object
3397
3401
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::TlsRoute]
3398
3402
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3471,7 +3475,7 @@ module Google
3471
3475
  #
3472
3476
  # @param parent [::String]
3473
3477
  # Required. The parent resource of the TlsRoute. Must be in the
3474
- # format `projects/*/locations/global`.
3478
+ # format `projects/*/locations/*`.
3475
3479
  # @param tls_route_id [::String]
3476
3480
  # Required. Short name of the TlsRoute resource to be created.
3477
3481
  # @param tls_route [::Google::Cloud::NetworkServices::V1::TlsRoute, ::Hash]
@@ -3656,7 +3660,7 @@ module Google
3656
3660
  #
3657
3661
  # @param name [::String]
3658
3662
  # Required. A name of the TlsRoute to delete. Must be in the format
3659
- # `projects/*/locations/global/tlsRoutes/*`.
3663
+ # `projects/*/locations/*/tlsRoutes/*`.
3660
3664
  # @yield [result, operation] Access the result along with the TransportOperation object
3661
3665
  # @yieldparam result [::Gapic::Operation]
3662
3666
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -4187,7 +4191,7 @@ module Google
4187
4191
  #
4188
4192
  # @param parent [::String]
4189
4193
  # Required. The project and location from which the Meshes should be
4190
- # listed, specified in the format `projects/*/locations/global`.
4194
+ # listed, specified in the format `projects/*/locations/*`.
4191
4195
  # @param page_size [::Integer]
4192
4196
  # Maximum number of Meshes to return per call.
4193
4197
  # @param page_token [::String]
@@ -4282,7 +4286,7 @@ module Google
4282
4286
  #
4283
4287
  # @param name [::String]
4284
4288
  # Required. A name of the Mesh to get. Must be in the format
4285
- # `projects/*/locations/global/meshes/*`.
4289
+ # `projects/*/locations/*/meshes/*`.
4286
4290
  # @yield [result, operation] Access the result along with the TransportOperation object
4287
4291
  # @yieldparam result [::Google::Cloud::NetworkServices::V1::Mesh]
4288
4292
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -4361,7 +4365,7 @@ module Google
4361
4365
  #
4362
4366
  # @param parent [::String]
4363
4367
  # Required. The parent resource of the Mesh. Must be in the
4364
- # format `projects/*/locations/global`.
4368
+ # format `projects/*/locations/*`.
4365
4369
  # @param mesh_id [::String]
4366
4370
  # Required. Short name of the Mesh resource to be created.
4367
4371
  # @param mesh [::Google::Cloud::NetworkServices::V1::Mesh, ::Hash]
@@ -4546,7 +4550,7 @@ module Google
4546
4550
  #
4547
4551
  # @param name [::String]
4548
4552
  # Required. A name of the Mesh to delete. Must be in the format
4549
- # `projects/*/locations/global/meshes/*`.
4553
+ # `projects/*/locations/*/meshes/*`.
4550
4554
  # @yield [result, operation] Access the result along with the TransportOperation object
4551
4555
  # @yieldparam result [::Gapic::Operation]
4552
4556
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -5405,6 +5409,455 @@ module Google
5405
5409
  raise ::Google::Cloud::Error.from_error(e)
5406
5410
  end
5407
5411
 
5412
+ ##
5413
+ # Lists AgentGateways in a given project and location.
5414
+ #
5415
+ # @overload list_agent_gateways(request, options = nil)
5416
+ # Pass arguments to `list_agent_gateways` via a request object, either of type
5417
+ # {::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest} or an equivalent Hash.
5418
+ #
5419
+ # @param request [::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest, ::Hash]
5420
+ # A request object representing the call parameters. Required. To specify no
5421
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5422
+ # @param options [::Gapic::CallOptions, ::Hash]
5423
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5424
+ #
5425
+ # @overload list_agent_gateways(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil)
5426
+ # Pass arguments to `list_agent_gateways` via keyword arguments. Note that at
5427
+ # least one keyword argument is required. To specify no parameters, or to keep all
5428
+ # the default parameter values, pass an empty Hash as a request object (see above).
5429
+ #
5430
+ # @param parent [::String]
5431
+ # Required. The project and location from which the AgentGateways should be
5432
+ # listed, specified in the format `projects/*/locations/*`.
5433
+ # @param page_size [::Integer]
5434
+ # Optional. Maximum number of AgentGateways to return per call.
5435
+ # @param page_token [::String]
5436
+ # Optional. The value returned by the last `ListAgentGatewaysResponse`
5437
+ # Indicates that this is a continuation of a prior `ListAgentGateways`
5438
+ # call, and that the system should return the next page of data.
5439
+ # @param return_partial_success [::Boolean]
5440
+ # Optional. If true, allow partial responses for multi-regional Aggregated
5441
+ # List requests. Otherwise if one of the locations is down or unreachable,
5442
+ # the Aggregated List request will fail.
5443
+ # @yield [result, operation] Access the result along with the TransportOperation object
5444
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AgentGateway>]
5445
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5446
+ #
5447
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AgentGateway>]
5448
+ #
5449
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5450
+ #
5451
+ # @example Basic example
5452
+ # require "google/cloud/network_services/v1"
5453
+ #
5454
+ # # Create a client object. The client can be reused for multiple calls.
5455
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Rest::Client.new
5456
+ #
5457
+ # # Create a request. To set request fields, pass in keyword arguments.
5458
+ # request = Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest.new
5459
+ #
5460
+ # # Call the list_agent_gateways method.
5461
+ # result = client.list_agent_gateways request
5462
+ #
5463
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5464
+ # # over elements, and API calls will be issued to fetch pages as needed.
5465
+ # result.each do |item|
5466
+ # # Each element is of type ::Google::Cloud::NetworkServices::V1::AgentGateway.
5467
+ # p item
5468
+ # end
5469
+ #
5470
+ def list_agent_gateways request, options = nil
5471
+ raise ::ArgumentError, "request must be provided" if request.nil?
5472
+
5473
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest
5474
+
5475
+ # Converts hash and nil to an options object
5476
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5477
+
5478
+ # Customize the options with defaults
5479
+ call_metadata = @config.rpcs.list_agent_gateways.metadata.to_h
5480
+
5481
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5482
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5483
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5484
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
5485
+ transports_version_send: [:rest]
5486
+
5487
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5488
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5489
+
5490
+ options.apply_defaults timeout: @config.rpcs.list_agent_gateways.timeout,
5491
+ metadata: call_metadata,
5492
+ retry_policy: @config.rpcs.list_agent_gateways.retry_policy
5493
+
5494
+ options.apply_defaults timeout: @config.timeout,
5495
+ metadata: @config.metadata,
5496
+ retry_policy: @config.retry_policy
5497
+
5498
+ @network_services_stub.list_agent_gateways request, options do |result, operation|
5499
+ result = ::Gapic::Rest::PagedEnumerable.new @network_services_stub, :list_agent_gateways, "agent_gateways", request, result, options
5500
+ yield result, operation if block_given?
5501
+ throw :response, result
5502
+ end
5503
+ rescue ::Gapic::Rest::Error => e
5504
+ raise ::Google::Cloud::Error.from_error(e)
5505
+ end
5506
+
5507
+ ##
5508
+ # Gets details of a single AgentGateway.
5509
+ #
5510
+ # @overload get_agent_gateway(request, options = nil)
5511
+ # Pass arguments to `get_agent_gateway` via a request object, either of type
5512
+ # {::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest} or an equivalent Hash.
5513
+ #
5514
+ # @param request [::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest, ::Hash]
5515
+ # A request object representing the call parameters. Required. To specify no
5516
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5517
+ # @param options [::Gapic::CallOptions, ::Hash]
5518
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5519
+ #
5520
+ # @overload get_agent_gateway(name: nil)
5521
+ # Pass arguments to `get_agent_gateway` via keyword arguments. Note that at
5522
+ # least one keyword argument is required. To specify no parameters, or to keep all
5523
+ # the default parameter values, pass an empty Hash as a request object (see above).
5524
+ #
5525
+ # @param name [::String]
5526
+ # Required. A name of the AgentGateway to get. Must be in the format
5527
+ # `projects/*/locations/*/agentGateways/*`.
5528
+ # @yield [result, operation] Access the result along with the TransportOperation object
5529
+ # @yieldparam result [::Google::Cloud::NetworkServices::V1::AgentGateway]
5530
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5531
+ #
5532
+ # @return [::Google::Cloud::NetworkServices::V1::AgentGateway]
5533
+ #
5534
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5535
+ #
5536
+ # @example Basic example
5537
+ # require "google/cloud/network_services/v1"
5538
+ #
5539
+ # # Create a client object. The client can be reused for multiple calls.
5540
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Rest::Client.new
5541
+ #
5542
+ # # Create a request. To set request fields, pass in keyword arguments.
5543
+ # request = Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest.new
5544
+ #
5545
+ # # Call the get_agent_gateway method.
5546
+ # result = client.get_agent_gateway request
5547
+ #
5548
+ # # The returned object is of type Google::Cloud::NetworkServices::V1::AgentGateway.
5549
+ # p result
5550
+ #
5551
+ def get_agent_gateway request, options = nil
5552
+ raise ::ArgumentError, "request must be provided" if request.nil?
5553
+
5554
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest
5555
+
5556
+ # Converts hash and nil to an options object
5557
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5558
+
5559
+ # Customize the options with defaults
5560
+ call_metadata = @config.rpcs.get_agent_gateway.metadata.to_h
5561
+
5562
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5563
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5564
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5565
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
5566
+ transports_version_send: [:rest]
5567
+
5568
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5569
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5570
+
5571
+ options.apply_defaults timeout: @config.rpcs.get_agent_gateway.timeout,
5572
+ metadata: call_metadata,
5573
+ retry_policy: @config.rpcs.get_agent_gateway.retry_policy
5574
+
5575
+ options.apply_defaults timeout: @config.timeout,
5576
+ metadata: @config.metadata,
5577
+ retry_policy: @config.retry_policy
5578
+
5579
+ @network_services_stub.get_agent_gateway request, options do |result, operation|
5580
+ yield result, operation if block_given?
5581
+ end
5582
+ rescue ::Gapic::Rest::Error => e
5583
+ raise ::Google::Cloud::Error.from_error(e)
5584
+ end
5585
+
5586
+ ##
5587
+ # Creates a new AgentGateway in a given project and location.
5588
+ #
5589
+ # @overload create_agent_gateway(request, options = nil)
5590
+ # Pass arguments to `create_agent_gateway` via a request object, either of type
5591
+ # {::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest} or an equivalent Hash.
5592
+ #
5593
+ # @param request [::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest, ::Hash]
5594
+ # A request object representing the call parameters. Required. To specify no
5595
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5596
+ # @param options [::Gapic::CallOptions, ::Hash]
5597
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5598
+ #
5599
+ # @overload create_agent_gateway(parent: nil, agent_gateway_id: nil, agent_gateway: nil)
5600
+ # Pass arguments to `create_agent_gateway` via keyword arguments. Note that at
5601
+ # least one keyword argument is required. To specify no parameters, or to keep all
5602
+ # the default parameter values, pass an empty Hash as a request object (see above).
5603
+ #
5604
+ # @param parent [::String]
5605
+ # Required. The parent resource of the AgentGateway. Must be in the
5606
+ # format `projects/*/locations/*`.
5607
+ # @param agent_gateway_id [::String]
5608
+ # Required. Short name of the AgentGateway resource to be created.
5609
+ # @param agent_gateway [::Google::Cloud::NetworkServices::V1::AgentGateway, ::Hash]
5610
+ # Required. AgentGateway resource to be created.
5611
+ # @yield [result, operation] Access the result along with the TransportOperation object
5612
+ # @yieldparam result [::Gapic::Operation]
5613
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5614
+ #
5615
+ # @return [::Gapic::Operation]
5616
+ #
5617
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5618
+ #
5619
+ # @example Basic example
5620
+ # require "google/cloud/network_services/v1"
5621
+ #
5622
+ # # Create a client object. The client can be reused for multiple calls.
5623
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Rest::Client.new
5624
+ #
5625
+ # # Create a request. To set request fields, pass in keyword arguments.
5626
+ # request = Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest.new
5627
+ #
5628
+ # # Call the create_agent_gateway method.
5629
+ # result = client.create_agent_gateway request
5630
+ #
5631
+ # # The returned object is of type Gapic::Operation. You can use it to
5632
+ # # check the status of an operation, cancel it, or wait for results.
5633
+ # # Here is how to wait for a response.
5634
+ # result.wait_until_done! timeout: 60
5635
+ # if result.response?
5636
+ # p result.response
5637
+ # else
5638
+ # puts "No response received."
5639
+ # end
5640
+ #
5641
+ def create_agent_gateway request, options = nil
5642
+ raise ::ArgumentError, "request must be provided" if request.nil?
5643
+
5644
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest
5645
+
5646
+ # Converts hash and nil to an options object
5647
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5648
+
5649
+ # Customize the options with defaults
5650
+ call_metadata = @config.rpcs.create_agent_gateway.metadata.to_h
5651
+
5652
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5653
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5654
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5655
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
5656
+ transports_version_send: [:rest]
5657
+
5658
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5659
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5660
+
5661
+ options.apply_defaults timeout: @config.rpcs.create_agent_gateway.timeout,
5662
+ metadata: call_metadata,
5663
+ retry_policy: @config.rpcs.create_agent_gateway.retry_policy
5664
+
5665
+ options.apply_defaults timeout: @config.timeout,
5666
+ metadata: @config.metadata,
5667
+ retry_policy: @config.retry_policy
5668
+
5669
+ @network_services_stub.create_agent_gateway request, options do |result, operation|
5670
+ result = ::Gapic::Operation.new result, @operations_client, options: options
5671
+ yield result, operation if block_given?
5672
+ throw :response, result
5673
+ end
5674
+ rescue ::Gapic::Rest::Error => e
5675
+ raise ::Google::Cloud::Error.from_error(e)
5676
+ end
5677
+
5678
+ ##
5679
+ # Updates the parameters of a single AgentGateway.
5680
+ #
5681
+ # @overload update_agent_gateway(request, options = nil)
5682
+ # Pass arguments to `update_agent_gateway` via a request object, either of type
5683
+ # {::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest} or an equivalent Hash.
5684
+ #
5685
+ # @param request [::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest, ::Hash]
5686
+ # A request object representing the call parameters. Required. To specify no
5687
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5688
+ # @param options [::Gapic::CallOptions, ::Hash]
5689
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5690
+ #
5691
+ # @overload update_agent_gateway(update_mask: nil, agent_gateway: nil)
5692
+ # Pass arguments to `update_agent_gateway` via keyword arguments. Note that at
5693
+ # least one keyword argument is required. To specify no parameters, or to keep all
5694
+ # the default parameter values, pass an empty Hash as a request object (see above).
5695
+ #
5696
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
5697
+ # Optional. Field mask is used to specify the fields to be overwritten in the
5698
+ # AgentGateway resource by the update.
5699
+ # The fields specified in the update_mask are relative to the resource, not
5700
+ # the full request. A field will be overwritten if it is in the mask. If the
5701
+ # user does not provide a mask then all fields will be overwritten.
5702
+ # @param agent_gateway [::Google::Cloud::NetworkServices::V1::AgentGateway, ::Hash]
5703
+ # Required. Updated AgentGateway resource.
5704
+ # @yield [result, operation] Access the result along with the TransportOperation object
5705
+ # @yieldparam result [::Gapic::Operation]
5706
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5707
+ #
5708
+ # @return [::Gapic::Operation]
5709
+ #
5710
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5711
+ #
5712
+ # @example Basic example
5713
+ # require "google/cloud/network_services/v1"
5714
+ #
5715
+ # # Create a client object. The client can be reused for multiple calls.
5716
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Rest::Client.new
5717
+ #
5718
+ # # Create a request. To set request fields, pass in keyword arguments.
5719
+ # request = Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest.new
5720
+ #
5721
+ # # Call the update_agent_gateway method.
5722
+ # result = client.update_agent_gateway request
5723
+ #
5724
+ # # The returned object is of type Gapic::Operation. You can use it to
5725
+ # # check the status of an operation, cancel it, or wait for results.
5726
+ # # Here is how to wait for a response.
5727
+ # result.wait_until_done! timeout: 60
5728
+ # if result.response?
5729
+ # p result.response
5730
+ # else
5731
+ # puts "No response received."
5732
+ # end
5733
+ #
5734
+ def update_agent_gateway request, options = nil
5735
+ raise ::ArgumentError, "request must be provided" if request.nil?
5736
+
5737
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest
5738
+
5739
+ # Converts hash and nil to an options object
5740
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5741
+
5742
+ # Customize the options with defaults
5743
+ call_metadata = @config.rpcs.update_agent_gateway.metadata.to_h
5744
+
5745
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5746
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5747
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5748
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
5749
+ transports_version_send: [:rest]
5750
+
5751
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5752
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5753
+
5754
+ options.apply_defaults timeout: @config.rpcs.update_agent_gateway.timeout,
5755
+ metadata: call_metadata,
5756
+ retry_policy: @config.rpcs.update_agent_gateway.retry_policy
5757
+
5758
+ options.apply_defaults timeout: @config.timeout,
5759
+ metadata: @config.metadata,
5760
+ retry_policy: @config.retry_policy
5761
+
5762
+ @network_services_stub.update_agent_gateway request, options do |result, operation|
5763
+ result = ::Gapic::Operation.new result, @operations_client, options: options
5764
+ yield result, operation if block_given?
5765
+ throw :response, result
5766
+ end
5767
+ rescue ::Gapic::Rest::Error => e
5768
+ raise ::Google::Cloud::Error.from_error(e)
5769
+ end
5770
+
5771
+ ##
5772
+ # Deletes a single AgentGateway.
5773
+ #
5774
+ # @overload delete_agent_gateway(request, options = nil)
5775
+ # Pass arguments to `delete_agent_gateway` via a request object, either of type
5776
+ # {::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest} or an equivalent Hash.
5777
+ #
5778
+ # @param request [::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest, ::Hash]
5779
+ # A request object representing the call parameters. Required. To specify no
5780
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5781
+ # @param options [::Gapic::CallOptions, ::Hash]
5782
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5783
+ #
5784
+ # @overload delete_agent_gateway(name: nil, etag: nil)
5785
+ # Pass arguments to `delete_agent_gateway` via keyword arguments. Note that at
5786
+ # least one keyword argument is required. To specify no parameters, or to keep all
5787
+ # the default parameter values, pass an empty Hash as a request object (see above).
5788
+ #
5789
+ # @param name [::String]
5790
+ # Required. A name of the AgentGateway to delete. Must be in the format
5791
+ # `projects/*/locations/*/agentGateways/*`.
5792
+ # @param etag [::String]
5793
+ # Optional. The etag of the AgentGateway to delete.
5794
+ # @yield [result, operation] Access the result along with the TransportOperation object
5795
+ # @yieldparam result [::Gapic::Operation]
5796
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5797
+ #
5798
+ # @return [::Gapic::Operation]
5799
+ #
5800
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5801
+ #
5802
+ # @example Basic example
5803
+ # require "google/cloud/network_services/v1"
5804
+ #
5805
+ # # Create a client object. The client can be reused for multiple calls.
5806
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Rest::Client.new
5807
+ #
5808
+ # # Create a request. To set request fields, pass in keyword arguments.
5809
+ # request = Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest.new
5810
+ #
5811
+ # # Call the delete_agent_gateway method.
5812
+ # result = client.delete_agent_gateway request
5813
+ #
5814
+ # # The returned object is of type Gapic::Operation. You can use it to
5815
+ # # check the status of an operation, cancel it, or wait for results.
5816
+ # # Here is how to wait for a response.
5817
+ # result.wait_until_done! timeout: 60
5818
+ # if result.response?
5819
+ # p result.response
5820
+ # else
5821
+ # puts "No response received."
5822
+ # end
5823
+ #
5824
+ def delete_agent_gateway request, options = nil
5825
+ raise ::ArgumentError, "request must be provided" if request.nil?
5826
+
5827
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest
5828
+
5829
+ # Converts hash and nil to an options object
5830
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5831
+
5832
+ # Customize the options with defaults
5833
+ call_metadata = @config.rpcs.delete_agent_gateway.metadata.to_h
5834
+
5835
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5836
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5837
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5838
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION,
5839
+ transports_version_send: [:rest]
5840
+
5841
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5842
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5843
+
5844
+ options.apply_defaults timeout: @config.rpcs.delete_agent_gateway.timeout,
5845
+ metadata: call_metadata,
5846
+ retry_policy: @config.rpcs.delete_agent_gateway.retry_policy
5847
+
5848
+ options.apply_defaults timeout: @config.timeout,
5849
+ metadata: @config.metadata,
5850
+ retry_policy: @config.retry_policy
5851
+
5852
+ @network_services_stub.delete_agent_gateway request, options do |result, operation|
5853
+ result = ::Gapic::Operation.new result, @operations_client, options: options
5854
+ yield result, operation if block_given?
5855
+ throw :response, result
5856
+ end
5857
+ rescue ::Gapic::Rest::Error => e
5858
+ raise ::Google::Cloud::Error.from_error(e)
5859
+ end
5860
+
5408
5861
  ##
5409
5862
  # Configuration class for the NetworkServices REST API.
5410
5863
  #
@@ -5475,6 +5928,7 @@ module Google
5475
5928
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5476
5929
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5477
5930
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
5931
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5478
5932
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5479
5933
  # trigger a retry.
5480
5934
  # @return [::Hash]
@@ -5554,6 +6008,7 @@ module Google
5554
6008
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5555
6009
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5556
6010
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
6011
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5557
6012
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5558
6013
  # trigger a retry.
5559
6014
  #
@@ -5848,6 +6303,31 @@ module Google
5848
6303
  # @return [::Gapic::Config::Method]
5849
6304
  #
5850
6305
  attr_reader :list_mesh_route_views
6306
+ ##
6307
+ # RPC-specific configuration for `list_agent_gateways`
6308
+ # @return [::Gapic::Config::Method]
6309
+ #
6310
+ attr_reader :list_agent_gateways
6311
+ ##
6312
+ # RPC-specific configuration for `get_agent_gateway`
6313
+ # @return [::Gapic::Config::Method]
6314
+ #
6315
+ attr_reader :get_agent_gateway
6316
+ ##
6317
+ # RPC-specific configuration for `create_agent_gateway`
6318
+ # @return [::Gapic::Config::Method]
6319
+ #
6320
+ attr_reader :create_agent_gateway
6321
+ ##
6322
+ # RPC-specific configuration for `update_agent_gateway`
6323
+ # @return [::Gapic::Config::Method]
6324
+ #
6325
+ attr_reader :update_agent_gateway
6326
+ ##
6327
+ # RPC-specific configuration for `delete_agent_gateway`
6328
+ # @return [::Gapic::Config::Method]
6329
+ #
6330
+ attr_reader :delete_agent_gateway
5851
6331
 
5852
6332
  # @private
5853
6333
  def initialize parent_rpcs = nil
@@ -5967,6 +6447,16 @@ module Google
5967
6447
  @list_gateway_route_views = ::Gapic::Config::Method.new list_gateway_route_views_config
5968
6448
  list_mesh_route_views_config = parent_rpcs.list_mesh_route_views if parent_rpcs.respond_to? :list_mesh_route_views
5969
6449
  @list_mesh_route_views = ::Gapic::Config::Method.new list_mesh_route_views_config
6450
+ list_agent_gateways_config = parent_rpcs.list_agent_gateways if parent_rpcs.respond_to? :list_agent_gateways
6451
+ @list_agent_gateways = ::Gapic::Config::Method.new list_agent_gateways_config
6452
+ get_agent_gateway_config = parent_rpcs.get_agent_gateway if parent_rpcs.respond_to? :get_agent_gateway
6453
+ @get_agent_gateway = ::Gapic::Config::Method.new get_agent_gateway_config
6454
+ create_agent_gateway_config = parent_rpcs.create_agent_gateway if parent_rpcs.respond_to? :create_agent_gateway
6455
+ @create_agent_gateway = ::Gapic::Config::Method.new create_agent_gateway_config
6456
+ update_agent_gateway_config = parent_rpcs.update_agent_gateway if parent_rpcs.respond_to? :update_agent_gateway
6457
+ @update_agent_gateway = ::Gapic::Config::Method.new update_agent_gateway_config
6458
+ delete_agent_gateway_config = parent_rpcs.delete_agent_gateway if parent_rpcs.respond_to? :delete_agent_gateway
6459
+ @delete_agent_gateway = ::Gapic::Config::Method.new delete_agent_gateway_config
5970
6460
 
5971
6461
  yield self if block_given?
5972
6462
  end