google-cloud-network_services-v1 2.1.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.
Files changed (40) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/network_services/v1/dep_service/client.rb +579 -24
  3. data/lib/google/cloud/network_services/v1/dep_service/paths.rb +19 -0
  4. data/lib/google/cloud/network_services/v1/dep_service/rest/client.rb +544 -24
  5. data/lib/google/cloud/network_services/v1/dep_service/rest/service_stub.rb +307 -0
  6. data/lib/google/cloud/network_services/v1/network_services/client.rb +2816 -824
  7. data/lib/google/cloud/network_services/v1/network_services/paths.rb +215 -0
  8. data/lib/google/cloud/network_services/v1/network_services/rest/client.rb +2658 -799
  9. data/lib/google/cloud/network_services/v1/network_services/rest/service_stub.rb +1443 -278
  10. data/lib/google/cloud/network_services/v1/version.rb +1 -1
  11. data/lib/google/cloud/networkservices/v1/common_pb.rb +2 -1
  12. data/lib/google/cloud/networkservices/v1/dep_pb.rb +10 -2
  13. data/lib/google/cloud/networkservices/v1/dep_services_pb.rb +12 -0
  14. data/lib/google/cloud/networkservices/v1/endpoint_policy_pb.rb +1 -1
  15. data/lib/google/cloud/networkservices/v1/extensibility_pb.rb +66 -0
  16. data/lib/google/cloud/networkservices/v1/gateway_pb.rb +4 -1
  17. data/lib/google/cloud/networkservices/v1/grpc_route_pb.rb +2 -1
  18. data/lib/google/cloud/networkservices/v1/http_route_pb.rb +3 -1
  19. data/lib/google/cloud/networkservices/v1/mesh_pb.rb +2 -1
  20. data/lib/google/cloud/networkservices/v1/network_services_pb.rb +6 -1
  21. data/lib/google/cloud/networkservices/v1/network_services_services_pb.rb +42 -0
  22. data/lib/google/cloud/networkservices/v1/route_view_pb.rb +52 -0
  23. data/lib/google/cloud/networkservices/v1/service_binding_pb.rb +4 -1
  24. data/lib/google/cloud/networkservices/v1/service_lb_policy_pb.rb +58 -0
  25. data/lib/google/cloud/networkservices/v1/tcp_route_pb.rb +3 -1
  26. data/lib/google/cloud/networkservices/v1/tls_route_pb.rb +3 -1
  27. data/proto_docs/google/cloud/networkservices/v1/common.rb +18 -1
  28. data/proto_docs/google/cloud/networkservices/v1/dep.rb +376 -52
  29. data/proto_docs/google/cloud/networkservices/v1/endpoint_policy.rb +12 -1
  30. data/proto_docs/google/cloud/networkservices/v1/extensibility.rb +518 -0
  31. data/proto_docs/google/cloud/networkservices/v1/gateway.rb +96 -8
  32. data/proto_docs/google/cloud/networkservices/v1/grpc_route.rb +51 -7
  33. data/proto_docs/google/cloud/networkservices/v1/http_route.rb +86 -1
  34. data/proto_docs/google/cloud/networkservices/v1/mesh.rb +16 -1
  35. data/proto_docs/google/cloud/networkservices/v1/route_view.rb +168 -0
  36. data/proto_docs/google/cloud/networkservices/v1/service_binding.rb +47 -10
  37. data/proto_docs/google/cloud/networkservices/v1/service_lb_policy.rb +217 -0
  38. data/proto_docs/google/cloud/networkservices/v1/tcp_route.rb +23 -7
  39. data/proto_docs/google/cloud/networkservices/v1/tls_route.rb +35 -6
  40. metadata +8 -2
@@ -25,7 +25,7 @@ module Google
25
25
  # or Gateway resource is routed.
26
26
  # @!attribute [rw] name
27
27
  # @return [::String]
28
- # Required. Name of the GrpcRoute resource. It matches pattern
28
+ # Identifier. Name of the GrpcRoute resource. It matches pattern
29
29
  # `projects/*/locations/global/grpcRoutes/<grpc_route_name>`
