@aws-sdk/client-cloudtrail 3.78.0 → 3.79.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.79.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.78.0...v3.79.0) (2022-04-27)
+
+
+### Features
+
+* **client-cloudtrail:** Increases the retention period maximum to 2557 days. Deprecates unused fields of the ListEventDataStores API response. Updates documentation. ([13baee3](https://github.com/aws/aws-sdk-js-v3/commit/13baee38c049a4934b390f5a49c1feb8d55b652b))
+
+
+
+
+
 # [3.78.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.77.0...v3.78.0) (2022-04-26)
 
 

package/dist-types/CloudTrail.d.ts

@@ -49,10 +49,15 @@ import { UpdateTrailCommandInput, UpdateTrailCommandOutput } from "./commands/Up
  */
 export declare class CloudTrail extends CloudTrailClient {
     /**
-     * <p>Adds one or more tags to a trail, up to a limit of 50. Overwrites an existing tag's value when a new value is specified for an existing tag key.
-     *          Tag key names must be unique for a trail; you cannot have two keys with the same name but different values.
-     *           If you specify a key without a value, the tag will be created with the specified key and a value of null.
-     *           You can tag a trail that applies to all Amazon Web Services Regions only from the Region in which the trail was created (also known as its home region).</p>
+     * <p>Adds one or more tags to a trail or event data store, up to a limit of 50. Overwrites an
+     *          existing tag's value when a new value is specified for an existing tag key.
+     *          Tag key names must be unique for a trail; you cannot have two keys with the same name but
+     *          different values.
+     *           If you specify a key without a value, the tag will be created with the specified key and a
+     *           value of null.
+     *           You can tag a trail or event data store that applies to all Amazon Web Services Regions
+     *          only from the Region in which the trail or event data store was created (also known as its
+     *          home region).</p>
      */
     addTags(args: AddTagsCommandInput, options?: __HttpHandlerOptions): Promise<AddTagsCommandOutput>;
     addTags(args: AddTagsCommandInput, cb: (err: any, data?: AddTagsCommandOutput) => void): void;
@@ -198,7 +203,7 @@ export declare class CloudTrail extends CloudTrailClient {
     listQueries(args: ListQueriesCommandInput, cb: (err: any, data?: ListQueriesCommandOutput) => void): void;
     listQueries(args: ListQueriesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListQueriesCommandOutput) => void): void;
     /**
-     * <p>Lists the tags for the trail in the current region.</p>
+     * <p>Lists the tags for the trail or event data store in the current region.</p>
      */
     listTags(args: ListTagsCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsCommandOutput>;
     listTags(args: ListTagsCommandInput, cb: (err: any, data?: ListTagsCommandOutput) => void): void;
@@ -322,7 +327,7 @@ export declare class CloudTrail extends CloudTrailClient {
     putInsightSelectors(args: PutInsightSelectorsCommandInput, cb: (err: any, data?: PutInsightSelectorsCommandOutput) => void): void;
     putInsightSelectors(args: PutInsightSelectorsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutInsightSelectorsCommandOutput) => void): void;
     /**
-     * <p>Removes the specified tags from a trail.</p>
+     * <p>Removes the specified tags from a trail or event data store.</p>
      */
     removeTags(args: RemoveTagsCommandInput, options?: __HttpHandlerOptions): Promise<RemoveTagsCommandOutput>;
     removeTags(args: RemoveTagsCommandInput, cb: (err: any, data?: RemoveTagsCommandOutput) => void): void;

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

@@ -7,10 +7,15 @@ export interface AddTagsCommandInput extends AddTagsRequest {
 export interface AddTagsCommandOutput extends AddTagsResponse, __MetadataBearer {
 }
 /**
- * <p>Adds one or more tags to a trail, up to a limit of 50. Overwrites an existing tag's value when a new value is specified for an existing tag key.
- *          Tag key names must be unique for a trail; you cannot have two keys with the same name but different values.
- *           If you specify a key without a value, the tag will be created with the specified key and a value of null.
- *           You can tag a trail that applies to all Amazon Web Services Regions only from the Region in which the trail was created (also known as its home region).</p>
+ * <p>Adds one or more tags to a trail or event data store, up to a limit of 50. Overwrites an
+ *          existing tag's value when a new value is specified for an existing tag key.
+ *          Tag key names must be unique for a trail; you cannot have two keys with the same name but
+ *          different values.
+ *           If you specify a key without a value, the tag will be created with the specified key and a
+ *           value of null.
+ *           You can tag a trail or event data store that applies to all Amazon Web Services Regions
+ *          only from the Region in which the trail or event data store was created (also known as its
+ *          home region).</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,7 @@ export interface ListTagsCommandInput extends ListTagsRequest {
 export interface ListTagsCommandOutput extends ListTagsResponse, __MetadataBearer {
 }
 /**
- * <p>Lists the tags for the trail in the current region.</p>
+ * <p>Lists the tags for the trail or event data store in the current region.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,7 @@ export interface RemoveTagsCommandInput extends RemoveTagsRequest {
 export interface RemoveTagsCommandOutput extends RemoveTagsResponse, __MetadataBearer {
 }
 /**
- * <p>Removes the specified tags from a trail.</p>
+ * <p>Removes the specified tags from a trail or event data store.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -21,11 +21,11 @@ export declare namespace Tag {
     const filterSensitiveLog: (obj: Tag) => any;
 }
 /**
- * <p>Specifies the tags to add to a trail.</p>
+ * <p>Specifies the tags to add to a trail or event data store.</p>
  */
 export interface AddTagsRequest {
     /**
-     * <p>Specifies the ARN of the trail to which one or more tags will be added. The format of a trail ARN is:</p>
+     * <p>Specifies the ARN of the trail or event data store to which one or more tags will be added. The format of a trail ARN is:</p>
      *          <p>
      *             <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
      *          </p>
@@ -73,7 +73,7 @@ export declare class CloudTrailARNInvalidException extends __BaseException {
 }
 /**
  * <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 trail before CloudTrail has time to fully load the trail.
+ *          This can occur when you try to run an operation on a resource before CloudTrail has time to fully load the resource.
  *          If this exception occurs, wait a few minutes, and then try the operation again.</p>
  */
 export declare class ConflictException extends __BaseException {
@@ -104,7 +104,7 @@ export declare class EventDataStoreNotFoundException extends __BaseException {
     constructor(opts: __ExceptionOptionType<EventDataStoreNotFoundException, __BaseException>);
 }
 /**
- * <p>The event data store against which you ran your query is inactive.</p>
+ * <p>The event data store is inactive.</p>
  */
 export declare class InactiveEventDataStoreException extends __BaseException {
     readonly name: "InactiveEventDataStoreException";
@@ -168,9 +168,10 @@ export declare class InvalidTrailNameException extends __BaseException {
     constructor(opts: __ExceptionOptionType<InvalidTrailNameException, __BaseException>);
 }
 /**
- * <p>This exception is thrown when the Amazon Web Services account making the request to create or update an organization trail is not the management account for an
+ * <p>This exception is thrown when the Amazon Web Services account making the request to create
+ *          or update an organization trail or event data store is not the management account for an
  *          organization in Organizations. For more information, see
- *          <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html">Prepare For Creating a Trail For Your Organization</a>.</p>
+ *          <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html">Prepare For Creating a Trail For Your Organization</a> or <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html">Create an event data store</a>.</p>
  */
 export declare class NotOrganizationMasterAccountException extends __BaseException {
     readonly name: "NotOrganizationMasterAccountException";
@@ -834,9 +835,9 @@ export declare class EventDataStoreMaxLimitExceededException extends __BaseExcep
     constructor(opts: __ExceptionOptionType<EventDataStoreMaxLimitExceededException, __BaseException>);
 }
 /**
- * <p>This exception is thrown when the IAM user or role that is used to create the organization trail is lacking one or more required permissions for
- *          creating an organization trail in a required service. For more information, see
- *          <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html">Prepare For Creating a Trail For Your Organization</a>.</p>
+ * <p>This exception is thrown when the IAM user or role that is used to create
+ *          the organization resource lacks one or more required permissions for
+ *          creating an organization resource in a required service.</p>
  */
 export declare class InsufficientDependencyServiceAccessPermissionException extends __BaseException {
     readonly name: "InsufficientDependencyServiceAccessPermissionException";
@@ -851,9 +852,9 @@ export declare class InsufficientDependencyServiceAccessPermissionException exte
     constructor(opts: __ExceptionOptionType<InsufficientDependencyServiceAccessPermissionException, __BaseException>);
 }
 /**
- * <p>This exception is thrown when Organizations is not configured to support all features. All features must be enabled in Organizations to support
- *          creating an organization trail. For more information, see
- *          <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html">Prepare For Creating a Trail For Your Organization</a>.</p>
+ * <p>This exception is thrown when Organizations is not configured to support all
+ *          features. All features must be enabled in Organizations to support
+ *          creating an organization trail or event data store.</p>
  */
 export declare class OrganizationNotInAllFeaturesModeException extends __BaseException {
     readonly name: "OrganizationNotInAllFeaturesModeException";
@@ -2394,35 +2395,51 @@ export interface EventDataStore {
      */
     Name?: string;
     /**
-     * <p>Indicates whether the event data store is protected from termination.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. Indicates whether the event data store is protected from termination.</p>
      */
     TerminationProtectionEnabled?: boolean;
     /**
-     * <p>The status of an event data store. Values are <code>ENABLED</code> and <code>PENDING_DELETION</code>.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. The status of an event data store. Values are <code>ENABLED</code> and <code>PENDING_DELETION</code>.</p>
      */
     Status?: EventDataStoreStatus | string;
     /**
-     * <p>The advanced event selectors that were used to select events for the data store.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. The advanced event selectors that were used to select events for the data store.</p>
      */
     AdvancedEventSelectors?: AdvancedEventSelector[];
     /**
-     * <p>Indicates whether the event data store includes events from all regions, or only from the region in which it was created.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. Indicates whether the event data store includes events from all regions, or only from the region in which it was created.</p>
      */
     MultiRegionEnabled?: boolean;
     /**
-     * <p>Indicates that an event data store is collecting logged events for an organization.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. Indicates that an event data store is collecting logged events for an organization.</p>
      */
     OrganizationEnabled?: boolean;
     /**
-     * <p>The retention period, in days.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. The retention period, in days.</p>
      */
     RetentionPeriod?: number;
     /**
-     * <p>The timestamp of the event data store's creation.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. The timestamp of the event data store's creation.</p>
      */
     CreatedTimestamp?: Date;
     /**
-     * <p>The timestamp showing when an event data store was updated, if applicable. <code>UpdatedTimestamp</code> is always either the same or newer than the time shown in <code>CreatedTimestamp</code>.</p>
+     * @deprecated
+     *
+     * <p>This field is being deprecated. The timestamp showing when an event data store was updated, if applicable. <code>UpdatedTimestamp</code> is always either the same or newer than the time shown in <code>CreatedTimestamp</code>.</p>
      */
     UpdatedTimestamp?: Date;
 }
@@ -2553,7 +2570,8 @@ export declare namespace ListPublicKeysResponse {
     const filterSensitiveLog: (obj: ListPublicKeysResponse) => any;
 }
 /**
- * <p>A date range for the query was specified that is not valid. For more information
+ * <p>A date range for the query was specified that is not valid. Be sure that the start time is chronologically
+ *          before the end time. 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>
  */
@@ -2660,15 +2678,12 @@ export declare namespace ListQueriesResponse {
     const filterSensitiveLog: (obj: ListQueriesResponse) => any;
 }
 /**
- * <p>Specifies a list of trail tags to return.</p>
+ * <p>Specifies a list of tags to return.</p>
  */
 export interface ListTagsRequest {
     /**
-     * <p>Specifies a list of trail ARNs whose tags will be listed. The list has a limit of 20 ARNs. The following is the format of
-     *          a trail ARN.</p>
-     *             <p>
-     *             <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
-     *          </p>
+     * <p>Specifies a list of trail and event data store ARNs whose tags will be listed. The list
+     *          has a limit of 20 ARNs.</p>
      */
     ResourceIdList: string[] | undefined;
     /**
@@ -3131,13 +3146,15 @@ export declare namespace PutInsightSelectorsResponse {
     const filterSensitiveLog: (obj: PutInsightSelectorsResponse) => any;
 }
 /**
- * <p>Specifies the tags to remove from a trail.</p>
+ * <p>Specifies the tags to remove from a trail or event data store.</p>
  */
 export interface RemoveTagsRequest {
     /**
-     * <p>Specifies the ARN of the trail from which tags should be removed. The format of a trail ARN is:</p>
+     * <p>Specifies the ARN of the trail or event data store from which tags should be removed.</p>
      *          <p>
-     *             <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
+     *          Example trail ARN format: <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
+     *          </p>
+     *          <p>Example event data store ARN format: <code>arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
      *          </p>
      */
     ResourceId: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cloudtrail",
   "description": "AWS SDK for JavaScript Cloudtrail Client for Node.js, Browser and React Native",
-  "version": "3.78.0",
+  "version": "3.79.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,21 +18,21 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.78.0",
-    "@aws-sdk/config-resolver": "3.78.0",
-    "@aws-sdk/credential-provider-node": "3.78.0",
+    "@aws-sdk/client-sts": "3.79.0",
+    "@aws-sdk/config-resolver": "3.79.0",
+    "@aws-sdk/credential-provider-node": "3.79.0",
     "@aws-sdk/fetch-http-handler": "3.78.0",
     "@aws-sdk/hash-node": "3.78.0",
     "@aws-sdk/invalid-dependency": "3.78.0",
     "@aws-sdk/middleware-content-length": "3.78.0",
     "@aws-sdk/middleware-host-header": "3.78.0",
     "@aws-sdk/middleware-logger": "3.78.0",
-    "@aws-sdk/middleware-retry": "3.78.0",
+    "@aws-sdk/middleware-retry": "3.79.0",
     "@aws-sdk/middleware-serde": "3.78.0",
     "@aws-sdk/middleware-signing": "3.78.0",
     "@aws-sdk/middleware-stack": "3.78.0",
     "@aws-sdk/middleware-user-agent": "3.78.0",
-    "@aws-sdk/node-config-provider": "3.78.0",
+    "@aws-sdk/node-config-provider": "3.79.0",
     "@aws-sdk/node-http-handler": "3.78.0",
     "@aws-sdk/protocol-http": "3.78.0",
     "@aws-sdk/smithy-client": "3.78.0",
@@ -43,9 +43,9 @@
     "@aws-sdk/util-body-length-browser": "3.55.0",
     "@aws-sdk/util-body-length-node": "3.55.0",
     "@aws-sdk/util-defaults-mode-browser": "3.78.0",
-    "@aws-sdk/util-defaults-mode-node": "3.78.0",
+    "@aws-sdk/util-defaults-mode-node": "3.79.0",
     "@aws-sdk/util-user-agent-browser": "3.78.0",
-    "@aws-sdk/util-user-agent-node": "3.78.0",
+    "@aws-sdk/util-user-agent-node": "3.79.0",
     "@aws-sdk/util-utf8-browser": "3.55.0",
     "@aws-sdk/util-utf8-node": "3.55.0",
     "tslib": "^2.3.1"