“exponential”

Exponential backoff policy

“linear”

Linear backoff policy

Spec is the part where the Channelable fulfills the Subscribable contract.

(Members of SubscribableSpec are embedded into this type.)

DeliverySpec contains the default delivery spec for each subscription to this Channelable. Each subscription delivery spec, if any, overrides this global delivery spec.

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

(Members of AddressStatus are embedded into this type.)

AddressStatus is the part where the Channelable fulfills the Addressable contract.

(Members of SubscribableStatus are embedded into this type.)

Subscribers is populated with the statuses of each of the Channelable’s subscribers.

(Members of DeliveryStatus are embedded into this type.)

DeliveryStatus contains a resolved URL to the dead letter sink address, and any other resolved delivery options.

DeadLetterChannel is a KReference and is set by the channel when it supports native error handling via a channel Failed messages are delivered here. Deprecated in favor of DeliveryStatus, to be removed September 2022.

DeadLetterSink is the sink receiving event that could not be sent to a destination.

Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.

Timeout is the timeout of each single request. The value must be greater than 0. More information on Duration format: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601

Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5148

BackoffPolicy is the retry backoff policy (linear, exponential).

BackoffDelay is the delay before retrying. More information on Duration format: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601

For linear policy, backoff delay is backoffDelay. For exponential policy, backoff delay is backoffDelay2^.

RetryAfterMax provides an optional upper bound on the duration specified in a “Retry-After” header when calculating backoff times for retrying 429 and 503 response codes. Setting the value to zero (“PT0S”) can be used to opt-out of respecting “Retry-After” header values altogether. This value only takes effect if “Retry” is configured, and also depends on specific implementations (Channels, Sources, etc.) choosing to provide this capability.

Note: This API is EXPERIMENTAL and might be changed at anytime. While this experimental feature is in the Alpha/Beta stage, you must provide a valid value to opt-in for supporting “Retry-After” headers. When the feature becomes Stable/GA “Retry-After” headers will be respected by default, and you can choose to specify “PT0S” to opt-out of supporting “Retry-After” headers. For more details: https://github.com/knative/eventing/issues/5811

More information on Duration format: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601

DeadLetterSink is a KReference that is the reference to the native, platform specific channel where failed events are sent to.

SubscribableSpec is the part where Subscribable object is configured as to be compatible with Subscribable contract.

SubscribableStatus is the part where SubscribableStatus object is configured as to be compatible with Subscribable contract.

This is the list of subscriptions for this subscribable.

This is the list of subscription’s statuses for this channel.

UID is used to understand the origin of the subscriber.

Generation of the origin of the subscriber with uid:UID.

SubscriberURI is the endpoint for the subscriber

ReplyURI is the endpoint for the reply

DeliverySpec contains options controlling the event delivery

UID is used to understand the origin of the subscriber.

Generation of the origin of the subscriber with uid:UID.

Status of the subscriber.

A human readable message indicating details of Ready status.

(Members of Placeable are embedded into this type.)

PodName is the name of the pod where the resource is placed

VReplicas is the number of virtual replicas assigned to in the pod

“exponential”

Exponential backoff policy

“linear”

Linear backoff policy

Spec is the part where the Channelable fulfills the Subscribable contract.

(Members of SubscribableSpec are embedded into this type.)

DeliverySpec contains options controlling the event delivery

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

(Members of AddressStatus are embedded into this type.)

AddressStatus is the part where the Channelable fulfills the Addressable contract.

(Members of SubscribableStatus are embedded into this type.)

Subscribers is populated with the statuses of each of the Channelable’s subscribers.

DeadLetterChannel is a KReference and is set by the channel when it supports native error handling via a channel Failed messages are delivered here.

DeadLetterSink is the sink receiving event that could not be sent to a destination.

Retry is the minimum number of retries the sender should attempt when sending an event before moving it to the dead letter sink.

Timeout is the timeout of each single request. More information on Duration format: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601

BackoffPolicy is the retry backoff policy (linear, exponential).

BackoffDelay is the delay before retrying. More information on Duration format: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601

For linear policy, backoff delay is backoffDelay. For exponential policy, backoff delay is backoffDelay2^.

DeadLetterChannel is a KReference that is the reference to the native, platform specific channel where failed events are sent to.

