// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
pub struct CreateSubscriberInput {
/// Name of a subscriber. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
pub name: ::std::option::Option<::std::string::String>,
/// The Amazon Resource Name (ARN) that uniquely identifies an event bus.
pub event_bus_arn: ::std::option::Option<::std::string::String>,
/// Configuration for how the subscriber invokes its target.
pub invoke_configuration: ::std::option::Option<crate::types::InvokeConfiguration>,
/// Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
pub description: ::std::option::Option<::std::string::String>,
/// Configuration for filtering events delivered to a subscriber. On CreateSubscriber, Filters is required and must contain at least one Filter with a non-empty Pattern. On UpdateSubscriber, an empty `FilterConfiguration:{}` clears the existing filter. Any non-empty shape (including `{Language:X}` without Filters) must contain a valid Filters list — same contract as CreateSubscriber. A non-empty Filters list overwrites; an omitted FilterConfiguration preserves existing state. All Filters are implicitly ANDed — an event must match every Filter to be delivered.
pub filter_configuration: ::std::option::Option<crate::types::FilterConfiguration>,
/// Delivery ordering mode of a subscriber: FIFO delivers events in order within an event group; UNORDERED delivers without an ordering guarantee.
pub r#type: ::std::option::Option<crate::types::OrderingType>,
/// Starting position for a subscriber.
pub starting_position: ::std::option::Option<crate::types::StartingPosition>,
/// Point-in-time configuration for a subscriber. Only applicable when StartingPosition is POINT_IN_TIME.
pub point_in_time_configuration: ::std::option::Option<crate::types::PointInTimeConfiguration>,
/// Batching configuration for a subscriber.
pub batch_configuration: ::std::option::Option<crate::types::BatchConfiguration>,
/// Not applicable to universal (aws-sdk) targets, whose input transformation is UniversalTargetParameters.Input; a Transformer on such a target is rejected.
pub transformer: ::std::option::Option<crate::types::Transformer>,
/// Retry policy for a subscriber.
pub retry_policy: ::std::option::Option<crate::types::RetryPolicy>,
/// On-failure configuration: where a failed delivery is sent. Shared by the subscriber and the EventSource.
pub on_failure_configuration: ::std::option::Option<crate::types::OnFailureConfiguration>,
/// Log configuration for a subscriber.
pub log_configuration: ::std::option::Option<crate::types::LogConfiguration>,
/// Customer-controlled run state of a subscriber, set on create or update. Distinct from the bus lifecycle vocabulary, where ACTIVE means "provisioned and healthy". Delivery requires State RUNNING on a subscriber that is not revoked.
pub state: ::std::option::Option<crate::types::SubscriberState>,
/// Tags attached to a resource, as key-value pairs.
pub tags: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
/// Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.
pub client_token: ::std::option::Option<::std::string::String>,
}
impl CreateSubscriberInput {
/// Name of a subscriber. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
pub fn name(&self) -> ::std::option::Option<&str> {
self.name.as_deref()
}
/// The Amazon Resource Name (ARN) that uniquely identifies an event bus.
pub fn event_bus_arn(&self) -> ::std::option::Option<&str> {
self.event_bus_arn.as_deref()
}
/// Configuration for how the subscriber invokes its target.
pub fn invoke_configuration(&self) -> ::std::option::Option<&crate::types::InvokeConfiguration> {
self.invoke_configuration.as_ref()
}
/// Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
pub fn description(&self) -> ::std::option::Option<&str> {
self.description.as_deref()
}
/// Configuration for filtering events delivered to a subscriber. On CreateSubscriber, Filters is required and must contain at least one Filter with a non-empty Pattern. On UpdateSubscriber, an empty `FilterConfiguration:{}` clears the existing filter. Any non-empty shape (including `{Language:X}` without Filters) must contain a valid Filters list — same contract as CreateSubscriber. A non-empty Filters list overwrites; an omitted FilterConfiguration preserves existing state. All Filters are implicitly ANDed — an event must match every Filter to be delivered.
pub fn filter_configuration(&self) -> ::std::option::Option<&crate::types::FilterConfiguration> {
self.filter_configuration.as_ref()
}
/// Delivery ordering mode of a subscriber: FIFO delivers events in order within an event group; UNORDERED delivers without an ordering guarantee.
pub fn r#type(&self) -> ::std::option::Option<&crate::types::OrderingType> {
self.r#type.as_ref()
}
/// Starting position for a subscriber.
pub fn starting_position(&self) -> ::std::option::Option<&crate::types::StartingPosition> {
self.starting_position.as_ref()
}
/// Point-in-time configuration for a subscriber. Only applicable when StartingPosition is POINT_IN_TIME.
pub fn point_in_time_configuration(&self) -> ::std::option::Option<&crate::types::PointInTimeConfiguration> {
self.point_in_time_configuration.as_ref()
}
/// Batching configuration for a subscriber.
pub fn batch_configuration(&self) -> ::std::option::Option<&crate::types::BatchConfiguration> {
self.batch_configuration.as_ref()
}
/// Not applicable to universal (aws-sdk) targets, whose input transformation is UniversalTargetParameters.Input; a Transformer on such a target is rejected.
pub fn transformer(&self) -> ::std::option::Option<&crate::types::Transformer> {
self.transformer.as_ref()
}
/// Retry policy for a subscriber.
pub fn retry_policy(&self) -> ::std::option::Option<&crate::types::RetryPolicy> {
self.retry_policy.as_ref()
}
/// On-failure configuration: where a failed delivery is sent. Shared by the subscriber and the EventSource.
pub fn on_failure_configuration(&self) -> ::std::option::Option<&crate::types::OnFailureConfiguration> {
self.on_failure_configuration.as_ref()
}
/// Log configuration for a subscriber.
pub fn log_configuration(&self) -> ::std::option::Option<&crate::types::LogConfiguration> {
self.log_configuration.as_ref()
}
/// Customer-controlled run state of a subscriber, set on create or update. Distinct from the bus lifecycle vocabulary, where ACTIVE means "provisioned and healthy". Delivery requires State RUNNING on a subscriber that is not revoked.
pub fn state(&self) -> ::std::option::Option<&crate::types::SubscriberState> {
self.state.as_ref()
}
/// Tags attached to a resource, as key-value pairs.
pub fn tags(&self) -> ::std::option::Option<&::std::collections::HashMap<::std::string::String, ::std::string::String>> {
self.tags.as_ref()
}
/// Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.
pub fn client_token(&self) -> ::std::option::Option<&str> {
self.client_token.as_deref()
}
}
impl CreateSubscriberInput {
/// Creates a new builder-style object to manufacture [`CreateSubscriberInput`](crate::operation::create_subscriber::CreateSubscriberInput).
pub fn builder() -> crate::operation::create_subscriber::builders::CreateSubscriberInputBuilder {
crate::operation::create_subscriber::builders::CreateSubscriberInputBuilder::default()
}
}
/// A builder for [`CreateSubscriberInput`](crate::operation::create_subscriber::CreateSubscriberInput).
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
#[non_exhaustive]
pub struct CreateSubscriberInputBuilder {
pub(crate) name: ::std::option::Option<::std::string::String>,
pub(crate) event_bus_arn: ::std::option::Option<::std::string::String>,
pub(crate) invoke_configuration: ::std::option::Option<crate::types::InvokeConfiguration>,
pub(crate) description: ::std::option::Option<::std::string::String>,
pub(crate) filter_configuration: ::std::option::Option<crate::types::FilterConfiguration>,
pub(crate) r#type: ::std::option::Option<crate::types::OrderingType>,
pub(crate) starting_position: ::std::option::Option<crate::types::StartingPosition>,
pub(crate) point_in_time_configuration: ::std::option::Option<crate::types::PointInTimeConfiguration>,
pub(crate) batch_configuration: ::std::option::Option<crate::types::BatchConfiguration>,
pub(crate) transformer: ::std::option::Option<crate::types::Transformer>,
pub(crate) retry_policy: ::std::option::Option<crate::types::RetryPolicy>,
pub(crate) on_failure_configuration: ::std::option::Option<crate::types::OnFailureConfiguration>,
pub(crate) log_configuration: ::std::option::Option<crate::types::LogConfiguration>,
pub(crate) state: ::std::option::Option<crate::types::SubscriberState>,
pub(crate) tags: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
pub(crate) client_token: ::std::option::Option<::std::string::String>,
}
impl CreateSubscriberInputBuilder {
/// Name of a subscriber. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
/// This field is required.
pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.name = ::std::option::Option::Some(input.into());
self
}
/// Name of a subscriber. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.name = input;
self
}
/// Name of a subscriber. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
&self.name
}
/// The Amazon Resource Name (ARN) that uniquely identifies an event bus.
/// This field is required.
pub fn event_bus_arn(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.event_bus_arn = ::std::option::Option::Some(input.into());
self
}
/// The Amazon Resource Name (ARN) that uniquely identifies an event bus.
pub fn set_event_bus_arn(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.event_bus_arn = input;
self
}
/// The Amazon Resource Name (ARN) that uniquely identifies an event bus.
pub fn get_event_bus_arn(&self) -> &::std::option::Option<::std::string::String> {
&self.event_bus_arn
}
/// Configuration for how the subscriber invokes its target.
/// This field is required.
pub fn invoke_configuration(mut self, input: crate::types::InvokeConfiguration) -> Self {
self.invoke_configuration = ::std::option::Option::Some(input);
self
}
/// Configuration for how the subscriber invokes its target.
pub fn set_invoke_configuration(mut self, input: ::std::option::Option<crate::types::InvokeConfiguration>) -> Self {
self.invoke_configuration = input;
self
}
/// Configuration for how the subscriber invokes its target.
pub fn get_invoke_configuration(&self) -> &::std::option::Option<crate::types::InvokeConfiguration> {
&self.invoke_configuration
}
/// Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
pub fn description(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.description = ::std::option::Option::Some(input.into());
self
}
/// Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
pub fn set_description(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.description = input;
self
}
/// Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
pub fn get_description(&self) -> &::std::option::Option<::std::string::String> {
&self.description
}
/// Configuration for filtering events delivered to a subscriber. On CreateSubscriber, Filters is required and must contain at least one Filter with a non-empty Pattern. On UpdateSubscriber, an empty `FilterConfiguration:{}` clears the existing filter. Any non-empty shape (including `{Language:X}` without Filters) must contain a valid Filters list — same contract as CreateSubscriber. A non-empty Filters list overwrites; an omitted FilterConfiguration preserves existing state. All Filters are implicitly ANDed — an event must match every Filter to be delivered.
pub fn filter_configuration(mut self, input: crate::types::FilterConfiguration) -> Self {
self.filter_configuration = ::std::option::Option::Some(input);
self
}
/// Configuration for filtering events delivered to a subscriber. On CreateSubscriber, Filters is required and must contain at least one Filter with a non-empty Pattern. On UpdateSubscriber, an empty `FilterConfiguration:{}` clears the existing filter. Any non-empty shape (including `{Language:X}` without Filters) must contain a valid Filters list — same contract as CreateSubscriber. A non-empty Filters list overwrites; an omitted FilterConfiguration preserves existing state. All Filters are implicitly ANDed — an event must match every Filter to be delivered.
pub fn set_filter_configuration(mut self, input: ::std::option::Option<crate::types::FilterConfiguration>) -> Self {
self.filter_configuration = input;
self
}
/// Configuration for filtering events delivered to a subscriber. On CreateSubscriber, Filters is required and must contain at least one Filter with a non-empty Pattern. On UpdateSubscriber, an empty `FilterConfiguration:{}` clears the existing filter. Any non-empty shape (including `{Language:X}` without Filters) must contain a valid Filters list — same contract as CreateSubscriber. A non-empty Filters list overwrites; an omitted FilterConfiguration preserves existing state. All Filters are implicitly ANDed — an event must match every Filter to be delivered.
pub fn get_filter_configuration(&self) -> &::std::option::Option<crate::types::FilterConfiguration> {
&self.filter_configuration
}
/// Delivery ordering mode of a subscriber: FIFO delivers events in order within an event group; UNORDERED delivers without an ordering guarantee.
pub fn r#type(mut self, input: crate::types::OrderingType) -> Self {
self.r#type = ::std::option::Option::Some(input);
self
}
/// Delivery ordering mode of a subscriber: FIFO delivers events in order within an event group; UNORDERED delivers without an ordering guarantee.
pub fn set_type(mut self, input: ::std::option::Option<crate::types::OrderingType>) -> Self {
self.r#type = input;
self
}
/// Delivery ordering mode of a subscriber: FIFO delivers events in order within an event group; UNORDERED delivers without an ordering guarantee.
pub fn get_type(&self) -> &::std::option::Option<crate::types::OrderingType> {
&self.r#type
}
/// Starting position for a subscriber.
pub fn starting_position(mut self, input: crate::types::StartingPosition) -> Self {
self.starting_position = ::std::option::Option::Some(input);
self
}
/// Starting position for a subscriber.
pub fn set_starting_position(mut self, input: ::std::option::Option<crate::types::StartingPosition>) -> Self {
self.starting_position = input;
self
}
/// Starting position for a subscriber.
pub fn get_starting_position(&self) -> &::std::option::Option<crate::types::StartingPosition> {
&self.starting_position
}
/// Point-in-time configuration for a subscriber. Only applicable when StartingPosition is POINT_IN_TIME.
pub fn point_in_time_configuration(mut self, input: crate::types::PointInTimeConfiguration) -> Self {
self.point_in_time_configuration = ::std::option::Option::Some(input);
self
}
/// Point-in-time configuration for a subscriber. Only applicable when StartingPosition is POINT_IN_TIME.
pub fn set_point_in_time_configuration(mut self, input: ::std::option::Option<crate::types::PointInTimeConfiguration>) -> Self {
self.point_in_time_configuration = input;
self
}
/// Point-in-time configuration for a subscriber. Only applicable when StartingPosition is POINT_IN_TIME.
pub fn get_point_in_time_configuration(&self) -> &::std::option::Option<crate::types::PointInTimeConfiguration> {
&self.point_in_time_configuration
}
/// Batching configuration for a subscriber.
pub fn batch_configuration(mut self, input: crate::types::BatchConfiguration) -> Self {
self.batch_configuration = ::std::option::Option::Some(input);
self
}
/// Batching configuration for a subscriber.
pub fn set_batch_configuration(mut self, input: ::std::option::Option<crate::types::BatchConfiguration>) -> Self {
self.batch_configuration = input;
self
}
/// Batching configuration for a subscriber.
pub fn get_batch_configuration(&self) -> &::std::option::Option<crate::types::BatchConfiguration> {
&self.batch_configuration
}
/// Not applicable to universal (aws-sdk) targets, whose input transformation is UniversalTargetParameters.Input; a Transformer on such a target is rejected.
pub fn transformer(mut self, input: crate::types::Transformer) -> Self {
self.transformer = ::std::option::Option::Some(input);
self
}
/// Not applicable to universal (aws-sdk) targets, whose input transformation is UniversalTargetParameters.Input; a Transformer on such a target is rejected.
pub fn set_transformer(mut self, input: ::std::option::Option<crate::types::Transformer>) -> Self {
self.transformer = input;
self
}
/// Not applicable to universal (aws-sdk) targets, whose input transformation is UniversalTargetParameters.Input; a Transformer on such a target is rejected.
pub fn get_transformer(&self) -> &::std::option::Option<crate::types::Transformer> {
&self.transformer
}
/// Retry policy for a subscriber.
pub fn retry_policy(mut self, input: crate::types::RetryPolicy) -> Self {
self.retry_policy = ::std::option::Option::Some(input);
self
}
/// Retry policy for a subscriber.
pub fn set_retry_policy(mut self, input: ::std::option::Option<crate::types::RetryPolicy>) -> Self {
self.retry_policy = input;
self
}
/// Retry policy for a subscriber.
pub fn get_retry_policy(&self) -> &::std::option::Option<crate::types::RetryPolicy> {
&self.retry_policy
}
/// On-failure configuration: where a failed delivery is sent. Shared by the subscriber and the EventSource.
pub fn on_failure_configuration(mut self, input: crate::types::OnFailureConfiguration) -> Self {
self.on_failure_configuration = ::std::option::Option::Some(input);
self
}
/// On-failure configuration: where a failed delivery is sent. Shared by the subscriber and the EventSource.
pub fn set_on_failure_configuration(mut self, input: ::std::option::Option<crate::types::OnFailureConfiguration>) -> Self {
self.on_failure_configuration = input;
self
}
/// On-failure configuration: where a failed delivery is sent. Shared by the subscriber and the EventSource.
pub fn get_on_failure_configuration(&self) -> &::std::option::Option<crate::types::OnFailureConfiguration> {
&self.on_failure_configuration
}
/// Log configuration for a subscriber.
pub fn log_configuration(mut self, input: crate::types::LogConfiguration) -> Self {
self.log_configuration = ::std::option::Option::Some(input);
self
}
/// Log configuration for a subscriber.
pub fn set_log_configuration(mut self, input: ::std::option::Option<crate::types::LogConfiguration>) -> Self {
self.log_configuration = input;
self
}
/// Log configuration for a subscriber.
pub fn get_log_configuration(&self) -> &::std::option::Option<crate::types::LogConfiguration> {
&self.log_configuration
}
/// Customer-controlled run state of a subscriber, set on create or update. Distinct from the bus lifecycle vocabulary, where ACTIVE means "provisioned and healthy". Delivery requires State RUNNING on a subscriber that is not revoked.
pub fn state(mut self, input: crate::types::SubscriberState) -> Self {
self.state = ::std::option::Option::Some(input);
self
}
/// Customer-controlled run state of a subscriber, set on create or update. Distinct from the bus lifecycle vocabulary, where ACTIVE means "provisioned and healthy". Delivery requires State RUNNING on a subscriber that is not revoked.
pub fn set_state(mut self, input: ::std::option::Option<crate::types::SubscriberState>) -> Self {
self.state = input;
self
}
/// Customer-controlled run state of a subscriber, set on create or update. Distinct from the bus lifecycle vocabulary, where ACTIVE means "provisioned and healthy". Delivery requires State RUNNING on a subscriber that is not revoked.
pub fn get_state(&self) -> &::std::option::Option<crate::types::SubscriberState> {
&self.state
}
/// Adds a key-value pair to `tags`.
///
/// To override the contents of this collection use [`set_tags`](Self::set_tags).
///
/// Tags attached to a resource, as key-value pairs.
pub fn tags(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
let mut hash_map = self.tags.unwrap_or_default();
hash_map.insert(k.into(), v.into());
self.tags = ::std::option::Option::Some(hash_map);
self
}
/// Tags attached to a resource, as key-value pairs.
pub fn set_tags(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
self.tags = input;
self
}
/// Tags attached to a resource, as key-value pairs.
pub fn get_tags(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
&self.tags
}
/// Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.
pub fn client_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.client_token = ::std::option::Option::Some(input.into());
self
}
/// Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.
pub fn set_client_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.client_token = input;
self
}
/// Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.
pub fn get_client_token(&self) -> &::std::option::Option<::std::string::String> {
&self.client_token
}
/// Consumes the builder and constructs a [`CreateSubscriberInput`](crate::operation::create_subscriber::CreateSubscriberInput).
pub fn build(
self,
) -> ::std::result::Result<crate::operation::create_subscriber::CreateSubscriberInput, ::aws_smithy_types::error::operation::BuildError> {
::std::result::Result::Ok(crate::operation::create_subscriber::CreateSubscriberInput {
name: self.name,
event_bus_arn: self.event_bus_arn,
invoke_configuration: self.invoke_configuration,
description: self.description,
filter_configuration: self.filter_configuration,
r#type: self.r#type,
starting_position: self.starting_position,
point_in_time_configuration: self.point_in_time_configuration,
batch_configuration: self.batch_configuration,
transformer: self.transformer,
retry_policy: self.retry_policy,
on_failure_configuration: self.on_failure_configuration,
log_configuration: self.log_configuration,
state: self.state,
tags: self.tags,
client_token: self.client_token,
})
}
}