google-cloud-network_services-v1beta1 0.a → 0.1.0

data/proto_docs/google/cloud/networkservices/v1beta1/dep.rb

@@ -0,0 +1,928 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module NetworkServices
+      module V1beta1
+        # A single extension chain wrapper that contains the match conditions and
+        # extensions to execute.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name for this extension chain.
+        #     The name is logged as part of the HTTP request logs.
+        #     The name must conform with RFC-1034, is restricted to lower-cased letters,
+        #     numbers and hyphens, and can have a maximum length of 63 characters.
+        #     Additionally, the first character must be a letter and the last a letter or
+        #     a number.
+        # @!attribute [rw] match_condition
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionChain::MatchCondition]
+        #     Required. Conditions under which this chain is invoked for a request.
+        # @!attribute [rw] extensions
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionChain::Extension>]
+        #     Required. A set of extensions to execute for the matching request.
+        #     At least one extension is required.
+        #     Up to 3 extensions can be defined for each extension chain
+        #     for `LbTrafficExtension` resource.
+        #     `LbRouteExtension` chains are limited to 1 extension per extension chain.
+        class ExtensionChain
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Conditions under which this chain is invoked for a request.
+          # @!attribute [rw] cel_expression
+          #   @return [::String]
+          #     Required. A Common Expression Language (CEL) expression that is used to
+          #     match requests for which the extension chain is executed.
+          #
+          #     For more information, see [CEL matcher language
+          #     reference](https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference).
+          class MatchCondition
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A single extension in the chain to execute for the matching request.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name for this extension.
+          #     The name is logged as part of the HTTP request logs.
+          #     The name must conform with RFC-1034, is restricted to lower-cased
+          #     letters, numbers and hyphens, and can have a maximum length of 63
+          #     characters. Additionally, the first character must be a letter and the
+          #     last a letter or a number.
+          # @!attribute [rw] authority
+          #   @return [::String]
+          #     Optional. The `:authority` header in the gRPC request sent from Envoy
+          #     to the extension service.
+          #     Required for Callout extensions.
+          # @!attribute [rw] service
+          #   @return [::String]
+          #     Required. The reference to the service that runs the extension.
+          #
+          #     Currently only callout extensions are supported here.
+          #
+          #     To configure a callout extension, `service` must be a fully-qualified
+          #     reference
+          #     to a [backend
+          #     service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)
+          #     in the format:
+          #     `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}`
+          #     or
+          #     `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`.
+          # @!attribute [rw] supported_events
+          #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::EventType>]
+          #     Optional. A set of events during request or response processing for which
+          #     this extension is called. This field is required for the
+          #     `LbTrafficExtension` resource. It's not relevant for the
+          #     `LbRouteExtension` resource.
+          # @!attribute [rw] timeout
+          #   @return [::Google::Protobuf::Duration]
+          #     Optional. Specifies the timeout for each individual message on the
+          #     stream. The timeout must be between 10-1000 milliseconds. Required for
+          #     Callout extensions.
+          # @!attribute [rw] fail_open
+          #   @return [::Boolean]
+          #     Optional. Determines how the proxy behaves if the call to the extension
+          #     fails or times out.
+          #
+          #     When set to `TRUE`, request or response processing continues without
+          #     error. Any subsequent extensions in the extension chain are also
+          #     executed. When set to `FALSE` or the default setting of `FALSE` is used,
+          #     one of the following happens:
+          #     * If response headers have not been delivered to the downstream client,
+          #     a generic 500 error is returned to the client. The error response can be
+          #     tailored by configuring a custom error response in the load balancer.
+          #
+          #     * If response headers have been delivered, then the HTTP stream to the
+          #     downstream client is reset.
+          # @!attribute [rw] forward_headers
+          #   @return [::Array<::String>]
+          #     Optional. List of the HTTP headers to forward to the extension
+          #     (from the client or backend). If omitted, all headers are sent.
+          #     Each element is a string indicating the header name.
+          class Extension
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # `LbTrafficExtension` is a resource that lets the extension service modify the
+        # headers and payloads of both requests and responses without impacting the
+        # choice of backend services or any other security policies associated with the
+        # backend service.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Identifier. Name of the `LbTrafficExtension` resource in the
+        #     following format:
+        #     `projects/{project}/locations/{location}/lbTrafficExtensions/{lb_traffic_extension}`.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was updated.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. A human-readable description of the resource.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Set of labels associated with the `LbTrafficExtension` resource.
+        #
+        #     The format must comply with [the requirements for
+        #     labels](https://cloud.google.com/compute/docs/labeling-resources#requirements)
+        #     for Google Cloud resources.
+        # @!attribute [rw] forwarding_rules
+        #   @return [::Array<::String>]
+        #     Required. A list of references to the forwarding rules to which this
+        #     service extension is attached to. At least one forwarding rule is required.
+        #     There can be only one `LBTrafficExtension` resource per forwarding rule.
+        # @!attribute [rw] extension_chains
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionChain>]
+        #     Required. A set of ordered extension chains that contain the match
+        #     conditions and extensions to execute. Match conditions for each extension
+        #     chain are evaluated in sequence for a given request. The first extension
+        #     chain that has a condition that matches the request is executed.
+        #     Any subsequent extension chains do not execute.
+        #     Limited to 5 extension chains per resource.
+        # @!attribute [rw] load_balancing_scheme
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LoadBalancingScheme]
+        #     Required. All backend services and forwarding rules referenced by this
+        #     extension must share the same load balancing scheme. Supported values:
+        #     `INTERNAL_MANAGED`, `EXTERNAL_MANAGED`. For more information, refer to
+        #     [Choosing a load
+        #     balancer](https://cloud.google.com/load-balancing/docs/backend-service).
+        class LbTrafficExtension
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Message for requesting list of `LbTrafficExtension` resources.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project and location from which the `LbTrafficExtension`
+        #     resources are listed, specified in the following format:
+        #     `projects/{project}/locations/{location}`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Requested page size. The server might return fewer items than
+        #     requested. If unspecified, the server picks an appropriate default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A token identifying a page of results that the server returns.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filtering results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Hint for how to order the results.
+        class ListLbTrafficExtensionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for response to listing `LbTrafficExtension` resources.
+        # @!attribute [rw] lb_traffic_extensions
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::LbTrafficExtension>]
+        #     The list of `LbTrafficExtension` resources.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results that the server returns.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListLbTrafficExtensionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for getting a `LbTrafficExtension` resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A name of the `LbTrafficExtension` resource to get. Must be in
+        #     the format
+        #     `projects/{project}/locations/{location}/lbTrafficExtensions/{lb_traffic_extension}`.
+        class GetLbTrafficExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for creating a `LbTrafficExtension` resource.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource of the `LbTrafficExtension` resource. Must be
+        #     in the format `projects/{project}/locations/{location}`.
+        # @!attribute [rw] lb_traffic_extension_id
+        #   @return [::String]
+        #     Required. User-provided ID of the `LbTrafficExtension` resource to be
+        #     created.
+        # @!attribute [rw] lb_traffic_extension
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LbTrafficExtension]
+        #     Required. `LbTrafficExtension` resource to be created.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class CreateLbTrafficExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for updating a `LbTrafficExtension` resource.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. Used to specify the fields to be overwritten in the
+        #     `LbTrafficExtension` resource by the update.
+        #     The fields specified in the update_mask are relative to the resource, not
+        #     the full request. A field is overwritten if it is in the mask. If the
+        #     user does not specify a mask, then all fields are overwritten.
+        # @!attribute [rw] lb_traffic_extension
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LbTrafficExtension]
+        #     Required. `LbTrafficExtension` resource being updated.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class UpdateLbTrafficExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for deleting a `LbTrafficExtension` resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the `LbTrafficExtension` resource to delete. Must be
+        #     in the format
+        #     `projects/{project}/locations/{location}/lbTrafficExtensions/{lb_traffic_extension}`.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class DeleteLbTrafficExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `LbRouteExtension` is a resource that lets you control where traffic is
+        # routed to for a given request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Identifier. Name of the `LbRouteExtension` resource in the
+        #     following format:
+        #     `projects/{project}/locations/{location}/lbRouteExtensions/{lb_route_extension}`.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was updated.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. A human-readable description of the resource.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Set of labels associated with the `LbRouteExtension` resource.
+        #
+        #     The format must comply with [the requirements for
+        #     labels](https://cloud.google.com/compute/docs/labeling-resources#requirements)
+        #     for Google Cloud resources.
+        # @!attribute [rw] forwarding_rules
+        #   @return [::Array<::String>]
+        #     Required. A list of references to the forwarding rules to which this
+        #     service extension is attached to. At least one forwarding rule is required.
+        #     There can be only one `LbRouteExtension` resource per forwarding rule.
+        # @!attribute [rw] extension_chains
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionChain>]
+        #     Required. A set of ordered extension chains that contain the match
+        #     conditions and extensions to execute. Match conditions for each extension
+        #     chain are evaluated in sequence for a given request. The first extension
+        #     chain that has a condition that matches the request is executed.
+        #     Any subsequent extension chains do not execute.
+        #     Limited to 5 extension chains per resource.
+        # @!attribute [rw] load_balancing_scheme
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LoadBalancingScheme]
+        #     Required. All backend services and forwarding rules referenced by this
+        #     extension must share the same load balancing scheme. Supported values:
+        #     `INTERNAL_MANAGED`, `EXTERNAL_MANAGED`. For more information, refer to
+        #     [Choosing a load
+        #     balancer](https://cloud.google.com/load-balancing/docs/backend-service).
+        class LbRouteExtension
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Message for requesting list of `LbRouteExtension` resources.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project and location from which the `LbRouteExtension`
+        #     resources are listed, specified in the following format:
+        #     `projects/{project}/locations/{location}`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Requested page size. The server might return fewer items than
+        #     requested. If unspecified, the server picks an appropriate default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A token identifying a page of results that the server returns.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filtering results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Hint for how to order the results.
+        class ListLbRouteExtensionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for response to listing `LbRouteExtension` resources.
+        # @!attribute [rw] lb_route_extensions
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::LbRouteExtension>]
+        #     The list of `LbRouteExtension` resources.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results that the server returns.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListLbRouteExtensionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for getting a `LbRouteExtension` resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A name of the `LbRouteExtension` resource to get. Must be in the
+        #     format
+        #     `projects/{project}/locations/{location}/lbRouteExtensions/{lb_route_extension}`.
+        class GetLbRouteExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for creating a `LbRouteExtension` resource.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource of the `LbRouteExtension` resource. Must be
+        #     in the format `projects/{project}/locations/{location}`.
+        # @!attribute [rw] lb_route_extension_id
+        #   @return [::String]
+        #     Required. User-provided ID of the `LbRouteExtension` resource to be
+        #     created.
+        # @!attribute [rw] lb_route_extension
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LbRouteExtension]
+        #     Required. `LbRouteExtension` resource to be created.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class CreateLbRouteExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for updating a `LbRouteExtension` resource.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. Used to specify the fields to be overwritten in the
+        #     `LbRouteExtension` resource by the update.
+        #     The fields specified in the update_mask are relative to the resource, not
+        #     the full request. A field is overwritten if it is in the mask. If the
+        #     user does not specify a mask, then all fields are overwritten.
+        # @!attribute [rw] lb_route_extension
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::LbRouteExtension]
+        #     Required. `LbRouteExtension` resource being updated.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class UpdateLbRouteExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for deleting a `LbRouteExtension` resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the `LbRouteExtension` resource to delete. Must be in
+        #     the format
+        #     `projects/{project}/locations/{location}/lbRouteExtensions/{lb_route_extension}`.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server can ignore
+        #     the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, ignores the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class DeleteLbRouteExtensionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `ExtensionBinding` is a resource representing the attachment of an extension
+        # to a service.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the `ExtensionBinding` resource in the following
+        #     format:
+        #     `projects/{project}/locations/{location}/extensionBindings/{extension_binding}`.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was updated.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. A human-readable description of the resource.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Set of labels associated with the `ExtensionBinding` resource.
+        #
+        #     The format must comply with [the following
+        #     requirements](https://cloud.google.com/compute/docs/labeling-resources#requirements).
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. Etag of the resource.
+        #     If provided, it must match the server's etag. If the provided etag
+        #     does not match the server's etag, the request will fail with a 409 ABORTED
+        #     error.
+        # @!attribute [rw] producer_extension
+        #   @return [::String]
+        #     Required. The name of the extension that this binding should attach to
+        #     target resources.
+        #
+        #     Format:
+        #     For Google-provided extensions, specify the service endpoint (see
+        #     [Model Armor
+        #     integration](https://docs.cloud.google.com/model-armor/integrations))
+        # @!attribute [rw] target
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::Target]
+        #     Required. Specifies a target to which this `ExtensionBinding` should be
+        #     attached. The target can be either a single resource or a scope of
+        #     resources.
+        # @!attribute [rw] match_conditions
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition>]
+        #     Optional. A list of match conditions to match against the incoming
+        #     request. The extension will be invoked if at least one condition matches
+        #     the request, or if no match conditions are specified. Limited to 5
+        #     conditions.
+        # @!attribute [rw] fail_open
+        #   @return [::Boolean]
+        #     Optional. Determines the behavior of the extension binding when the call to
+        #     the extension fails or times out. Default value is `FALSE`.
+        #
+        #     When set to `TRUE`, failures of the extension are silently ignored.
+        # @!attribute [rw] producer_metadata
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Additional metadata that should be passed to the attached
+        #     extension with each request.
+        # @!attribute [rw] priority
+        #   @return [::Integer]
+        #     Optional. Priority of the extension binding. Lower numbers indicate higher
+        #     priority. Priority of extension bindings are used to determine the order in
+        #     which extension bindings are applied to a request.
+        class ExtensionBinding
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies a list of targets to which this `ExtensionBinding` should attach.
+          # @!attribute [rw] resources
+          #   @return [::Array<::String>]
+          #     Optional. The reference to the target resource, to which this binding
+          #     should attach. Exactly one of `resources` or `scope` must be set.
+          # @!attribute [rw] scope
+          #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::Target::Scope]
+          #     Optional. Specifies the scope of resources to which this binding should
+          #     attach. Exactly one of `resources` or `scope` must be set.
+          class Target
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Specifies the scope of resources to which this binding should attach.
+            # @!attribute [rw] parent
+            #   @return [::String]
+            #     Required. Parent resource name specification, in the format:
+            #     `projects/{project_number}`.
+            # @!attribute [rw] resource_types
+            #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::Target::Scope::ResourceType>]
+            #     Required. Type of the resource to which the binding should attach.
+            #     Limited to 1 resource type.
+            class Scope
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Resource types that should be targeted by the binding.
+              module ResourceType
+                # Default value. Should not be used.
+                RESOURCE_TYPE_UNSPECIFIED = 0
+
+                # AI Application resources.
+                AI_APPLICATION = 1
+
+                # Agent Gateway resources.
+                AGENT_GATEWAY = 2
+              end
+            end
+          end
+
+          # Conditions to match against the incoming request.
+          # @!attribute [rw] to
+          #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::To]
+          #     Optional. Describes properties of a destination of a request. If
+          #     specified, the extension will only be invoked on requests to destinations
+          #     that match the specified criteria.
+          class MatchCondition
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Specifies matching logic for string values.
+            # @!attribute [rw] exact
+            #   @return [::String]
+            #     Optional. The input string must match exactly the string specified
+            #     here.
+            #
+            #     Examples:
+            #
+            #     * ``abc`` only matches the value ``abc``.
+            #
+            #     Note: The following fields are mutually exclusive: `exact`, `prefix`, `suffix`, `contains`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] prefix
+            #   @return [::String]
+            #     Optional. The input string must have the prefix specified here.
+            #     Note: empty prefix is not allowed.
+            #
+            #     Examples:
+            #
+            #     * ``abc`` matches the value ``abc.xyz``
+            #
+            #     Note: The following fields are mutually exclusive: `prefix`, `exact`, `suffix`, `contains`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] suffix
+            #   @return [::String]
+            #     Optional. The input string must have the suffix specified here.
+            #     Note: empty prefix is not allowed, please use regex instead.
+            #
+            #     Examples:
+            #
+            #     * ``abc`` matches the value ``xyz.abc``
+            #
+            #     Note: The following fields are mutually exclusive: `suffix`, `exact`, `prefix`, `contains`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] contains
+            #   @return [::String]
+            #     Optional. The input string must have the substring specified here.
+            #     Note: empty contains match is not allowed, please use regex instead.
+            #
+            #     Examples:
+            #
+            #     * ``abc`` matches the value ``xyz.abc.def``
+            #
+            #     Note: The following fields are mutually exclusive: `contains`, `exact`, `prefix`, `suffix`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] ignore_case
+            #   @return [::Boolean]
+            #     Optional. If true, indicates the exact/prefix/suffix/contains matching
+            #     should be case insensitive. For example, the matcher ``data`` will
+            #     match both input string ``Data`` and ``data`` if set to true.
+            class StringMatch
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Determines how an HTTP header should be matched.
+            # @!attribute [rw] name
+            #   @return [::String]
+            #     Required. Specifies the name of the header in the request.
+            # @!attribute [rw] value
+            #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::StringMatch]
+            #     Optional. Specifies how the header match will be performed.
+            class HeaderMatch
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Describes properties of one or more destinations of a request.
+            # @!attribute [rw] destination
+            #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::To::Destination]
+            #     Optional. Describes properties of destination of a request. Within a
+            #     destination, the match follows AND semantics across fields and OR
+            #     semantics within a field, i.e. a match occurs when ANY path matches AND
+            #     ANY header matches and ANY method matches. At least one of destination
+            #     or not_destination must be specified.
+            # @!attribute [rw] not_destination
+            #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::To::Destination]
+            #     Optional. Describes the negated properties of the request destination.
+            #     Extension will not be invoked on requests that match the criteria
+            #     specified in this field. At least one of destination or not_destination
+            #     must be specified.
+            class To
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Describes properties of a single destination.
+              # @!attribute [rw] header_set
+              #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::To::Destination::HeaderSet]
+              #     Optional. A set of HTTP headers to match against. If not specified,
+              #     requests with any headers are matched.
+              # @!attribute [rw] resources
+              #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::StringMatch>]
+              #     Optional. A list of non-empty strings whose value is matched against
+              #     the resource to which a request is sent (e.g., an Agent in
+              #     AiApplication). If not specified, any resource is allowed.
+              #     If specified, a match occurs if any of the resources
+              #     matches the resource value in the request. Limited to 5 resources.
+              #     When matching against resources in the AgentRegistry, use the URNs
+              #     of the registry resources.
+              # @!attribute [rw] hosts
+              #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::StringMatch>]
+              #     Optional. A list of HTTP Hosts to match against. Limited to 10 hosts.
+              #     If not specified, any host is allowed. If specified, a match occurs
+              #     if any of the hosts matches the host value in the request.
+              # @!attribute [rw] paths
+              #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::StringMatch>]
+              #     Optional. A list of paths to match against. Limited to 10
+              #     paths. If not specified, any path is allowed.
+              #
+              #     Note that this path match includes the query parameters. For gRPC
+              #     services, this should be a fully-qualified name of the form
+              #     /package.service/method.
+              class Destination
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # Describes a set of HTTP headers to match against.
+                # @!attribute [rw] headers
+                #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding::MatchCondition::HeaderMatch>]
+                #     Required. A list of headers to match against in http header.
+                #     If multiple header matches are provided, they will be evaluated as
+                #     an AND, i.e. all header matches must match for the request to
+                #     match.
+                class HeaderSet
+                  include ::Google::Protobuf::MessageExts
+                  extend ::Google::Protobuf::MessageExts::ClassMethods
+                end
+              end
+            end
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class ProducerMetadataEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Request used with the `ListExtensionBindings` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project and location from which the `ExtensionBinding`
+        #     resources should be listed, specified in the format
+        #     `projects/{project}/locations/{location}`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Maximum number of `ExtensionBinding` resources to return per
+        #     call.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value returned by the last `ListExtensionBindingsResponse`
+        #     Indicates that this is a continuation of a prior `ListExtensionBindings`
+        #     call, and that the system should return the next page of data.
+        class ListExtensionBindingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response returned by the `ListExtensionBindings` method.
+        # @!attribute [rw] extension_bindings
+        #   @return [::Array<::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding>]
+        #     List of `ExtensionBinding` resources.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     If there might be more results than those appearing in this response, then
+        #     `next_page_token` is included. To get the next set of results, call this
+        #     method again using the value of `next_page_token` as `page_token`.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Unordered list. Unreachable resources. Populated when the request attempts
+        #     to list all resources across all supported locations, while some locations
+        #     are temporarily unavailable. The resource names are in the format
+        #     `projects/{project}/locations/{location}/extensionBindings/{extension_binding}`.
+        class ListExtensionBindingsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request used by the `GetExtensionBinding` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A name of the `ExtensionBinding` resource to get. Must be in the
+        #     format
+        #     `projects/{project}/locations/{location}/extensionBindings/{extension_binding}`.
+        class GetExtensionBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request used by the `CreateExtensionBinding` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource of the `ExtensionBinding` resource. Must be
+        #     in the format `projects/{project}/locations/{location}`.
+        # @!attribute [rw] extension_binding_id
+        #   @return [::String]
+        #     Required. Short name of the `ExtensionBinding` resource to be created.
+        # @!attribute [rw] extension_binding
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding]
+        #     Required. `ExtensionBinding` resource to be created.
+        class CreateExtensionBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request used by the `UpdateExtensionBinding` method.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask is used to specify the fields to be overwritten in the
+        #     `ExtensionBinding` resource by the update.
+        #     The fields specified in the update_mask are relative to the resource, not
+        #     the full request. A field will be overwritten if it is in the mask. If the
+        #     user does not provide a mask then all fields will be overwritten.
+        # @!attribute [rw] extension_binding
+        #   @return [::Google::Cloud::NetworkServices::V1beta1::ExtensionBinding]
+        #     Required. Updated `ExtensionBinding` resource.
+        class UpdateExtensionBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request used by the `DeleteExtensionBinding` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A name of the `ExtensionBinding` resource to delete. Must be in
+        #     the format
+        #     `projects/{project}/locations/{location}/extensionBindings/{extension_binding}`.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. The etag of the ExtensionBinding to delete.
+        class DeleteExtensionBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The part of the request or response for which the extension is called.
+        module EventType
+          # Unspecified value. Do not use.
+          EVENT_TYPE_UNSPECIFIED = 0
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP request headers arrive.
+          REQUEST_HEADERS = 1
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP request body arrives.
+          REQUEST_BODY = 2
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP response headers arrive.
+          RESPONSE_HEADERS = 3
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP response body arrives.
+          RESPONSE_BODY = 4
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP request trailers arrives.
+          REQUEST_TRAILERS = 5
+
+          # If included in `supported_events`,
+          # the extension is called when the HTTP response trailers arrives.
+          RESPONSE_TRAILERS = 6
+        end
+
+        # Load balancing schemes supported by the `LbTrafficExtension` resource and
+        # `LbRouteExtension` resource.
+        # For more information, refer to [Choosing a load
+        # balancer](https://cloud.google.com/load-balancing/docs/backend-service).
+        module LoadBalancingScheme
+          # Default value. Do not use.
+          LOAD_BALANCING_SCHEME_UNSPECIFIED = 0
+
+          # Signifies that this is used for Internal HTTP(S) Load Balancing.
+          INTERNAL_MANAGED = 1
+
+          # Signifies that this is used for External Managed HTTP(S) Load
+          # Balancing.
+          EXTERNAL_MANAGED = 2
+        end
+      end
+    end
+  end
+end