SubscribableSpec is the part where Subscribable object is configured as to be compatible with Subscribable contract.

SubscribableStatus is the part where SubscribableStatus object is configured as to be compatible with Subscribable contract.

This is the list of subscriptions for this subscribable.

This is the list of subscription’s statuses for this channel.

UID is used to understand the origin of the subscriber.

Generation of the origin of the subscriber with uid:UID.

SubscriberURI is the endpoint for the subscriber

ReplyURI is the endpoint for the reply

DeliverySpec contains options controlling the event delivery

UID is used to understand the origin of the subscriber.

Generation of the origin of the subscriber with uid:UID.

Status of the subscriber.

A human readable message indicating details of Ready status.

Spec defines the desired state of the Broker.

Status represents the current state of the Broker. This data may be out of date.

Spec defines the desired state of the Trigger.

Status represents the current state of the Trigger. This data may be out of date.

Config is a KReference to the configuration that specifies configuration options for this Broker. For example, this could be a pointer to a ConfigMap.

Delivery contains the delivery spec for each trigger to this Broker. Each trigger delivery spec, if any, overrides this global delivery spec.

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Broker that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

Broker is Addressable. It exposes the endpoint as an URI to get events delivered into the Broker mesh.

(Members of DeliveryStatus are embedded into this type.)

DeliveryStatus contains a resolved URL to the dead letter sink address, and any other resolved delivery options.

All evaluates to true if all the nested expressions evaluate to true. It must contain at least one filter expression.

Any evaluates to true if at least one of the nested expressions evaluates to true. It must contain at least one filter expression.

Not evaluates to true if the nested expression evaluates to false.

Exact evaluates to true if the value of the matching CloudEvents attribute matches exactly the String value specified (case-sensitive). Exact must contain exactly one property, where the key is the name of the CloudEvents attribute to be matched, and its value is the String value to use in the comparison. The attribute name and value specified in the filter expression cannot be empty strings.

Prefix evaluates to true if the value of the matching CloudEvents attribute starts with the String value specified (case-sensitive). Prefix must contain exactly one property, where the key is the name of the CloudEvents attribute to be matched, and its value is the String value to use in the comparison. The attribute name and value specified in the filter expression cannot be empty strings.

Suffix evaluates to true if the value of the matching CloudEvents attribute ends with the String value specified (case-sensitive). Suffix must contain exactly one property, where the key is the name of the CloudEvents attribute to be matched, and its value is the String value to use in the comparison. The attribute name and value specified in the filter expression cannot be empty strings.

CESQL is a CloudEvents SQL expression that will be evaluated to true or false against each CloudEvent.

Attributes filters events by exact match on event context attributes. Each key in the map is compared with the equivalent key in the event context. An event passes the filter if all values are equal to the specified values. Nested context attributes are not supported as keys. Only string values are supported.

Broker is the broker that this trigger receives events from.

Filter is the filter to apply against all events from the Broker. Only events that pass this filter will be sent to the Subscriber. If not specified, will default to allowing all events.

Filters is an experimental field that conforms to the CNCF CloudEvents Subscriptions API. It’s an array of filter expressions that evaluate to true or false. If any filter expression in the array evaluates to false, the event MUST NOT be sent to the Subscriber. If all the filter expressions in the array evaluate to true, the event MUST be attempted to be delivered. Absence of a filter or empty array implies a value of true. In the event of users specifying both Filter and Filters, then the latter will override the former. This will allow users to try out the effect of the new Filters field without compromising the existing attribute-based Filter and try it out on existing Trigger objects.

Subscriber is the addressable that receives events from the Broker that pass the Filter. It is required.

Delivery contains the delivery spec for this specific trigger.

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Trigger that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

SubscriberURI is the resolved URI of the receiver for this Trigger.

(Members of DeliveryStatus are embedded into this type.)

DeliveryStatus contains a resolved URL to the dead letter sink address, and any other resolved delivery options.

Spec defines the desired state of the EventType.

Status represents the current state of the EventType. This data may be out of date. TODO might be removed https://github.com/knative/eventing/issues/2750

Type represents the CloudEvents type. It is authoritative.

Source is a URI, it represents the CloudEvents source.

Schema is a URI, it represents the CloudEvents schemaurl extension attribute. It may be a JSON schema, a protobuf schema, etc. It is optional.

