Class ExtensionChain.Extension

java.lang.Object
com.google.protobuf.AbstractMessageLite
com.google.protobuf.AbstractMessage
com.google.protobuf.GeneratedMessage
com.google.cloud.networkservices.v1.ExtensionChain.Extension
All Implemented Interfaces:
ExtensionChain.ExtensionOrBuilder, com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Serializable
Enclosing class:
ExtensionChain

public static final class ExtensionChain.Extension extends com.google.protobuf.GeneratedMessage implements ExtensionChain.ExtensionOrBuilder
 A single extension in the chain to execute for the matching request.
 
Protobuf type google.cloud.networkservices.v1.ExtensionChain.Extension
See Also:
  • Field Details

  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessage
    • getName

      public String getName()
       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.
       
      string name = 1 [(.google.api.field_behavior) = REQUIRED];
      Specified by:
      getName in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The name.
    • getNameBytes

      public com.google.protobuf.ByteString getNameBytes()
       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.
       
      string name = 1 [(.google.api.field_behavior) = REQUIRED];
      Specified by:
      getNameBytes in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The bytes for name.
    • getAuthority

      public String getAuthority()
       Optional. The `:authority` header in the gRPC request sent from Envoy
       to the extension service.
       Required for Callout extensions.
      
       This field is not supported for plugin extensions. Setting it results in
       a validation error.
       
      string authority = 2 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getAuthority in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The authority.
    • getAuthorityBytes

      public com.google.protobuf.ByteString getAuthorityBytes()
       Optional. The `:authority` header in the gRPC request sent from Envoy
       to the extension service.
       Required for Callout extensions.
      
       This field is not supported for plugin extensions. Setting it results in
       a validation error.
       
      string authority = 2 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getAuthorityBytes in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The bytes for authority.
    • getService

      public String getService()
       Required. The reference to the service that runs the extension.
      
       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}`.
      
       To configure a plugin extension, `service` must be a reference
       to a [`WasmPlugin`
       resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins)
       in the format:
       `projects/{project}/locations/{location}/wasmPlugins/{plugin}`
       or
       `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`.
      
       Plugin extensions are currently supported for the
       `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension`
       resources.
       
      string service = 3 [(.google.api.field_behavior) = REQUIRED];
      Specified by:
      getService in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The service.
    • getServiceBytes

      public com.google.protobuf.ByteString getServiceBytes()
       Required. The reference to the service that runs the extension.
      
       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}`.
      
       To configure a plugin extension, `service` must be a reference
       to a [`WasmPlugin`
       resource](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins)
       in the format:
       `projects/{project}/locations/{location}/wasmPlugins/{plugin}`
       or
       `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`.
      
       Plugin extensions are currently supported for the
       `LbTrafficExtension`, the `LbRouteExtension`, and the `LbEdgeExtension`
       resources.
       
      string service = 3 [(.google.api.field_behavior) = REQUIRED];
      Specified by:
      getServiceBytes in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The bytes for service.
    • getSupportedEventsList

      public List<EventType> getSupportedEventsList()
       Optional. A set of events during request or response processing for which
       this extension is called.
      
       For the `LbTrafficExtension` resource, this field is required.
      
       For the `LbRouteExtension` resource, this field is optional. If
       unspecified, `REQUEST_HEADERS` event is assumed as supported.
      
       For the `LbEdgeExtension` resource, this field is required and must only
       contain `REQUEST_HEADERS` event.
       
      repeated .google.cloud.networkservices.v1.EventType supported_events = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSupportedEventsList in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      A list containing the supportedEvents.
    • getSupportedEventsCount

      public int getSupportedEventsCount()
       Optional. A set of events during request or response processing for which
       this extension is called.
      
       For the `LbTrafficExtension` resource, this field is required.
      
       For the `LbRouteExtension` resource, this field is optional. If
       unspecified, `REQUEST_HEADERS` event is assumed as supported.
      
       For the `LbEdgeExtension` resource, this field is required and must only
       contain `REQUEST_HEADERS` event.
       
      repeated .google.cloud.networkservices.v1.EventType supported_events = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSupportedEventsCount in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The count of supportedEvents.
    • getSupportedEvents

      public EventType getSupportedEvents(int index)
       Optional. A set of events during request or response processing for which
       this extension is called.
      
       For the `LbTrafficExtension` resource, this field is required.
      
       For the `LbRouteExtension` resource, this field is optional. If
       unspecified, `REQUEST_HEADERS` event is assumed as supported.
      
       For the `LbEdgeExtension` resource, this field is required and must only
       contain `REQUEST_HEADERS` event.
       
      repeated .google.cloud.networkservices.v1.EventType supported_events = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSupportedEvents in interface ExtensionChain.ExtensionOrBuilder
      Parameters:
      index - The index of the element to return.
      Returns:
      The supportedEvents at the given index.
    • getSupportedEventsValueList

      public List<Integer> getSupportedEventsValueList()
       Optional. A set of events during request or response processing for which
       this extension is called.
      
       For the `LbTrafficExtension` resource, this field is required.
      
       For the `LbRouteExtension` resource, this field is optional. If
       unspecified, `REQUEST_HEADERS` event is assumed as supported.
      
       For the `LbEdgeExtension` resource, this field is required and must only
       contain `REQUEST_HEADERS` event.
       
      repeated .google.cloud.networkservices.v1.EventType supported_events = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSupportedEventsValueList in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      A list containing the enum numeric values on the wire for supportedEvents.
    • getSupportedEventsValue

      public int getSupportedEventsValue(int index)
       Optional. A set of events during request or response processing for which
       this extension is called.
      
       For the `LbTrafficExtension` resource, this field is required.
      
       For the `LbRouteExtension` resource, this field is optional. If
       unspecified, `REQUEST_HEADERS` event is assumed as supported.
      
       For the `LbEdgeExtension` resource, this field is required and must only
       contain `REQUEST_HEADERS` event.
       
      repeated .google.cloud.networkservices.v1.EventType supported_events = 4 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getSupportedEventsValue in interface ExtensionChain.ExtensionOrBuilder
      Parameters:
      index - The index of the value to return.
      Returns:
      The enum numeric value on the wire of supportedEvents at the given index.
    • hasTimeout

      public boolean hasTimeout()
       Optional. Specifies the timeout for each individual message on the
       stream. The timeout must be between `10`-`10000` milliseconds. Required
       for callout extensions.
      
       This field is not supported for plugin extensions. Setting it results in
       a validation error.
       
      .google.protobuf.Duration timeout = 5 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      hasTimeout in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      Whether the timeout field is set.
    • getTimeout

      public com.google.protobuf.Duration getTimeout()
       Optional. Specifies the timeout for each individual message on the
       stream. The timeout must be between `10`-`10000` milliseconds. Required
       for callout extensions.
      
       This field is not supported for plugin extensions. Setting it results in
       a validation error.
       
      .google.protobuf.Duration timeout = 5 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getTimeout in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The timeout.
    • getTimeoutOrBuilder

      public com.google.protobuf.DurationOrBuilder getTimeoutOrBuilder()
       Optional. Specifies the timeout for each individual message on the
       stream. The timeout must be between `10`-`10000` milliseconds. Required
       for callout extensions.
      
       This field is not supported for plugin extensions. Setting it results in
       a validation error.
       
      .google.protobuf.Duration timeout = 5 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getTimeoutOrBuilder in interface ExtensionChain.ExtensionOrBuilder
    • getFailOpen

      public boolean getFailOpen()
       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.
       
      bool fail_open = 6 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getFailOpen in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The failOpen.
    • getForwardHeadersList

      public com.google.protobuf.ProtocolStringList getForwardHeadersList()
       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.
       
      repeated string forward_headers = 7 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getForwardHeadersList in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      A list containing the forwardHeaders.
    • getForwardHeadersCount

      public int getForwardHeadersCount()
       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.
       
      repeated string forward_headers = 7 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getForwardHeadersCount in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The count of forwardHeaders.
    • getForwardHeaders

      public String getForwardHeaders(int index)
       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.
       
      repeated string forward_headers = 7 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getForwardHeaders in interface ExtensionChain.ExtensionOrBuilder
      Parameters:
      index - The index of the element to return.
      Returns:
      The forwardHeaders at the given index.
    • getForwardHeadersBytes

      public com.google.protobuf.ByteString getForwardHeadersBytes(int index)
       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.
       
      repeated string forward_headers = 7 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getForwardHeadersBytes in interface ExtensionChain.ExtensionOrBuilder
      Parameters:
      index - The index of the value to return.
      Returns:
      The bytes of the forwardHeaders at the given index.
    • hasMetadata

      public boolean hasMetadata()
       Optional. The metadata provided here is included as part of the
       `metadata_context` (of type `google.protobuf.Struct`) in the
       `ProcessingRequest` message sent to the extension server.
      
       The metadata is available under the namespace
       `com.google.<extension_type>.<resource_name>.<extension_chain_name>.<extension_name>`.
       For example:
       `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`.
      
       The following variables are supported in the metadata:
      
       `{forwarding_rule_id}` - substituted with the forwarding rule's fully
       qualified resource name.
      
       This field must not be set for plugin extensions. Setting it results in
       a validation error.
      
       You can set metadata at either the resource level or the extension level.
       The extension level metadata is recommended because you can pass a
       different set of metadata through each extension to the backend.
      
       This field is subject to following limitations:
      
       * The total size of the metadata must be less than 1KiB.
       * The total number of keys in the metadata must be less than 16.
       * The length of each key must be less than 64 characters.
       * The length of each value must be less than 1024 characters.
       * All values must be strings.
       
      .google.protobuf.Struct metadata = 9 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      hasMetadata in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      Whether the metadata field is set.
    • getMetadata

      public com.google.protobuf.Struct getMetadata()
       Optional. The metadata provided here is included as part of the
       `metadata_context` (of type `google.protobuf.Struct`) in the
       `ProcessingRequest` message sent to the extension server.
      
       The metadata is available under the namespace
       `com.google.<extension_type>.<resource_name>.<extension_chain_name>.<extension_name>`.
       For example:
       `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`.
      
       The following variables are supported in the metadata:
      
       `{forwarding_rule_id}` - substituted with the forwarding rule's fully
       qualified resource name.
      
       This field must not be set for plugin extensions. Setting it results in
       a validation error.
      
       You can set metadata at either the resource level or the extension level.
       The extension level metadata is recommended because you can pass a
       different set of metadata through each extension to the backend.
      
       This field is subject to following limitations:
      
       * The total size of the metadata must be less than 1KiB.
       * The total number of keys in the metadata must be less than 16.
       * The length of each key must be less than 64 characters.
       * The length of each value must be less than 1024 characters.
       * All values must be strings.
       
      .google.protobuf.Struct metadata = 9 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getMetadata in interface ExtensionChain.ExtensionOrBuilder
      Returns:
      The metadata.
    • getMetadataOrBuilder

      public com.google.protobuf.StructOrBuilder getMetadataOrBuilder()
       Optional. The metadata provided here is included as part of the
       `metadata_context` (of type `google.protobuf.Struct`) in the
       `ProcessingRequest` message sent to the extension server.
      
       The metadata is available under the namespace
       `com.google.<extension_type>.<resource_name>.<extension_chain_name>.<extension_name>`.
       For example:
       `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`.
      
       The following variables are supported in the metadata:
      
       `{forwarding_rule_id}` - substituted with the forwarding rule's fully
       qualified resource name.
      
       This field must not be set for plugin extensions. Setting it results in
       a validation error.
      
       You can set metadata at either the resource level or the extension level.
       The extension level metadata is recommended because you can pass a
       different set of metadata through each extension to the backend.
      
       This field is subject to following limitations:
      
       * The total size of the metadata must be less than 1KiB.
       * The total number of keys in the metadata must be less than 16.
       * The length of each key must be less than 64 characters.
       * The length of each value must be less than 1024 characters.
       * All values must be strings.
       
      .google.protobuf.Struct metadata = 9 [(.google.api.field_behavior) = OPTIONAL];
      Specified by:
      getMetadataOrBuilder in interface ExtensionChain.ExtensionOrBuilder
    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessage
    • writeTo

      public void writeTo(com.google.protobuf.CodedOutputStream output) throws IOException
      Specified by:
      writeTo in interface com.google.protobuf.MessageLite
      Overrides:
      writeTo in class com.google.protobuf.GeneratedMessage
      Throws:
      IOException
    • getSerializedSize

      public int getSerializedSize()
      Specified by:
      getSerializedSize in interface com.google.protobuf.MessageLite
      Overrides:
      getSerializedSize in class com.google.protobuf.GeneratedMessage
    • equals

      public boolean equals(Object obj)
      Specified by:
      equals in interface com.google.protobuf.Message
      Overrides:
      equals in class com.google.protobuf.AbstractMessage
    • hashCode

      public int hashCode()
      Specified by:
      hashCode in interface com.google.protobuf.Message
      Overrides:
      hashCode in class com.google.protobuf.AbstractMessage
    • parseFrom

      public static ExtensionChain.Extension parseFrom(ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(com.google.protobuf.ByteString data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(byte[] data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(InputStream input) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • parseDelimitedFrom

      public static ExtensionChain.Extension parseDelimitedFrom(InputStream input) throws IOException
      Throws:
      IOException
    • parseDelimitedFrom

      public static ExtensionChain.Extension parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(com.google.protobuf.CodedInputStream input) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ExtensionChain.Extension parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • newBuilderForType

      public ExtensionChain.Extension.Builder newBuilderForType()
      Specified by:
      newBuilderForType in interface com.google.protobuf.Message
      Specified by:
      newBuilderForType in interface com.google.protobuf.MessageLite
    • newBuilder

      public static ExtensionChain.Extension.Builder newBuilder()
    • newBuilder

      public static ExtensionChain.Extension.Builder newBuilder(ExtensionChain.Extension prototype)
    • toBuilder

      Specified by:
      toBuilder in interface com.google.protobuf.Message
      Specified by:
      toBuilder in interface com.google.protobuf.MessageLite
    • newBuilderForType

      protected ExtensionChain.Extension.Builder newBuilderForType(com.google.protobuf.AbstractMessage.BuilderParent parent)
      Overrides:
      newBuilderForType in class com.google.protobuf.AbstractMessage
    • getDefaultInstance

      public static ExtensionChain.Extension getDefaultInstance()
    • parser

      public static com.google.protobuf.Parser<ExtensionChain.Extension> parser()
    • getParserForType

      public com.google.protobuf.Parser<ExtensionChain.Extension> getParserForType()
      Specified by:
      getParserForType in interface com.google.protobuf.Message
      Specified by:
      getParserForType in interface com.google.protobuf.MessageLite
      Overrides:
      getParserForType in class com.google.protobuf.GeneratedMessage
    • getDefaultInstanceForType

      public ExtensionChain.Extension getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder