@aws-sdk/client-cloudtrail 3.171.0 → 3.178.0

package/dist-types/models/models_0.d.ts

@@ -1,5 +1,23 @@
 import { ExceptionOptionType as __ExceptionOptionType } from "@aws-sdk/smithy-client";
 import { CloudTrailServiceException as __BaseException } from "./CloudTrailServiceException";
+/**
+ * <p>
+ *          This exception is thrown when you start a new import and a
+ *          previous import is still in progress.
+ *       </p>
+ */
+export declare class AccountHasOngoingImportException extends __BaseException {
+    readonly name: "AccountHasOngoingImportException";
+    readonly $fault: "client";
+    /**
+     * <p>Brief description of the exception returned by the request.</p>
+     */
+    Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<AccountHasOngoingImportException, __BaseException>);
+}
 /**
  * <p>A custom key-value pair associated with a resource such as a CloudTrail trail.</p>
  */
@@ -1356,6 +1374,23 @@ export interface DeleteEventDataStoreRequest {
 }
 export interface DeleteEventDataStoreResponse {
 }
+/**
+ * <p>
+ *          This exception is thrown when you try to update or delete an event data store that currently has an import in progress.
+ *       </p>
+ */
+export declare class EventDataStoreHasOngoingImportException extends __BaseException {
+    readonly name: "EventDataStoreHasOngoingImportException";
+    readonly $fault: "client";
+    /**
+     * <p>Brief description of the exception returned by the request.</p>
+     */
+    Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<EventDataStoreHasOngoingImportException, __BaseException>);
+}
 /**
  * <p>The event data store cannot be deleted because termination protection is enabled for it.</p>
  */
