Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. eventsv2
  6. EventBus

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.eventsv2.EventBus

aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource type definition for AWS::EventsV2::EventBus, an Amazon EventBridge custom event bus that receives events and delivers them to matching subscribers.

    Create EventBus Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new EventBus(name: string, args?: EventBusArgs, opts?: CustomResourceOptions);
    @overload
def EventBus(resource_name: str,
             args: Optional[EventBusArgs] = None,
             opts: Optional[ResourceOptions] = None)

@overload
def EventBus(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             description: Optional[str] = None,
             encryption_configuration: Optional[EventBusEncryptionConfigurationArgs] = None,
             name: Optional[str] = None,
             storage_configuration: Optional[EventBusStorageConfigurationArgs] = None,
             tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewEventBus(ctx *Context, name string, args *EventBusArgs, opts ...ResourceOption) (*EventBus, error)
    public EventBus(string name, EventBusArgs? args = null, CustomResourceOptions? opts = null)
    public EventBus(String name, EventBusArgs args)
public EventBus(String name, EventBusArgs args, CustomResourceOptions options)

    type: aws-native:eventsv2:EventBus
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_eventsv2_event_bus" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args EventBusArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EventBusArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EventBusArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EventBusArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EventBusArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    EventBus Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The EventBus resource accepts the following input properties:

    Description string
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    EncryptionConfiguration Pulumi.AwsNative.EventsV2.Inputs.EventBusEncryptionConfiguration
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    Name string
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    StorageConfiguration Pulumi.AwsNative.EventsV2.Inputs.EventBusStorageConfiguration
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags assigned to the event bus.
    Description string
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    EncryptionConfiguration EventBusEncryptionConfigurationArgs
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    Name string
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    StorageConfiguration EventBusStorageConfigurationArgs
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    Tags TagArgs
    The tags assigned to the event bus.
    description string
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryption_configuration object
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    name string
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    storage_configuration object
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags list(object)
    The tags assigned to the event bus.
    description String
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryptionConfiguration EventBusEncryptionConfiguration
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    name String
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    storageConfiguration EventBusStorageConfiguration
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags List<Tag>
    The tags assigned to the event bus.
    description string
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryptionConfiguration EventBusEncryptionConfiguration
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    name string
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    storageConfiguration EventBusStorageConfiguration
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags Tag[]
    The tags assigned to the event bus.
    description str
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryption_configuration EventBusEncryptionConfigurationArgs
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    name str
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    storage_configuration EventBusStorageConfigurationArgs
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags Sequence[TagArgs]
    The tags assigned to the event bus.
    description String
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryptionConfiguration Property Map
    Encryption configuration for the event bus. The service stores and returns the customer managed key as its key ARN. The key ARN is recommended so that drift detection stays accurate. A key ID is also accepted and is matched to the returned key ARN when CloudFormation checks for drift; a key alias is accepted but can be reported as a value difference, because an alias cannot be matched to the key ARN it points to.
    name String
    The name of the event bus. The first character must be alphanumeric; the remaining characters may also include '.', '-', and '_'.
    storageConfiguration Property Map
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags List<Property Map>
    The tags assigned to the event bus.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the EventBus resource produces the following output properties:

    CreationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedTime string
    The time the event bus was last modified, as an ISO 8601 timestamp.
    State Pulumi.AwsNative.EventsV2.EventBusState
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    CreationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedTime string
    The time the event bus was last modified, as an ISO 8601 timestamp.
    State EventBusStateEnum
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    creation_time string
    The time the event bus was created, as an ISO 8601 timestamp.
    event_bus_arn string
    The Amazon Resource Name (ARN) of the event bus.
    id string
    The provider-assigned unique ID for this managed resource.
    last_modified_time string
    The time the event bus was last modified, as an ISO 8601 timestamp.
    state "CREATING" | "ACTIVE" | "UPDATING" | "CREATE_FAILED" | "UPDATE_FAILED" | "DELETE_FAILED" | "DELETING"
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    creationTime String
    The time the event bus was created, as an ISO 8601 timestamp.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime String
    The time the event bus was last modified, as an ISO 8601 timestamp.
    state EventBusState
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    creationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    eventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    id string
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime string
    The time the event bus was last modified, as an ISO 8601 timestamp.
    state EventBusState
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    creation_time str
    The time the event bus was created, as an ISO 8601 timestamp.
    event_bus_arn str
    The Amazon Resource Name (ARN) of the event bus.
    id str
    The provider-assigned unique ID for this managed resource.
    last_modified_time str
    The time the event bus was last modified, as an ISO 8601 timestamp.
    state EventBusState
    The lifecycle state of the event bus. The settled operational state is ACTIVE.
    creationTime String
    The time the event bus was created, as an ISO 8601 timestamp.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime String
    The time the event bus was last modified, as an ISO 8601 timestamp.
    state "CREATING" | "ACTIVE" | "UPDATING" | "CREATE_FAILED" | "UPDATE_FAILED" | "DELETE_FAILED" | "DELETING"
    The lifecycle state of the event bus. The settled operational state is ACTIVE.

    Supporting Types

    EventBusEncryptionConfiguration, EventBusEncryptionConfigurationArgs

    Encryption configuration for an event bus.
    KmsKeyIdentifier string
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    KmsKeyIdentifier string
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    kms_key_identifier string
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    kmsKeyIdentifier String
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    kmsKeyIdentifier string
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    kms_key_identifier str
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.
    kmsKeyIdentifier String
    The identifier of the AWS KMS customer managed key that the event bus uses to encrypt events. You can specify the key ARN, key ID, alias name, or alias ARN. If you do not specify a key, EventBridge uses an AWS owned key.

    EventBusState, EventBusStateArgs

    Creating
    CREATING
    Active
    ACTIVE
    Updating
    UPDATING
    CreateFailed
    CREATE_FAILED
    UpdateFailed
    UPDATE_FAILED
    DeleteFailed
    DELETE_FAILED
    Deleting
    DELETING
    EventBusStateCreating
    CREATING
    EventBusStateActive
    ACTIVE
    EventBusStateUpdating
    UPDATING
    EventBusStateCreateFailed
    CREATE_FAILED
    EventBusStateUpdateFailed
    UPDATE_FAILED
    EventBusStateDeleteFailed
    DELETE_FAILED
    EventBusStateDeleting
    DELETING
    "CREATING"
    CREATING
    "ACTIVE"
    ACTIVE
    "UPDATING"
    UPDATING
    "CREATE_FAILED"
    CREATE_FAILED
    "UPDATE_FAILED"
    UPDATE_FAILED
    "DELETE_FAILED"
    DELETE_FAILED
    "DELETING"
    DELETING
    Creating
    CREATING
    Active
    ACTIVE
    Updating
    UPDATING
    CreateFailed
    CREATE_FAILED
    UpdateFailed
    UPDATE_FAILED
    DeleteFailed
    DELETE_FAILED
    Deleting
    DELETING
    Creating
    CREATING
    Active
    ACTIVE
    Updating
    UPDATING
    CreateFailed
    CREATE_FAILED
    UpdateFailed
    UPDATE_FAILED
    DeleteFailed
    DELETE_FAILED
    Deleting
    DELETING
    CREATING
    CREATING
    ACTIVE
    ACTIVE
    UPDATING
    UPDATING
    CREATE_FAILED
    CREATE_FAILED
    UPDATE_FAILED
    UPDATE_FAILED
    DELETE_FAILED
    DELETE_FAILED
    DELETING
    DELETING
    "CREATING"
    CREATING
    "ACTIVE"
    ACTIVE
    "UPDATING"
    UPDATING
    "CREATE_FAILED"
    CREATE_FAILED
    "UPDATE_FAILED"
    UPDATE_FAILED
    "DELETE_FAILED"
    DELETE_FAILED
    "DELETING"
    DELETING

    EventBusStorageConfiguration, EventBusStorageConfigurationArgs

    Storage (retention) configuration for the event bus.
    RetentionPeriodInDays int
    The number of days events are retained on the event bus for replay, 1-365.
    RetentionPeriodInDays int
    The number of days events are retained on the event bus for replay, 1-365.
    retention_period_in_days number
    The number of days events are retained on the event bus for replay, 1-365.
    retentionPeriodInDays Integer
    The number of days events are retained on the event bus for replay, 1-365.
    retentionPeriodInDays number
    The number of days events are retained on the event bus for replay, 1-365.
    retention_period_in_days int
    The number of days events are retained on the event bus for replay, 1-365.
    retentionPeriodInDays Number
    The number of days events are retained on the event bus for replay, 1-365.

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.81.0
    published on Monday, Sep 28, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial