google-cloud-network_services-v1 2.10.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 (27) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/network_services/v1/network_services/client.rb +549 -26
  3. data/lib/google/cloud/network_services/v1/network_services/paths.rb +38 -0
  4. data/lib/google/cloud/network_services/v1/network_services/rest/client.rb +514 -26
  5. data/lib/google/cloud/network_services/v1/network_services/rest/service_stub.rb +307 -0
  6. data/lib/google/cloud/network_services/v1/version.rb +1 -1
  7. data/lib/google/cloud/networkservices/v1/agent_gateway_pb.rb +41 -0
  8. data/lib/google/cloud/networkservices/v1/dep_pb.rb +2 -1
  9. data/lib/google/cloud/networkservices/v1/gateway_pb.rb +1 -1
  10. data/lib/google/cloud/networkservices/v1/http_route_pb.rb +2 -1
  11. data/lib/google/cloud/networkservices/v1/mesh_pb.rb +1 -1
  12. data/lib/google/cloud/networkservices/v1/network_services_pb.rb +2 -1
  13. data/lib/google/cloud/networkservices/v1/network_services_services_pb.rb +10 -0
  14. data/lib/google/cloud/networkservices/v1/service_binding_pb.rb +2 -1
  15. data/lib/google/cloud/networkservices/v1/tls_route_pb.rb +1 -1
  16. data/proto_docs/google/cloud/networkservices/v1/agent_gateway.rb +302 -0
  17. data/proto_docs/google/cloud/networkservices/v1/common.rb +4 -4
  18. data/proto_docs/google/cloud/networkservices/v1/dep.rb +110 -7
  19. data/proto_docs/google/cloud/networkservices/v1/endpoint_policy.rb +5 -5
  20. data/proto_docs/google/cloud/networkservices/v1/extensibility.rb +90 -33
  21. data/proto_docs/google/cloud/networkservices/v1/gateway.rb +11 -1
  22. data/proto_docs/google/cloud/networkservices/v1/grpc_route.rb +7 -7
  23. data/proto_docs/google/cloud/networkservices/v1/http_route.rb +13 -7
  24. data/proto_docs/google/cloud/networkservices/v1/mesh.rb +5 -5
  25. data/proto_docs/google/cloud/networkservices/v1/tcp_route.rb +7 -7
  26. data/proto_docs/google/cloud/networkservices/v1/tls_route.rb +15 -7
  27. metadata +3 -1
@@ -251,7 +251,7 @@ module Google
251
251
  #
252
252
  # @param parent [::String]
253
253
  # Required. The project and location from which the EndpointPolicies should
254
- # be listed, specified in the format `projects/*/locations/global`.
254
+ # be listed, specified in the format `projects/*/locations/*`.
255
255
  # @param page_size [::Integer]
256
256
  # Maximum number of EndpointPolicies to return per call.
257
257
  # @param page_token [::String]
@@ -354,7 +354,7 @@ module Google
354
354
  #
355
355
  # @param name [::String]
356
356
  # Required. A name of the EndpointPolicy to get. Must be in the format
357
- # `projects/*/locations/global/endpointPolicies/*`.
357
+ # `projects/*/locations/*/endpointPolicies/*`.
358
358
  #
359
359
  # @yield [response, operation] Access the result along with the RPC operation
360
360
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::EndpointPolicy]
@@ -440,7 +440,7 @@ module Google
440
440
  #
441
441
  # @param parent [::String]
442
442
  # Required. The parent resource of the EndpointPolicy. Must be in the
443
- # format `projects/*/locations/global`.
443
+ # format `projects/*/locations/*`.
444
444
  # @param endpoint_policy_id [::String]
445
445
  # Required. Short name of the EndpointPolicy resource to be created.
446
446
  # E.g. "CustomECS".
@@ -640,7 +640,7 @@ module Google
640
640
  #
641
641
  # @param name [::String]
642
642
  # Required. A name of the EndpointPolicy to delete. Must be in the format
643
- # `projects/*/locations/global/endpointPolicies/*`.
643
+ # `projects/*/locations/*/endpointPolicies/*`.
644
644
  #
645
645
  # @yield [response, operation] Access the result along with the RPC operation
646
646
  # @yieldparam response [::Gapic::Operation]
@@ -2094,7 +2094,7 @@ module Google
2094
2094
  #
2095
2095
  # @param parent [::String]
2096
2096
  # Required. The project and location from which the GrpcRoutes should be
2097
- # listed, specified in the format `projects/*/locations/global`.
2097
+ # listed, specified in the format `projects/*/locations/*`.
2098
2098
  # @param page_size [::Integer]
2099
2099
  # Maximum number of GrpcRoutes to return per call.
2100
2100
  # @param page_token [::String]
@@ -2196,7 +2196,7 @@ module Google
2196
2196
  #
2197
2197
  # @param name [::String]
2198
2198
  # Required. A name of the GrpcRoute to get. Must be in the format
