EventBridgeV2 / Client / list_event_sources

list_event_sources¶

EventBridgeV2.Client.list_event_sources(**kwargs)¶

Lists EventSources as summaries. By default the list spans the EventSources the caller account owns; set EventBusArn to scope it to one bus. Use DescribeEventSource to retrieve full configuration.

Request Syntax

response = client.list_event_sources(
    EventBusArn='string',
    NamePrefix='string',
    NextToken='string',
    MaxResults=123
)

Parameters:

EventBusArn (string) – The Amazon Resource Name (ARN) that uniquely identifies an event bus.
NamePrefix (string) – EventSource name. First character alphanumeric; the rest may add ‘.’, ‘-’, ‘_’. Names may not begin with the reserved “aws.” prefix. The grammar matches the ARN local-name segment in EventSourceArn (event-sourcev2///), mirroring EventBusName, so a name the ARN cannot represent cannot be created.
NextToken (string) – Opaque pagination token returned by a List operation. Pass it back in the next request to retrieve the next page of results.
MaxResults (integer) – Maximum number of results to return in one page of a List operation.

Return type:

dict

Returns:

Response Syntax

{
    'EventSources': [
        {
            'EventSourceArn': 'string',
            'Name': 'string',
            'EventBusArn': 'string',
            'Type': 'AWS_SERVICE_EVENTS'|'PARTNER_EVENTS',
            'State': 'CREATING'|'ACTIVE'|'UPDATING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED',
            'Revoked': True|False,
            'CreationTime': datetime(2015, 1, 1),
            'LastModifiedTime': datetime(2015, 1, 1),
            'EventSourceAccountId': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- EventSources (list) –
  
  List of EventSource summaries.
  - (dict) –
    
    Summary of an EventSource, as returned by ListEventSources.
    - EventSourceArn (string) –
      
      EventSource ARN: event-sourcev2///. The type segment is set by the service (aws.service for AWS service events, aws.partner for partner events) and is not part of the resource’s name. The id segment is a 25-character identifier generated by the service.
    - Name (string) –
      
      EventSource name. First character alphanumeric; the rest may add ‘.’, ‘-’, ‘_’. Names may not begin with the reserved “aws.” prefix. The grammar matches the ARN local-name segment in EventSourceArn (event-sourcev2///), mirroring EventBusName, so a name the ARN cannot represent cannot be created.
    - EventBusArn (string) –
      
      The Amazon Resource Name (ARN) that uniquely identifies an event bus.
    - Type (string) –
      
      Origin type of an EventSource: an AWS service’s events (AWS_SERVICE_EVENTS) or a partner event source’s events (PARTNER_EVENTS).
    - State (string) –
      
      Lifecycle state of an EventSource. Revocation is reported by the Revoked flag.
    - Revoked (boolean) –
      
      True when the bus owner has withdrawn this EventSource. Present only when true, so a bus owner listing EventSources sees at a glance which ones they revoked. See DescribeEventSourceResponse$Revoked.
    - CreationTime (datetime) –
      
      The time the EventSource was created.
    - LastModifiedTime (datetime) –
      
      The time the EventSource was last modified.
    - EventSourceAccountId (string) –
      
      AWS Account Id.
- NextToken (string) –
  
  Opaque pagination token returned by a List operation. Pass it back in the next request to retrieve the next page of results.

Exceptions

EventBridgeV2.Client.exceptions.AccessDeniedException
EventBridgeV2.Client.exceptions.ResourceNotFoundException
EventBridgeV2.Client.exceptions.ThrottlingException
EventBridgeV2.Client.exceptions.InvalidInputException
EventBridgeV2.Client.exceptions.InternalException