30
30
  # @!attribute [r] self_link
31
31
  # @return [::String]
@@ -256,7 +256,30 @@ module Google
256
256
  end
257
257
  end
258
258
 
259
+ # The specification for cookie-based stateful session affinity where the
260
+ # date plane supplies a “session cookie” with the name "GSSA" which encodes
261
+ # a specific destination host and each request containing that cookie will
262
+ # be directed to that host as long as the destination host remains up and
263
+ # healthy.
264
+ #
265
+ # The gRPC proxyless mesh library or sidecar proxy will manage the session
266
+ # cookie but the client application code is responsible for copying the
267
+ # cookie from each RPC in the session to the next.
268
+ # @!attribute [rw] cookie_ttl
269
+ # @return [::Google::Protobuf::Duration]
270
+ # Required. The cookie TTL value for the Set-Cookie header generated by the
271
+ # data plane. The lifetime of the cookie may be set to a value from 0 to
272
+ # 86400 seconds (24 hours) inclusive.
273
+ #
274
+ # Set this to 0s to use a session cookie and disable cookie expiration.
275
+ class StatefulSessionAffinityPolicy
276
+ include ::Google::Protobuf::MessageExts
277
+ extend ::Google::Protobuf::MessageExts::ClassMethods
278
+ end
279
+
259
280
  # The specifications for retries.
281
+ # Specifies one or more conditions for which this retry rule applies. Valid
282
+ # values are:
260
283
  # @!attribute [rw] retry_conditions
261
284
  # @return [::Array<::String>]
262
285
  # - connect-failure: Router will retry on failures connecting to Backend
@@ -292,12 +315,12 @@ module Google
292
315
  # Backend Service(s) according to the weight field of these destinations.
293
316
  # @!attribute [rw] fault_injection_policy
294
317
  # @return [::Google::Cloud::NetworkServices::V1::GrpcRoute::FaultInjectionPolicy]
295
- # Optional. The specification for fault injection introduced into traffic to test the
296
- # resiliency of clients to destination service failure. As part of fault
297
- # injection, when clients send requests to a destination, delays can be
298
- # introduced on a percentage of requests before sending those requests to
299
- # the destination service. Similarly requests from clients can be aborted
300
- # by for a percentage of requests.
318
+ # Optional. The specification for fault injection introduced into traffic
319
+ # to test the resiliency of clients to destination service failure. As part
320
+ # of fault injection, when clients send requests to a destination, delays
321
+ # can be introduced on a percentage of requests before sending those
322
+ # requests to the destination service. Similarly requests from clients can
323
+ # be aborted by for a percentage of requests.
301
324
  #
302
325
  # timeout and retry_policy will be ignored by clients that are configured
303
326
  # with a fault_injection_policy
@@ -310,6 +333,16 @@ module Google
310
333
  # @!attribute [rw] retry_policy
311
334
  # @return [::Google::Cloud::NetworkServices::V1::GrpcRoute::RetryPolicy]
312
335
  # Optional. Specifies the retry policy associated with this route.
336
+ # @!attribute [rw] stateful_session_affinity
337
+ # @return [::Google::Cloud::NetworkServices::V1::GrpcRoute::StatefulSessionAffinityPolicy]
338
+ # Optional. Specifies cookie-based stateful session affinity.
339
+ # @!attribute [rw] idle_timeout
340
+ # @return [::Google::Protobuf::Duration]
341
+ # Optional. Specifies the idle timeout for the selected route. The idle
342
+ # timeout is defined as the period in which there are no bytes sent or
343
+ # received on either the upstream or downstream connection. If not set, the
344
+ # default idle timeout is 1 hour. If set to 0s, the timeout will be
345
+ # disabled.
313
346
  class RouteAction
314
347
  include ::Google::Protobuf::MessageExts
315
348
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -354,6 +387,11 @@ module Google
354
387
  # The value returned by the last `ListGrpcRoutesResponse`
355
388
  # Indicates that this is a continuation of a prior `ListGrpcRoutes` call,
356
389
  # and that the system should return the next page of data.
