aws-sdk-eventbridgev2 1.2.0

AWS SDK for Amazon EventBridgeV2
Documentation
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateEventBus`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`name(impl Into<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::name) / [`set_name(Option<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_name):<br>required: **true**<br>Name of an event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'. The grammar matches the name segment of EventBusArn (event-busv2/<name>  /  <id>   ), so every valid name can be represented in the bus's ARN. The same type is used everywhere a bus name appears.  </id> </name><br>
    ///   - [`description(impl Into<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_description):<br>required: **false**<br>Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.<br>
    ///   - [`encryption_configuration(EncryptionConfiguration)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::encryption_configuration) / [`set_encryption_configuration(Option<EncryptionConfiguration>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_encryption_configuration):<br>required: **false**<br>Encryption configuration for an event bus.<br>
    ///   - [`storage_configuration(StorageConfiguration)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::storage_configuration) / [`set_storage_configuration(Option<StorageConfiguration>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_storage_configuration):<br>required: **false**<br>Event storage configuration for an event bus.<br>
    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_tags):<br>required: **false**<br>Tags attached to a resource, as key-value pairs.<br>
    ///   - [`client_token(impl Into<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::set_client_token):<br>required: **false**<br>Unique, case-sensitive identifier that ensures the idempotency of the request. The SDK generates one automatically when the field is omitted.<br>
    /// - On success, responds with [`CreateEventBusOutput`](crate::operation::create_event_bus::CreateEventBusOutput) with field(s):
    ///   - [`event_bus_arn(Option<String>)`](crate::operation::create_event_bus::CreateEventBusOutput::event_bus_arn): The Amazon Resource Name (ARN) that uniquely identifies an event bus.
    ///   - [`name(Option<String>)`](crate::operation::create_event_bus::CreateEventBusOutput::name): Name of an event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'. The grammar matches the name segment of EventBusArn (event-busv2/<name>  /  <id>   ), so every valid name can be represented in the bus's ARN. The same type is used everywhere a bus name appears.  </id> </name>
    ///   - [`description(Option<String>)`](crate::operation::create_event_bus::CreateEventBusOutput::description): Free-text description. Used by every resource type that has one: event buses, subscribers, and event sources.
    ///   - [`encryption_configuration(Option<EncryptionConfiguration>)`](crate::operation::create_event_bus::CreateEventBusOutput::encryption_configuration): Encryption configuration for an event bus.
    ///   - [`storage_configuration(Option<StorageConfigurationOutput>)`](crate::operation::create_event_bus::CreateEventBusOutput::storage_configuration): Event storage configuration of an event bus, as returned on reads.
    ///   - [`state(Option<BusState>)`](crate::operation::create_event_bus::CreateEventBusOutput::state): Lifecycle state of an event bus. - CREATING: Bus creation is in progress. - CREATE_FAILED: Bus creation failed; see StateReason. The bus cannot be recovered or recreated in place: delete it with DeleteEventBus, then create a new bus. - ACTIVE: Bus is fully operational and can accept events. - UPDATING: Bus update is in progress. - UPDATE_FAILED: Bus update failed; the bus remains operational with its previous configuration. - DELETING: Bus deletion is actively in progress. - DELETE_FAILED: Bus deletion failed; see StateReason. Retry DeleteEventBus after removing subscribers and event sources.
    ///   - [`state_reason(Option<String>)`](crate::operation::create_event_bus::CreateEventBusOutput::state_reason): Human-readable explanation of why an event bus is in its current State. Omitted when the bus is in a normal operational state (ACTIVE). It stands in for the error response an asynchronous failure cannot return, so it applies only to resources with an asynchronous lifecycle: event buses. EventSources and subscribers are provisioned synchronously and report failures directly on the request.
    ///   - [`creation_time(Option<DateTime>)`](crate::operation::create_event_bus::CreateEventBusOutput::creation_time): The time the event bus was created.
    /// - On failure, responds with [`SdkError<CreateEventBusError>`](crate::operation::create_event_bus::CreateEventBusError)
    pub fn create_event_bus(&self) -> crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder {
        crate::operation::create_event_bus::builders::CreateEventBusFluentBuilder::new(self.handle.clone())
    }
}