Skip to content

Lists your archives

Description

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.

Usage

eventbridge_list_archives(NamePrefix, EventSourceArn, State, NextToken,
  Limit)

Arguments

  • NamePrefix

    A name prefix to filter the archives returned. Only archives with name that match the prefix are returned.

  • EventSourceArn

    The ARN of the event source associated with the archive.

  • State

    The state of the archive.

  • NextToken

    The token returned by a previous call, which you can use to retrieve the next set of results.

    The value of nextToken is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.

    Using an expired pagination token results in an HTTP 400 InvalidToken error.

  • Limit

    The maximum number of results to return.

Value

A list with the following syntax:

list(
  Archives = list(
    list(
      ArchiveName = "string",
      EventSourceArn = "string",
      State = "ENABLED"|"DISABLED"|"CREATING"|"UPDATING"|"CREATE_FAILED"|"UPDATE_FAILED",
      StateReason = "string",
      RetentionDays = 123,
      SizeBytes = 123,
      EventCount = 123,
      CreationTime = as.POSIXct(
        "2015-01-01"
      )
    )
  ),
  NextToken = "string"
)

Request syntax

svc$list_archives(
  NamePrefix = "string",
  EventSourceArn = "string",
  State = "ENABLED"|"DISABLED"|"CREATING"|"UPDATING"|"CREATE_FAILED"|"UPDATE_FAILED",
  NextToken = "string",
  Limit = 123
)