@@ -1894,7 +1929,7 @@ export interface DataResource {
      *          <ul>
      *             <li>
      *                <p>To log data events for all objects in all S3 buckets in your Amazon Web Services account, specify the
-     *          prefix as <code>arn:aws:s3:::</code>.</p>
+     *          prefix as <code>arn:aws:s3</code>.</p>
      *                <note>
      *                   <p>This also enables logging of data event activity performed by any user or role in your Amazon Web Services account,
      *          even if that activity is performed on a bucket that belongs to another Amazon Web Services account.</p>
@@ -1961,7 +1996,7 @@ export interface EventSelector {
     /**
      * <p>Specify if you want your event selector to include management events for your trail.</p>
      *          <p>
-     *          For more information, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-management-events">Management Events</a> in the <i>CloudTrail User Guide</i>.</p>
+     *          For more information, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html">Management Events</a> in the <i>CloudTrail User Guide</i>.</p>
      *
      *          <p>By default, the value is <code>true</code>.</p>
      *          <p>The first copy of management events is free. You are charged for additional copies of management
@@ -1976,7 +2011,7 @@ export interface EventSelector {
      *          selector, but the total number of data resources cannot exceed 250 across all event
      *          selectors in a trail. This limit does not apply if you configure resource logging for all
      *          data events.</p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events">Data Events</a> and <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html">Limits in CloudTrail</a>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html">Data Events</a> and <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html">Limits in CloudTrail</a>
      *          in the <i>CloudTrail User Guide</i>.</p>
      */
     DataResources?: DataResource[];
@@ -2004,6 +2039,169 @@ export interface GetEventSelectorsResponse {
      */
     AdvancedEventSelectors?: AdvancedEventSelector[];
 }
+export interface GetImportRequest {
+    /**
+     * <p>
+     *          The ID for the import.
+     *       </p>
+     */
+    ImportId: string | undefined;
+}
+/**
+ * <p>
+ *          The settings for the source S3 bucket.
+ *       </p>
+ */
+export interface S3ImportSource {
+    /**
+     * <p>
+     *          The URI for the source S3 bucket.
+     *       </p>
+     */
+    S3LocationUri: string | undefined;
+    /**
+     * <p>
+     *          The region associated with the source S3 bucket.
+     *       </p>
+     */
+    S3BucketRegion: string | undefined;
+    /**
+     * <p>
+     *          The IAM ARN role used to access the source S3 bucket.
+     *       </p>
+     */
+    S3BucketAccessRoleArn: string | undefined;
+}
+/**
+ * <p>
+ *          The import source.
+ *       </p>
+ */
+export interface ImportSource {
+    /**
+     * <p>
+     *          The source S3 bucket.
+     *       </p>
+     */
+    S3: S3ImportSource | undefined;
+}
+/**
+ * <p>
+ *         Provides statistics for the specified <code>ImportID</code>.
+ *       </p>
+ */
+export interface ImportStatistics {
+    /**
+     * <p>
+     *          The number of S3 prefixes found for the import.
+     *       </p>
+     */
+    PrefixesFound?: number;
+    /**
+     * <p>
+     *          The number of S3 prefixes that completed import.
+     *       </p>
+     */
+    PrefixesCompleted?: number;
+    /**
+     * <p>The number of files that completed import.</p>
+     */
+    FilesCompleted?: number;
+    /**
+     * <p>
+     *          The number of trail events imported.
+     *       </p>
+     */
+    EventsCompleted?: number;
+    /**
+     * <p>
+     *         The number of failed entries.
+     *       </p>
+     */
+    FailedEntries?: number;
+}
+export declare enum ImportStatus {
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    INITIALIZING = "INITIALIZING",
+    IN_PROGRESS = "IN_PROGRESS",
+    STOPPED = "STOPPED"
+}
+export interface GetImportResponse {
+    /**
+     * <p>
+     *          The ID of the import.
+     *       </p>
+     */
+    ImportId?: string;
+    /**
+     * <p>
+     *          The destination event data store.
+     *       </p>
+     */
+    Destinations?: string[];
+    /**
+     * <p>
+     *          The source S3 bucket.
+     *       </p>
+     */
+    ImportSource?: ImportSource;
+    /**
+     * <p>
+     *          Used with <code>EndEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    StartEventTime?: Date;
+    /**
+     * <p>
+     *          Used with <code>StartEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    EndEventTime?: Date;
+    /**
+     * <p>
+     *          The status of the import.
+     *       </p>
+     */
+    ImportStatus?: ImportStatus | string;
+    /**
+     * <p>
+     *          The timestamp of the import's creation.
+     *       </p>
+     */
+    CreatedTimestamp?: Date;
+    /**
+     * <p>
+     *          The timestamp of when the import was updated.
+     *       </p>
+     */
+    UpdatedTimestamp?: Date;
+    /**
+     * <p>
+     *          Provides statistics for the import.
+     *       </p>
+     */
+    ImportStatistics?: ImportStatistics;
+}
+/**
+ * <p>
+ *          The specified import was not found.
+ *       </p>
+ */
+export declare class ImportNotFoundException extends __BaseException {
+    readonly name: "ImportNotFoundException";
+    readonly $fault: "client";
+    /**
+     * <p>Brief description of the exception returned by the request.</p>
+     */
+    Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ImportNotFoundException, __BaseException>);
+}
 export interface GetInsightSelectorsRequest {
     /**
      * <p>Specifies the name of the trail or trail ARN. If you specify a trail name, the
@@ -2389,6 +2587,159 @@ export interface ListEventDataStoresResponse {
      */
     NextToken?: string;
 }
+export interface ListImportFailuresRequest {
+    /**
+     * <p>
+     *          The ID of the import.
+     *       </p>
+     */
+    ImportId: string | undefined;
+    /**
+     * <p>
+     *          The maximum number of failures to display on a single page.
+     *       </p>
+     */
+    MaxResults?: number;
+    /**
+     * <p>
+     *          A token you can use to get the next page of import failures.
+     *       </p>
+     */
+    NextToken?: string;
+}
+export declare enum ImportFailureStatus {
+    FAILED = "FAILED",
+    RETRY = "RETRY",
+    SUCCEEDED = "SUCCEEDED"
+}
+/**
+ * <p>
+ *          Provides information about an import failure.
+ *       </p>
+ */
+export interface ImportFailureListItem {
+    /**
+     * <p>
+     *          The location of the failure in the S3 bucket.
+     *       </p>
+     */
+    Location?: string;
+    /**
+     * <p>
+     *          The status of the import.
+     *       </p>
+     */
+    Status?: ImportFailureStatus | string;
+    /**
+     * <p>
+     *          The type of import error.
+     *       </p>
+     */
+    ErrorType?: string;
+    /**
+     * <p>
+     *          Provides the reason the import failed.
+     *       </p>
+     */
+    ErrorMessage?: string;
+    /**
+     * <p>
+     *          When the import was last updated.
+     *       </p>
+     */
+    LastUpdatedTime?: Date;
+}
+export interface ListImportFailuresResponse {
+    /**
+     * <p>
+     *         Contains information about the import failures.
+     *       </p>
+     */
+    Failures?: ImportFailureListItem[];
+    /**
+     * <p>
+     *          A token you can use to get the next page of results.
+     *       </p>
+     */
+    NextToken?: string;
+}
+export interface ListImportsRequest {
+    /**
+     * <p>
+     *          The maximum number of imports to display on a single page.
+     *       </p>
+     */
+    MaxResults?: number;
+    /**
+     * <p>
+     *          The destination event data store.
+     *       </p>
+     */
+    Destination?: string;
+    /**
+     * <p>
+     *          The status of the import.
+     *       </p>
+     */
+    ImportStatus?: ImportStatus | string;
+    /**
+     * <p>
+     *          A token you can use to get the next page of import results.
+     *       </p>
+     */
+    NextToken?: string;
+}
+/**
+ * <p>
+ *          Contains information about an import that was returned by a lookup request.
+ *       </p>
+ */
+export interface ImportsListItem {
+    /**
+     * <p>
+     *          The ID of the import.
+     *       </p>
+     */
+    ImportId?: string;
+    /**
+     * <p>
+     *          The status of the import.
+     *       </p>
+     */
+    ImportStatus?: ImportStatus | string;
+    /**
+     * <p>
+     *          The destination event data store.
+     *       </p>
+     */
+    Destinations?: string[];
+    /**
+     * <p>
+     *          The timestamp of the import's creation.
+     *       </p>
+     */
+    CreatedTimestamp?: Date;
+    /**
+     * <p>
+     *          The timestamp of the import's last update.
+     *       </p>
+     */
+    UpdatedTimestamp?: Date;
+}
+export interface ListImportsResponse {
+    /**
+     * <p>
+     *          The list of returned imports.
+     *       </p>
+     */
+    Imports?: ImportsListItem[];
+    /**
+     * <p>
+     *          A token you can use to get the next page of import results.
+     *       </p>
+     */
+    NextToken?: string;
+}
 /**
  * <p>Occurs if the timestamp values are not valid. Either the start time occurs after the end time, or the time range is outside the range of possible values.</p>
  */
@@ -3031,6 +3382,127 @@ export interface RestoreEventDataStoreResponse {
      */
     UpdatedTimestamp?: Date;
 }
+/**
+ * <p>
+ *          This exception is thrown when the event data store category is not valid for the import.
+ *       </p>
+ */
+export declare class InvalidEventDataStoreCategoryException extends __BaseException {
+    readonly name: "InvalidEventDataStoreCategoryException";
+    readonly $fault: "client";
+    /**
+     * <p>Brief description of the exception returned by the request.</p>
+     */
+    Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<InvalidEventDataStoreCategoryException, __BaseException>);
+}
+/**
+ * <p>
+ *          This exception is thrown when the provided source S3 bucket is not valid for import.
+ *       </p>
+ */
+export declare class InvalidImportSourceException extends __BaseException {
+    readonly name: "InvalidImportSourceException";
+    readonly $fault: "client";
+    /**
+     * <p>Brief description of the exception returned by the request.</p>
+     */
+    Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<InvalidImportSourceException, __BaseException>);
+}
+export interface StartImportRequest {
+    /**
+     * <p>
+     *          The destination event data store. Use this parameter for a new import.
+     *       </p>
+     */
+    Destinations?: string[];
+    /**
+     * <p>
+     *          The source S3 bucket for the import. Use this parameter for a new import.
+     *       </p>
+     */
+    ImportSource?: ImportSource;
+    /**
+     * <p>
+     *          Use with <code>EndEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    StartEventTime?: Date;
+    /**
+     * <p>
+     *          Use with <code>StartEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    EndEventTime?: Date;
+    /**
+     * <p>
+     *          The ID of the import. Use this parameter when you are retrying an import.
+     *       </p>
+     */
+    ImportId?: string;
+}
+export interface StartImportResponse {
+    /**
+     * <p>
+     *          The ID of the import.
+     *       </p>
+     */
+    ImportId?: string;
+    /**
+     * <p>
+     *          The destination event data store.
+     *       </p>
+     */
+    Destinations?: string[];
+    /**
+     * <p>
+     *          The source S3 bucket.
+     *       </p>
+     */
+    ImportSource?: ImportSource;
+    /**
+     * <p>
+     *          Used with <code>EndEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    StartEventTime?: Date;
+    /**
+     * <p>
+     *          Used with <code>StartEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    EndEventTime?: Date;
+    /**
+     * <p>
+     *          Shows the status of the import after a <code>StartImport</code> request. An import finishes with a status of <code>COMPLETED</code> if there were no failures, or <code>FAILED</code>
+     *          if there were failures.
+     *       </p>
+     */
+    ImportStatus?: ImportStatus | string;
+    /**
+     * <p>
+     *          The timestamp for the import's creation.
+     *       </p>
+     */
+    CreatedTimestamp?: Date;
+    /**
+     * <p>
+     *          The timestamp of the import's last update, if applicable.
+     *       </p>
+     */
+    UpdatedTimestamp?: Date;
+}
 /**
  * <p>The request to CloudTrail to start logging Amazon Web Services API calls for an account.</p>
  */
