Skip to content

Latest commit

 

History

History
45 lines (37 loc) · 2.28 KB

documented-extensions.md

File metadata and controls

45 lines (37 loc) · 2.28 KB

CloudEvents Extension Attributes

The CloudEvents specification defines a set of metadata attributes than can be used when transforming a generic event into a CloudEvent. The list of attributes specified in that document represent the minimal set that the specification authors deemed most likely to be used in a majority of situations.

This document defines some addition attributes that, while not as commonly used as the ones specified in the CloudEvents specification, could still benefit from being formally specified in the hopes of providing some degree of interoperability. This also allows for attributes to be defined in an experimental manner and tested prior to being considered for inclusion in the CloudEvents specification.

Implementations of the CloudEvents specification are not mandated to limit their use of extension attributes to just the ones specified in this document. The attributes defined in this document have no official standing and might be changed, or removed, at any time. As such, inclusion of an attribute in this document does not need to meet the same level of maturity, or popularity, as attributes defined in the CloudEvents specification. To be included in this document, aside from the normal PR review process, the attribute needs to have at least two Voting member organizations stating their support for its inclusion as comments in the PR. If the author of the PR is also a Voting member, then they are allowed to be one of two.

Usage

Support for any extension is OPTIONAL. When an extension definition uses RFC 2199 keywords (e.g. MUST, SHOULD, MAY), this usage only applies to events that use the extension.

Extensions attributes, while not defined by the core CloudEvents specifications, MUST follow the same serialization rules as defined by the format and protocol binding specifications. See Extension Context Attributes for more information.

Known Extensions