390
+ # @!attribute [rw] return_partial_success
391
+ # @return [::Boolean]
392
+ # Optional. If true, allow partial responses for multi-regional Aggregated
393
+ # List requests. Otherwise if one of the locations is down or unreachable,
394
+ # the Aggregated List request will fail.
357
395
  class ListGrpcRoutesRequest
358
396
  include ::Google::Protobuf::MessageExts
359
397
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -368,6 +406,12 @@ module Google
368
406
  # If there might be more results than those appearing in this response, then
369
407
  # `next_page_token` is included. To get the next set of results, call this
370
408
  # method again using the value of `next_page_token` as `page_token`.
409
+ # @!attribute [rw] unreachable
410
+ # @return [::Array<::String>]
411
+ # Unreachable resources. Populated when the request opts into
412
+ # {::Google::Cloud::NetworkServices::V1::ListGrpcRoutesRequest#return_partial_success return_partial_success}
413
+ # and reading across collections e.g. when attempting to list all resources
414
+ # across all supported locations.
371
415
  class ListGrpcRoutesResponse
372
416
  include ::Google::Protobuf::MessageExts
373
417
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -25,7 +25,7 @@ module Google
25
25
  # Mesh or Gateway resource.
26
26
  # @!attribute [rw] name
27
27
  # @return [::String]
28
- # Required. Name of the HttpRoute resource. It matches pattern
28
+ # Identifier. Name of the HttpRoute resource. It matches pattern
29
29
  # `projects/*/locations/global/httpRoutes/http_route_name>`.
30
30
  # @!attribute [r] self_link
31
31
  # @return [::String]
@@ -258,6 +258,19 @@ module Google
258
258
  #
259
259
  # If weights are unspecified for all services, then, traffic is distributed
260
260
  # in equal proportions to all of them.
261
+ # @!attribute [rw] request_header_modifier
262
+ # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::HeaderModifier]
263
+ # Optional. The specification for modifying the headers of a matching
264
+ # request prior to delivery of the request to the destination. If
265
+ # HeaderModifiers are set on both the Destination and the RouteAction, they
266
+ # will be merged. Conflicts between the two will not be resolved on the
267
+ # configuration.
268
+ # @!attribute [rw] response_header_modifier
269
+ # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::HeaderModifier]
270
+ # Optional. The specification for modifying the headers of a response prior
271
+ # to sending the response back to the client. If HeaderModifiers are set on
272
+ # both the Destination and the RouteAction, they will be merged. Conflicts
273
+ # between the two will not be resolved on the configuration.
261
274
  class Destination
262
275
  include ::Google::Protobuf::MessageExts
263
276
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -376,6 +389,27 @@ module Google
376
389
  end
377
390
  end
378
391
 
392
+ # The specification for cookie-based stateful session affinity where the
393
+ # date plane supplies a “session cookie” with the name "GSSA" which encodes
394
+ # a specific destination host and each request containing that cookie will
395
+ # be directed to that host as long as the destination host remains up and
396
+ # healthy.
397
+ #
398
+ # The gRPC proxyless mesh library or sidecar proxy will manage the session
399
+ # cookie but the client application code is responsible for copying the
400
+ # cookie from each RPC in the session to the next.
401
+ # @!attribute [rw] cookie_ttl
402
+ # @return [::Google::Protobuf::Duration]
403
+ # Required. The cookie TTL value for the Set-Cookie header generated by
404
+ # the data plane. The lifetime of the cookie may be set to a value from 0
405
+ # to 86400 seconds (24 hours) inclusive.
406
+ #
407
+ # Set this to 0s to use a session cookie and disable cookie expiration.
408
+ class StatefulSessionAffinityPolicy
409
+ include ::Google::Protobuf::MessageExts
410
+ extend ::Google::Protobuf::MessageExts::ClassMethods
411
+ end
412
+
379
413
  # The specification for modifying HTTP header in HTTP request and HTTP
380
414
  # response.
381
415
  # @!attribute [rw] set
@@ -468,10 +502,15 @@ module Google
468
502
  # destination service. The proxy does not wait for responses from the