2199
- # `projects/*/locations/global/grpcRoutes/*`.
2199
+ # `projects/*/locations/*/grpcRoutes/*`.
2200
2200
  #
2201
2201
  # @yield [response, operation] Access the result along with the RPC operation
2202
2202
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::GrpcRoute]
@@ -2282,7 +2282,7 @@ module Google
2282
2282
  #
2283
2283
  # @param parent [::String]
2284
2284
  # Required. The parent resource of the GrpcRoute. Must be in the
2285
- # format `projects/*/locations/global`.
2285
+ # format `projects/*/locations/*`.
2286
2286
  # @param grpc_route_id [::String]
2287
2287
  # Required. Short name of the GrpcRoute resource to be created.
2288
2288
  # @param grpc_route [::Google::Cloud::NetworkServices::V1::GrpcRoute, ::Hash]
@@ -2481,7 +2481,7 @@ module Google
2481
2481
  #
2482
2482
  # @param name [::String]
2483
2483
  # Required. A name of the GrpcRoute to delete. Must be in the format
2484
- # `projects/*/locations/global/grpcRoutes/*`.
2484
+ # `projects/*/locations/*/grpcRoutes/*`.
2485
2485
  #
2486
2486
  # @yield [response, operation] Access the result along with the RPC operation
2487
2487
  # @yieldparam response [::Gapic::Operation]
@@ -2569,14 +2569,14 @@ module Google
2569
2569
  # @param options [::Gapic::CallOptions, ::Hash]
2570
2570
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2571
2571
  #
2572
- # @overload list_http_routes(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil)
2572
+ # @overload list_http_routes(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil, filter: nil)
2573
2573
  # Pass arguments to `list_http_routes` via keyword arguments. Note that at
2574
2574
  # least one keyword argument is required. To specify no parameters, or to keep all
2575
2575
  # the default parameter values, pass an empty Hash as a request object (see above).
2576
2576
  #
2577
2577
  # @param parent [::String]
2578
2578
  # Required. The project and location from which the HttpRoutes should be
2579
- # listed, specified in the format `projects/*/locations/global`.
2579
+ # listed, specified in the format `projects/*/locations/*`.
2580
2580
  # @param page_size [::Integer]
2581
2581
  # Maximum number of HttpRoutes to return per call.
2582
2582
  # @param page_token [::String]
@@ -2587,6 +2587,8 @@ module Google
2587
2587
  # Optional. If true, allow partial responses for multi-regional Aggregated
2588
2588
  # List requests. Otherwise if one of the locations is down or unreachable,
2589
2589
  # the Aggregated List request will fail.
2590
+ # @param filter [::String]
2591
+ # Optional. Filter expression to restrict the list.
2590
2592
  #
2591
2593
  # @yield [response, operation] Access the result along with the RPC operation
2592
2594
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::HttpRoute>]
@@ -2678,7 +2680,7 @@ module Google
2678
2680
  #
2679
2681
  # @param name [::String]
2680
2682
  # Required. A name of the HttpRoute to get. Must be in the format
2681
- # `projects/*/locations/global/httpRoutes/*`.
2683
+ # `projects/*/locations/*/httpRoutes/*`.
2682
2684
  #
2683
2685
  # @yield [response, operation] Access the result along with the RPC operation
2684
2686
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::HttpRoute]
@@ -2757,18 +2759,20 @@ module Google
2757
2759
  # @param options [::Gapic::CallOptions, ::Hash]
2758
2760
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2759
2761
  #
2760
- # @overload create_http_route(parent: nil, http_route_id: nil, http_route: nil)
2762
+ # @overload create_http_route(parent: nil, http_route_id: nil, http_route: nil, request_id: nil)
2761
2763
  # Pass arguments to `create_http_route` via keyword arguments. Note that at
2762
2764
  # least one keyword argument is required. To specify no parameters, or to keep all
2763
2765
  # the default parameter values, pass an empty Hash as a request object (see above).
2764
2766
  #
2765
2767
  # @param parent [::String]
2766
2768
  # Required. The parent resource of the HttpRoute. Must be in the
2767
- # format `projects/*/locations/global`.
2769
+ # format `projects/*/locations/*`.
2768
2770
  # @param http_route_id [::String]
2769
2771
  # Required. Short name of the HttpRoute resource to be created.
2770
2772
  # @param http_route [::Google::Cloud::NetworkServices::V1::HttpRoute, ::Hash]
2771
2773
  # Required. HttpRoute resource to be created.
2774
+ # @param request_id [::String]
2775
+ # Optional. Idempotent request UUID.
2772
2776
  #
2773
2777
  # @yield [response, operation] Access the result along with the RPC operation
2774
2778
  # @yieldparam response [::Gapic::Operation]
@@ -2963,7 +2967,7 @@ module Google
2963
2967
  #
2964
2968
  # @param name [::String]
2965
2969
  # Required. A name of the HttpRoute to delete. Must be in the format
