pub enum CreateStreamIntent {
CreateOnly {
config: OptionalStreamConfig,
request_token: Option<RequestToken>,
},
CreateOrReconfigure {
reconfiguration: StreamReconfiguration,
},
}Expand description
Stream creation operation intent.
Separates POST-style create-only requests, which carry a complete creation config and optional idempotency token, from PUT-style create-or-reconfigure requests, which carry only a reconfiguration patch.
Variants§
CreateOnly
Create a new stream.
HTTP POST semantics: idempotent if a request token is provided and the stream was previously created using the same token and config.
Fields
config: OptionalStreamConfigComplete stream configuration for a new stream.
request_token: Option<RequestToken>Optional request token used to make create retries idempotent.
CreateOrReconfigure
Create a new stream or reconfigure it if it already exists.
HTTP PUT semantics: always idempotent. When the stream already exists, unspecified fields in the reconfiguration preserve the existing config.
Fields
reconfiguration: StreamReconfigurationStream reconfiguration patch to apply on create-or-reconfigure.