469
503
  # shadow service. Prior to sending traffic to the shadow service, the
470
504
  # host/authority header is suffixed with -shadow.
505
+ # Mirroring is currently not supported for Cloud Run destinations.
471
506
  # @!attribute [rw] destination
472
507
  # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::Destination]
473
508
  # The destination the requests will be mirrored to. The weight of the
474
509
  # destination will be ignored.
510
+ # @!attribute [rw] mirror_percent
511
+ # @return [::Float]
512
+ # Optional. The percentage of requests to get mirrored to the desired
513
+ # destination.
475
514
  class RequestMirrorPolicy
476
515
  include ::Google::Protobuf::MessageExts
477
516
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -517,6 +556,27 @@ module Google
517
556
  extend ::Google::Protobuf::MessageExts::ClassMethods
518
557
  end
519
558
 
559
+ # Static HTTP response object to be returned.
560
+ # @!attribute [rw] string_body
561
+ # @return [::String]
562
+ # Optional. Response body as a string. Maximum body length is 1024
563
+ # characters.
564
+ #
565
+ # Note: The following fields are mutually exclusive: `string_body`, `bytes_body`. If a field in that set is populated, all other fields in the set will automatically be cleared.
566
+ # @!attribute [rw] bytes_body
567
+ # @return [::String]
568
+ # Optional. Response body as bytes. Maximum body size is 4096B.
569
+ #
570
+ # Note: The following fields are mutually exclusive: `bytes_body`, `string_body`. If a field in that set is populated, all other fields in the set will automatically be cleared.
571
+ # @!attribute [rw] status
572
+ # @return [::Integer]
573
+ # Required. Status to return as part of HTTP Response. Must be a positive
574
+ # integer.
575
+ class HttpDirectResponse
576
+ include ::Google::Protobuf::MessageExts
577
+ extend ::Google::Protobuf::MessageExts::ClassMethods
578
+ end
579
+
520
580
  # The specifications for routing traffic and applying associated policies.
521
581
  # @!attribute [rw] destinations
522
582
  # @return [::Array<::Google::Cloud::NetworkServices::V1::HttpRoute::Destination>]
@@ -569,6 +629,20 @@ module Google
569
629
  # @!attribute [rw] cors_policy
570
630
  # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::CorsPolicy]
571
631
  # The specification for allowing client side cross-origin requests.
632
+ # @!attribute [rw] stateful_session_affinity
633
+ # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::StatefulSessionAffinityPolicy]
634
+ # Optional. Specifies cookie-based stateful session affinity.
635
+ # @!attribute [rw] direct_response
636
+ # @return [::Google::Cloud::NetworkServices::V1::HttpRoute::HttpDirectResponse]
637
+ # Optional. Static HTTP Response object to be returned regardless of the
638
+ # request.
639
+ # @!attribute [rw] idle_timeout
640
+ # @return [::Google::Protobuf::Duration]
641
+ # Optional. Specifies the idle timeout for the selected route. The idle
642
+ # timeout is defined as the period in which there are no bytes sent or
643
+ # received on either the upstream or downstream connection. If not set, the
644
+ # default idle timeout is 1 hour. If set to 0s, the timeout will be
645
+ # disabled.
572
646
  class RouteAction
573
647
  include ::Google::Protobuf::MessageExts
574
648
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -618,6 +692,11 @@ module Google
618
692
  # The value returned by the last `ListHttpRoutesResponse`
619
693
  # Indicates that this is a continuation of a prior `ListHttpRoutes` call,
620
694
  # and that the system should return the next page of data.
695
+ # @!attribute [rw] return_partial_success
696
+ # @return [::Boolean]
697
+ # Optional. If true, allow partial responses for multi-regional Aggregated
698
+ # List requests. Otherwise if one of the locations is down or unreachable,
699
+ # the Aggregated List request will fail.
621
700
  class ListHttpRoutesRequest
622
701
  include ::Google::Protobuf::MessageExts
623
702
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -632,6 +711,12 @@ module Google
632
711
  # If there might be more results than those appearing in this response, then