2966
- # `projects/*/locations/global/httpRoutes/*`.
2970
+ # `projects/*/locations/*/httpRoutes/*`.
2967
2971
  #
2968
2972
  # @yield [response, operation] Access the result along with the RPC operation
2969
2973
  # @yieldparam response [::Gapic::Operation]
@@ -3058,7 +3062,7 @@ module Google
3058
3062
  #
3059
3063
  # @param parent [::String]
3060
3064
  # Required. The project and location from which the TcpRoutes should be
3061
- # listed, specified in the format `projects/*/locations/global`.
3065
+ # listed, specified in the format `projects/*/locations/*`.
3062
3066
  # @param page_size [::Integer]
3063
3067
  # Maximum number of TcpRoutes to return per call.
3064
3068
  # @param page_token [::String]
@@ -3160,7 +3164,7 @@ module Google
3160
3164
  #
3161
3165
  # @param name [::String]
3162
3166
  # Required. A name of the TcpRoute to get. Must be in the format
3163
- # `projects/*/locations/global/tcpRoutes/*`.
3167
+ # `projects/*/locations/*/tcpRoutes/*`.
3164
3168
  #
3165
3169
  # @yield [response, operation] Access the result along with the RPC operation
3166
3170
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::TcpRoute]
@@ -3246,7 +3250,7 @@ module Google
3246
3250
  #
3247
3251
  # @param parent [::String]
3248
3252
  # Required. The parent resource of the TcpRoute. Must be in the
3249
- # format `projects/*/locations/global`.
3253
+ # format `projects/*/locations/*`.
3250
3254
  # @param tcp_route_id [::String]
3251
3255
  # Required. Short name of the TcpRoute resource to be created.
3252
3256
  # @param tcp_route [::Google::Cloud::NetworkServices::V1::TcpRoute, ::Hash]
@@ -3445,7 +3449,7 @@ module Google
3445
3449
  #
3446
3450
  # @param name [::String]
3447
3451
  # Required. A name of the TcpRoute to delete. Must be in the format
3448
- # `projects/*/locations/global/tcpRoutes/*`.
3452
+ # `projects/*/locations/*/tcpRoutes/*`.
3449
3453
  #
3450
3454
  # @yield [response, operation] Access the result along with the RPC operation
3451
3455
  # @yieldparam response [::Gapic::Operation]
@@ -3540,7 +3544,7 @@ module Google
3540
3544
  #
3541
3545
  # @param parent [::String]
3542
3546
  # Required. The project and location from which the TlsRoutes should be
3543
- # listed, specified in the format `projects/*/locations/global`.
3547
+ # listed, specified in the format `projects/*/locations/*`.
3544
3548
  # @param page_size [::Integer]
3545
3549
  # Maximum number of TlsRoutes to return per call.
3546
3550
  # @param page_token [::String]
@@ -3642,7 +3646,7 @@ module Google
3642
3646
  #
3643
3647
  # @param name [::String]
3644
3648
  # Required. A name of the TlsRoute to get. Must be in the format
3645
- # `projects/*/locations/global/tlsRoutes/*`.
3649
+ # `projects/*/locations/*/tlsRoutes/*`.
3646
3650
  #
3647
3651
  # @yield [response, operation] Access the result along with the RPC operation
3648
3652
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::TlsRoute]
@@ -3728,7 +3732,7 @@ module Google
3728
3732
  #
3729
3733
  # @param parent [::String]
3730
3734
  # Required. The parent resource of the TlsRoute. Must be in the
3731
- # format `projects/*/locations/global`.
3735
+ # format `projects/*/locations/*`.
3732
3736
  # @param tls_route_id [::String]
3733
3737
  # Required. Short name of the TlsRoute resource to be created.
3734
3738
  # @param tls_route [::Google::Cloud::NetworkServices::V1::TlsRoute, ::Hash]
@@ -3927,7 +3931,7 @@ module Google
3927
3931
  #
3928
3932
  # @param name [::String]
3929
3933
  # Required. A name of the TlsRoute to delete. Must be in the format
3930
- # `projects/*/locations/global/tlsRoutes/*`.
3934
+ # `projects/*/locations/*/tlsRoutes/*`.
3931
3935
  #
3932
3936
  # @yield [response, operation] Access the result along with the RPC operation
3933
3937
  # @yieldparam response [::Gapic::Operation]
@@ -4500,7 +4504,7 @@ module Google
4500
4504
  #
4501
4505
  # @param parent [::String]
4502
4506
  # Required. The project and location from which the Meshes should be
4503
- # listed, specified in the format `projects/*/locations/global`.
4507
+ # listed, specified in the format `projects/*/locations/*`.
4504
4508
  # @param page_size [::Integer]
4505
4509
  # Maximum number of Meshes to return per call.
4506
4510
  # @param page_token [::String]
@@ -4602,7 +4606,7 @@ module Google
4602
4606
  #
4603
4607
  # @param name [::String]
4604
4608
  # Required. A name of the Mesh to get. Must be in the format
