DescribeEventCategories - Amazon Relational Database Service
Request ParametersResponse ElementsErrorsExamplesSee Also

DescribeEventCategories

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in Events in the Amazon RDS 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.

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

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 AWS SDKs, see the following: