事件 API
包
- duck.knative.dev/v1
- duck.knative.dev/v1alpha1
- duck.knative.dev/v1beta1
- eventing.knative.dev/v1
- eventing.knative.dev/v1alpha1
- eventing.knative.dev/v1beta1
- eventing.knative.dev/v1beta2
- eventing.knative.dev/v1beta3
- flows.knative.dev/v1
- messaging.knative.dev/v1
- sinks.knative.dev/v1alpha1
- sources.knative.dev/v1
- sources.knative.dev/v1beta2
duck.knative.dev/v1
Package v1 是 API 的 v1 版本。
资源类型
AppliedEventPoliciesStatus
(出现在:ChannelableStatus, BrokerStatus, ParallelStatus, SequenceStatus, JobSinkStatus)
AppliedEventPoliciesStatus 包含应用于资源的策略列表。此类型旨在嵌入到状态结构中。
字段 | 描述 |
---|---|
policies []AppliedEventPolicyRef |
(可选)
Policies 保存应用的 EventPolicies 列表 |
AppliedEventPolicyRef
(出现在:AppliedEventPoliciesStatus)
AppliedEventPolicyRef 是对 EventPolicy 的引用
字段 | 描述 |
---|---|
apiVersion string |
应用的 EventPolicy 的 APIVersion。这表明资源支持 EventPolicy 的哪个版本。 |
name string |
应用的 EventPolicy 的名称 |
BackoffPolicyType (string
别名)
(出现在:DeliverySpec)
BackoffPolicyType 是回退策略的类型
值 | 描述 |
---|---|
"exponential" |
指数回退策略 |
"linear" |
线性回退策略 |
Channelable
Channelable 是一个骨架类型,以我们期望资源编写者定义兼容资源的方式包装 Subscribable 和 Addressable。我们通常会使用此类型来反序列化 Channelable 对象引用并访问它们的订阅和地址数据。这不是一个真正的资源。
字段 | 描述 | ||||
---|---|---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||
spec ChannelableSpec |
Spec 是 Channelable 履行 Subscribable 合同的部分。
|
||||
status ChannelableStatus |
ChannelableSpec
(出现在:Channelable, ChannelSpec, InMemoryChannelSpec)
ChannelableSpec 包含 Channelable 对象的 Spec
字段 | 描述 |
---|---|
SubscribableSpec SubscribableSpec |
( |
delivery DeliverySpec |
(可选)
DeliverySpec 包含对每个订阅此 Channelable 的默认传递规范。每个订阅传递规范(如果有)都会覆盖此全局传递规范。 |
ChannelableStatus
(出现在:Channelable, ChannelStatus, InMemoryChannelStatus)
ChannelableStatus 包含 Channelable 对象的状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
AddressStatus knative.dev/pkg/apis/duck/v1.AddressStatus |
( AddressStatus 是 Channelable 履行 Addressable 合同的部分。 |
SubscribableStatus SubscribableStatus |
( Subscribers 使用 Channelable 的每个订阅者的状态填充。 |
DeliveryStatus DeliveryStatus |
( DeliveryStatus 包含解析后的死信接收器地址的 URL 以及任何其他解析的传递选项。 |
AppliedEventPoliciesStatus AppliedEventPoliciesStatus |
( AppliedEventPoliciesStatus 包含应用于此 Channel 的 EventPolicies 列表 |
DeliverySpec
(出现在:ChannelableSpec, SubscriberSpec, BrokerSpec, TriggerSpec, ParallelBranch, SequenceStep, SubscriptionSpec)
DeliverySpec 包含事件发送者的传递选项,例如可信赖通道和源。
字段 | 描述 |
---|---|
deadLetterSink knative.dev/pkg/apis/duck/v1.Destination |
(可选)
DeadLetterSink 是接收无法发送到目的地的事件的接收器。 |
retry int32 |
(可选)
Retry 是发送方在将事件移动到死信接收器之前应尝试发送事件的最小重试次数。 |
timeout string |
(可选)
Timeout 是每个单一请求的超时。该值必须大于 0。有关持续时间格式的更多信息:- https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601 注意:此 API 为实验性 API,可能会随时中断。有关更多详细信息:https://github.com/knative/eventing/issues/5148 |
backoffPolicy BackoffPolicyType |
(可选)
BackoffPolicy 是重试回退策略(线性、指数)。 |
backoffDelay string |
(可选)
BackoffDelay 是重试之前的延迟。有关持续时间格式的更多信息:- https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601 对于线性策略,回退延迟为 backoffDelay* |
retryAfterMax string |
(可选)
RetryAfterMax 为在计算 429 和 503 响应代码的重试回退时间时,在“Retry-After”标头中指定的持续时间提供可选的上限。将该值设置为零(“PT0S”)可用于完全选择不遵守“Retry-After”标头值。此值仅在配置“Retry”时生效,并且还取决于特定实现(Channel、Source 等)选择提供此功能。 注意:此 API 为实验性 API,可能会随时更改。虽然此实验性功能处于 Alpha/Beta 阶段,但您必须提供一个有效的值来选择加入支持“Retry-After”标头。当该功能变为 Stable/GA 时,将默认遵守“Retry-After”标头,您可以选择指定“PT0S”来选择不遵守“Retry-After”标头。有关更多详细信息:https://github.com/knative/eventing/issues/5811 有关持续时间格式的更多信息:- https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601 |
format FormatType |
(可选)
format 指定云事件所需的事件格式。它可以是以下值之一:- nil:默认值,不需要特定格式。- “JSON”:表示事件应处于结构化模式。- “binary”:表示事件应处于二进制模式。 |
DeliveryStatus
(出现在:ChannelableStatus, BrokerStatus, TriggerStatus, SubscriptionStatusPhysicalSubscription)
DeliveryStatus 包含支持传递选项的对象的状态。此类型旨在嵌入到状态结构中。
字段 | 描述 |
---|---|
deadLetterSinkUri knative.dev/pkg/apis.URL |
(可选)
DeadLetterSink 是一个 KReference,它是对将失败事件发送到的本机、平台特定通道的引用。 |
deadLetterSinkCACerts string |
(可选)
DeadLetterSinkCACerts 是 Certification Authority (CA) 证书,采用 https://www.rfc-editor.org/rfc/rfc7468 中规定的 PEM 格式。 |
deadLetterSinkAudience string |
(可选)
DeadLetterSinkAudience 是 DeadLetterSink 的 OIDC 观众 |
FormatType (string
别名)
(出现在:DeliverySpec)
FormatType 是传递格式的类型
值 | 描述 |
---|---|
"binary" |
|
"json" |
Subscribable
Subscribable 是一个骨架类型,以我们期望资源编写者定义兼容资源的方式包装 Subscribable。我们通常会使用此类型来反序列化 SubscribableType 对象引用并访问订阅数据。这不是一个真正的资源。
字段 | 描述 | ||
---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||
spec SubscribableSpec |
SubscribableSpec 是 Subscribable 对象配置为与 Subscribable 合同兼容的部分。
|
||
status SubscribableStatus |
SubscribableStatus 是 SubscribableStatus 对象配置为与 Subscribable 合同兼容的部分。 |
SubscribableSpec
(出现在:ChannelableSpec, Subscribable)
SubscribableSpec 显示了我们期望人们在他们的 Spec 字段中嵌入 Subscribable 的方式。
字段 | 描述 |
---|---|
subscribers []SubscriberSpec |
这是此可订阅对象的订阅列表。 |
SubscribableStatus
(出现在:ChannelableStatus, Subscribable)
SubscribableStatus 是资源状态部分中可订阅部分状态的模式。
字段 | 描述 |
---|---|
subscribers []SubscriberStatus |
这是此频道订阅状态的列表。 |
SubscriberSpec
(显示于:SubscribableSpec)
SubscriberSpec 定义了可订阅的单个订阅者。
SubscriberURI 和 ReplyURI 中至少必须有一个存在
字段 | 描述 |
---|---|
name string |
(可选)
名称用于识别原始订阅对象。 |
uid k8s.io/apimachinery/pkg/types.UID |
(可选)
UID 用于了解订阅者的来源。 |
generation int64 |
(可选)
具有 uid:UID 的订阅者来源的生成。 |
subscriberUri knative.dev/pkg/apis.URL |
(可选)
SubscriberURI 是订阅者的端点 |
subscriberCACerts string |
(可选)
SubscriberCACerts 是订阅者 Uri 的证书颁发机构 (CA) 证书,采用 PEM 格式,符合 https://www.rfc-editor.org/rfc/rfc7468 |
subscriberAudience string |
(可选)
SubscriberAudience 是 subscriberUri 的 OIDC 受众。 |
replyUri knative.dev/pkg/apis.URL |
(可选)
ReplyURI 是回复的端点 |
replyCACerts string |
(可选)
ReplyCACerts 是回复 Uri 的证书颁发机构 (CA) 证书,采用 PEM 格式,符合 https://www.rfc-editor.org/rfc/rfc7468 |
replyAudience string |
(可选)
ReplyAudience 是 replyUri 的 OIDC 受众。 |
delivery DeliverySpec |
(可选)
DeliverySpec 包含控制事件传递的选项 |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 包含订阅的服务帐户名称 |
SubscriberStatus
(显示于:SubscribableStatus)
SubscriberStatus 定义了频道单个订阅者的状态。
字段 | 描述 |
---|---|
uid k8s.io/apimachinery/pkg/types.UID |
(可选)
UID 用于了解订阅者的来源。 |
observedGeneration int64 |
(可选)
具有 uid:UID 的订阅者来源的生成。 |
ready Kubernetes core/v1.ConditionStatus |
订阅者的状态。 |
message string |
(可选)
一条人类可读的消息,指示 Ready 状态的详细信息。 |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 提供了与 OIDC 身份验证相关的信息。 |
duck.knative.dev/v1alpha1
资源类型
Placeable
(显示于:PlaceableStatus)
Placeable 是 podName 和虚拟副本对的列表。每对表示虚拟副本分配给 pod
字段 | 描述 |
---|---|
maxAllowedVReplicas int32 |
|
placements []Placement |
PlaceableStatus
(显示于:PlaceableType)
字段 | 描述 |
---|---|
Placeable Placeable |
( |
PlaceableType
PlaceableType 是一种骨架类型,以我们期望资源编写者定义兼容资源的方式嵌入 Placeable。我们通常会使用这种类型来反序列化 Placeable 对象引用并访问 Placeable 数据。这不是一个真正的资源。
字段 | 描述 |
---|---|
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
status PlaceableStatus |
Placement
(显示于:Placeable)
字段 | 描述 |
---|---|
podName string |
PodName 是放置资源的 pod 的名称 |
vreplicas int32 |
VReplicas 是分配给 pod 的虚拟副本数量 |
duck.knative.dev/v1beta1
Package v1beta1 是 API 的 v1beta1 版本。
资源类型
BackoffPolicyType (string
别名)
(显示于:DeliverySpec)
BackoffPolicyType 是回退策略的类型
值 | 描述 |
---|---|
"exponential" |
指数回退策略 |
"linear" |
线性回退策略 |
Channelable
Channelable 是一个骨架类型,以我们期望资源编写者定义兼容资源的方式包装 Subscribable 和 Addressable。我们通常会使用此类型来反序列化 Channelable 对象引用并访问它们的订阅和地址数据。这不是一个真正的资源。
字段 | 描述 | ||||
---|---|---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||
spec ChannelableSpec |
Spec 是 Channelable 履行 Subscribable 合同的部分。
|
||||
status ChannelableStatus |
ChannelableSpec
(显示于:Channelable)
ChannelableSpec 包含 Channelable 对象的 Spec
字段 | 描述 |
---|---|
SubscribableSpec SubscribableSpec |
( |
delivery DeliverySpec |
(可选)
DeliverySpec 包含控制事件传递的选项 |
ChannelableStatus
(显示于:Channelable)
ChannelableStatus 包含 Channelable 对象的状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
AddressStatus knative.dev/pkg/apis/duck/v1.AddressStatus |
( AddressStatus 是 Channelable 履行 Addressable 合同的部分。 |
SubscribableStatus SubscribableStatus |
( Subscribers 使用 Channelable 的每个订阅者的状态填充。 |
deadLetterChannel knative.dev/pkg/apis/duck/v1.KReference |
(可选)
DeadLetterChannel 是一个 KReference,当频道支持通过频道进行本机错误处理时由频道设置。失败的消息将交付到这里。 |
DeliverySpec
(显示于:ChannelableSpec, SubscriberSpec)
DeliverySpec 包含事件发送者的传递选项,例如可信赖通道和源。
字段 | 描述 |
---|---|
deadLetterSink knative.dev/pkg/apis/duck/v1.Destination |
(可选)
DeadLetterSink 是接收无法发送到目的地的事件的接收器。 |
retry int32 |
(可选)
Retry 是发送方在将事件移动到死信接收器之前应尝试发送事件的最小重试次数。 |
timeout string |
Timeout 是每个单一请求的超时时间。有关 Duration 格式的更多信息: - https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601 |
backoffPolicy BackoffPolicyType |
(可选)
BackoffPolicy 是重试回退策略(线性、指数)。 |
backoffDelay string |
(可选)
BackoffDelay 是重试之前的延迟。有关持续时间格式的更多信息:- https://www.iso.org/iso-8601-date-and-time-format.html - https://en.wikipedia.org/wiki/ISO_8601 对于线性策略,回退延迟为 backoffDelay* |
DeliveryStatus
DeliveryStatus 包含支持传递选项的对象的状态。
字段 | 描述 |
---|---|
deadLetterChannel knative.dev/pkg/apis/duck/v1.KReference |
(可选)
DeadLetterChannel 是一个 KReference,它是对本机、平台特定频道的引用,失败的事件将发送到该频道。 |
Subscribable
Subscribable 是一个骨架类型,以我们期望资源编写者定义兼容资源的方式包装 Subscribable。我们通常会使用此类型来反序列化 SubscribableType 对象引用并访问订阅数据。这不是一个真正的资源。
字段 | 描述 | ||
---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||
spec SubscribableSpec |
SubscribableSpec 是 Subscribable 对象配置为与 Subscribable 合同兼容的部分。
|
||
status SubscribableStatus |
SubscribableStatus 是 SubscribableStatus 对象配置为与 Subscribable 合同兼容的部分。 |
SubscribableSpec
(显示于:ChannelableSpec, Subscribable)
SubscribableSpec 显示了我们期望人们在他们的 Spec 字段中嵌入 Subscribable 的方式。
字段 | 描述 |
---|---|
subscribers []SubscriberSpec |
这是此可订阅对象的订阅列表。 |
SubscribableStatus
(显示于:ChannelableStatus, Subscribable)
SubscribableStatus 是资源状态部分中可订阅部分状态的模式。
字段 | 描述 |
---|---|
subscribers []SubscriberStatus |
这是此频道订阅状态的列表。 |
SubscriberSpec
(显示于:SubscribableSpec)
SubscriberSpec 定义了可订阅的单个订阅者。
SubscriberURI 和 ReplyURI 中至少必须有一个存在
字段 | 描述 |
---|---|
uid k8s.io/apimachinery/pkg/types.UID |
(可选)
UID 用于了解订阅者的来源。 |
generation int64 |
(可选)
具有 uid:UID 的订阅者来源的生成。 |
subscriberUri knative.dev/pkg/apis.URL |
(可选)
SubscriberURI 是订阅者的端点 |
replyUri knative.dev/pkg/apis.URL |
(可选)
ReplyURI 是回复的端点 |
delivery DeliverySpec |
(可选)
DeliverySpec 包含控制事件传递的选项 |
SubscriberStatus
(显示于:SubscribableStatus)
SubscriberStatus 定义了频道单个订阅者的状态。
字段 | 描述 |
---|---|
uid k8s.io/apimachinery/pkg/types.UID |
(可选)
UID 用于了解订阅者的来源。 |
observedGeneration int64 |
(可选)
具有 uid:UID 的订阅者来源的生成。 |
ready Kubernetes core/v1.ConditionStatus |
订阅者的状态。 |
message string |
(可选)
一条人类可读的消息,指示 Ready 状态的详细信息。 |
eventing.knative.dev/v1
Package v1 是 API 的 v1 版本。
资源类型
Broker
Broker 收集一池事件,这些事件可以使用 Trigger 消费。Broker 提供一个众所周知的事件传递端点,发送者可以使用该端点,而无需了解事件路由策略的太多信息。订阅者使用 Trigger 从 Broker 的事件池请求将事件传递到特定的 URL 或可寻址端点。
字段 | 描述 | ||||
---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1
|
||||
kind string |
Broker |
||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||
spec BrokerSpec |
Spec 定义了 Broker 的期望状态。
|
||||
status BrokerStatus |
(可选)
Status 表示 Broker 的当前状态。此数据可能已过时。 |
Trigger
Trigger 表示从 Broker 的事件池将事件传递到订阅者的请求。
字段 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1
|
||||||||||||
kind string |
Trigger |
||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||||||||
spec TriggerSpec |
Spec 定义了 Trigger 的期望状态。
|
||||||||||||
status TriggerStatus |
(可选)
Status 表示 Trigger 的当前状态。此数据可能已过时。 |
BrokerSpec
(显示于:Broker)
字段 | 描述 |
---|---|
config knative.dev/pkg/apis/duck/v1.KReference |
(可选)
Config 是对配置的 KReference,该配置指定此 Broker 的配置选项。例如,这可以是指向 ConfigMap 的指针。 |
delivery DeliverySpec |
(可选)
Delivery 包含对该 Broker 的每个触发器的传递规范。每个触发器传递规范(如果有)都将覆盖此全局传递规范。 |
BrokerStatus
(显示于:Broker)
BrokerStatus 表示 Broker 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 Status,它目前提供: * ObservedGeneration - 由控制器最后处理的 Broker 的“Generation”。 * Conditions - 资源当前状态的最新可用观察结果。 |
AddressStatus knative.dev/pkg/apis/duck/v1.AddressStatus |
( AddressStatus 是 Broker 履行可寻址合同的部分。它将端点公开为 URI,以将事件传递到 Broker 网格中。 |
DeliveryStatus DeliveryStatus |
( DeliveryStatus 包含解析后的死信接收器地址的 URL 以及任何其他解析的传递选项。 |
AppliedEventPoliciesStatus AppliedEventPoliciesStatus |
( AppliedEventPoliciesStatus 包含应用于此 Broker 的 EventPolicies 列表 |
SubscriptionsAPIFilter
(显示于:SubscriptionsAPIFilter, TriggerSpec, EventPolicySpec, ApiServerSourceSpec)
SubscriptionsAPIFilter 允许使用 CloudEvents Subscriptions API 定义过滤器表达式。如果指定了多个过滤器,则应用与 SubscriptionsAPIFilter.All 相同的语义。如果没有指定过滤器方言或空对象,则过滤器始终接受事件。
字段 | 描述 |
---|---|
all []SubscriptionsAPIFilter |
(可选)
如果所有嵌套表达式都求值为真,则 All 求值为真。它必须包含至少一个过滤器表达式。 |
any []SubscriptionsAPIFilter |
(可选)
如果至少一个嵌套表达式求值为真,则 Any 求值为真。它必须包含至少一个过滤器表达式。 |
not SubscriptionsAPIFilter |
(可选)
如果嵌套表达式求值为假,则 Not 求值为真。 |
exact map[string]string |
(可选)
如果匹配的 CloudEvents 属性的值 MUST 完全匹配指定的关联值 String(区分大小写),则 Exact 求值为真。键是要匹配的 CloudEvents 属性的名称,它们的值是要在比较中使用的 String 值。过滤器表达式中指定的属性名称和值 MUST NOT 为空字符串。 |
prefix map[string]string |
(可选)
如果匹配的 CloudEvents 属性的值 MUST 都以指定的关联值 String 开头(区分大小写),则 Prefix 求值为真。键是要匹配的 CloudEvents 属性的名称,它们的值是要在比较中使用的 String 值。过滤器表达式中指定的属性名称和值 MUST NOT 为空字符串。 |
suffix map[string]string |
(可选)
如果匹配的 CloudEvents 属性的值 MUST 都以指定的关联值 String 结尾(区分大小写),则 Suffix 求值为真。键是要匹配的 CloudEvents 属性的名称,它们的值是要在比较中使用的 String 值。过滤器表达式中指定的属性名称和值 MUST NOT 为空字符串。 |
cesql string |
(可选)
CESQL 是一个 CloudEvents SQL 表达式,它将针对每个 CloudEvent 求值为真或假。 |
TriggerFilter
(显示于:TriggerSpec)
字段 | 描述 |
---|---|
attributes TriggerFilterAttributes |
(可选)
Attributes 通过对事件上下文属性进行精确匹配来过滤事件。映射中的每个键都与事件上下文中的等效键进行比较。如果所有值都等于指定的值,则事件通过过滤器。不支持嵌套上下文属性作为键。仅支持字符串值。 |
TriggerFilterAttributes (map[string]string
别名)
(显示于:TriggerFilter)
TriggerFilterAttributes 是一个上下文属性名称到值的映射,用于通过相等性进行过滤。只有完全匹配才会通过过滤器。可以使用值 ” 来指示所有字符串匹配。
TriggerSpec
(显示于:Trigger)
字段 | 描述 |
---|---|
broker string |
Broker 是此触发器接收事件的代理。 |
brokerRef knative.dev/pkg/apis/duck/v1.KReference |
BrokerRef 是用于跨命名空间引用的代理。 |
filter TriggerFilter |
(可选)
Filter 是要对来自 Broker 的所有事件应用的过滤器。只有通过此过滤器的事件才会发送到订阅者。如果未指定,将默认允许所有事件。 |
filters []SubscriptionsAPIFilter |
(可选)
Filters 是一个实验性字段,符合 CNCF CloudEvents Subscriptions API。它是一系列求值为真或假的过滤器表达式。如果数组中的任何过滤器表达式求值为假,则事件 MUST NOT 发送到订阅者。如果数组中的所有过滤器表达式都求值为真,则 MUST 尝试传递事件。没有过滤器或空数组意味着值为真。如果用户同时指定了 Filter 和 Filters,则后者将覆盖前者。这将允许用户尝试新 Filters 字段的效果,而不会影响现有的基于属性的 Filter,并尝试将其应用到现有的 Trigger 对象上。 |
subscriber knative.dev/pkg/apis/duck/v1.Destination |
Subscriber 是从 Broker 接收通过 Filter 的事件的可寻址端点。这是必需的。 |
delivery DeliverySpec |
(可选)
Delivery 包含此特定触发器的传递规范。 |
TriggerStatus
(显示于:Trigger)
TriggerStatus 表示 Trigger 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 Status,它目前提供: * ObservedGeneration - 由控制器最后处理的 Trigger 的“Generation”。 * Conditions - 资源当前状态的最新可用观察结果。 |
subscriberUri knative.dev/pkg/apis.URL |
(可选)
SubscriberURI 是此 Trigger 的接收器的已解析 URI。 |
subscriberCACerts string |
(可选)
SubscriberCACerts 是此 Trigger 的接收器的证书颁发机构 (CA) 证书,采用 PEM 格式,符合 https://www.rfc-editor.org/rfc/rfc7468 |
subscriberAudience string |
(可选)
SubscriberAudience 是订阅者的 OIDC 受众。 |
DeliveryStatus DeliveryStatus |
( DeliveryStatus 包含解析后的死信接收器地址的 URL 以及任何其他解析的传递选项。 |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 提供了与 OIDC 身份验证相关的信息。 |
eventing.knative.dev/v1alpha1
Package v1alpha1 是 API 的 v1alpha1 版本。
资源类型
EventPolicy
EventPolicy 代表可寻址资源(Broker、Channel、sink)的策略。
字段 | 描述 | ||||||
---|---|---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1alpha1
|
||||||
kind string |
EventPolicy |
||||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||
spec EventPolicySpec |
Spec 定义了 EventPolicy 的期望状态。
|
||||||
status EventPolicyStatus |
(可选)
Status 表示 EventPolicy 的当前状态。此数据可能已过时。 |
EventPolicyFromReference
(显示于:EventPolicySpecFrom)
字段 | 描述 |
---|---|
apiVersion string |
引用的 API 版本。 |
kind string |
引用的类型。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
name string |
引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names |
命名空间 string |
(可选)
引用的命名空间。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/ 这是一个可选字段,如果省略,它将默认为包含它的对象。 |
EventPolicySelector
(出现在:EventPolicySpecTo)
字段 | 描述 |
---|---|
LabelSelector Kubernetes meta/v1.LabelSelector |
( |
EventPolicySpec
(出现在:EventPolicy)
字段 | 描述 |
---|---|
to []EventPolicySpecTo |
(可选)
To 列出此策略适用的所有资源。此列表中的资源必须像入站一样工作,并具有受众。这些资源与 EventPolicy 位于同一个命名空间中。空列表意味着它适用于 EventPolicies 命名空间中的所有资源 |
from []EventPolicySpecFrom |
From 是允许将事件发送到目标 (.spec.to) 的源或 oidc 身份列表。 |
filters []SubscriptionsAPIFilter |
(可选)
Filters 是 SubscriptoinsApi 过滤器的列表,这些过滤器决定是否接受事件。它是一系列求值为真或假的过滤器表达式。如果数组中的任何过滤器表达式求值为假,则事件将不会通过目标资源的入站。没有任何过滤器意味着过滤器始终求值为真。 |
EventPolicySpecFrom
(出现在:EventPolicySpec)
字段 | 描述 |
---|---|
ref EventPolicyFromReference |
(可选)
Ref 包含对允许向目标发送事件的资源的直接引用。 |
sub string |
(可选)
Sub 设置允许向目标发送事件的 OIDC 身份名称。也可以设置类似于 glob 的模式来匹配任何后缀。 |
EventPolicySpecTo
(出现在:EventPolicySpec)
字段 | 描述 |
---|---|
ref EventPolicyToReference |
(可选)
Ref 包含对目标的直接引用。 |
selector EventPolicySelector |
(可选)
Selector 包含一个选择器,用于对目标进行分组。 |
EventPolicyStatus
(出现在:EventPolicy)
EventPolicyStatus 表示 EventPolicy 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
from []string |
From 是从 .spec.from 解析的 OIDC 身份列表。 |
EventPolicyToReference
(出现在:EventPolicySpecTo)
字段 | 描述 |
---|---|
apiVersion string |
引用的 API 版本。 |
kind string |
引用的类型。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
name string |
引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names |
eventing.knative.dev/v1beta1
Package v1beta1 是 API 的 v1beta1 版本。
资源类型
EventType
EventType 代表可以从 Broker 消费的事件类型。已弃用:请改用 v1beta2.EventType。
字段 | 描述 | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1beta1
|
||||||||||||||
kind string |
EventType |
||||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||||||||||
spec EventTypeSpec |
Spec 定义 EventType 的期望状态。
|
||||||||||||||
status EventTypeStatus |
(可选)
Status 表示 EventType 的当前状态。此数据可能已过时。 |
EventTypeSpec
(出现在:EventType)
字段 | 描述 |
---|---|
type string |
Type 代表 CloudEvents 类型。它具有权威性。 |
source knative.dev/pkg/apis.URL |
(可选)
Source 是一个 URI,它代表 CloudEvents 源。 |
schema knative.dev/pkg/apis.URL |
(可选)
Schema 是一个 URI,它代表 CloudEvents schemaurl 扩展属性。它可以是 JSON 架构、protobuf 架构等。它是可选的。 |
schemaData string |
(可选)
SchemaData 允许将 CloudEvents 架构直接存储在 EventType 中。内容取决于编码。可选属性。系统不会验证或操作内容。 |
broker string |
(可选)
Broker 指向可以提供 EventType 的 Broker。 |
reference knative.dev/pkg/apis/duck/v1.KReference |
(可选)
Reference 是对所属可寻址对象的 KReference。例如,这可能是指向 Broker 的指针。 |
description string |
(可选)
Description 是一个可选字段,用于以任何有意义的方式描述 EventType。 |
EventTypeStatus
(出现在:EventType)
EventTypeStatus 表示 EventType 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
eventing.knative.dev/v1beta2
包 v1beta2 是 API 的 v1beta2 版本。
资源类型
EventType
EventType 代表可以从 Broker 消费的事件类型。
字段 | 描述 | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1beta2
|
||||||||||||||
kind string |
EventType |
||||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||||||||||
spec EventTypeSpec |
Spec 定义 EventType 的期望状态。
|
||||||||||||||
status EventTypeStatus |
(可选)
Status 表示 EventType 的当前状态。此数据可能已过时。 |
EventTypeSpec
(出现在:EventType)
字段 | 描述 |
---|---|
type string |
Type 代表 CloudEvents 类型。它具有权威性。 |
source knative.dev/pkg/apis.URL |
(可选)
Source 是一个 URI,它代表 CloudEvents 源。 |
schema knative.dev/pkg/apis.URL |
(可选)
Schema 是一个 URI,它代表 CloudEvents schemaurl 扩展属性。它可以是 JSON 架构、protobuf 架构等。它是可选的。 |
schemaData string |
(可选)
SchemaData 允许将 CloudEvents 架构直接存储在 EventType 中。内容取决于编码。可选属性。系统不会验证或操作内容。 |
broker string |
(可选)
Broker 指向可以提供 EventType 的 Broker。已弃用:此字段已弃用,将在未来版本中删除。 |
reference knative.dev/pkg/apis/duck/v1.KReference |
(可选)
Reference 是对所属可寻址对象的 KReference。例如,这可能是指向 Broker 的指针。 |
description string |
(可选)
Description 是一个可选字段,用于以任何有意义的方式描述 EventType。 |
EventTypeStatus
(出现在:EventType)
EventTypeStatus 表示 EventType 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
eventing.knative.dev/v1beta3
包 v1beta3 是 API 的 v1beta3 版本。
资源类型
EventType
EventType 代表可以从 Broker 消费的事件类型。
字段 | 描述 | ||||||
---|---|---|---|---|---|---|---|
apiVersion string |
eventing.knative.dev/v1beta3
|
||||||
kind string |
EventType |
||||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||
spec EventTypeSpec |
Spec 定义 EventType 的期望状态。
|
||||||
status EventTypeStatus |
(可选)
Status 表示 EventType 的当前状态。此数据可能已过时。 |
EventAttributeDefinition
(出现在:EventTypeSpec)
字段 | 描述 |
---|---|
name string |
Name 是 CloudEvents 属性的名称。 |
required bool |
Required 确定是否必须在相应的 CloudEvents 上设置此属性。 |
value string |
Value 是一个字符串,表示 EventType 属性的允许值。它可以是单个值,例如“/apis/v1/namespaces/default/pingsource/ps”,也可以是允许值的模板,例如“/apis/v1/namespaces/{namespace}/pingsource/{sourceName}。要指定字符串值中可能在不同 CloudEvents 之间发生变化的部分,可以使用大括号 {},并在其中可选地包含变量名称。 |
EventTypeSpec
(出现在:EventType)
字段 | 描述 |
---|---|
reference knative.dev/pkg/apis/duck/v1.KReference |
(可选)
Reference 是对所属可寻址对象的 KReference。例如,这可能是指向 Broker 的指针。 |
description string |
(可选)
Description 是一个可选字段,用于以任何有意义的方式描述 EventType。 |
attributes []EventAttributeDefinition |
Attributes 是 CloudEvent 属性和扩展属性的数组。 |
EventTypeStatus
(出现在:EventType)
EventTypeStatus 表示 EventType 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
flows.knative.dev/v1
Package v1 是 API 的 v1 版本。
资源类型
并行
Parallel 定义了将通过 Channels 和 Subscriptions 按顺序连接的条件分支。
字段 | 描述 | ||||||
---|---|---|---|---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||
spec ParallelSpec |
Spec 定义 Parallel 的期望状态。
|
||||||
status ParallelStatus |
(可选)
Status 表示 Parallel 的当前状态。此数据可能已过时。 |
ParallelBranch
(出现在:ParallelSpec)
字段 | 描述 |
---|---|
filter knative.dev/pkg/apis/duck/v1.Destination |
(可选)
Filter 是保护分支的表达式。 |
subscriber knative.dev/pkg/apis/duck/v1.Destination |
当过滤器通过时接收事件的 Subscriber。 |
reply knative.dev/pkg/apis/duck/v1.Destination |
(可选)
Reply 是对 Subscriber 的结果将发送到何处的引用。如果未指定,则将结果发送到 Parallel Reply。 |
delivery DeliverySpec |
(可选)
Delivery 是事件向 Subscriber 的传递规范。这包括重试、DLS 等。 |
ParallelBranchStatus
(出现在:ParallelStatus)
ParallelBranchStatus 表示 Parallel 分支的当前状态。
字段 | 描述 |
---|---|
filterSubscriptionStatus ParallelSubscriptionStatus |
FilterSubscriptionStatus 对应于过滤器订阅状态。 |
filterChannelStatus ParallelChannelStatus |
FilterChannelStatus 对应于过滤器通道状态。 |
subscriberSubscriptionStatus ParallelSubscriptionStatus |
SubscriptionStatus 对应于订阅者订阅状态。 |
ParallelChannelStatus
(出现在:ParallelBranchStatus, ParallelStatus)
字段 | 描述 |
---|---|
channel Kubernetes core/v1.ObjectReference |
Channel 是对底层通道的引用。 |
ready knative.dev/pkg/apis.Condition |
ReadyCondition 指示通道是否已准备就绪。 |
ParallelSpec
(出现在:Parallel)
字段 | 描述 |
---|---|
branches []ParallelBranch |
Branches 是 Filter/Subscribers 对的列表。 |
channelTemplate ChannelTemplateSpec |
(可选)
ChannelTemplate 指定要使用的 Channel CRD。如果未指定,则设置为命名空间的默认 Channel CRD(或集群,如果命名空间没有默认值)。 |
reply knative.dev/pkg/apis/duck/v1.Destination |
(可选)
Reply 是对当 case Subscriber 没有 Reply 时,case Subscriber 的结果将发送到何处的引用。 |
ParallelStatus
(出现在:Parallel)
ParallelStatus 表示 Parallel 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
ingressChannelStatus ParallelChannelStatus |
IngressChannelStatus 对应于入站通道状态。 |
branchStatuses []ParallelBranchStatus |
BranchStatuses 是一个数组,对应于分支状态。按顺序匹配 Spec.Branches 数组。 |
AddressStatus knative.dev/pkg/apis/duck/v1.AddressStatus |
( AddressStatus 是此 Parallel 的起点。发送到此将针对第一个订阅者。它通常采用以下形式:{channel}.{namespace}.svc.{cluster domain name} |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 提供了与 OIDC 身份验证相关的信息。 |
AppliedEventPoliciesStatus AppliedEventPoliciesStatus |
( AppliedEventPoliciesStatus 包含应用于此 Broker 的 EventPolicies 列表 |
ParallelSubscriptionStatus
(出现在:ParallelBranchStatus)
字段 | 描述 |
---|---|
subscription Kubernetes core/v1.ObjectReference |
Subscription 是对底层 Subscription 的引用。 |
ready knative.dev/pkg/apis.Condition |
ReadyCondition 指示 Subscription 是否已准备就绪。 |
Sequence
Sequence 定义了将通过 Channels 和 Subscriptions 按顺序连接的 Subscribers 序列。
字段 | 描述 | ||||||
---|---|---|---|---|---|---|---|
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||||
spec SequenceSpec |
Spec 定义 Sequence 的期望状态。
|
||||||
status SequenceStatus |
(可选)
Status 表示 Sequence 的当前状态。此数据可能已过时。 |
SequenceChannelStatus
(出现在:SequenceStatus)
字段 | 描述 |
---|---|
channel Kubernetes core/v1.ObjectReference |
Channel 是对底层通道的引用。 |
ready knative.dev/pkg/apis.Condition |
ReadyCondition 指示通道是否已准备就绪。 |
SequenceSpec
(出现在:Sequence)
字段 | 描述 |
---|---|
steps []SequenceStep |
Steps 是将按提供的顺序调用的 Destination(处理器/函数)列表。每个步骤都有自己的传递选项。 |
channelTemplate ChannelTemplateSpec |
(可选)
ChannelTemplate 指定要使用的 Channel CRD。如果未指定,则设置为命名空间的默认 Channel CRD(或集群,如果命名空间没有默认值)。 |
reply knative.dev/pkg/apis/duck/v1.Destination |
(可选)
Reply 是对最后一个 Subscriber 的结果将发送到何处的引用。 |
SequenceStatus
(出现在:Sequence)
SequenceStatus 表示 Sequence 的当前状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
subscriptionStatuses []SequenceSubscriptionStatus |
(可选)
SubscriptionStatuses 是一个数组,对应于 Subscription 状态。按顺序匹配 Spec.Steps 数组。 |
channelStatuses []SequenceChannelStatus |
(可选)
ChannelStatuses 是一个数组,对应于 Channel 状态。按顺序匹配 Spec.Steps 数组。 |
address knative.dev/pkg/apis/duck/v1.Addressable |
(可选)
Address 是此 Sequence 的起点。发送到此将针对第一个订阅者。它通常采用以下形式:{channel}.{namespace}.svc.{cluster domain name} |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 提供了与 OIDC 身份验证相关的信息。 |
AppliedEventPoliciesStatus AppliedEventPoliciesStatus |
( AppliedEventPoliciesStatus 包含应用于此 Broker 的 EventPolicies 列表 |
SequenceStep
(出现在:SequenceSpec)
字段 | 描述 |
---|---|
Destination knative.dev/pkg/apis/duck/v1.Destination |
( 接收步骤事件的 Subscriber。 |
delivery DeliverySpec |
(可选)
Delivery 是事件向 Subscriber 的传递规范。这包括重试、DLS 等。 |
SequenceSubscriptionStatus
(出现在:SequenceStatus)
字段 | 描述 |
---|---|
subscription Kubernetes core/v1.ObjectReference |
Subscription 是对底层 Subscription 的引用。 |
ready knative.dev/pkg/apis.Condition |
ReadyCondition 指示 Subscription 是否已准备就绪。 |
messaging.knative.dev/v1
Package v1 是 API 的 v1 版本。
资源类型
Channel
Channel 代表一个通用通道。通常在需要通道但不需要特定通道实现时使用。
字段 | 描述 | ||||
---|---|---|---|---|---|
apiVersion string |
messaging.knative.dev/v1
|
||||
kind string |
Channel |
||||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||||
spec ChannelSpec |
Spec 定义通道的期望状态。
|
||||
status ChannelStatus |
(可选)
Status 表示通道的当前状态。此数据可能已过时。 |
InMemoryChannel
InMemoryChannel 是一个资源,表示内存中的通道。
字段 | 描述 | ||
---|---|---|---|
apiVersion string |
messaging.knative.dev/v1
|
||
kind string |
InMemoryChannel |
||
metadata Kubernetes meta/v1.ObjectMeta |
(可选) 请参阅 Kubernetes API 文档以了解 metadata 字段的字段。 |
||
spec InMemoryChannelSpec |
Spec 定义通道的期望状态。
|
||
status InMemoryChannelStatus |
(可选)
Status 表示通道的当前状态。此数据可能已过时。 |
Subscription
Subscription 将接收到的通道上的事件路由到 DNS 名称,并对应于 subscriptions.channels.knative.dev CRD。
字段 | 描述 | ||||||||
---|---|---|---|---|---|---|---|---|---|
apiVersion string |
messaging.knative.dev/v1
|
||||||||
kind string |
Subscription |
||||||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||||||
spec SubscriptionSpec |
|
||||||||
status SubscriptionStatus |
ChannelDefaulter
ChannelDefaulter 为未指定任何实现的通道设置默认 Channel CRD 和参数。
ChannelSpec
(出现在:Channel)
ChannelSpec 定义了哪些订阅者已表示对接收来自此通道的事件感兴趣。它还定义了用于创建支持此通道的 CRD 通道的 ChannelTemplate。
字段 | 描述 |
---|---|
channelTemplate ChannelTemplateSpec |
(可选)
ChannelTemplate 指定要用来创建支持此通道的 CRD 通道的 Channel CRD。创建后,它将不可变。通常,这是由通道默认值设置的,而不是由用户直接设置的。 |
ChannelableSpec ChannelableSpec |
( Channel 符合 ChannelableSpec。 |
ChannelStatus
(出现在:Channel)
ChannelStatus 表示通道的当前状态。
字段 | 描述 |
---|---|
ChannelableStatus ChannelableStatus |
( Channel 符合 ChannelableStatus。 |
channel knative.dev/pkg/apis/duck/v1.KReference |
(可选)
Channel 是对支持此通道的 Channel CRD 的 KReference。 |
ChannelTemplateSpec
(出现在:ParallelSpec, SequenceSpec, ChannelSpec)
字段 | 描述 |
---|---|
spec k8s.io/apimachinery/pkg/runtime.RawExtension |
(可选)
Spec 定义了要为每个创建的通道使用的 Spec。按原样传递到 Channel CRD 作为 Spec 部分。 |
ChannelTemplateSpecOption
ChannelTemplateSpecOption 是 ChannelTemplateSpec 的一个可选函数。
InMemoryChannelSpec
(出现在:InMemoryChannel)
InMemoryChannelSpec 定义了哪些订阅者已表示对接收来自此 InMemoryChannel 的事件感兴趣。通道的参数。
字段 | 描述 |
---|---|
ChannelableSpec ChannelableSpec |
( Channel 符合 Duck 类型 Channelable。 |
InMemoryChannelStatus
(出现在:InMemoryChannel)
ChannelStatus 表示通道的当前状态。
字段 | 描述 |
---|---|
ChannelableStatus ChannelableStatus |
( Channel 符合 Duck 类型 ChannelableStatus。 |
SubscriptionSpec
(出现在:Subscription)
SubscriptionSpec 指定了传入事件的 Channel、用于处理这些事件的 Subscriber 目标以及将处理结果放置的位置。只有 From(事件来自何处)始终是必需的。您可以通过省略 Reply 来选择性地仅处理事件(不会产生输出事件)。您也可以通过省略 Subscriber 且仅指定 Reply 来对传入事件执行身份转换。
以下是所有有效的规范:channel –[subscriber]–> reply Sink,没有传出事件:channel – subscriber 无操作函数(身份转换):channel –> reply
字段 | 描述 |
---|---|
channel knative.dev/pkg/apis/duck/v1.KReference |
对将用于创建订阅的通道的引用。您只能指定 KReference 的以下字段:- Kind - APIVersion - Name - Namespace 此 KReference 指向的资源必须满足 ChannelableSpec 鸭子类型的契约。如果资源不满足此契约,它将反映在 Subscription 的状态中。 此字段不可变。对于当前正在消费的通道中的事件以及应使用哪些语义,我们没有很好的答案。目前,您可以始终删除 Subscription 并重新创建它以指向另一个通道,让用户更好地控制应使用哪些语义(先清空通道,可能让事件被丢弃等)。 |
subscriber knative.dev/pkg/apis/duck/v1.Destination |
Subscriber 是对用于处理事件的函数的引用。来自通道的事件将传递到此处,回复将发送到 Reply 指定的 Destination。 |
reply knative.dev/pkg/apis/duck/v1.Destination |
(可选)
Reply 指定(可选)如何处理从 Subscriber 目标返回的事件。 |
delivery DeliverySpec |
(可选)
传递配置。 |
SubscriptionStatus
(出现在:Subscription)
订阅的 SubscriptionStatus(计算得出)
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( 继承 duck/v1 状态,目前提供:* ObservedGeneration - 由控制器最后处理的服务的“生成”。* Conditions - 资源当前状态的最新可用观察结果。 |
physicalSubscription SubscriptionStatusPhysicalSubscription |
PhysicalSubscription 是此 Subscription 表示的完全解析的值。 |
auth knative.dev/pkg/apis/duck/v1.AuthStatus |
(可选)
Auth 提供了与 OIDC 身份验证相关的信息。 |
SubscriptionStatusPhysicalSubscription
(出现在:SubscriptionStatus)
SubscriptionStatusPhysicalSubscription 表示此 Subscription 的完全解析的值。
字段 | 描述 |
---|---|
subscriberUri knative.dev/pkg/apis.URL |
(可选)
SubscriberURI 是 spec.subscriber 的完全解析的 URI。 |
subscriberCACerts string |
(可选)
SubscriberCACerts 是根据 https://www.rfc-editor.org/rfc/rfc7468 针对 spec.subscriber 的解析的 URI 的 PEM 格式的证书颁发机构 (CA) 证书。 |
subscriberAudience string |
(可选)
SubscriberAudience 是 spec.subscriber 的解析的 URI 的 OIDC 受众。 |
replyUri knative.dev/pkg/apis.URL |
(可选)
ReplyURI 是 spec.reply 的完全解析的 URI。 |
replyCACerts string |
(可选)
ReplyCACerts 是根据 https://www.rfc-editor.org/rfc/rfc7468 针对 spec.reply 的解析的 URI 的 PEM 格式的证书颁发机构 (CA) 证书。 |
replyAudience string |
(可选)
ReplyAudience 是 spec.reply 的解析的 URI 的 OIDC 受众。 |
DeliveryStatus DeliveryStatus |
( DeliveryStatus 包含解析后的死信接收器地址的 URL 以及任何其他解析的传递选项。 |
sinks.knative.dev/v1alpha1
Package v1alpha1 包含 sources v1alpha1 API 组的 API Schema 定义。
资源类型
JobSink
JobSink 是 JobSink API 的 Schema。
字段 | 描述 | ||
---|---|---|---|
apiVersion string |
sinks.knative.dev/v1alpha1
|
||
kind string |
JobSink |
||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||
spec JobSinkSpec |
|
||
status JobSinkStatus |
JobSinkSpec
(出现在:JobSink)
JobSinkSpec 定义 JobSink 的期望状态。
字段 | 描述 |
---|---|
job Kubernetes batch/v1.Job |
(可选)
当事件发生时运行的作业。 |
JobSinkStatus
(出现在:JobSink)
JobSinkStatus 定义 JobSink 的观察状态。
字段 | 描述 |
---|---|
Status knative.dev/pkg/apis/duck/v1.Status |
( |
AddressStatus knative.dev/pkg/apis/duck/v1.AddressStatus |
( AddressStatus 是 JobSink 履行 Addressable 合约的部分。它将端点公开为 URI 以接收事件。 |
job JobStatus |
(可选) |
AppliedEventPoliciesStatus AppliedEventPoliciesStatus |
( AppliedEventPoliciesStatus 包含应用于此 JobSink 的 EventPolicies 列表 |
JobStatus
(出现在:JobSinkStatus)
字段 | 描述 |
---|---|
selector string |
sources.knative.dev/v1
Package v1 包含 sources v1 API 组的 API Schema 定义。
资源类型
ApiServerSource
ApiServerSource 是 apiserversources API 的 Schema
字段 | 描述 | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
sources.knative.dev/v1
|
||||||||||||||
kind string |
ApiServerSource |
||||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||||||||||||
spec ApiServerSourceSpec |
|
||||||||||||||
status ApiServerSourceStatus |
ContainerSource
ContainerSource 是 containersources API 的 Schema
字段 | 描述 | ||||
---|---|---|---|---|---|
apiVersion string |
sources.knative.dev/v1
|
||||
kind string |
ContainerSource |
||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||
spec ContainerSourceSpec |
|
||||
status ContainerSourceStatus |
PingSource
PingSource 是 PingSources API 的 Schema。
字段 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
sources.knative.dev/v1
|
||||||||||||
kind string |
PingSource |
||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||||||||||
spec PingSourceSpec |
|
||||||||||||
status PingSourceStatus |
SinkBinding
SinkBinding 描述一个也是源的绑定。sink
(来自 Source duck)解析为 URL,然后通过增强引用容器的运行时契约以包含一个名为 K_SINK
的环境变量来投影到 subject
中,该变量包含要发送云事件的端点。
字段 | 描述 | ||||
---|---|---|---|---|---|
apiVersion string |
sources.knative.dev/v1
|
||||
kind string |
SinkBinding |
||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||
spec SinkBindingSpec |
|
||||
status SinkBindingStatus |
APIVersionKind
(出现在:ApiServerSourceSpec)
APIVersionKind 是一个 APIVersion 和 Kind 元组。
字段 | 描述 |
---|---|
apiVersion string |
APIVersion - 要观察的资源的 API 版本。 |
kind string |
要观察的资源的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
APIVersionKindSelector
(出现在:ApiServerSourceSpec)
APIVersionKindSelector 是一个带有 LabelSelector 的 APIVersion Kind 元组。
字段 | 描述 |
---|---|
apiVersion string |
APIVersion - 要观察的资源的 API 版本。 |
kind string |
要观察的资源的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
selector Kubernetes meta/v1.LabelSelector |
(可选)
LabelSelector 将此源过滤为对象,以使这些资源通过标签选择器。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/labels/#label-selectors |
ApiServerSourceSpec
(出现在:ApiServerSource)
ApiServerSourceSpec 定义 ApiServerSource 的期望状态
字段 | 描述 |
---|---|
SourceSpec knative.dev/pkg/apis/duck/v1.SourceSpec |
( 继承 duck/v1 SourceSpec,它目前提供:* Sink - 对将解析为域名或 URI 的对象的引用,直接用作接收器。* CloudEventOverrides - 定义覆盖以控制发送到接收器的事件的输出格式和修改。 |
resources []APIVersionKindSelector |
Resource 是此源将跟踪并从中发送相关生命周期事件的 Kubernetes ApiServer 的资源,带有可选的标签选择器以帮助过滤。 |
owner APIVersionKind |
(可选)
ResourceOwner 是一个附加过滤器,仅跟踪由特定资源类型拥有的资源。如果 ResourceOwner 与 Resources[n] 匹配,则允许 Resources[n] 通过 ResourceOwner 过滤器。 |
mode string |
(可选)
EventMode 控制事件的格式。 |
serviceAccountName string |
(可选)
ServiceAccountName 是用于运行此源的 ServiceAccount 的名称。如果未设置,则默认为默认值。 |
namespaceSelector Kubernetes meta/v1.LabelSelector |
(可选)
NamespaceSelector 是一个标签选择器,用于捕获源应观察的命名空间。 |
filters []SubscriptionsAPIFilter |
(可选)
Filters 是一个实验性字段,符合 CNCF CloudEvents 订阅 API。它是一个过滤器表达式的数组,这些表达式计算为真或假。如果数组中的任何过滤器表达式计算为假,则事件必须不发送到接收器。如果数组中的所有过滤器表达式计算为真,则必须尝试传递事件。没有过滤器或空数组意味着值为真。 |
ApiServerSourceStatus
(出现在:ApiServerSource)
ApiServerSourceStatus 定义 ApiServerSource 的观察状态
字段 | 描述 |
---|---|
SourceStatus knative.dev/pkg/apis/duck/v1.SourceStatus |
( 继承 duck/v1 SourceStatus,它目前提供:* ObservedGeneration - 控制器最后处理的服务的“Generation”。* Conditions - 资源当前状态的最新可用观察结果。* SinkURI - 为源配置的当前活动接收器 URI。 |
namespaces []string |
Namespaces 显示 ApiServerSource 当前观察的命名空间 |
ContainerSourceSpec
(出现在:ContainerSource)
ContainerSourceSpec 定义 ContainerSource 的期望状态
字段 | 描述 |
---|---|
SourceSpec knative.dev/pkg/apis/duck/v1.SourceSpec |
( 继承 duck/v1 SourceSpec,它目前提供:* Sink - 对将解析为域名或 URI 的对象的引用,直接用作接收器。* CloudEventOverrides - 定义覆盖以控制发送到接收器的事件的输出格式和修改。 |
template Kubernetes core/v1.PodTemplateSpec |
Template 描述了将创建的 Pod |
ContainerSourceStatus
(出现在:ContainerSource)
ContainerSourceStatus 定义 ContainerSource 的观察状态
字段 | 描述 |
---|---|
SourceStatus knative.dev/pkg/apis/duck/v1.SourceStatus |
( 继承 duck/v1 SourceStatus,它目前提供:* ObservedGeneration - 控制器最后处理的服务的“Generation”。* Conditions - 资源当前状态的最新可用观察结果。* SinkURI - 为源配置的当前活动接收器 URI。 |
PingSourceSpec
(出现在:PingSource)
PingSourceSpec 定义 PingSource 的期望状态。
字段 | 描述 |
---|---|
SourceSpec knative.dev/pkg/apis/duck/v1.SourceSpec |
( 继承 duck/v1 SourceSpec,它目前提供:* Sink - 对将解析为域名或 URI 的对象的引用,直接用作接收器。* CloudEventOverrides - 定义覆盖以控制发送到接收器的事件的输出格式和修改。 |
schedule string |
(可选)
Schedule 是 cron 计划。默认为 |
timezone string |
Timezone 修改相对于指定时区的实际时间。默认为系统时区。有关时区的一般信息:https://www.iana.org/time-zones 有效时区值的列表:https://en.wikipedia.org/wiki/List_of_tz_database_time_zones |
contentType string |
(可选)
ContentType 是 Data 或 DataBase64 的媒体类型。默认为空。 |
data string |
(可选)
Data 是用作发送到接收器的事件正文的数据。默认为空。与 DataBase64 相互排斥。 |
dataBase64 string |
(可选)
DataBase64 是发送到接收器的实际事件正文的 Base64 编码字符串。默认为空。与 Data 相互排斥。 |
PingSourceStatus
(出现在:PingSource)
PingSourceStatus 定义 PingSource 的观察状态。
字段 | 描述 |
---|---|
SourceStatus knative.dev/pkg/apis/duck/v1.SourceStatus |
( 继承 duck/v1 SourceStatus,它目前提供:* ObservedGeneration - 控制器最后处理的服务的“Generation”。* Conditions - 资源当前状态的最新可用观察结果。* SinkURI - 为源配置的当前活动接收器 URI。 |
SinkBindingSpec
(出现在:SinkBinding)
SinkBindingSpec 保存 SinkBinding 的期望状态(来自客户端)。
字段 | 描述 |
---|---|
SourceSpec knative.dev/pkg/apis/duck/v1.SourceSpec |
( 继承 duck/v1 SourceSpec,它目前提供:* Sink - 对将解析为域名或 URI 的对象的引用,直接用作接收器。* CloudEventOverrides - 定义覆盖以控制发送到接收器的事件的输出格式和修改。 |
BindingSpec knative.dev/pkg/apis/duck/v1.BindingSpec |
( 继承 duck/v1 BindingSpec,它目前提供:* Subject - Subject 引用其“运行时契约”应由绑定实现增强的一种或多种资源。 |
SinkBindingStatus
(出现在:SinkBinding)
SinkBindingStatus 传达 SinkBinding 的观察状态(来自控制器)。
字段 | 描述 |
---|---|
SourceStatus knative.dev/pkg/apis/duck/v1.SourceStatus |
( 继承 duck/v1 SourceStatus,它目前提供:* ObservedGeneration - 控制器最后处理的服务的“Generation”。* Conditions - 资源当前状态的最新可用观察结果。* SinkURI - 为源配置的当前活动接收器 URI。 |
oidcTokenSecretName string |
OIDCTokenSecretName 是包含此 SinkBinding OIDC 身份验证的令牌的密钥的名称 |
sources.knative.dev/v1beta2
Package v1beta2 包含 sources v1beta2 API 组的 API Schema 定义。
资源类型
PingSource
PingSource 是 PingSources API 的 Schema。
字段 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion string |
sources.knative.dev/v1beta2
|
||||||||||||
kind string |
PingSource |
||||||||||||
metadata Kubernetes meta/v1.ObjectMeta |
有关 metadata 字段的字段,请参阅 Kubernetes API 文档。 |
||||||||||||
spec PingSourceSpec |
|
||||||||||||
status PingSourceStatus |
PingSourceSpec
(出现在:PingSource)
PingSourceSpec 定义 PingSource 的期望状态。
字段 | 描述 |
---|---|
SourceSpec knative.dev/pkg/apis/duck/v1.SourceSpec |
( 继承 duck/v1 SourceSpec,它目前提供:* Sink - 对将解析为域名或 URI 的对象的引用,直接用作接收器。* CloudEventOverrides - 定义覆盖以控制发送到接收器的事件的输出格式和修改。 |
schedule string |
(可选)
Schedule 是 cron 计划。默认为 |
timezone string |
Timezone 修改相对于指定时区的实际时间。默认为系统时区。有关时区的一般信息:https://www.iana.org/time-zones 有效时区值的列表:https://en.wikipedia.org/wiki/List_of_tz_database_time_zones |
contentType string |
(可选)
ContentType 是 Data 或 DataBase64 的媒体类型。默认为空。 |
data string |
(可选)
Data 是用作发送到接收器的事件正文的数据。默认为空。与 DataBase64 相互排斥。 |
dataBase64 string |
(可选)
DataBase64 是发送到接收器的实际事件正文的 Base64 编码字符串。默认为空。与 Data 相互排斥。 |
PingSourceStatus
(出现在:PingSource)
PingSourceStatus 定义 PingSource 的观察状态。
字段 | 描述 |
---|---|
SourceStatus knative.dev/pkg/apis/duck/v1.SourceStatus |
( 继承 duck/v1 SourceStatus,它目前提供:* ObservedGeneration - 控制器最后处理的服务的“Generation”。* Conditions - 资源当前状态的最新可用观察结果。* SinkURI - 为源配置的当前活动接收器 URI。 |
使用 gen-crd-api-reference-docs
生成。