4605
- # `projects/*/locations/global/meshes/*`.
4609
+ # `projects/*/locations/*/meshes/*`.
4606
4610
  #
4607
4611
  # @yield [response, operation] Access the result along with the RPC operation
4608
4612
  # @yieldparam response [::Google::Cloud::NetworkServices::V1::Mesh]
@@ -4688,7 +4692,7 @@ module Google
4688
4692
  #
4689
4693
  # @param parent [::String]
4690
4694
  # Required. The parent resource of the Mesh. Must be in the
4691
- # format `projects/*/locations/global`.
4695
+ # format `projects/*/locations/*`.
4692
4696
  # @param mesh_id [::String]
4693
4697
  # Required. Short name of the Mesh resource to be created.
4694
4698
  # @param mesh [::Google::Cloud::NetworkServices::V1::Mesh, ::Hash]
@@ -4887,7 +4891,7 @@ module Google
4887
4891
  #
4888
4892
  # @param name [::String]
4889
4893
  # Required. A name of the Mesh to delete. Must be in the format
4890
- # `projects/*/locations/global/meshes/*`.
4894
+ # `projects/*/locations/*/meshes/*`.
4891
4895
  #
4892
4896
  # @yield [response, operation] Access the result along with the RPC operation
4893
4897
  # @yieldparam response [::Gapic::Operation]
@@ -5816,6 +5820,490 @@ module Google
5816
5820
  raise ::Google::Cloud::Error.from_error(e)
5817
5821
  end
5818
5822
 
