import * as pulumi from "@pulumi/pulumi";
import * as outputs from "../types/output";
/**
 * Provides details about RDS events, as recorded in the RDS event stream. RDS
 * records events such as maintenance and failure notifications that are not
 * always surfaced by the AWS API as errors. This data source is a thin wrapper
 * over the `DescribeEvents` API and does not evaluate or interpret the events it
 * returns.
 *
 * The `events` attribute reflects a wall-clock time window at read time. The
 * events themselves are stable, but because the window moves with each read,
 * successive `pulumi preview`/`refresh` runs can return different results. If
 * you use this data source to inspect events generated by another resource's
 * most recent apply, add a `dependsOn` on that resource so the read happens
 * after the operation you're investigating.
 *
 * Reading events requires the `rds:DescribeEvents` IAM permission.
 *
 * ## Example Usage
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const example = aws.rds.getEvents({
 *     sourceIdentifier: exampleAwsDbInstance.identifier,
 *     sourceType: "db-instance",
 *     eventCategories: [
 *         "failure",
 *         "maintenance",
 *     ],
 * });
 * ```
 */
export declare function getEvents(args?: GetEventsArgs, opts?: pulumi.InvokeOptions): Promise<GetEventsResult>;
/**
 * A collection of arguments for invoking getEvents.
 */
export interface GetEventsArgs {
    /**
     * Number of minutes to look back from now. Conflicts with `startTime` and `endTime`.
     */
    duration?: number;
    /**
     * End of the time interval, in RFC3339 format. Conflicts with `duration`.
     */
    endTime?: string;
    /**
     * Set of event categories to filter on, e.g. `failure`, `maintenance`, `configuration change`. Defaults to all categories.
     */
    eventCategories?: string[];
    /**
     * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
     */
    region?: string;
    /**
     * Identifier of the source, such as a DB instance or DB cluster identifier. Requires `sourceType` to also be set.
     */
    sourceIdentifier?: string;
    /**
     * Type of source. Valid values include `db-instance`, `db-cluster`, `db-snapshot`, `db-parameter-group`, `db-security-group`, `db-cluster-snapshot`, `custom-engine-version`, `db-proxy`, `blue-green-deployment`, `db-shard-group`, and `zero-etl`.
     */
    sourceType?: string;
    /**
     * Start of the time interval, in RFC3339 format. Conflicts with `duration`.
     */
    startTime?: string;
}
/**
 * A collection of values returned by getEvents.
 */
export interface GetEventsResult {
    readonly duration?: number;
    readonly endTime?: string;
    /**
     * List of categories for the event.
     */
    readonly eventCategories?: string[];
    /**
     * List of events. See `events` below.
     */
    readonly events: outputs.rds.GetEventsEvent[];
    readonly region: string;
    /**
     * Identifier of the event source.
     */
    readonly sourceIdentifier?: string;
    /**
     * Type of the event source.
     */
    readonly sourceType?: string;
    readonly startTime?: string;
}
/**
 * Provides details about RDS events, as recorded in the RDS event stream. RDS
 * records events such as maintenance and failure notifications that are not
 * always surfaced by the AWS API as errors. This data source is a thin wrapper
 * over the `DescribeEvents` API and does not evaluate or interpret the events it
 * returns.
 *
 * The `events` attribute reflects a wall-clock time window at read time. The
 * events themselves are stable, but because the window moves with each read,
 * successive `pulumi preview`/`refresh` runs can return different results. If
 * you use this data source to inspect events generated by another resource's
 * most recent apply, add a `dependsOn` on that resource so the read happens
 * after the operation you're investigating.
 *
 * Reading events requires the `rds:DescribeEvents` IAM permission.
 *
 * ## Example Usage
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const example = aws.rds.getEvents({
 *     sourceIdentifier: exampleAwsDbInstance.identifier,
 *     sourceType: "db-instance",
 *     eventCategories: [
 *         "failure",
 *         "maintenance",
 *     ],
 * });
 * ```
 */
export declare function getEventsOutput(args?: GetEventsOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output<GetEventsResult>;
/**
 * A collection of arguments for invoking getEvents.
 */
export interface GetEventsOutputArgs {
    /**
     * Number of minutes to look back from now. Conflicts with `startTime` and `endTime`.
     */
    duration?: pulumi.Input<number | undefined>;
    /**
     * End of the time interval, in RFC3339 format. Conflicts with `duration`.
     */
    endTime?: pulumi.Input<string | undefined>;
    /**
     * Set of event categories to filter on, e.g. `failure`, `maintenance`, `configuration change`. Defaults to all categories.
     */
    eventCategories?: pulumi.Input<pulumi.Input<string>[] | undefined>;
    /**
     * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
     */
    region?: pulumi.Input<string | undefined>;
    /**
     * Identifier of the source, such as a DB instance or DB cluster identifier. Requires `sourceType` to also be set.
     */
    sourceIdentifier?: pulumi.Input<string | undefined>;
    /**
     * Type of source. Valid values include `db-instance`, `db-cluster`, `db-snapshot`, `db-parameter-group`, `db-security-group`, `db-cluster-snapshot`, `custom-engine-version`, `db-proxy`, `blue-green-deployment`, `db-shard-group`, and `zero-etl`.
     */
    sourceType?: pulumi.Input<string | undefined>;
    /**
     * Start of the time interval, in RFC3339 format. Conflicts with `duration`.
     */
    startTime?: pulumi.Input<string | undefined>;
}
//# sourceMappingURL=getEvents.d.ts.map