EventFilter - AWS Health

EventFilter

The values to use to filter results from the DescribeEvents and DescribeEventAggregates operations.

Contents

availabilityZones

A list of AWS Availability Zones.

Type: Array of strings

Length Constraints: Minimum length of 6. Maximum length of 18.

Pattern: [a-z]{2}\-[0-9a-z\-]{4,16}

Required: No

endTimes

A list of dates and times that the event ended.

Type: Array of DateTimeRange objects

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No

entityArns

A list of entity ARNs (unique identifiers).

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 99 items.

Length Constraints: Maximum length of 1600.

Pattern: .{0,1600}

Required: No

entityValues

A list of entity identifiers, such as EC2 instance IDs (i-34ab692e) or EBS volumes (vol-426ab23e).

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 99 items.

Length Constraints: Maximum length of 1224.

Pattern: .{0,1224}

Required: No

eventArns

A list of event ARNs (unique identifiers). For example: "arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456", "arn:aws:health:us-west-1::event/EBS/AWS_EBS_LOST_VOLUME/AWS_EBS_LOST_VOLUME_CHI789_JKL101"

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Maximum length of 1600.

Pattern: arn:aws(-[a-z]+(-[a-z]+)?)?:health:[^:]*:[^:]*:event(?:/[\w-]+){3}

Required: No

eventStatusCodes

A list of event status codes.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 6 items.

Valid Values: open | closed | upcoming

Required: No

eventTypeCategories

A list of event type category codes. Possible values are issue, accountNotification, or scheduledChange. Currently, the investigation value isn't supported at this time.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Minimum length of 3. Maximum length of 255.

Valid Values: issue | accountNotification | scheduledChange | investigation

Required: No

eventTypeCodes

A list of unique identifiers for event types. For example, "AWS_EC2_SYSTEM_MAINTENANCE_EVENT","AWS_RDS_MAINTENANCE_SCHEDULED".

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

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

Pattern: [^:/]{3,100}

Required: No

lastUpdatedTimes

A list of dates and times that the event was last updated.

Type: Array of DateTimeRange objects

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No

regions

A list of AWS Regions.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Minimum length of 2. Maximum length of 25.

Pattern: [^:/]{2,25}

Required: No

services

The AWS services associated with the event. For example, EC2, RDS.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Minimum length of 2. Maximum length of 30.

Pattern: [^:/]{2,30}

Required: No

startTimes

A list of dates and times that the event began.

Type: Array of DateTimeRange objects

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No

tags

A map of entity tags attached to the affected entity.

Note

Currently, the tags property isn't supported.

Type: Array of string to string maps

Array Members: Maximum number of 50 items.

Map Entries: Maximum number of 50 items.

Key Length Constraints: Maximum length of 127.

Key Pattern: .{0,127}

Value Length Constraints: Maximum length of 255.

Value Pattern: .{0,255}

Required: No

See Also

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