5823
+ ##
5824
+ # Lists AgentGateways in a given project and location.
5825
+ #
5826
+ # @overload list_agent_gateways(request, options = nil)
5827
+ # Pass arguments to `list_agent_gateways` via a request object, either of type
5828
+ # {::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest} or an equivalent Hash.
5829
+ #
5830
+ # @param request [::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest, ::Hash]
5831
+ # A request object representing the call parameters. Required. To specify no
5832
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5833
+ # @param options [::Gapic::CallOptions, ::Hash]
5834
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
5835
+ #
5836
+ # @overload list_agent_gateways(parent: nil, page_size: nil, page_token: nil, return_partial_success: nil)
5837
+ # Pass arguments to `list_agent_gateways` via keyword arguments. Note that at
5838
+ # least one keyword argument is required. To specify no parameters, or to keep all
5839
+ # the default parameter values, pass an empty Hash as a request object (see above).
5840
+ #
5841
+ # @param parent [::String]
5842
+ # Required. The project and location from which the AgentGateways should be
5843
+ # listed, specified in the format `projects/*/locations/*`.
5844
+ # @param page_size [::Integer]
5845
+ # Optional. Maximum number of AgentGateways to return per call.
5846
+ # @param page_token [::String]
5847
+ # Optional. The value returned by the last `ListAgentGatewaysResponse`
5848
+ # Indicates that this is a continuation of a prior `ListAgentGateways`
5849
+ # call, and that the system should return the next page of data.
5850
+ # @param return_partial_success [::Boolean]
5851
+ # Optional. If true, allow partial responses for multi-regional Aggregated
5852
+ # List requests. Otherwise if one of the locations is down or unreachable,
5853
+ # the Aggregated List request will fail.
5854
+ #
5855
+ # @yield [response, operation] Access the result along with the RPC operation
5856
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AgentGateway>]
5857
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
5858
+ #
5859
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::NetworkServices::V1::AgentGateway>]
5860
+ #
5861
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
5862
+ #
5863
+ # @example Basic example
5864
+ # require "google/cloud/network_services/v1"
5865
+ #
5866
+ # # Create a client object. The client can be reused for multiple calls.
5867
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Client.new
5868
+ #
5869
+ # # Create a request. To set request fields, pass in keyword arguments.
5870
+ # request = Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest.new
5871
+ #
5872
+ # # Call the list_agent_gateways method.
5873
+ # result = client.list_agent_gateways request
5874
+ #
5875
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5876
+ # # over elements, and API calls will be issued to fetch pages as needed.
5877
+ # result.each do |item|
5878
+ # # Each element is of type ::Google::Cloud::NetworkServices::V1::AgentGateway.
5879
+ # p item
5880
+ # end
5881
+ #
5882
+ def list_agent_gateways request, options = nil
5883
+ raise ::ArgumentError, "request must be provided" if request.nil?
5884
+
5885
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::ListAgentGatewaysRequest
5886
+
5887
+ # Converts hash and nil to an options object
5888
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5889
+
5890
+ # Customize the options with defaults
5891
+ metadata = @config.rpcs.list_agent_gateways.metadata.to_h
5892
+
5893
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5894
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5895
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5896
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
5897
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5898
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5899
+
5900
+ header_params = {}
5901
+ if request.parent
5902
+ header_params["parent"] = request.parent
5903
+ end
5904
+
5905
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
5906
+ metadata[:"x-goog-request-params"] ||= request_params_header
5907
+
5908
+ options.apply_defaults timeout: @config.rpcs.list_agent_gateways.timeout,
5909
+ metadata: metadata,
5910
+ retry_policy: @config.rpcs.list_agent_gateways.retry_policy
5911
+
5912
+ options.apply_defaults timeout: @config.timeout,
5913
+ metadata: @config.metadata,
5914
+ retry_policy: @config.retry_policy
5915
+
5916
+ @network_services_stub.call_rpc :list_agent_gateways, request, options: options do |response, operation|
5917
+ response = ::Gapic::PagedEnumerable.new @network_services_stub, :list_agent_gateways, request, response, operation, options
5918
+ yield response, operation if block_given?
5919
+ throw :response, response
5920
+ end
5921
+ rescue ::GRPC::BadStatus => e
5922
+ raise ::Google::Cloud::Error.from_error(e)
5923
+ end
5924
+
5925
+ ##
5926
+ # Gets details of a single AgentGateway.
5927
+ #
5928
+ # @overload get_agent_gateway(request, options = nil)
5929
+ # Pass arguments to `get_agent_gateway` via a request object, either of type
5930
+ # {::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest} or an equivalent Hash.
5931
+ #
5932
+ # @param request [::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest, ::Hash]
5933
+ # A request object representing the call parameters. Required. To specify no
5934
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5935
+ # @param options [::Gapic::CallOptions, ::Hash]
5936
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
5937
+ #
5938
+ # @overload get_agent_gateway(name: nil)
5939
+ # Pass arguments to `get_agent_gateway` via keyword arguments. Note that at
5940
+ # least one keyword argument is required. To specify no parameters, or to keep all
5941
+ # the default parameter values, pass an empty Hash as a request object (see above).
5942
+ #
5943
+ # @param name [::String]
5944
+ # Required. A name of the AgentGateway to get. Must be in the format
5945
+ # `projects/*/locations/*/agentGateways/*`.
5946
+ #
5947
+ # @yield [response, operation] Access the result along with the RPC operation
5948
+ # @yieldparam response [::Google::Cloud::NetworkServices::V1::AgentGateway]
5949
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
5950
+ #
5951
+ # @return [::Google::Cloud::NetworkServices::V1::AgentGateway]
5952
+ #
5953
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
5954
+ #
5955
+ # @example Basic example
5956
+ # require "google/cloud/network_services/v1"
5957
+ #
5958
+ # # Create a client object. The client can be reused for multiple calls.
5959
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Client.new
5960
+ #
5961
+ # # Create a request. To set request fields, pass in keyword arguments.
5962
+ # request = Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest.new
5963
+ #
5964
+ # # Call the get_agent_gateway method.
5965
+ # result = client.get_agent_gateway request
5966
+ #
5967
+ # # The returned object is of type Google::Cloud::NetworkServices::V1::AgentGateway.
5968
+ # p result
5969
+ #
5970
+ def get_agent_gateway request, options = nil
5971
+ raise ::ArgumentError, "request must be provided" if request.nil?
5972
+
5973
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::GetAgentGatewayRequest
5974
+
5975
+ # Converts hash and nil to an options object
5976
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5977
+
5978
+ # Customize the options with defaults
5979
+ metadata = @config.rpcs.get_agent_gateway.metadata.to_h
5980
+
5981
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5982
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5983
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5984
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
5985
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5986
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5987
+
5988
+ header_params = {}
5989
+ if request.name
5990
+ header_params["name"] = request.name
5991
+ end
5992
+
5993
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
5994
+ metadata[:"x-goog-request-params"] ||= request_params_header
5995
+
5996
+ options.apply_defaults timeout: @config.rpcs.get_agent_gateway.timeout,
5997
+ metadata: metadata,
5998
+ retry_policy: @config.rpcs.get_agent_gateway.retry_policy
5999
+
6000
+ options.apply_defaults timeout: @config.timeout,
6001
+ metadata: @config.metadata,
6002
+ retry_policy: @config.retry_policy
6003
+
6004
+ @network_services_stub.call_rpc :get_agent_gateway, request, options: options do |response, operation|
6005
+ yield response, operation if block_given?
6006
+ end
6007
+ rescue ::GRPC::BadStatus => e
6008
+ raise ::Google::Cloud::Error.from_error(e)
6009
+ end
6010
+
6011
+ ##
6012
+ # Creates a new AgentGateway in a given project and location.
6013
+ #
6014
+ # @overload create_agent_gateway(request, options = nil)
6015
+ # Pass arguments to `create_agent_gateway` via a request object, either of type
6016
+ # {::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest} or an equivalent Hash.
6017
+ #
6018
+ # @param request [::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest, ::Hash]
6019
+ # A request object representing the call parameters. Required. To specify no
6020
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6021
+ # @param options [::Gapic::CallOptions, ::Hash]
6022
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
6023
+ #
6024
+ # @overload create_agent_gateway(parent: nil, agent_gateway_id: nil, agent_gateway: nil)
6025
+ # Pass arguments to `create_agent_gateway` via keyword arguments. Note that at
6026
+ # least one keyword argument is required. To specify no parameters, or to keep all
6027
+ # the default parameter values, pass an empty Hash as a request object (see above).
6028
+ #
6029
+ # @param parent [::String]
6030
+ # Required. The parent resource of the AgentGateway. Must be in the
6031
+ # format `projects/*/locations/*`.
6032
+ # @param agent_gateway_id [::String]
6033
+ # Required. Short name of the AgentGateway resource to be created.
6034
+ # @param agent_gateway [::Google::Cloud::NetworkServices::V1::AgentGateway, ::Hash]
6035
+ # Required. AgentGateway resource to be created.
6036
+ #
6037
+ # @yield [response, operation] Access the result along with the RPC operation
6038
+ # @yieldparam response [::Gapic::Operation]
6039
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
6040
+ #
6041
+ # @return [::Gapic::Operation]
6042
+ #
6043
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
6044
+ #
6045
+ # @example Basic example
6046
+ # require "google/cloud/network_services/v1"
6047
+ #
6048
+ # # Create a client object. The client can be reused for multiple calls.
6049
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Client.new
6050
+ #
6051
+ # # Create a request. To set request fields, pass in keyword arguments.
6052
+ # request = Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest.new
6053
+ #
6054
+ # # Call the create_agent_gateway method.
6055
+ # result = client.create_agent_gateway request
6056
+ #
6057
+ # # The returned object is of type Gapic::Operation. You can use it to
6058
+ # # check the status of an operation, cancel it, or wait for results.
6059
+ # # Here is how to wait for a response.
6060
+ # result.wait_until_done! timeout: 60
6061
+ # if result.response?
6062
+ # p result.response
6063
+ # else
6064
+ # puts "No response received."
6065
+ # end
6066
+ #
6067
+ def create_agent_gateway request, options = nil
6068
+ raise ::ArgumentError, "request must be provided" if request.nil?
6069
+
6070
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::CreateAgentGatewayRequest
6071
+
6072
+ # Converts hash and nil to an options object
6073
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6074
+
6075
+ # Customize the options with defaults
6076
+ metadata = @config.rpcs.create_agent_gateway.metadata.to_h
6077
+
6078
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6079
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6080
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6081
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
6082
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6083
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6084
+
6085
+ header_params = {}
6086
+ if request.parent
6087
+ header_params["parent"] = request.parent
6088
+ end
6089
+
6090
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
6091
+ metadata[:"x-goog-request-params"] ||= request_params_header
6092
+
6093
+ options.apply_defaults timeout: @config.rpcs.create_agent_gateway.timeout,
6094
+ metadata: metadata,
6095
+ retry_policy: @config.rpcs.create_agent_gateway.retry_policy
6096
+
6097
+ options.apply_defaults timeout: @config.timeout,
6098
+ metadata: @config.metadata,
6099
+ retry_policy: @config.retry_policy
6100
+
6101
+ @network_services_stub.call_rpc :create_agent_gateway, request, options: options do |response, operation|
6102
+ response = ::Gapic::Operation.new response, @operations_client, options: options
6103
+ yield response, operation if block_given?
6104
+ throw :response, response
6105
+ end
6106
+ rescue ::GRPC::BadStatus => e
6107
+ raise ::Google::Cloud::Error.from_error(e)
6108
+ end
6109
+
6110
+ ##
6111
+ # Updates the parameters of a single AgentGateway.
6112
+ #
6113
+ # @overload update_agent_gateway(request, options = nil)
6114
+ # Pass arguments to `update_agent_gateway` via a request object, either of type
6115
+ # {::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest} or an equivalent Hash.
6116
+ #
6117
+ # @param request [::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest, ::Hash]
6118
+ # A request object representing the call parameters. Required. To specify no
6119
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6120
+ # @param options [::Gapic::CallOptions, ::Hash]
6121
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
6122
+ #
6123
+ # @overload update_agent_gateway(update_mask: nil, agent_gateway: nil)
6124
+ # Pass arguments to `update_agent_gateway` via keyword arguments. Note that at
6125
+ # least one keyword argument is required. To specify no parameters, or to keep all
6126
+ # the default parameter values, pass an empty Hash as a request object (see above).
6127
+ #
6128
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
6129
+ # Optional. Field mask is used to specify the fields to be overwritten in the
6130
+ # AgentGateway resource by the update.
6131
+ # The fields specified in the update_mask are relative to the resource, not
6132
+ # the full request. A field will be overwritten if it is in the mask. If the
6133
+ # user does not provide a mask then all fields will be overwritten.
6134
+ # @param agent_gateway [::Google::Cloud::NetworkServices::V1::AgentGateway, ::Hash]
6135
+ # Required. Updated AgentGateway resource.
6136
+ #
6137
+ # @yield [response, operation] Access the result along with the RPC operation
6138
+ # @yieldparam response [::Gapic::Operation]
6139
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
6140
+ #
6141
+ # @return [::Gapic::Operation]
6142
+ #
6143
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
6144
+ #
6145
+ # @example Basic example
6146
+ # require "google/cloud/network_services/v1"
6147
+ #
6148
+ # # Create a client object. The client can be reused for multiple calls.
6149
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Client.new
6150
+ #
6151
+ # # Create a request. To set request fields, pass in keyword arguments.
6152
+ # request = Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest.new
6153
+ #
6154
+ # # Call the update_agent_gateway method.
6155
+ # result = client.update_agent_gateway request
6156
+ #
6157
+ # # The returned object is of type Gapic::Operation. You can use it to
6158
+ # # check the status of an operation, cancel it, or wait for results.
6159
+ # # Here is how to wait for a response.
6160
+ # result.wait_until_done! timeout: 60
6161
+ # if result.response?
6162
+ # p result.response
6163
+ # else
6164
+ # puts "No response received."
6165
+ # end
6166
+ #
6167
+ def update_agent_gateway request, options = nil
6168
+ raise ::ArgumentError, "request must be provided" if request.nil?
6169
+
6170
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::UpdateAgentGatewayRequest
6171
+
6172
+ # Converts hash and nil to an options object
6173
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6174
+
6175
+ # Customize the options with defaults
6176
+ metadata = @config.rpcs.update_agent_gateway.metadata.to_h
6177
+
6178
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6179
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6180
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6181
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
6182
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6183
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6184
+
6185
+ header_params = {}
6186
+ if request.agent_gateway&.name
6187
+ header_params["agent_gateway.name"] = request.agent_gateway.name
6188
+ end
6189
+
6190
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
6191
+ metadata[:"x-goog-request-params"] ||= request_params_header
6192
+
6193
+ options.apply_defaults timeout: @config.rpcs.update_agent_gateway.timeout,
6194
+ metadata: metadata,
6195
+ retry_policy: @config.rpcs.update_agent_gateway.retry_policy
6196
+
6197
+ options.apply_defaults timeout: @config.timeout,
6198
+ metadata: @config.metadata,
6199
+ retry_policy: @config.retry_policy
6200
+
6201
+ @network_services_stub.call_rpc :update_agent_gateway, request, options: options do |response, operation|
6202
+ response = ::Gapic::Operation.new response, @operations_client, options: options
6203
+ yield response, operation if block_given?
6204
+ throw :response, response
6205
+ end
6206
+ rescue ::GRPC::BadStatus => e
6207
+ raise ::Google::Cloud::Error.from_error(e)
6208
+ end
6209
+
6210
+ ##
6211
+ # Deletes a single AgentGateway.
6212
+ #
6213
+ # @overload delete_agent_gateway(request, options = nil)
6214
+ # Pass arguments to `delete_agent_gateway` via a request object, either of type
6215
+ # {::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest} or an equivalent Hash.
6216
+ #
6217
+ # @param request [::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest, ::Hash]
6218
+ # A request object representing the call parameters. Required. To specify no
6219
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6220
+ # @param options [::Gapic::CallOptions, ::Hash]
6221
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
6222
+ #
6223
+ # @overload delete_agent_gateway(name: nil, etag: nil)
6224
+ # Pass arguments to `delete_agent_gateway` via keyword arguments. Note that at
6225
+ # least one keyword argument is required. To specify no parameters, or to keep all
6226
+ # the default parameter values, pass an empty Hash as a request object (see above).
6227
+ #
6228
+ # @param name [::String]
6229
+ # Required. A name of the AgentGateway to delete. Must be in the format
6230
+ # `projects/*/locations/*/agentGateways/*`.
6231
+ # @param etag [::String]
6232
+ # Optional. The etag of the AgentGateway to delete.
6233
+ #
6234
+ # @yield [response, operation] Access the result along with the RPC operation
6235
+ # @yieldparam response [::Gapic::Operation]
6236
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
6237
+ #
6238
+ # @return [::Gapic::Operation]
6239
+ #
6240
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
6241
+ #
6242
+ # @example Basic example
6243
+ # require "google/cloud/network_services/v1"
6244
+ #
6245
+ # # Create a client object. The client can be reused for multiple calls.
6246
+ # client = Google::Cloud::NetworkServices::V1::NetworkServices::Client.new
6247
+ #
6248
+ # # Create a request. To set request fields, pass in keyword arguments.
6249
+ # request = Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest.new
6250
+ #
6251
+ # # Call the delete_agent_gateway method.
6252
+ # result = client.delete_agent_gateway request
6253
+ #
6254
+ # # The returned object is of type Gapic::Operation. You can use it to
6255
+ # # check the status of an operation, cancel it, or wait for results.
6256
+ # # Here is how to wait for a response.
6257
+ # result.wait_until_done! timeout: 60
6258
+ # if result.response?
6259
+ # p result.response
6260
+ # else
6261
+ # puts "No response received."
6262
+ # end
6263
+ #
6264
+ def delete_agent_gateway request, options = nil
6265
+ raise ::ArgumentError, "request must be provided" if request.nil?
6266
+
6267
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetworkServices::V1::DeleteAgentGatewayRequest
6268
+
6269
+ # Converts hash and nil to an options object
6270
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6271
+
6272
+ # Customize the options with defaults
6273
+ metadata = @config.rpcs.delete_agent_gateway.metadata.to_h
6274
+
6275
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6276
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6277
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6278
+ gapic_version: ::Google::Cloud::NetworkServices::V1::VERSION
6279
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6280
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6281
+
6282
+ header_params = {}
6283
+ if request.name
6284
+ header_params["name"] = request.name
6285
+ end
6286
+
6287
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
6288
+ metadata[:"x-goog-request-params"] ||= request_params_header
6289
+
6290
+ options.apply_defaults timeout: @config.rpcs.delete_agent_gateway.timeout,
6291
+ metadata: metadata,
6292
+ retry_policy: @config.rpcs.delete_agent_gateway.retry_policy
6293
+
6294
+ options.apply_defaults timeout: @config.timeout,
6295
+ metadata: @config.metadata,
6296
+ retry_policy: @config.retry_policy
6297
+
6298
+ @network_services_stub.call_rpc :delete_agent_gateway, request, options: options do |response, operation|
6299
+ response = ::Gapic::Operation.new response, @operations_client, options: options
6300
+ yield response, operation if block_given?
6301
+ throw :response, response
6302
+ end
6303
+ rescue ::GRPC::BadStatus => e
6304
+ raise ::Google::Cloud::Error.from_error(e)
6305
+ end
6306
+
5819
6307
  ##