633
712
  # `next_page_token` is included. To get the next set of results, call this
634
713
  # method again using the value of `next_page_token` as `page_token`.
714
+ # @!attribute [rw] unreachable
715
+ # @return [::Array<::String>]
716
+ # Unreachable resources. Populated when the request opts into
717
+ # {::Google::Cloud::NetworkServices::V1::ListHttpRoutesRequest#return_partial_success return_partial_success}
718
+ # and reading across collections e.g. when attempting to list all resources
719
+ # across all supported locations.
635
720
  class ListHttpRoutesResponse
636
721
  include ::Google::Protobuf::MessageExts
637
722
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -26,7 +26,7 @@ module Google
26
26
  # requests are routed within this logical mesh boundary.
27
27
  # @!attribute [rw] name
28
28
  # @return [::String]
29
- # Required. Name of the Mesh resource. It matches pattern
29
+ # Identifier. Name of the Mesh resource. It matches pattern
30
30
  # `projects/*/locations/global/meshes/<mesh_name>`.
31
31
  # @!attribute [r] self_link
32
32
  # @return [::String]
@@ -52,6 +52,11 @@ module Google
52
52
  # regardless of its actual ip:port destination. If unset, a port '15001' is
53
53
  # used as the interception port. This is applicable only for sidecar proxy
54
54
  # deployments.
55
+ # @!attribute [rw] envoy_headers
56
+ # @return [::Google::Cloud::NetworkServices::V1::EnvoyHeaders]
57
+ # Optional. Determines if envoy will insert internal debug headers into
58
+ # upstream requests. Other Envoy headers may still be injected. By default,
59
+ # envoy will not insert any debug headers.
55
60
  class Mesh
56
61
  include ::Google::Protobuf::MessageExts
57
62
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -79,6 +84,11 @@ module Google
79
84
  # The value returned by the last `ListMeshesResponse`
80
85
  # Indicates that this is a continuation of a prior `ListMeshes` call,
81
86
  # and that the system should return the next page of data.
87
+ # @!attribute [rw] return_partial_success
88
+ # @return [::Boolean]
89
+ # Optional. If true, allow partial responses for multi-regional Aggregated
90
+ # List requests. Otherwise if one of the locations is down or unreachable,
91
+ # the Aggregated List request will fail.
82
92
  class ListMeshesRequest
83
93
  include ::Google::Protobuf::MessageExts
84
94
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -93,6 +103,11 @@ module Google
93
103
  # If there might be more results than those appearing in this response, then
94
104
  # `next_page_token` is included. To get the next set of results, call this
95
105
  # method again using the value of `next_page_token` as `page_token`.
106
+ # @!attribute [rw] unreachable
107
+ # @return [::Array<::String>]
108
+ # Unreachable resources. Populated when the request opts into
109
+ # `return_partial_success` and reading across collections e.g. when
110
+ # attempting to list all resources across all supported locations.
96
111
  class ListMeshesResponse
97
112
  include ::Google::Protobuf::MessageExts
