Class: Google::Cloud::Eventarc::V1::Pipeline

Inherits:

Object

• Object
• Google::Cloud::Eventarc::V1::Pipeline

Extended by:

Protobuf::MessageExts::ClassMethods

Includes:

Protobuf::MessageExts

Defined in:

proto_docs/google/cloud/eventarc/v1/pipeline.rb

Overview

A representation of the Pipeline resource.

Defined Under Namespace

Classes: AnnotationsEntry, Destination, LabelsEntry, Mediation, MessagePayloadFormat, RetryPolicy

Instance Attribute Summary

• #annotations ⇒ ::Google::Protobuf::Map{::String => ::String}

  Optional.

• #create_time ⇒ ::Google::Protobuf::Timestamp readonly

  Output only.

• #crypto_key_name ⇒ ::String

  Optional.

• #destinations ⇒ ::Array<::Google::Cloud::Eventarc::V1::Pipeline::Destination>

  Required.

• #display_name ⇒ ::String

  Optional.

• #etag ⇒ ::String

  Output only.

• #input_payload_format ⇒ ::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat

  Optional.

• #labels ⇒ ::Google::Protobuf::Map{::String => ::String}

  Optional.

• #logging_config ⇒ ::Google::Cloud::Eventarc::V1::LoggingConfig

  Optional.

• #mediations ⇒ ::Array<::Google::Cloud::Eventarc::V1::Pipeline::Mediation>

  Optional.

• #name ⇒ ::String

  Identifier.

• #retry_policy ⇒ ::Google::Cloud::Eventarc::V1::Pipeline::RetryPolicy

  Optional.

• #uid ⇒ ::String readonly

  Output only.

• #update_time ⇒ ::Google::Protobuf::Timestamp readonly

  Output only.

Instance Attribute Details

#annotations ⇒ ::Google::Protobuf::Map{::String => ::String}

Returns Optional. User-defined annotations. See https://google.aip.dev/128#annotations.

Returns:

• (::Google::Protobuf::Map{::String => ::String}) —

  Optional. User-defined annotations. See https://google.aip.dev/128#annotations.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#create_time ⇒ ::Google::Protobuf::Timestamp (readonly)

Returns Output only. The creation time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Returns:

• (::Google::Protobuf::Timestamp) —

  Output only. The creation time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#crypto_key_name ⇒ ::String

Returns Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt the event data. If not set, an internal Google-owned key will be used to encrypt messages. It must match the pattern "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}".

Returns:

• (::String) —

  Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt the event data. If not set, an internal Google-owned key will be used to encrypt messages. It must match the pattern "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}".

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#destinations ⇒ ::Array<::Google::Cloud::Eventarc::V1::Pipeline::Destination>

Returns Required. List of destinations to which messages will be forwarded. Currently, exactly one destination is supported per Pipeline.

Returns:

• (::Array<::Google::Cloud::Eventarc::V1::Pipeline::Destination>) —

  Required. List of destinations to which messages will be forwarded. Currently, exactly one destination is supported per Pipeline.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#display_name ⇒ ::String

Returns Optional. Display name of resource.

Returns:

• (::String) —

  Optional. Display name of resource.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#etag ⇒ ::String

Returns Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on create requests to ensure that the client has an up-to-date value before proceeding.

Returns:

• (::String) —

  Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on create requests to ensure that the client has an up-to-date value before proceeding.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#input_payload_format ⇒ ::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat

Returns Optional. The payload format expected for the messages received by the Pipeline. If input_payload_format is set then any messages not matching this format will be treated as persistent errors. If input_payload_format is not set, then the message data will be treated as an opaque binary and no output format can be set on the Pipeline through the Pipeline.Destination.output_payload_format field. Any Mediations on the Pipeline that involve access to the data field will fail as persistent errors.

Returns:

• (::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat) —

  Optional. The payload format expected for the messages received by the Pipeline. If input_payload_format is set then any messages not matching this format will be treated as persistent errors. If input_payload_format is not set, then the message data will be treated as an opaque binary and no output format can be set on the Pipeline through the Pipeline.Destination.output_payload_format field. Any Mediations on the Pipeline that involve access to the data field will fail as persistent errors.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#labels ⇒ ::Google::Protobuf::Map{::String => ::String}

