import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudTrailClient"; import type { DescribeTrailsRequest, DescribeTrailsResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link DescribeTrailsCommand}. */ export interface DescribeTrailsCommandInput extends DescribeTrailsRequest { } /** * @public * * The output of {@link DescribeTrailsCommand}. */ export interface DescribeTrailsCommandOutput extends DescribeTrailsResponse, __MetadataBearer { } declare const DescribeTrailsCommand_base: { new (input: DescribeTrailsCommandInput): import("@smithy/smithy-client").CommandImpl; new (...[input]: [] | [DescribeTrailsCommandInput]): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Retrieves settings for one or more trails associated with the current Region for your * account.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { CloudTrailClient, DescribeTrailsCommand } from "@aws-sdk/client-cloudtrail"; // ES Modules import * // const { CloudTrailClient, DescribeTrailsCommand } = require("@aws-sdk/client-cloudtrail"); // CommonJS import * // import type { CloudTrailClientConfig } from "@aws-sdk/client-cloudtrail"; * const config = {}; // type is CloudTrailClientConfig * const client = new CloudTrailClient(config); * const input = { // DescribeTrailsRequest * trailNameList: [ // TrailNameList * "STRING_VALUE", * ], * includeShadowTrails: true || false, * }; * const command = new DescribeTrailsCommand(input); * const response = await client.send(command); * // { // DescribeTrailsResponse * // trailList: [ // TrailList * // { // Trail * // Name: "STRING_VALUE", * // S3BucketName: "STRING_VALUE", * // S3KeyPrefix: "STRING_VALUE", * // SnsTopicName: "STRING_VALUE", * // SnsTopicARN: "STRING_VALUE", * // IncludeGlobalServiceEvents: true || false, * // IsMultiRegionTrail: true || false, * // HomeRegion: "STRING_VALUE", * // TrailARN: "STRING_VALUE", * // LogFileValidationEnabled: true || false, * // CloudWatchLogsLogGroupArn: "STRING_VALUE", * // CloudWatchLogsRoleArn: "STRING_VALUE", * // KmsKeyId: "STRING_VALUE", * // HasCustomEventSelectors: true || false, * // HasInsightSelectors: true || false, * // IsOrganizationTrail: true || false, * // }, * // ], * // }; * * ``` * * @param DescribeTrailsCommandInput - {@link DescribeTrailsCommandInput} * @returns {@link DescribeTrailsCommandOutput} * @see {@link DescribeTrailsCommandInput} for command's `input` shape. * @see {@link DescribeTrailsCommandOutput} for command's `response` shape. * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape. * * @throws {@link CloudTrailARNInvalidException} (client fault) *

This exception is thrown when an operation is called with an ARN that is not valid.

*

The following is the format of a trail ARN: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail *

*

The following is the format of an event data store ARN: * arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE *

*

The following is the format of a dashboard ARN: arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash *

*

The following is the format of a channel ARN: * arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890 *

* * @throws {@link InvalidTrailNameException} (client fault) *

This exception is thrown when the provided trail name is not valid. Trail names must * meet the following requirements:

* * * @throws {@link NoManagementAccountSLRExistsException} (client fault) *

This exception is thrown when the management account does not have a service-linked * role.

* * @throws {@link OperationNotPermittedException} (client fault) *

This exception is thrown when the requested operation is not permitted.

* * @throws {@link UnsupportedOperationException} (client fault) *

This exception is thrown when the requested operation is not supported.

* * @throws {@link CloudTrailServiceException} *

Base exception class for all service exceptions from CloudTrail service.

* * * @public */ export declare class DescribeTrailsCommand extends DescribeTrailsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DescribeTrailsRequest; output: DescribeTrailsResponse; }; sdk: { input: DescribeTrailsCommandInput; output: DescribeTrailsCommandOutput; }; }; }