98
113
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -0,0 +1,168 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module NetworkServices
23
+ module V1
24
+ # GatewayRouteView defines view-only resource for Routes to a Gateway
25
+ # @!attribute [r] name
26
+ # @return [::String]
27
+ # Output only. Identifier. Full path name of the GatewayRouteView resource.
28
+ # Format:
29
+ # projects/\\{project_number}/locations/\\{location}/gateways/\\{gateway}/routeViews/\\{route_view}
30
+ # @!attribute [r] route_project_number
31
+ # @return [::Integer]
32
+ # Output only. Project number where the route exists.
33
+ # @!attribute [r] route_location
34
+ # @return [::String]
35
+ # Output only. Location where the route exists.
36
+ # @!attribute [r] route_type
37
+ # @return [::String]
38
+ # Output only. Type of the route: HttpRoute,GrpcRoute,TcpRoute, or TlsRoute
39
+ # @!attribute [r] route_id
40
+ # @return [::String]
41
+ # Output only. The resource id for the route.
42
+ class GatewayRouteView
43
+ include ::Google::Protobuf::MessageExts
44
+ extend ::Google::Protobuf::MessageExts::ClassMethods
45
+ end
46
+
47
+ # MeshRouteView defines view-only resource for Routes to a Mesh
48
+ # @!attribute [r] name
49
+ # @return [::String]
50
+ # Output only. Identifier. Full path name of the MeshRouteView resource.
51
+ # Format:
52
+ # projects/\\{project}/locations/\\{location}/meshes/\\{mesh}/routeViews/\\{route_view}
53
+ # @!attribute [r] route_project_number
54
+ # @return [::Integer]
55
+ # Output only. Project number where the route exists.
56
+ # @!attribute [r] route_location
57
+ # @return [::String]
58
+ # Output only. Location where the route exists.
59
+ # @!attribute [r] route_type
60
+ # @return [::String]
61
+ # Output only. Type of the route: HttpRoute,GrpcRoute,TcpRoute, or TlsRoute
62
+ # @!attribute [r] route_id
63
+ # @return [::String]
64
+ # Output only. The resource id for the route.
65
+ class MeshRouteView
66
+ include ::Google::Protobuf::MessageExts
67
+ extend ::Google::Protobuf::MessageExts::ClassMethods
68
+ end
69
+
70
+ # Request used with the GetGatewayRouteView method.
71
+ # @!attribute [rw] name
72
+ # @return [::String]
73
+ # Required. Name of the GatewayRouteView resource.
74
+ # Formats:
75
+ # projects/\\{project}/locations/\\{location}/gateways/\\{gateway}/routeViews/\\{route_view}
76
+ class GetGatewayRouteViewRequest
77
+ include ::Google::Protobuf::MessageExts
78
+ extend ::Google::Protobuf::MessageExts::ClassMethods
79
+ end
80
+
81
+ # Request used with the GetMeshRouteView method.
82
+ # @!attribute [rw] name
83
+ # @return [::String]
84
+ # Required. Name of the MeshRouteView resource.
85
+ # Format:
86
+ # projects/\\{project}/locations/\\{location}/meshes/\\{mesh}/routeViews/\\{route_view}
87
+ class GetMeshRouteViewRequest
88
+ include ::Google::Protobuf::MessageExts
89
+ extend ::Google::Protobuf::MessageExts::ClassMethods
90
+ end
91
+
92
+ # Request used with the ListGatewayRouteViews method.
93
+ # @!attribute [rw] parent
94
+ # @return [::String]
95
+ # Required. The Gateway to which a Route is associated.
96
+ # Formats:
97
+ # projects/\\{project}/locations/\\{location}/gateways/\\{gateway}
98
+ # @!attribute [rw] page_size
99
+ # @return [::Integer]
100
+ # Maximum number of GatewayRouteViews to return per call.
101
+ # @!attribute [rw] page_token
102
+ # @return [::String]
103
+ # The value returned by the last `ListGatewayRouteViewsResponse`
104
+ # Indicates that this is a continuation of a prior `ListGatewayRouteViews`
105
+ # call, and that the system should return the next page of data.
106
+ class ListGatewayRouteViewsRequest
107
+ include ::Google::Protobuf::MessageExts
108
+ extend ::Google::Protobuf::MessageExts::ClassMethods
109
+ end
110
+
111
+ # Request used with the ListMeshRouteViews method.
112
+ # @!attribute [rw] parent
113
+ # @return [::String]
114
+ # Required. The Mesh to which a Route is associated.
115
+ # Format:
116
+ # projects/\\{project}/locations/\\{location}/meshes/\\{mesh}
117
+ # @!attribute [rw] page_size
118
+ # @return [::Integer]
119
+ # Maximum number of MeshRouteViews to return per call.
120
+ # @!attribute [rw] page_token
121
+ # @return [::String]
122
+ # The value returned by the last `ListMeshRouteViewsResponse`
123
+ # Indicates that this is a continuation of a prior `ListMeshRouteViews` call,
124
+ # and that the system should return the next page of data.
125
+ class ListMeshRouteViewsRequest
126
+ include ::Google::Protobuf::MessageExts
127
+ extend ::Google::Protobuf::MessageExts::ClassMethods
128
+ end
129
+
130
+ # Response returned by the ListGatewayRouteViews method.
131
+ # @!attribute [rw] gateway_route_views
132
+ # @return [::Array<::Google::Cloud::NetworkServices::V1::GatewayRouteView>]
133
+ # List of GatewayRouteView resources.
134
+ # @!attribute [rw] next_page_token
135
+ # @return [::String]
136
+ # A token, which can be sent as `page_token` to retrieve the next page.
137
+ # If this field is omitted, there are no subsequent pages.
138
+ # @!attribute [rw] unreachable
139
+ # @return [::Array<::String>]
140
+ # Unreachable resources. Populated when the request attempts to list all
141
+ # resources across all supported locations, while some locations are
142
+ # temporarily unavailable.
143
+ class ListGatewayRouteViewsResponse
144
+ include ::Google::Protobuf::MessageExts
145
+ extend ::Google::Protobuf::MessageExts::ClassMethods
146
+ end
147
+
148
+ # Response returned by the ListMeshRouteViews method.
149
+ # @!attribute [rw] mesh_route_views
150
+ # @return [::Array<::Google::Cloud::NetworkServices::V1::MeshRouteView>]
151
+ # List of MeshRouteView resources.
152
+ # @!attribute [rw] next_page_token
153
+ # @return [::String]
154
+ # A token, which can be sent as `page_token` to retrieve the next page.
155
+ # If this field is omitted, there are no subsequent pages.
156
+ # @!attribute [rw] unreachable
157
+ # @return [::Array<::String>]
158
+ # Unreachable resources. Populated when the request attempts to list all
159
+ # resources across all supported locations, while some locations are
160
+ # temporarily unavailable.
161
+ class ListMeshRouteViewsResponse
162
+ include ::Google::Protobuf::MessageExts
163
+ extend ::Google::Protobuf::MessageExts::ClassMethods
164
+ end
165
+ end
166
+ end
167
+ end
168
+ end
@@ -21,12 +21,17 @@ module Google
21
21
  module Cloud