SchemaData allows the CloudEvents schema to be stored directly in the EventType. Content is dependent on the encoding. Optional attribute. The contents are not validated or manipulated by the system.

TODO remove https://github.com/knative/eventing/issues/2750 Broker refers to the Broker that can provide the EventType.

Description is an optional field used to describe the EventType, in any meaningful way.

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

Spec defines the desired state of the Parallel.

Status represents the current state of the Parallel. This data may be out of date.

Filter is the expression guarding the branch

Subscriber receiving the event when the filter passes

Reply is a Reference to where the result of Subscriber of this case gets sent to. If not specified, sent the result to the Parallel Reply

Delivery is the delivery specification for events to the subscriber This includes things like retries, DLS, etc.

FilterSubscriptionStatus corresponds to the filter subscription status.

FilterChannelStatus corresponds to the filter channel status.

SubscriptionStatus corresponds to the subscriber subscription status.

Channel is the reference to the underlying channel.

ReadyCondition indicates whether the Channel is ready or not.

Branches is the list of Filter/Subscribers pairs.

ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there are no defaults for the namespace).

Reply is a Reference to where the result of a case Subscriber gets sent to when the case does not have a Reply

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

IngressChannelStatus corresponds to the ingress channel status.

BranchStatuses is an array of corresponding to branch statuses. Matches the Spec.Branches array in the order.

(Members of AddressStatus are embedded into this type.)

AddressStatus is the starting point to this Parallel. Sending to this will target the first subscriber. It generally has the form {channel}.{namespace}.svc.{cluster domain name}

Subscription is the reference to the underlying Subscription.

ReadyCondition indicates whether the Subscription is ready or not.

Spec defines the desired state of the Sequence.

Status represents the current state of the Sequence. This data may be out of date.

Channel is the reference to the underlying channel.

ReadyCondition indicates whether the Channel is ready or not.

Steps is the list of Destinations (processors / functions) that will be called in the order provided. Each step has its own delivery options

ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there are no defaults for the namespace).

Reply is a Reference to where the result of the last Subscriber gets sent to.

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

SubscriptionStatuses is an array of corresponding Subscription statuses. Matches the Spec.Steps array in the order.

ChannelStatuses is an array of corresponding Channel statuses. Matches the Spec.Steps array in the order.

Address is the starting point to this Sequence. Sending to this will target the first subscriber. It generally has the form {channel}.{namespace}.svc.{cluster domain name}

(Members of Destination are embedded into this type.)

Subscriber receiving the step event

Delivery is the delivery specification for events to the subscriber This includes things like retries, DLS, etc.

Subscription is the reference to the underlying Subscription.

ReadyCondition indicates whether the Subscription is ready or not.

Spec defines the desired state of the Channel.

Status represents the current state of the Channel. This data may be out of date.

Spec defines the desired state of the Channel.

Status represents the current state of the Channel. This data may be out of date.

ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

(Members of ChannelableSpec are embedded into this type.)

Channel conforms to ChannelableSpec

(Members of ChannelableStatus are embedded into this type.)

Channel conforms to ChannelableStatus

Channel is an KReference to the Channel CRD backing this Channel.

Spec defines the Spec to use for each channel created. Passed in verbatim to the Channel CRD as Spec section.

(Members of ChannelableSpec are embedded into this type.)

Channel conforms to Duck type Channelable.

(Members of ChannelableStatus are embedded into this type.)

Channel conforms to Duck type ChannelableStatus.

Reference to a channel that will be used to create the subscription You can specify only the following fields of the KReference: - Kind - APIVersion - Name The resource pointed by this KReference must meet the contract to the ChannelableSpec duck type. If the resource does not meet this contract it will be reflected in the Subscription’s status.

This field is immutable. We have no good answer on what happens to the events that are currently in the channel being consumed from and what the semantics there should be. For now, you can always delete the Subscription and recreate it to point to a different channel, giving the user more control over what semantics should be used (drain the channel first, possibly have events dropped, etc.)

Subscriber is reference to (optional) function for processing events. Events from the Channel will be delivered here and replies are sent to a Destination as specified by the Reply.

Reply specifies (optionally) how to handle events returned from the Subscriber target.

Delivery configuration

(Members of Status are embedded into this type.)

inherits duck/v1 Status, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state.