5820
6308
  # Configuration class for the NetworkServices API.
5821
6309
  #
@@ -6291,6 +6779,31 @@ module Google
6291
6779
  # @return [::Gapic::Config::Method]
6292
6780
  #
6293
6781
  attr_reader :list_mesh_route_views
6782
+ ##
6783
+ # RPC-specific configuration for `list_agent_gateways`
6784
+ # @return [::Gapic::Config::Method]
6785
+ #
6786
+ attr_reader :list_agent_gateways
6787
+ ##
6788
+ # RPC-specific configuration for `get_agent_gateway`
6789
+ # @return [::Gapic::Config::Method]
6790
+ #
6791
+ attr_reader :get_agent_gateway
6792
+ ##
6793
+ # RPC-specific configuration for `create_agent_gateway`
6794
+ # @return [::Gapic::Config::Method]
6795
+ #
6796
+ attr_reader :create_agent_gateway
6797
+ ##
6798
+ # RPC-specific configuration for `update_agent_gateway`
6799
+ # @return [::Gapic::Config::Method]
6800
+ #
6801
+ attr_reader :update_agent_gateway
6802
+ ##
6803
+ # RPC-specific configuration for `delete_agent_gateway`
6804
+ # @return [::Gapic::Config::Method]
6805
+ #
6806
+ attr_reader :delete_agent_gateway
6294
6807
 
