AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

elastic-beanstalk-describe-events

Description

Returns a list of event descriptions matching criteria up to the last 6 weeks.

Note

This action returns the most recent 1,000 events from the specified NextToken.

Syntax

elastic-beanstalk-describe-events -a [name] -e [name] -E [id] -l [label] -L [timestamp] -m [count] -n [token] -r [id] -s [level] -S [timestamp] -t [name]

Options

NameDescriptionRequired

-a

--application-name name

The name of the application.

Type: String

Default: None

Length Constraints: Minimum value of 1. Maximum value of 100.

No

-e

--environment-name name

The name of the environment.

Type: String

Default: None

Length Constraints: Minimum value of 4. Maximum value of 23.

No

-E

--environment-id id

The ID of the environment.

Type: String

Default: None

No

-l

--version-label label

The application version.

Type: String

Default: None

Length Constraints: Minimum value of 1. Maximum value of 100.

No

-L

--end-time timestamp

If specified, a list of events that occurred up to but not including the specified time is returned.

Type: Date Time

Default: None

No

-m

--max-records count

Specifies the maximum number of events that can be returned, beginning with the most recent event.

Type: Integer

Default: None

No

-n

--next-token token

Pagination token. Used to return the next batch of results.

Type: String

Default: None

No

-r

--request-id id

The request ID.

Type: String

Default: None

No

-s

--severity level

If specified, a list of events with the specified severity level or higher is returned.

Type: String

Valid Values: TRACE | DEBUG | INFO | WARN | ERROR | FATAL

Default: None

No

-S

--start-time timestamp

If specified, a list of events that occurred after the specified time is returned.

Type: Date Time

Default: None

No

-t

--template-name name

The name of the configuration template.

Type: String

Default: None

Length Constraints: Minimum value of 1. Maximum value of 100.

No

Output

The command returns a table with the following information:

  • ApplicationName—The name of the application associated with the event.

  • EnvironmentName—The name of the environment associated with the event.

  • EventDate—The date of the event.

  • Message—The event's message.

  • RequestID—The web service request ID for the activity of this event.

  • Severity—The severity level of the event.

  • TemplateName—The name of the configuration associated with this event.

  • VersionLabel—The release label for the application version associated with this event.

Examples

Describing Events for an Environment with a Security Level

This example shows how to describe events that have a severity level of WARN or higher for an environment.

PROMPT> elastic-beanstalk-describe-events -e MySampleAppEnv -s WARN