Returns Optional. User labels attached to the Pipeline that can be used to group resources. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Returns:

• (::Google::Protobuf::Map{::String => ::String}) —

  Optional. User labels attached to the Pipeline that can be used to group resources. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#logging_config ⇒ ::Google::Cloud::Eventarc::V1::LoggingConfig

Returns Optional. Config to control Platform Logging for Pipelines.

Returns:

• (::Google::Cloud::Eventarc::V1::LoggingConfig) —

  Optional. Config to control Platform Logging for Pipelines.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#mediations ⇒ ::Array<::Google::Cloud::Eventarc::V1::Pipeline::Mediation>

Returns Optional. List of mediation operations to be performed on the message. Currently, only one Transformation operation is allowed in each Pipeline.

Returns:

• (::Array<::Google::Cloud::Eventarc::V1::Pipeline::Mediation>) —

  Optional. List of mediation operations to be performed on the message. Currently, only one Transformation operation is allowed in each Pipeline.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#name ⇒ ::String

Returns Identifier. The resource name of the Pipeline. Must be unique within the location of the project and must be in projects/{project}/locations/{location}/pipelines/{pipeline} format.

Returns:

• (::String) —

  Identifier. The resource name of the Pipeline. Must be unique within the location of the project and must be in projects/{project}/locations/{location}/pipelines/{pipeline} format.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#retry_policy ⇒ ::Google::Cloud::Eventarc::V1::Pipeline::RetryPolicy

Returns Optional. The retry policy to use in the pipeline.

Returns:

• (::Google::Cloud::Eventarc::V1::Pipeline::RetryPolicy) —

  Optional. The retry policy to use in the pipeline.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#uid ⇒ ::String (readonly)

Returns Output only. Server-assigned unique identifier for the Pipeline. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

Returns:

• (::String) —

  Output only. Server-assigned unique identifier for the Pipeline. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#update_time ⇒ ::Google::Protobuf::Timestamp (readonly)

Returns Output only. The last-modified time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Returns:

• (::Google::Protobuf::Timestamp) —

  Output only. The last-modified time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

# File 'proto_docs/google/cloud/eventarc/v1/pipeline.rb', line 94

class Pipeline
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents the format of message data.
  # @!attribute [rw] protobuf
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::ProtobufFormat]
  #     Optional. Protobuf format.
  # @!attribute [rw] avro
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::AvroFormat]
  #     Optional. Avro format.
  # @!attribute [rw] json
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat::JsonFormat]
  #     Optional. JSON format.
  class MessagePayloadFormat
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The format of a JSON message payload.
    class JsonFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of a Protobuf message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class ProtobufFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The format of an AVRO message payload.
    # @!attribute [rw] schema_definition
    #   @return [::String]
    #     Optional. The entire schema definition is stored in this field.
    class AvroFormat
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Represents a target of an invocation over HTTP.
  # @!attribute [rw] network_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::NetworkConfig]
  #     Optional. Network config is used to configure how Pipeline resolves and
  #     connects to a destination.
  # @!attribute [rw] http_endpoint
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::HttpEndpoint]
  #     Optional. An HTTP endpoint destination described by an URI.
  #     If a DNS FQDN is provided as the endpoint, Pipeline will create a
  #     peering zone to the consumer VPC and forward DNS requests to the VPC
  #     specified by network config to resolve the service endpoint. See:
  #     https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones
  # @!attribute [rw] workflow
  #   @return [::String]
  #     Optional. The resource name of the Workflow whose Executions are
  #     triggered by the events. The Workflow resource should be deployed in
  #     the same project as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/workflows/{workflow}`
  # @!attribute [rw] message_bus
  #   @return [::String]
  #     Optional. The resource name of the Message Bus to which events should
  #     be published. The Message Bus resource should exist in the same project
  #     as the Pipeline. Format:
  #     `projects/{project}/locations/{location}/messageBuses/{message_bus}`
  # @!attribute [rw] topic
  #   @return [::String]
  #     Optional. The resource name of the Pub/Sub topic to which events should
  #     be published. Format:
  #     `projects/{project}/locations/{location}/topics/{topic}`
  # @!attribute [rw] authentication_config
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig]
  #     Optional. An authentication config used to authenticate message requests,
  #     such that destinations can verify the source. For example, this can be
  #     used with private GCP destinations that require GCP credentials to access
  #     like Cloud Run. This field is optional and should be set only by users
  #     interested in authenticated push
  # @!attribute [rw] output_payload_format
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::MessagePayloadFormat]
  #     Optional. The message format before it is delivered to the destination.
  #     If not set, the message will be delivered in the format it was originally
  #     delivered to the Pipeline. This field can only be set if
  #     Pipeline.input_payload_format is also set.
  class Destination
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents a network config to be used for destination resolution and
    # connectivity.
    # @!attribute [rw] network_attachment
    #   @return [::String]
    #     Required. Name of the NetworkAttachment that allows access to the
    #     consumer VPC. Format:
    #     `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
    class NetworkConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a HTTP endpoint destination.
    # @!attribute [rw] uri
    #   @return [::String]
    #     Required. The URI of the HTTP enpdoint.
    #
    #     The value must be a RFC2396 URI string.
    #     Examples: `https://svc.us-central1.p.local:8080/route`.
    #     Only the HTTPS protocol is supported.
    # @!attribute [rw] message_binding_template
    #   @return [::String]
    #     Optional. The CEL expression used to modify how the destination-bound
    #     HTTP request is constructed.
    #
    #     If a binding expression is not specified here, the message
    #     is treated as a CloudEvent and is mapped to the HTTP request according
    #     to the CloudEvent HTTP Protocol Binding Binary Content Mode. In this
    #     representation, all fields except the `data` and `datacontenttype`
    #     field on the message are mapped to HTTP request headers with a prefix
    #     of `ce-`.
    #
    #     To construct the HTTP request payload and the value of the content-type
    #     HTTP header, the payload format is defined as follows:
    #     1) Use the output_payload_format_type on the Pipeline.Destination if it
    #        is set, else:
    #     2) Use the input_payload_format_type on the Pipeline if it is set,
    #        else:
    #     3) Treat the payload as opaque binary data.
    #
    #     The `data` field of the message is converted to the payload format or
    #     left as-is for case 3) and then attached as the payload of the HTTP
    #     request. The `content-type` header on the HTTP request is set to the
    #     payload format type or left empty for case 3). However, if a mediation
    #     has updated the `datacontenttype` field on the message so that it is
    #     not the same as the payload format type but it is still a prefix of the
    #     payload format type, then the `content-type` header on the HTTP request
    #     is set to this `datacontenttype` value. For example, if the
    #     `datacontenttype` is "application/json" and the payload format type is
    #     "application/json; charset=utf-8", then the `content-type` header on
    #     the HTTP request is set to "application/json; charset=utf-8".
    #
    #     If a non-empty binding expression is specified then this expression is
    #     used to modify the default CloudEvent HTTP Protocol Binding Binary
    #     Content representation.
    #     The result of the CEL expression must be a map of key/value pairs
    #     which is used as follows:
    #     - If a map named `headers` exists on the result of the expression,
    #     then its key/value pairs are directly mapped to the HTTP request
    #     headers. The headers values are constructed from the corresponding
    #     value type’s canonical representation. If the `headers` field doesn’t
    #     exist then the resulting HTTP request will be the headers of the
    #     CloudEvent HTTP Binding Binary Content Mode representation of the final
    #     message. Note: If the specified binding expression, has updated the
    #     `datacontenttype` field on the message so that it is not the same as
    #     the payload format type but it is still a prefix of the payload format
    #     type, then the `content-type` header in the `headers` map is set to
    #     this `datacontenttype` value.
    #     - If a field named `body` exists on the result of the expression then
    #     its value is directly mapped to the body of the request. If the value
    #     of the `body` field is of type bytes or string then it is used for
    #     the HTTP request body as-is, with no conversion. If the body field is
    #     of any other type then it is converted to a JSON string. If the body
    #     field does not exist then the resulting payload of the HTTP request
    #     will be data value of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message as described earlier.
    #     - Any other fields in the resulting expression will be ignored.
    #
    #     The CEL expression may access the incoming CloudEvent message in its
    #     definition, as follows:
    #     - The `data` field of the incoming CloudEvent message can be accessed
    #     using the `message.data` value. Subfields of `message.data` may also be
    #     accessed if an input_payload_format has been specified on the Pipeline.
    #     - Each attribute of the incoming CloudEvent message can be accessed
    #     using the `message.<key>` value, where <key> is replaced with the
    #     name of the attribute.
    #     - Existing headers can be accessed in the CEL expression using the
    #     `headers` variable. The `headers` variable defines a map of key/value
    #     pairs corresponding to the HTTP headers of the CloudEvent HTTP Binding
    #     Binary Content Mode representation of the final message as described
    #     earlier. For example, the following CEL expression can be used to
    #     construct an HTTP request by adding an additional header to the HTTP
    #     headers of the CloudEvent HTTP Binding Binary Content Mode
    #     representation of the final message and by overwriting the body of the
    #     request:
    #
    #     ```
    #     {
    #       "headers": headers.merge(\\{"new-header-key": "new-header-value"}),
    #       "body": "new-body"
    #     }
    #     ```
    #
    #     Additionally, the following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - toBase64Url:
    #       map.toBase64Url() -> string
    #         - Converts a CelValue to a base64url encoded string
    #     - toJsonString: map.toJsonString() -> string
    #         - Converts a CelValue to a JSON string
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    #
    #     The Pipeline expects that the message it receives adheres to the
    #     standard CloudEvent format. If it doesn’t then the outgoing message
    #     request may fail with a persistent error.
    class HttpEndpoint
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Represents a config used to authenticate message requests.
    # @!attribute [rw] google_oidc
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OidcToken]
    #     Optional. This authenticate method will apply Google OIDC tokens
    #     signed by a GCP service account to the requests.
    # @!attribute [rw] oauth_token
    #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Destination::AuthenticationConfig::OAuthToken]
    #     Optional. If specified, an [OAuth
    #     token](https://developers.google.com/identity/protocols/OAuth2) will
    #     be generated and attached as an `Authorization` header in the HTTP
    #     request.
    #
    #     This type of authorization should generally only be used when calling
    #     Google APIs hosted on *.googleapis.com.
    class AuthenticationConfig
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents a config used to authenticate with a Google OIDC token using
      # a GCP service account. Use this authentication method to invoke your
      # Cloud Run and Cloud Functions destinations or HTTP endpoints that
      # support Google OIDC.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the OIDC Token.
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow the
      #     Pipeline to create OpenID tokens for authenticated requests.
      # @!attribute [rw] audience
      #   @return [::String]
      #     Optional. Audience to be used to generate the OIDC Token. The
      #     audience claim identifies the recipient that the JWT is intended for.
      #     If unspecified, the destination URI will be used.
      class OidcToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Contains information needed for generating an
      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
      # This type of authorization should generally only be used when calling
      # Google APIs hosted on *.googleapis.com.
      # @!attribute [rw] service_account
      #   @return [::String]
      #     Required. Service account email used to generate the [OAuth
      #     token](https://developers.google.com/identity/protocols/OAuth2).
      #     The principal who calls this API must have
      #     iam.serviceAccounts.actAs permission in the service account. See
      #     https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common
      #     for more information. Eventarc service agents must have
      #     roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline
      #     to create OAuth2 tokens for authenticated requests.
      # @!attribute [rw] scope
      #   @return [::String]
      #     Optional. OAuth scope to be used for generating OAuth access token.
      #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
      #     will be used.
      class OAuthToken
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end
  end

  # Mediation defines different ways to modify the Pipeline.
  # @!attribute [rw] transformation
  #   @return [::Google::Cloud::Eventarc::V1::Pipeline::Mediation::Transformation]
  #     Optional. How the Pipeline is to transform messages
  class Mediation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Transformation defines the way to transform an incoming message.
    # @!attribute [rw] transformation_template
    #   @return [::String]
    #     Optional. The CEL expression template to apply to transform messages.
    #     The following CEL extension functions are provided for
    #     use in this CEL expression:
    #     - merge:
    #       map1.merge(map2) -> map3
    #         - Merges the passed CEL map with the existing CEL map the
    #         function is applied to.
    #         - If the same key exists in both maps, if the key's value is type
    #         map both maps are merged else the value from the passed map is
    #         used.
    #     - denormalize:
    #       map.denormalize() -> map
    #         - Denormalizes a CEL map such that every value of type map or key
    #         in the map is expanded to return a single level map.
    #         - The resulting keys are "." separated indices of the map keys.
    #         - For example:
    #           {
    #             "a": 1,
    #             "b": {
    #               "c": 2,
    #               "d": 3
    #             }
    #             "e": [4, 5]
    #           }
    #           .denormalize()
    #           -> {
    #             "a": 1,
    #             "b.c": 2,
    #             "b.d": 3,
    #             "e.0": 4,
    #             "e.1": 5
    #           }
    #     - setField:
    #       map.setField(key, value) -> message
    #         - Sets the field of the message with the given key to the
    #         given value.
    #         - If the field is not present it will be added.
    #         - If the field is present it will be overwritten.
    #         - The key can be a dot separated path to set a field in a nested
    #         message.
    #         - Key must be of type string.
    #         - Value may be any valid type.
    #     - removeFields:
    #       map.removeFields([key1, key2, ...]) -> message
    #         - Removes the fields of the map with the given keys.
    #         - The keys can be a dot separated path to remove a field in a
    #         nested message.
    #         - If a key is not found it will be ignored.
    #         - Keys must be of type string.
    #     - toMap:
    #       [map1, map2, ...].toMap() -> map
    #         - Converts a CEL list of CEL maps to a single CEL map
    #     - toDestinationPayloadFormat():
    #       message.data.toDestinationPayloadFormat() -> string or bytes
    #         - Converts the message data to the destination payload format
    #         specified in Pipeline.Destination.output_payload_format
    #         - This function is meant to be applied to the message.data field.
    #         - If the destination payload format is not set, the function will
    #         return the message data unchanged.
    #     - toCloudEventJsonWithPayloadFormat:
    #       message.toCloudEventJsonWithPayloadFormat() -> map
    #         - Converts a message to the corresponding structure of JSON
    #         format for CloudEvents
    #         - This function applies toDestinationPayloadFormat() to the
    #         message data. It also sets the corresponding datacontenttype of
    #         the CloudEvent, as indicated by
    #         Pipeline.Destination.output_payload_format. If no
    #         output_payload_format is set it will use the existing
    #         datacontenttype on the CloudEvent if present, else leave
    #         datacontenttype absent.
    #         - This function expects that the content of the message will
    #         adhere to the standard CloudEvent format. If it doesn’t then this
    #         function will fail.
    #         - The result is a CEL map that corresponds to the JSON
    #         representation of the CloudEvent. To convert that data to a JSON
    #         string it can be chained with the toJsonString function.
    class Transformation
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # The retry policy configuration for the Pipeline. The pipeline
  # exponentially backs off in case the destination is non responsive or
  # returns a retryable error code. The default semantics are as follows:
  # The backoff starts with a 5 second delay and doubles the
  # delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.).
  # The delay is capped at 60 seconds by default.
  # Please note that if you set the min_retry_delay and max_retry_delay fields
  # to the same value this will make the duration between retries constant.
  # @!attribute [rw] max_attempts
  #   @return [::Integer]
  #     Optional. The maximum number of delivery attempts for any message. The
  #     value must be between 1 and 100. The default value for this field is 5.
  # @!attribute [rw] min_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The minimum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 5.
  # @!attribute [rw] max_retry_delay
  #   @return [::Google::Protobuf::Duration]
  #     Optional. The maximum amount of seconds to wait between retry attempts.
  #     The value must be between 1 and 600. The default value for this field
  #     is 60.
  class RetryPolicy
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  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 AnnotationsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end