6295
6808
  # @private
6296
6809
  def initialize parent_rpcs = nil
@@ -6410,6 +6923,16 @@ module Google
6410
6923
  @list_gateway_route_views = ::Gapic::Config::Method.new list_gateway_route_views_config
6411
6924
  list_mesh_route_views_config = parent_rpcs.list_mesh_route_views if parent_rpcs.respond_to? :list_mesh_route_views
6412
6925
  @list_mesh_route_views = ::Gapic::Config::Method.new list_mesh_route_views_config
6926
+ list_agent_gateways_config = parent_rpcs.list_agent_gateways if parent_rpcs.respond_to? :list_agent_gateways
6927
+ @list_agent_gateways = ::Gapic::Config::Method.new list_agent_gateways_config
6928
+ get_agent_gateway_config = parent_rpcs.get_agent_gateway if parent_rpcs.respond_to? :get_agent_gateway
6929
+ @get_agent_gateway = ::Gapic::Config::Method.new get_agent_gateway_config
6930
+ create_agent_gateway_config = parent_rpcs.create_agent_gateway if parent_rpcs.respond_to? :create_agent_gateway
6931
+ @create_agent_gateway = ::Gapic::Config::Method.new create_agent_gateway_config
6932
+ update_agent_gateway_config = parent_rpcs.update_agent_gateway if parent_rpcs.respond_to? :update_agent_gateway
6933
+ @update_agent_gateway = ::Gapic::Config::Method.new update_agent_gateway_config
6934
+ delete_agent_gateway_config = parent_rpcs.delete_agent_gateway if parent_rpcs.respond_to? :delete_agent_gateway
6935
+ @delete_agent_gateway = ::Gapic::Config::Method.new delete_agent_gateway_config
6413
6936
 
6414
6937
  yield self if block_given?
6415
6938
  end