22
22
  module NetworkServices
23
23
  module V1
24
- # ServiceBinding is the resource that defines a Service Directory Service to
25
- # be used in a BackendService resource.
24
+ # ServiceBinding can be used to:
25
+ # - Bind a Service Directory Service to be used in a BackendService resource.
26
+ # This feature will be deprecated soon.
27
+ # - Bind a Private Service Connect producer service to be used in consumer
28
+ # Cloud Service Mesh or Application Load Balancers.
29
+ # - Bind a Cloud Run service to be used in consumer Cloud Service Mesh or
30
+ # Application Load Balancers.
26
31
  # @!attribute [rw] name
27
32
  # @return [::String]
28
- # Required. Name of the ServiceBinding resource. It matches pattern
29
- # `projects/*/locations/global/serviceBindings/service_binding_name`.
33
+ # Identifier. Name of the ServiceBinding resource. It matches pattern
34
+ # `projects/*/locations/*/serviceBindings/<service_binding_name>`.
30
35
  # @!attribute [rw] description
31
36
  # @return [::String]
32
37
  # Optional. A free-text description of the resource. Max length 1024
@@ -38,9 +43,20 @@ module Google
38
43
  # @return [::Google::Protobuf::Timestamp]
39
44
  # Output only. The timestamp when the resource was updated.
40
45
  # @!attribute [rw] service
46
+ # @deprecated This field is deprecated and may be removed in the next major version update.
41
47
  # @return [::String]
42
- # Required. The full service directory service name of the format
43
- # /projects/*/locations/*/namespaces/*/services/*
48
+ # Optional. The full Service Directory Service name of the format
49
+ # `projects/*/locations/*/namespaces/*/services/*`.
50
+ # This field is for Service Directory integration which will be deprecated
51
+ # soon.
52
+ # @!attribute [r] service_id
53
+ # @deprecated This field is deprecated and may be removed in the next major version update.
54
+ # @return [::String]
55
+ # Output only. The unique identifier of the Service Directory Service against
56
+ # which the ServiceBinding resource is validated. This is populated when the
57
+ # Service Binding resource is used in another resource (like Backend
58
+ # Service). This is of the UUID4 format. This field is for Service Directory
59
+ # integration which will be deprecated soon.
44
60
  # @!attribute [rw] labels
