EventBridge / Client / create_event_bus

create_event_bus#

EventBridge.Client.create_event_bus(**kwargs)#

Creates a new event bus within your account. This can be a custom event bus which you can use to receive events from your custom applications and services, or it can be a partner event bus which can be matched to a partner event source.

See also: AWS API Documentation

Request Syntax

response = client.create_event_bus(
    Name='string',
    EventSourceName='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:

  • Name (string) –

    [REQUIRED]

    The name of the new event bus.

    Custom event bus names can’t contain the / character, but you can use the / character in partner event bus names. In addition, for partner event buses, the name must exactly match the name of the partner event source that this event bus is matched to.

    You can’t use the name default for a custom event bus, as this name is already used for your account’s default event bus.

  • EventSourceName (string) – If you are creating a partner event bus, this specifies the partner event source that the new event bus will be matched with.

  • Tags (list) –

    Tags to associate with the event bus.

    • (dict) –

      A key-value pair associated with an Amazon Web Services resource. In EventBridge, rules and event buses support tagging.

      • Key (string) – [REQUIRED]

        A string you can use to assign a value. The combination of tag keys and values can help you organize and categorize your resources.

      • Value (string) – [REQUIRED]

        The value for the specified tag key.

Return type:

dict

Returns:

Response Syntax

{
    'EventBusArn': 'string'
}

Response Structure

  • (dict) –

    • EventBusArn (string) –

      The ARN of the new event bus.

Exceptions

  • EventBridge.Client.exceptions.ResourceAlreadyExistsException

  • EventBridge.Client.exceptions.ResourceNotFoundException

  • EventBridge.Client.exceptions.InvalidStateException

  • EventBridge.Client.exceptions.InternalException

  • EventBridge.Client.exceptions.ConcurrentModificationException

  • EventBridge.Client.exceptions.LimitExceededException

  • EventBridge.Client.exceptions.OperationDisabledException