@@ -3094,6 +3566,72 @@ export interface StartQueryResponse {
      */
     QueryId?: string;
 }
+export interface StopImportRequest {
+    /**
+     * <p>
+     *         The ID of the import.
+     *       </p>
+     */
+    ImportId: string | undefined;
+}
+export interface StopImportResponse {
+    /**
+     * <p>
+     *          The ID for the import.
+     *       </p>
+     */
+    ImportId?: string;
+    /**
+     * <p>
+     *          The source S3 bucket.
+     *       </p>
+     */
+    ImportSource?: ImportSource;
+    /**
+     * <p>
+     *          The destination event data store.
+     *       </p>
+     */
+    Destinations?: string[];
+    /**
+     * <p>
+     *          The status of the import.
+     *       </p>
+     */
+    ImportStatus?: ImportStatus | string;
+    /**
+     * <p>
+     *          The timestamp of the import's creation.
+     *       </p>
+     */
+    CreatedTimestamp?: Date;
+    /**
+     * <p>
+     *          The timestamp of the import's last update.
+     *       </p>
+     */
+    UpdatedTimestamp?: Date;
+    /**
+     * <p>
+     *          Used with <code>EndEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    StartEventTime?: Date;
+    /**
+     * <p>
+     *          Used with <code>StartEventTime</code> to bound a <code>StartImport</code> request, and limit imported trail events
+     *          to only those events logged within a specified time period.
+     *       </p>
+     */
+    EndEventTime?: Date;
+    /**
+     * <p>
+     *         Returns information on the stopped import.
+     *       </p>
+     */
+    ImportStatistics?: ImportStatistics;
+}
 /**
  * <p>Passes the request to CloudTrail to stop logging Amazon Web Services API calls for the specified account.</p>
  */
@@ -3122,7 +3660,7 @@ export interface UpdateEventDataStoreRequest {
      */
     Name?: string;
     /**
-     * <p>The advanced event selectors used to select events for the event data store.</p>
+     * <p>The advanced event selectors used to select events for the event data store. You can configure up to five advanced event selectors for each event data store.</p>
      */
     AdvancedEventSelectors?: AdvancedEventSelector[];
     /**
@@ -3490,6 +4028,26 @@ export declare const EventSelectorFilterSensitiveLog: (obj: EventSelector) => an
  * @internal
  */
 export declare const GetEventSelectorsResponseFilterSensitiveLog: (obj: GetEventSelectorsResponse) => any;
+/**
+ * @internal
+ */
+export declare const GetImportRequestFilterSensitiveLog: (obj: GetImportRequest) => any;
+/**
+ * @internal
+ */
+export declare const S3ImportSourceFilterSensitiveLog: (obj: S3ImportSource) => any;
+/**
+ * @internal
+ */
+export declare const ImportSourceFilterSensitiveLog: (obj: ImportSource) => any;
+/**
+ * @internal
+ */
+export declare const ImportStatisticsFilterSensitiveLog: (obj: ImportStatistics) => any;
+/**
+ * @internal
+ */
+export declare const GetImportResponseFilterSensitiveLog: (obj: GetImportResponse) => any;
 /**
  * @internal
  */
@@ -3550,6 +4108,30 @@ export declare const EventDataStoreFilterSensitiveLog: (obj: EventDataStore) =>
  * @internal
  */
 export declare const ListEventDataStoresResponseFilterSensitiveLog: (obj: ListEventDataStoresResponse) => any;
+/**
+ * @internal
+ */
+export declare const ListImportFailuresRequestFilterSensitiveLog: (obj: ListImportFailuresRequest) => any;
+/**
+ * @internal
+ */
+export declare const ImportFailureListItemFilterSensitiveLog: (obj: ImportFailureListItem) => any;
+/**
+ * @internal
+ */
+export declare const ListImportFailuresResponseFilterSensitiveLog: (obj: ListImportFailuresResponse) => any;
+/**
+ * @internal
+ */
+export declare const ListImportsRequestFilterSensitiveLog: (obj: ListImportsRequest) => any;
+/**
+ * @internal
+ */
+export declare const ImportsListItemFilterSensitiveLog: (obj: ImportsListItem) => any;
+/**
+ * @internal
+ */
+export declare const ListImportsResponseFilterSensitiveLog: (obj: ListImportsResponse) => any;
 /**
  * @internal
  */
@@ -3650,6 +4232,14 @@ export declare const RestoreEventDataStoreRequestFilterSensitiveLog: (obj: Resto
  * @internal
  */
 export declare const RestoreEventDataStoreResponseFilterSensitiveLog: (obj: RestoreEventDataStoreResponse) => any;
+/**
+ * @internal
+ */
+export declare const StartImportRequestFilterSensitiveLog: (obj: StartImportRequest) => any;
+/**
+ * @internal
+ */
+export declare const StartImportResponseFilterSensitiveLog: (obj: StartImportResponse) => any;
 /**
  * @internal
  */
@@ -3666,6 +4256,14 @@ export declare const StartQueryRequestFilterSensitiveLog: (obj: StartQueryReques
  * @internal
  */
 export declare const StartQueryResponseFilterSensitiveLog: (obj: StartQueryResponse) => any;
+/**
+ * @internal
+ */
+export declare const StopImportRequestFilterSensitiveLog: (obj: StopImportRequest) => any;
+/**
+ * @internal
+ */
+export declare const StopImportResponseFilterSensitiveLog: (obj: StopImportResponse) => any;
 /**
  * @internal
  */

package/dist-types/pagination/ListImportFailuresPaginator.d.ts

@@ -0,0 +1,4 @@
+import { Paginator } from "@aws-sdk/types";
+import { ListImportFailuresCommandInput, ListImportFailuresCommandOutput } from "../commands/ListImportFailuresCommand";
+import { CloudTrailPaginationConfiguration } from "./Interfaces";
+export declare function paginateListImportFailures(config: CloudTrailPaginationConfiguration, input: ListImportFailuresCommandInput, ...additionalArguments: any): Paginator<ListImportFailuresCommandOutput>;

package/dist-types/pagination/ListImportsPaginator.d.ts

@@ -0,0 +1,4 @@
+import { Paginator } from "@aws-sdk/types";
+import { ListImportsCommandInput, ListImportsCommandOutput } from "../commands/ListImportsCommand";
+import { CloudTrailPaginationConfiguration } from "./Interfaces";
+export declare function paginateListImports(config: CloudTrailPaginationConfiguration, input: ListImportsCommandInput, ...additionalArguments: any): Paginator<ListImportsCommandOutput>;