45
61
  # @return [::Google::Protobuf::Map{::String => ::String}]
46
62
  # Optional. Set of label tags associated with the ServiceBinding resource.
@@ -62,7 +78,7 @@ module Google
62
78
  # @!attribute [rw] parent
63
79
  # @return [::String]
64
80
  # Required. The project and location from which the ServiceBindings should be
65
- # listed, specified in the format `projects/*/locations/global`.
81
+ # listed, specified in the format `projects/*/locations/*`.
66
82
  # @!attribute [rw] page_size
67
83
  # @return [::Integer]
68
84
  # Maximum number of ServiceBindings to return per call.
@@ -85,6 +101,11 @@ module Google
85
101
  # If there might be more results than those appearing in this response, then
86
102
  # `next_page_token` is included. To get the next set of results, call this
87
103
  # method again using the value of `next_page_token` as `page_token`.
104
+ # @!attribute [rw] unreachable
105
+ # @return [::Array<::String>]
106
+ # Unreachable resources. Populated when the request attempts to list all
107
+ # resources across all supported locations, while some locations are
108
+ # temporarily unavailable.
88
109
  class ListServiceBindingsResponse
89
110
  include ::Google::Protobuf::MessageExts
90
111
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -94,7 +115,7 @@ module Google
94
115
  # @!attribute [rw] name
95
116
  # @return [::String]
96
117
  # Required. A name of the ServiceBinding to get. Must be in the format
97
- # `projects/*/locations/global/serviceBindings/*`.
118
+ # `projects/*/locations/*/serviceBindings/*`.
98
119
  class GetServiceBindingRequest
99
120
  include ::Google::Protobuf::MessageExts
100
121
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -104,7 +125,7 @@ module Google
104
125
  # @!attribute [rw] parent
105
126
  # @return [::String]
106
127
  # Required. The parent resource of the ServiceBinding. Must be in the
107
- # format `projects/*/locations/global`.
128
+ # format `projects/*/locations/*`.
108
129
  # @!attribute [rw] service_binding_id
109
130
  # @return [::String]
110
131
  # Required. Short name of the ServiceBinding resource to be created.
@@ -116,11 +137,27 @@ module Google
116
137
  extend ::Google::Protobuf::MessageExts::ClassMethods
117
138
  end
118
139
 
140
+ # Request used by the UpdateServiceBinding method.
141
+ # @!attribute [rw] update_mask
142
+ # @return [::Google::Protobuf::FieldMask]
143
+ # Optional. Field mask is used to specify the fields to be overwritten in the
144
+ # ServiceBinding resource by the update.
145
+ # The fields specified in the update_mask are relative to the resource, not
146
+ # the full request. A field will be overwritten if it is in the mask. If the
147
+ # user does not provide a mask then all fields will be overwritten.
148
+ # @!attribute [rw] service_binding
149
+ # @return [::Google::Cloud::NetworkServices::V1::ServiceBinding]
150
+ # Required. Updated ServiceBinding resource.
151
+ class UpdateServiceBindingRequest
152
+ include ::Google::Protobuf::MessageExts
153
+ extend ::Google::Protobuf::MessageExts::ClassMethods
154
+ end
155
+
119
156
  # Request used by the DeleteServiceBinding method.
120
157
  # @!attribute [rw] name
121
158
  # @return [::String]
122
159
  # Required. A name of the ServiceBinding to delete. Must be in the format
123
- # `projects/*/locations/global/serviceBindings/*`.
160
+ # `projects/*/locations/*/serviceBindings/*`.
124
161
  class DeleteServiceBindingRequest
125
162
  include ::Google::Protobuf::MessageExts
126
163
  extend ::Google::Protobuf::MessageExts::ClassMethods