@aws-sdk/client-cloudtrail 3.693.0 → 3.698.0

package/dist-types/commands/CreateDashboardCommand.d.ts

@@ -0,0 +1,189 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudTrailClient";
+import { CreateDashboardRequest, CreateDashboardResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link CreateDashboardCommand}.
+ */
+export interface CreateDashboardCommandInput extends CreateDashboardRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link CreateDashboardCommand}.
+ */
+export interface CreateDashboardCommandOutput extends CreateDashboardResponse, __MetadataBearer {
+}
+declare const CreateDashboardCommand_base: {
+    new (input: CreateDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<CreateDashboardCommandInput, CreateDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: CreateDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<CreateDashboardCommandInput, CreateDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ * Creates a custom dashboard or the Highlights dashboard.
+ * </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <b>Custom dashboards</b> - Custom dashboards allow you to query
+ *             events in any event data store type. You can add up to 10 widgets to a custom dashboard. You can manually refresh a custom dashboard, or you can set a refresh schedule.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <b>Highlights dashboard</b> - You can create
+ *             the Highlights dashboard to see a summary of key user activities and API usage across all your event data stores.
+ *             CloudTrail Lake manages the Highlights dashboard and refreshes the dashboard every 6 hours. To create the Highlights dashboard, you must set and enable a refresh schedule.</p>
+ *             </li>
+ *          </ul>
+ *          <p>
+ *       CloudTrail runs queries to populate the dashboard's widgets during a manual or scheduled refresh. CloudTrail must be granted permissions to run the <code>StartQuery</code> operation on your behalf. To provide permissions, run the <code>PutResourcePolicy</code> operation to attach a resource-based policy to each event data store. For more information,
+ *       see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-eds-dashboard">Example: Allow CloudTrail to run queries to populate a dashboard</a> in the <i>CloudTrail User Guide</i>.
+ *    </p>
+ *          <p>
+ *       To set a refresh schedule, CloudTrail must be granted permissions to run the <code>StartDashboardRefresh</code> operation to refresh the dashboard on your behalf. To provide permissions, run the <code>PutResourcePolicy</code> operation to attach a resource-based policy to the dashboard. For more information,
+ *       see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-dashboards">
+ *          Resource-based policy example for a dashboard</a> in the <i>CloudTrail User Guide</i>.
+ *    </p>
+ *          <p>For more information about dashboards, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-dashboard.html">CloudTrail Lake dashboards</a> in the <i>CloudTrail User Guide</i>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudTrailClient, CreateDashboardCommand } from "@aws-sdk/client-cloudtrail"; // ES Modules import
+ * // const { CloudTrailClient, CreateDashboardCommand } = require("@aws-sdk/client-cloudtrail"); // CommonJS import
+ * const client = new CloudTrailClient(config);
+ * const input = { // CreateDashboardRequest
+ *   Name: "STRING_VALUE", // required
+ *   RefreshSchedule: { // RefreshSchedule
+ *     Frequency: { // RefreshScheduleFrequency
+ *       Unit: "HOURS" || "DAYS",
+ *       Value: Number("int"),
+ *     },
+ *     Status: "ENABLED" || "DISABLED",
+ *     TimeOfDay: "STRING_VALUE",
+ *   },
+ *   TagsList: [ // TagsList
+ *     { // Tag
+ *       Key: "STRING_VALUE", // required
+ *       Value: "STRING_VALUE",
+ *     },
+ *   ],
+ *   TerminationProtectionEnabled: true || false,
+ *   Widgets: [ // RequestWidgetList
+ *     { // RequestWidget
+ *       QueryStatement: "STRING_VALUE", // required
+ *       QueryParameters: [ // QueryParameters
+ *         "STRING_VALUE",
+ *       ],
+ *       ViewProperties: { // ViewPropertiesMap // required
+ *         "<keys>": "STRING_VALUE",
+ *       },
+ *     },
+ *   ],
+ * };
+ * const command = new CreateDashboardCommand(input);
+ * const response = await client.send(command);
+ * // { // CreateDashboardResponse
+ * //   DashboardArn: "STRING_VALUE",
+ * //   Name: "STRING_VALUE",
+ * //   Type: "MANAGED" || "CUSTOM",
+ * //   Widgets: [ // WidgetList
+ * //     { // Widget
+ * //       QueryAlias: "STRING_VALUE",
+ * //       QueryStatement: "STRING_VALUE",
+ * //       QueryParameters: [ // QueryParameters
+ * //         "STRING_VALUE",
+ * //       ],
+ * //       ViewProperties: { // ViewPropertiesMap
+ * //         "<keys>": "STRING_VALUE",
+ * //       },
+ * //     },
+ * //   ],
+ * //   TagsList: [ // TagsList
+ * //     { // Tag
+ * //       Key: "STRING_VALUE", // required
+ * //       Value: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   RefreshSchedule: { // RefreshSchedule
+ * //     Frequency: { // RefreshScheduleFrequency
+ * //       Unit: "HOURS" || "DAYS",
+ * //       Value: Number("int"),
+ * //     },
+ * //     Status: "ENABLED" || "DISABLED",
+ * //     TimeOfDay: "STRING_VALUE",
+ * //   },
+ * //   TerminationProtectionEnabled: true || false,
+ * // };
+ *
+ * ```
+ *
+ * @param CreateDashboardCommandInput - {@link CreateDashboardCommandInput}
+ * @returns {@link CreateDashboardCommandOutput}
+ * @see {@link CreateDashboardCommandInput} for command's `input` shape.
+ * @see {@link CreateDashboardCommandOutput} for command's `response` shape.
+ * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This exception is thrown when the specified resource is not ready for an operation. This
+ *          can occur when you try to run an operation on a resource before CloudTrail has time
+ *          to fully load the resource, or because another operation is modifying the resource. If this exception occurs, wait a few minutes, and then try the
+ *          operation again.</p>
+ *
+ * @throws {@link EventDataStoreNotFoundException} (client fault)
+ *  <p>The specified event data store was not found.</p>
+ *
+ * @throws {@link InactiveEventDataStoreException} (client fault)
+ *  <p>The event data store is inactive.</p>
+ *
+ * @throws {@link InsufficientEncryptionPolicyException} (client fault)
+ *  <p>For the <code>CreateTrail</code>
+ *             <code>PutInsightSelectors</code>, <code>UpdateTrail</code>, <code>StartQuery</code>, and <code>StartImport</code> operations, this exception is thrown
+ *          when the policy on the S3 bucket or KMS key does
+ *          not have sufficient permissions for the operation.</p>
+ *          <p>For all other operations, this exception is thrown when the policy for the KMS key does
+ *          not have sufficient permissions for the operation.</p>
+ *
+ * @throws {@link InvalidQueryStatementException} (client fault)
+ *  <p>The query that was submitted has validation errors, or uses incorrect syntax or
+ *          unsupported keywords. For more information about writing a query, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-create-edit-query.html">Create or edit a query</a> in the <i>CloudTrail User
+ *             Guide</i>.</p>
+ *
+ * @throws {@link InvalidTagParameterException} (client fault)
+ *  <p>This exception is thrown when the specified tag key or values are not valid. It can also
+ *          occur if there are duplicate tags or too many tags on the resource.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>
+ *    This exception is thrown when the quota is exceeded. For information about CloudTrail quotas, see <a href="https://docs.aws.amazon.com/general/latest/gr/ct.html#limits_cloudtrail">Service quotas</a>
+ *    in the <i>Amazon Web Services General Reference</i>.
+ * </p>
+ *
+ * @throws {@link UnsupportedOperationException} (client fault)
+ *  <p>This exception is thrown when the requested operation is not supported.</p>
+ *
+ * @throws {@link CloudTrailServiceException}
+ * <p>Base exception class for all service exceptions from CloudTrail service.</p>
+ *
+ * @public
+ */
+export declare class CreateDashboardCommand extends CreateDashboardCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: CreateDashboardRequest;
+            output: CreateDashboardResponse;
+        };
+        sdk: {
+            input: CreateDashboardCommandInput;
+            output: CreateDashboardCommandOutput;
+        };
+    };
+}

package/dist-types/commands/CreateEventDataStoreCommand.d.ts

@@ -153,7 +153,11 @@ declare const CreateEventDataStoreCommand_base: {
  *          organization resource in a required service.</p>
  *
  * @throws {@link InsufficientEncryptionPolicyException} (client fault)
- *  <p>This exception is thrown when the policy on the S3 bucket or KMS key does
+ *  <p>For the <code>CreateTrail</code>
+ *             <code>PutInsightSelectors</code>, <code>UpdateTrail</code>, <code>StartQuery</code>, and <code>StartImport</code> operations, this exception is thrown
+ *          when the policy on the S3 bucket or KMS key does
+ *          not have sufficient permissions for the operation.</p>
+ *          <p>For all other operations, this exception is thrown when the policy for the KMS key does
  *          not have sufficient permissions for the operation.</p>
  *
  * @throws {@link InvalidEventSelectorsException} (client fault)

package/dist-types/commands/CreateTrailCommand.d.ts

@@ -103,7 +103,11 @@ declare const CreateTrailCommand_base: {
  *          organization resource in a required service.</p>
  *
  * @throws {@link InsufficientEncryptionPolicyException} (client fault)
- *  <p>This exception is thrown when the policy on the S3 bucket or KMS key does
+ *  <p>For the <code>CreateTrail</code>
+ *             <code>PutInsightSelectors</code>, <code>UpdateTrail</code>, <code>StartQuery</code>, and <code>StartImport</code> operations, this exception is thrown
+ *          when the policy on the S3 bucket or KMS key does
+ *          not have sufficient permissions for the operation.</p>
+ *          <p>For all other operations, this exception is thrown when the policy for the KMS key does
  *          not have sufficient permissions for the operation.</p>
  *
  * @throws {@link InsufficientS3BucketPolicyException} (client fault)
@@ -207,7 +211,7 @@ declare const CreateTrailCommand_base: {
  *  <p>This exception is thrown when the specified S3 bucket does not exist.</p>
  *
  * @throws {@link TagsLimitExceededException} (client fault)
- *  <p>The number of tags per trail, event data store, or channel has exceeded the permitted amount. Currently, the limit is
+ *  <p>The number of tags per trail, event data store, dashboard, or channel has exceeded the permitted amount. Currently, the limit is
  *          50.</p>
  *
  * @throws {@link ThrottlingException} (client fault)

package/dist-types/commands/DeleteDashboardCommand.d.ts

@@ -0,0 +1,83 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudTrailClient";
+import { DeleteDashboardRequest, DeleteDashboardResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link DeleteDashboardCommand}.
+ */
+export interface DeleteDashboardCommandInput extends DeleteDashboardRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DeleteDashboardCommand}.
+ */
+export interface DeleteDashboardCommandOutput extends DeleteDashboardResponse, __MetadataBearer {
+}
+declare const DeleteDashboardCommand_base: {
+    new (input: DeleteDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<DeleteDashboardCommandInput, DeleteDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: DeleteDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<DeleteDashboardCommandInput, DeleteDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ * Deletes the specified dashboard. You cannot delete a dashboard that has termination protection enabled.
+ * </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudTrailClient, DeleteDashboardCommand } from "@aws-sdk/client-cloudtrail"; // ES Modules import
+ * // const { CloudTrailClient, DeleteDashboardCommand } = require("@aws-sdk/client-cloudtrail"); // CommonJS import
+ * const client = new CloudTrailClient(config);
+ * const input = { // DeleteDashboardRequest
+ *   DashboardId: "STRING_VALUE", // required
+ * };
+ * const command = new DeleteDashboardCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param DeleteDashboardCommandInput - {@link DeleteDashboardCommandInput}
+ * @returns {@link DeleteDashboardCommandOutput}
+ * @see {@link DeleteDashboardCommandInput} for command's `input` shape.
+ * @see {@link DeleteDashboardCommandOutput} for command's `response` shape.
+ * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This exception is thrown when the specified resource is not ready for an operation. This
+ *          can occur when you try to run an operation on a resource before CloudTrail has time
+ *          to fully load the resource, or because another operation is modifying the resource. If this exception occurs, wait a few minutes, and then try the
+ *          operation again.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>This exception is thrown when the specified resource is not found.</p>
+ *
+ * @throws {@link UnsupportedOperationException} (client fault)
+ *  <p>This exception is thrown when the requested operation is not supported.</p>
+ *
+ * @throws {@link CloudTrailServiceException}
+ * <p>Base exception class for all service exceptions from CloudTrail service.</p>
+ *
+ * @public
+ */
+export declare class DeleteDashboardCommand extends DeleteDashboardCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DeleteDashboardRequest;
+            output: {};
+        };
+        sdk: {
+            input: DeleteDashboardCommandInput;
+            output: DeleteDashboardCommandOutput;
+        };
+    };
+}

package/dist-types/commands/DeleteResourcePolicyCommand.d.ts

@@ -28,7 +28,7 @@ declare const DeleteResourcePolicyCommand_base: {
 };
 /**
  * <p>
- *          Deletes the resource-based policy attached to the CloudTrail channel.
+ *          Deletes the resource-based policy attached to the CloudTrail event data store, dashboard, or channel.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -51,14 +51,27 @@ declare const DeleteResourcePolicyCommand_base: {
  * @see {@link DeleteResourcePolicyCommandOutput} for command's `response` shape.
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
  *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This exception is thrown when the specified resource is not ready for an operation. This
+ *          can occur when you try to run an operation on a resource before CloudTrail has time
+ *          to fully load the resource, or because another operation is modifying the resource. If this exception occurs, wait a few minutes, and then try the
+ *          operation again.</p>
+ *
  * @throws {@link OperationNotPermittedException} (client fault)
  *  <p>This exception is thrown when the requested operation is not permitted.</p>
  *
  * @throws {@link ResourceARNNotValidException} (client fault)
  *  <p>
- *          This exception is thrown when the provided resource does not exist, or the ARN format of the resource is not valid. The following is the valid format for a resource ARN:
- *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/MyChannel</code>.
+ *          This exception is thrown when the provided resource does not exist, or the ARN format of the resource is not valid.
  *       </p>
+ *          <p>The following is the format of an event data store ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
+ *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
+ *          <p>The following is the format of a channel ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
+ *          </p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>This exception is thrown when the specified resource is not found.</p>

package/dist-types/commands/DeleteTrailCommand.d.ts

@@ -58,6 +58,8 @@ declare const DeleteTrailCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>

package/dist-types/commands/DescribeQueryCommand.d.ts

@@ -30,9 +30,10 @@ declare const DescribeQueryCommand_base: {
  * <p>Returns metadata about a query, including query run time in milliseconds, number of
  *          events scanned and matched, and query status. If the query results were delivered to an S3 bucket,
  *          the response also provides the S3 URI and the delivery status.</p>
- *          <p>You must specify either a <code>QueryID</code> or a <code>QueryAlias</code>. Specifying
- *          the <code>QueryAlias</code> parameter returns information about the last query run for the
- *          alias.</p>
+ *          <p>You must specify either <code>QueryId</code> or <code>QueryAlias</code>. Specifying the <code>QueryAlias</code> parameter
+ *          returns information about the last query run for the alias. You can provide
+ *          <code>RefreshId</code> along with <code>QueryAlias</code> to view the query results
+ *          of a dashboard query for the specified <code>RefreshId</code>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -43,6 +44,8 @@ declare const DescribeQueryCommand_base: {
  *   EventDataStore: "STRING_VALUE",
  *   QueryId: "STRING_VALUE",
  *   QueryAlias: "STRING_VALUE",
+ *   RefreshId: "STRING_VALUE",
+ *   EventDataStoreOwnerAccountId: "STRING_VALUE",
  * };
  * const command = new DescribeQueryCommand(input);
  * const response = await client.send(command);
@@ -61,6 +64,7 @@ declare const DescribeQueryCommand_base: {
  * //   DeliveryS3Uri: "STRING_VALUE",
  * //   DeliveryStatus: "SUCCESS" || "FAILED" || "FAILED_SIGNING_FILE" || "PENDING" || "RESOURCE_NOT_FOUND" || "ACCESS_DENIED" || "ACCESS_DENIED_SIGNING_FILE" || "CANCELLED" || "UNKNOWN",
  * //   Prompt: "STRING_VALUE",
+ * //   EventDataStoreOwnerAccountId: "STRING_VALUE",
  * // };
  *
  * ```

package/dist-types/commands/DescribeTrailsCommand.d.ts

@@ -81,6 +81,8 @@ declare const DescribeTrailsCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>

package/dist-types/commands/GenerateQueryCommand.d.ts

@@ -60,6 +60,7 @@ declare const GenerateQueryCommand_base: {
  * // { // GenerateQueryResponse
  * //   QueryStatement: "STRING_VALUE",
  * //   QueryAlias: "STRING_VALUE",
+ * //   EventDataStoreOwnerAccountId: "STRING_VALUE",
  * // };
  *
  * ```

package/dist-types/commands/GetDashboardCommand.d.ts

@@ -0,0 +1,106 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudTrailClient";
+import { GetDashboardRequest, GetDashboardResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetDashboardCommand}.
+ */
+export interface GetDashboardCommandInput extends GetDashboardRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetDashboardCommand}.
+ */
+export interface GetDashboardCommandOutput extends GetDashboardResponse, __MetadataBearer {
+}
+declare const GetDashboardCommand_base: {
+    new (input: GetDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<GetDashboardCommandInput, GetDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: GetDashboardCommandInput): import("@smithy/smithy-client").CommandImpl<GetDashboardCommandInput, GetDashboardCommandOutput, CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ * Returns the specified dashboard.
+ * </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudTrailClient, GetDashboardCommand } from "@aws-sdk/client-cloudtrail"; // ES Modules import
+ * // const { CloudTrailClient, GetDashboardCommand } = require("@aws-sdk/client-cloudtrail"); // CommonJS import
+ * const client = new CloudTrailClient(config);
+ * const input = { // GetDashboardRequest
+ *   DashboardId: "STRING_VALUE", // required
+ * };
+ * const command = new GetDashboardCommand(input);
+ * const response = await client.send(command);
+ * // { // GetDashboardResponse
+ * //   DashboardArn: "STRING_VALUE",
+ * //   Type: "MANAGED" || "CUSTOM",
+ * //   Status: "CREATING" || "CREATED" || "UPDATING" || "UPDATED" || "DELETING",
+ * //   Widgets: [ // WidgetList
+ * //     { // Widget
+ * //       QueryAlias: "STRING_VALUE",
+ * //       QueryStatement: "STRING_VALUE",
+ * //       QueryParameters: [ // QueryParameters
+ * //         "STRING_VALUE",
+ * //       ],
+ * //       ViewProperties: { // ViewPropertiesMap
+ * //         "<keys>": "STRING_VALUE",
+ * //       },
+ * //     },
+ * //   ],
+ * //   RefreshSchedule: { // RefreshSchedule
+ * //     Frequency: { // RefreshScheduleFrequency
+ * //       Unit: "HOURS" || "DAYS",
+ * //       Value: Number("int"),
+ * //     },
+ * //     Status: "ENABLED" || "DISABLED",
+ * //     TimeOfDay: "STRING_VALUE",
+ * //   },
+ * //   CreatedTimestamp: new Date("TIMESTAMP"),
+ * //   UpdatedTimestamp: new Date("TIMESTAMP"),
+ * //   LastRefreshId: "STRING_VALUE",
+ * //   LastRefreshFailureReason: "STRING_VALUE",
+ * //   TerminationProtectionEnabled: true || false,
+ * // };
+ *
+ * ```
+ *
+ * @param GetDashboardCommandInput - {@link GetDashboardCommandInput}
+ * @returns {@link GetDashboardCommandOutput}
+ * @see {@link GetDashboardCommandInput} for command's `input` shape.
+ * @see {@link GetDashboardCommandOutput} for command's `response` shape.
+ * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>This exception is thrown when the specified resource is not found.</p>
+ *
+ * @throws {@link UnsupportedOperationException} (client fault)
+ *  <p>This exception is thrown when the requested operation is not supported.</p>
+ *
+ * @throws {@link CloudTrailServiceException}
+ * <p>Base exception class for all service exceptions from CloudTrail service.</p>
+ *
+ * @public
+ */
+export declare class GetDashboardCommand extends GetDashboardCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetDashboardRequest;
+            output: GetDashboardResponse;
+        };
+        sdk: {
+            input: GetDashboardCommandInput;
+            output: GetDashboardCommandOutput;
+        };
+    };
+}

