DescribeEvents - AWS Elastic Beanstalk

DescribeEvents

Returns 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.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

ApplicationName

If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those associated with this application.

Type: String

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

Required: No

EndTime

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur up to, but not including, the EndTime.

Type: Timestamp

Required: No

EnvironmentId

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment.

Type: String

Required: No

EnvironmentName

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 40.

Required: No

MaxRecords

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

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1000.

Required: No

NextToken

Pagination token. If specified, the events return the next batch of results.

Type: String

Required: No

PlatformArn

The ARN of a custom platform version. If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this custom platform version.

Type: String

Required: No

RequestId

If specified, AWS Elastic Beanstalk restricts the described events to include only those associated with this request ID.

Type: String

Required: No

Severity

If specified, limits the events returned from this call to include only those with the specified severity or higher.

Type: String

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

Required: No

StartTime

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur on or after this time.

Type: Timestamp

Required: No

TemplateName

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that are associated with this environment configuration.

Type: String

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

Required: No

VersionLabel

If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this application version.

Type: String

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

Required: No

Response Elements

The following elements are returned by the service.

Events.member.N

A list of EventDescription.

Type: Array of EventDescription objects

NextToken

If returned, this indicates that there are more results to obtain. Use this token in the next DescribeEvents call to get the next batch of events.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

Examples

Example

This example illustrates one usage of DescribeEvents.

Sample Request

https://elasticbeanstalk.us-west-2.amazonaws.com/?ApplicationName=SampleApp &Severity=TRACE &StartTime=2010-11-17T10%3A26%3A40Z &Operation=DescribeEvents &AuthParams

Sample Response

<DescribeEventsResponse xmlns="https://elasticbeanstalk.amazonaws.com/docs/2010-12-01/"> <DescribeEventsResult> <Events> <member> <Message>Successfully completed createEnvironment activity.</Message> <EventDate>2010-11-17T20:25:35.191Z</EventDate> <VersionLabel>New Version</VersionLabel> <RequestId>bb01fa74-f287-11df-8a78-9f77047e0d0c</RequestId> <ApplicationName>SampleApp</ApplicationName> <EnvironmentName>SampleAppVersion</EnvironmentName> <Severity>INFO</Severity> </member> <member> <Message>Launching a new EC2 instance: i-04a8c569</Message> <EventDate>2010-11-17T20:21:30Z</EventDate> <VersionLabel>New Version</VersionLabel> <ApplicationName>SampleApp</ApplicationName> <EnvironmentName>SampleAppVersion</EnvironmentName> <Severity>DEBUG</Severity> </member> <member> <Message>At least one EC2 instance has entered the InService lifecycle state.</Message> <EventDate>2010-11-17T20:20:32.008Z</EventDate> <VersionLabel>New Version</VersionLabel> <RequestId>bb01fa74-f287-11df-8a78-9f77047e0d0c</RequestId> <ApplicationName>SampleApp</ApplicationName> <EnvironmentName>SampleAppVersion</EnvironmentName> <Severity>INFO</Severity> </member> <member> <Message>Elastic Load Balancer elasticbeanstalk-SampleAppVersion has failed 0 healthy instances - Environment may not be available.</Message> <EventDate>2010-11-17T20:19:28Z</EventDate> <VersionLabel>New Version</VersionLabel> <ApplicationName>SampleApp</ApplicationName> <EnvironmentName>SampleAppVersion</EnvironmentName> <Severity>WARN</Severity> </member> </Events> </DescribeEventsResult> <ResponseMetadata> <RequestId>f10d02dd-f288-11df-8a78-9f77047e0d0c</RequestId> </ResponseMetadata> </DescribeEventsResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: