import { Command as $Command } from "@smithy/core/client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { DescribeEventsMessage, EventsMessage } from "../models/models_0"; import type { RDSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSClient"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link DescribeEventsCommand}. */ export interface DescribeEventsCommandInput extends DescribeEventsMessage { } /** * @public * * The output of {@link DescribeEventsCommand}. */ export interface DescribeEventsCommandOutput extends EventsMessage, __MetadataBearer { } declare const DescribeEventsCommand_base: { new (input: DescribeEventsCommandInput): import("@smithy/core/client").CommandImpl; new (...[input]: [] | [DescribeEventsCommandInput]): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): { [x: string]: unknown; }; }; /** *

Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days. Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by providing the name as a parameter.

For more information on working with events, see Monitoring Amazon RDS events in the Amazon RDS User Guide and Monitoring Amazon Aurora events in the Amazon Aurora User Guide.

By default, RDS returns events that were generated in the past hour.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { RDSClient, DescribeEventsCommand } from "@aws-sdk/client-rds"; // ES Modules import * // const { RDSClient, DescribeEventsCommand } = require("@aws-sdk/client-rds"); // CommonJS import * // import type { RDSClientConfig } from "@aws-sdk/client-rds"; * const config = {}; // type is RDSClientConfig * const client = new RDSClient(config); * const input = { // DescribeEventsMessage * SourceIdentifier: "STRING_VALUE", * SourceType: "db-instance" || "db-parameter-group" || "db-security-group" || "db-snapshot" || "db-cluster" || "db-cluster-snapshot" || "custom-engine-version" || "db-proxy" || "blue-green-deployment" || "db-shard-group" || "zero-etl", * StartTime: new Date("TIMESTAMP"), * EndTime: new Date("TIMESTAMP"), * Duration: Number("int"), * EventCategories: [ // EventCategoriesList * "STRING_VALUE", * ], * Filters: [ // FilterList * { // Filter * Name: "STRING_VALUE", // required * Values: [ // FilterValueList // required * "STRING_VALUE", * ], * }, * ], * MaxRecords: Number("int"), * Marker: "STRING_VALUE", * }; * const command = new DescribeEventsCommand(input); * const response = await client.send(command); * // { // EventsMessage * // Marker: "STRING_VALUE", * // Events: [ // EventList * // { // Event * // SourceIdentifier: "STRING_VALUE", * // SourceType: "db-instance" || "db-parameter-group" || "db-security-group" || "db-snapshot" || "db-cluster" || "db-cluster-snapshot" || "custom-engine-version" || "db-proxy" || "blue-green-deployment" || "db-shard-group" || "zero-etl", * // Message: "STRING_VALUE", * // EventCategories: [ // EventCategoriesList * // "STRING_VALUE", * // ], * // Date: new Date("TIMESTAMP"), * // SourceArn: "STRING_VALUE", * // }, * // ], * // }; * * ``` * * @param DescribeEventsCommandInput - {@link DescribeEventsCommandInput} * @returns {@link DescribeEventsCommandOutput} * @see {@link DescribeEventsCommandInput} for command's `input` shape. * @see {@link DescribeEventsCommandOutput} for command's `response` shape. * @see {@link RDSClientResolvedConfig | config} for RDSClient's `config` shape. * * @throws {@link RDSServiceException} *

Base exception class for all service exceptions from RDS service.

* * * @example To describe events * ```javascript * // The following retrieves details for the events that have occurred for the specified DB instance. * const input = { * SourceIdentifier: "test-instance", * SourceType: "db-instance" * }; * const command = new DescribeEventsCommand(input); * const response = await client.send(command); * /* response is * { * Events: [ * { * Date: "2018-07-31T23:09:23.983Z", * EventCategories: [ * "backup" * ], * Message: "Backing up DB instance", * SourceArn: "arn:aws:rds:us-east-1:123456789012:db:test-instance", * SourceIdentifier: "test-instance", * SourceType: "db-instance" * }, * { * Date: "2018-07-31T23:15:13.049Z", * EventCategories: [ * "backup" * ], * Message: "Finished DB Instance backup", * SourceArn: "arn:aws:rds:us-east-1:123456789012:db:test-instance", * SourceIdentifier: "test-instance", * SourceType: "db-instance" * } * ] * } * *\/ * ``` * * @public */ export declare class DescribeEventsCommand extends DescribeEventsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DescribeEventsMessage; output: EventsMessage; }; sdk: { input: DescribeEventsCommandInput; output: DescribeEventsCommandOutput; }; }; }