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

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.getEventBus

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.

    Using getEventBus

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getEventBus(args: GetEventBusArgs, opts?: InvokeOptions): Promise<GetEventBusResult>
function getEventBusOutput(args: GetEventBusOutputArgs, opts?: InvokeOutputOptions): Output<GetEventBusResult>
    def get_event_bus(event_bus_arn: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetEventBusResult
def get_event_bus_output(event_bus_arn: pulumi.Input[Optional[str]] = None,
                  opts: Optional[InvokeOutputOptions] = None) -> Output[GetEventBusResult]
    func LookupEventBus(ctx *Context, args *LookupEventBusArgs, opts ...InvokeOption) (*LookupEventBusResult, error)
func LookupEventBusOutput(ctx *Context, args *LookupEventBusOutputArgs, opts ...InvokeOption) LookupEventBusResultOutput

    > Note: This function is named LookupEventBus in the Go SDK.

    public static class GetEventBus 
{
    public static Task<GetEventBusResult> InvokeAsync(GetEventBusArgs args, InvokeOptions? opts = null)
    public static Output<GetEventBusResult> Invoke(GetEventBusInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetEventBusResult> Invoke(GetEventBusInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetEventBusResult> getEventBus(GetEventBusArgs args, InvokeOptions options)
public static Output<GetEventBusResult> getEventBus(GetEventBusArgs args, InvokeOptions options)
public static Output<GetEventBusResult> getEventBus(GetEventBusArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: aws-native:eventsv2:getEventBus
  arguments:
    # arguments dictionary
    data "aws-native_eventsv2_get_event_bus" "name" {
    # arguments
}

    The following arguments are supported:

    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    event_bus_arn string
    The Amazon Resource Name (ARN) of the event bus.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.
    eventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    event_bus_arn str
    The Amazon Resource Name (ARN) of the event bus.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.

    getEventBus Result

    The following output properties are available:

    CreationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    Description string
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    EncryptionConfiguration Pulumi.AwsNative.EventsV2.Outputs.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.
    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    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.
    StorageConfiguration Pulumi.AwsNative.EventsV2.Outputs.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.Outputs.Tag>
    The tags assigned to the event bus.
    CreationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    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.
    EventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    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.
    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.
    creation_time string
    The time the event bus was created, as an ISO 8601 timestamp.
    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.
    event_bus_arn string
    The Amazon Resource Name (ARN) of the event bus.
    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.
    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.
    creationTime String
    The time the event bus was created, as an ISO 8601 timestamp.
    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.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.
    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.
    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.
    creationTime string
    The time the event bus was created, as an ISO 8601 timestamp.
    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.
    eventBusArn string
    The Amazon Resource Name (ARN) of the event bus.
    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.
    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.
    creation_time str
    The time the event bus was created, as an ISO 8601 timestamp.
    description str
    A description of the event bus. Control characters and Unicode line separators are not allowed.
    encryption_configuration 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.
    event_bus_arn str
    The Amazon Resource Name (ARN) of the event bus.
    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.
    storage_configuration EventBusStorageConfiguration
    The event storage configuration for the event bus, which controls the number of days events are retained on the bus.
    tags Sequence[root_Tag]
    The tags assigned to the event bus.
    creationTime String
    The time the event bus was created, as an ISO 8601 timestamp.
    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.
    eventBusArn String
    The Amazon Resource Name (ARN) of the event bus.
    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.
    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.

    Supporting Types

    EventBusEncryptionConfiguration

    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

    EventBusStorageConfiguration

    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

    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