EventBridge / Client / list_archives



Lists your archives. You can either list all the archives or you can provide a prefix to match to the archive names. Filter parameters are exclusive.

See also: AWS API Documentation

Request Syntax

response = client.list_archives(
  • NamePrefix (string) – A name prefix to filter the archives returned. Only archives with name that match the prefix are returned.

  • EventSourceArn (string) – The ARN of the event source associated with the archive.

  • State (string) – The state of the archive.

  • NextToken (string) – The token returned by a previous call to retrieve the next set of results.

  • Limit (integer) – The maximum number of results to return.

Return type:



Response Syntax

    'Archives': [
            'ArchiveName': 'string',
            'EventSourceArn': 'string',
            'StateReason': 'string',
            'RetentionDays': 123,
            'SizeBytes': 123,
            'EventCount': 123,
            'CreationTime': datetime(2015, 1, 1)
    'NextToken': 'string'

Response Structure

  • (dict) –

    • Archives (list) –

      An array of Archive objects that include details about an archive.

      • (dict) –

        An Archive object that contains details about an archive.

        • ArchiveName (string) –

          The name of the archive.

        • EventSourceArn (string) –

          The ARN of the event bus associated with the archive. Only events from this event bus are sent to the archive.

        • State (string) –

          The current state of the archive.

        • StateReason (string) –

          A description for the reason that the archive is in the current state.

        • RetentionDays (integer) –

          The number of days to retain events in the archive before they are deleted.

        • SizeBytes (integer) –

          The size of the archive, in bytes.

        • EventCount (integer) –

          The number of events in the archive.

        • CreationTime (datetime) –

          The time stamp for the time that the archive was created.

    • NextToken (string) –

      The token returned by a previous call to retrieve the next set of results.


  • EventBridge.Client.exceptions.ResourceNotFoundException

  • EventBridge.Client.exceptions.InternalException