DescribeEventCategories - Amazon Relational Database Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

DescribeEventCategories

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can also see this list in the "Amazon RDS event categories and event messages" section of the Amazon RDS User Guide or the Amazon Aurora User Guide.

Request Parameters

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

Filters.Filter.N

This parameter isn't currently supported.

Type: Array of Filter objects

Required: No

SourceType

The type of source that is generating the events. For RDS Proxy events, specify db-proxy.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot | db-proxy

Type: String

Required: No

Response Elements

The following element is returned by the service.

EventCategoriesMapList.EventCategoriesMap.N

A list of EventCategoriesMap data types.

Type: Array of EventCategoriesMap objects

Errors

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

Examples

Example

This example illustrates one usage of DescribeEventCategories.

Sample Request

https://rds.us-west-2.amazonaws.com/ ?Action=DescribeEventCategories &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140421/us-west-2/rds/aws4_request &X-Amz-Date=20140421T194732Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=6e25c542bf96fe24b28c12976ec92d2f856ab1d2a158e21c35441a736e4fde2b

Sample Response

<DescribeEventCategoriesResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <DescribeEventCategoriesResult> <EventCategoriesMapList> <EventCategoriesMap> <SourceType>db-instance</SourceType> <EventCategories> <EventCategory>backup</EventCategory> <EventCategory>recovery</EventCategory> <EventCategory>restoration</EventCategory> <EventCategory>failover</EventCategory> <EventCategory>low storage</EventCategory> <EventCategory>maintenance</EventCategory> <EventCategory>deletion</EventCategory> <EventCategory>availability</EventCategory> <EventCategory>configuration change</EventCategory> <EventCategory>notification</EventCategory> <EventCategory>failure</EventCategory> <EventCategory>creation</EventCategory> </EventCategories> </EventCategoriesMap> <EventCategoriesMap> <SourceType>db-security-group</SourceType> <EventCategories> <EventCategory>configuration change</EventCategory> <EventCategory>failure</EventCategory> </EventCategories> </EventCategoriesMap> <EventCategoriesMap> <SourceType>db-parameter-group</SourceType> <EventCategories> <EventCategory>configuration change</EventCategory> </EventCategories> </EventCategoriesMap> <EventCategoriesMap> <SourceType>db-snapshot</SourceType> <EventCategories> <EventCategory>deletion</EventCategory> <EventCategory>restoration</EventCategory> <EventCategory>notification</EventCategory> <EventCategory>failure</EventCategory> <EventCategory>creation</EventCategory> </EventCategories> </EventCategoriesMap> </EventCategoriesMap> </DescribeEventCategoriesResult> <ResponseMetadata> <RequestId>b79456f2-b98c-11d3-f272-7cd6cce12cc5</RequestId> </ResponseMetadata> </DescribeEventCategoriesResponse>

See Also

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