PhysicalSubscription is the fully resolved values that this Subscription represents.

SubscriberURI is the fully resolved URI for spec.subscriber.

ReplyURI is the fully resolved URI for the spec.reply.

(Members of DeliveryStatus are embedded into this type.)

DeliveryStatus contains a resolved URL to the dead letter sink address, and any other resolved delivery options.

APIVersion - the API version of the resource to watch.

Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

APIVersion - the API version of the resource to watch.

Kind of the resource to watch. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

LabelSelector filters this source to objects to those resources pass the label selector. More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

(Members of SourceSpec are embedded into this type.)

inherits duck/v1 SourceSpec, which currently provides: Sink - a reference to an object that will resolve to a domain name or a URI directly to use as the sink. CloudEventOverrides - defines overrides to control the output format and modifications of the event sent to the sink.

Resource are the resources this source will track and send related lifecycle events from the Kubernetes ApiServer, with an optional label selector to help filter.

ResourceOwner is an additional filter to only track resources that are owned by a specific resource type. If ResourceOwner matches Resources[n] then Resources[n] is allowed to pass the ResourceOwner filter.

EventMode controls the format of the event. Reference sends a dataref event type for the resource under watch. Resource send the full resource lifecycle event. Defaults to Reference

ServiceAccountName is the name of the ServiceAccount to use to run this source. Defaults to default if not set.

(Members of SourceStatus are embedded into this type.)

inherits duck/v1 SourceStatus, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state. * SinkURI - the current active sink URI that has been configured for the Source.

(Members of SourceSpec are embedded into this type.)

inherits duck/v1 SourceSpec, which currently provides: Sink - a reference to an object that will resolve to a domain name or a URI directly to use as the sink. CloudEventOverrides - defines overrides to control the output format and modifications of the event sent to the sink.

Template describes the pods that will be created

(Members of SourceStatus are embedded into this type.)

inherits duck/v1 SourceStatus, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state. * SinkURI - the current active sink URI that has been configured for the Source.

(Members of SourceSpec are embedded into this type.)

inherits duck/v1 SourceSpec, which currently provides: Sink - a reference to an object that will resolve to a domain name or a URI directly to use as the sink. CloudEventOverrides - defines overrides to control the output format and modifications of the event sent to the sink.

Schedule is the cron schedule. Defaults to *.

Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

ContentType is the media type of Data or DataBase64. Default is empty.

Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.

DataBase64 is the base64-encoded string of the actual event’s body posted to the sink. Default is empty. Mutually exclusive with Data.

(Members of SourceStatus are embedded into this type.)

inherits duck/v1 SourceStatus, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state. * SinkURI - the current active sink URI that has been configured for the Source.

(Members of SourceSpec are embedded into this type.)

inherits duck/v1 SourceSpec, which currently provides: Sink - a reference to an object that will resolve to a domain name or a URI directly to use as the sink. CloudEventOverrides - defines overrides to control the output format and modifications of the event sent to the sink.

(Members of BindingSpec are embedded into this type.)

inherits duck/v1 BindingSpec, which currently provides: * Subject - Subject references the resource(s) whose “runtime contract” should be augmented by Binding implementations.

(Members of SourceStatus are embedded into this type.)

inherits duck/v1 SourceStatus, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state. * SinkURI - the current active sink URI that has been configured for the Source.

(Members of SourceSpec are embedded into this type.)

inherits duck/v1 SourceSpec, which currently provides: Sink - a reference to an object that will resolve to a domain name or a URI directly to use as the sink. CloudEventOverrides - defines overrides to control the output format and modifications of the event sent to the sink.

Schedule is the cron schedule. Defaults to *.

Timezone modifies the actual time relative to the specified timezone. Defaults to the system time zone. More general information about time zones: https://www.iana.org/time-zones List of valid timezone values: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

ContentType is the media type of Data or DataBase64. Default is empty.

Data is data used as the body of the event posted to the sink. Default is empty. Mutually exclusive with DataBase64.

DataBase64 is the base64-encoded string of the actual event’s body posted to the sink. Default is empty. Mutually exclusive with Data.

(Members of SourceStatus are embedded into this type.)

inherits duck/v1 SourceStatus, which currently provides: ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. Conditions - the latest available observations of a resource’s current state. * SinkURI - the current active sink URI that has been configured for the Source.