package/dist-types/commands/GetEventSelectorsCommand.d.ts

@@ -138,6 +138,8 @@ declare const GetEventSelectorsCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>

package/dist-types/commands/GetInsightSelectorsCommand.d.ts

@@ -74,6 +74,8 @@ declare const GetInsightSelectorsCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>

package/dist-types/commands/GetQueryResultsCommand.d.ts

@@ -40,6 +40,7 @@ declare const GetQueryResultsCommand_base: {
  *   QueryId: "STRING_VALUE", // required
  *   NextToken: "STRING_VALUE",
  *   MaxQueryResults: Number("int"),
+ *   EventDataStoreOwnerAccountId: "STRING_VALUE",
  * };
  * const command = new GetQueryResultsCommand(input);
  * const response = await client.send(command);
@@ -80,7 +81,11 @@ declare const GetQueryResultsCommand_base: {
  *  <p>The event data store is inactive.</p>
  *
  * @throws {@link InsufficientEncryptionPolicyException} (client fault)
- *  <p>This exception is thrown when the policy on the S3 bucket or KMS key does
+ *  <p>For the <code>CreateTrail</code>
+ *             <code>PutInsightSelectors</code>, <code>UpdateTrail</code>, <code>StartQuery</code>, and <code>StartImport</code> operations, this exception is thrown
+ *          when the policy on the S3 bucket or KMS key does
+ *          not have sufficient permissions for the operation.</p>
+ *          <p>For all other operations, this exception is thrown when the policy for the KMS key does
  *          not have sufficient permissions for the operation.</p>
  *
  * @throws {@link InvalidMaxResultsException} (client fault)

package/dist-types/commands/GetResourcePolicyCommand.d.ts

@@ -28,7 +28,7 @@ declare const GetResourcePolicyCommand_base: {
 };
 /**
  * <p>
- *          Retrieves the JSON text of the resource-based policy document attached to the CloudTrail channel.
+ *          Retrieves the JSON text of the resource-based policy document attached to the CloudTrail event data store, dashboard, or channel.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -44,6 +44,7 @@ declare const GetResourcePolicyCommand_base: {
  * // { // GetResourcePolicyResponse
  * //   ResourceArn: "STRING_VALUE",
  * //   ResourcePolicy: "STRING_VALUE",
+ * //   DelegatedAdminResourcePolicy: "STRING_VALUE",
  * // };
  *
  * ```
@@ -59,9 +60,16 @@ declare const GetResourcePolicyCommand_base: {
  *
  * @throws {@link ResourceARNNotValidException} (client fault)
  *  <p>
- *          This exception is thrown when the provided resource does not exist, or the ARN format of the resource is not valid. The following is the valid format for a resource ARN:
- *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/MyChannel</code>.
+ *          This exception is thrown when the provided resource does not exist, or the ARN format of the resource is not valid.
  *       </p>
+ *          <p>The following is the format of an event data store ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
+ *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
+ *          <p>The following is the format of a channel ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
+ *          </p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>This exception is thrown when the specified resource is not found.</p>

package/dist-types/commands/GetTrailCommand.d.ts

@@ -75,6 +75,8 @@ declare const GetTrailCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>

package/dist-types/commands/GetTrailStatusCommand.d.ts

@@ -78,6 +78,8 @@ declare const GetTrailStatusCommand_base: {
  *          <p>The following is the format of an event data store ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
  *          </p>
+ *          <p>The following is the format of a dashboard ARN: <code>arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash</code>
+ *          </p>
  *          <p>The following is the format of a channel ARN:
  *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
  *          </p>