@aws-sdk/client-cloudtrail 3.654.0 → 3.658.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist-types/commands/GetEventSelectorsCommand.d.ts +11 -2
  2. package/dist-types/commands/PutEventSelectorsCommand.d.ts +35 -15
  3. package/dist-types/commands/StartEventDataStoreIngestionCommand.d.ts +1 -1
  4. package/dist-types/commands/StopEventDataStoreIngestionCommand.d.ts +1 -1
  5. package/dist-types/commands/UpdateEventDataStoreCommand.d.ts +1 -1
  6. package/dist-types/models/models_0.d.ts +220 -658
  7. package/package.json +12 -12
package/dist-types/commands/GetEventSelectorsCommand.d.ts CHANGED
@@ -32,17 +32,21 @@ declare const GetEventSelectorsCommand_base: {
32
32
  * <ul>
33
33
  * <li>
34
34
  * <p>If your event selector includes read-only events, write-only events, or all
35
- * events. This applies to both management events and data events.</p>
35
+ * events. This applies to management events, data events, and network activity events.</p>
36
36
  * </li>
37
37
  * <li>
38
38
  * <p>If your event selector includes management events.</p>
39
39
  * </li>
40
40
  * <li>
41
+ * <p>If your event selector includes network activity events, the event sources
42
+ * for which you are logging network activity events.</p>
43
+ * </li>
44
+ * <li>
41
45
  * <p>If your event selector includes data events, the resources on which you are
42
46
  * logging data events.</p>
43
47
  * </li>
44
48
  * </ul>
45
- * <p>For more information about logging management and data events, see the following topics
49
+ * <p>For more information about logging management, data, and network activity events, see the following topics
46
50
  * in the <i>CloudTrail User Guide</i>:</p>
47
51
  * <ul>
48
52
  * <li>
@@ -55,6 +59,11 @@ declare const GetEventSelectorsCommand_base: {
55
59
  * <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html">Logging data events</a>
56
60
  * </p>
57
61
  * </li>
62
+ * <li>
63
+ * <p>
64
+ * <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html">Logging network activity events</a>
65
+ * </p>
66
+ * </li>
58
67
  * </ul>
59
68
  * @example
60
69
  * Use a bare-bones client and the command you need to make an API call.
package/dist-types/commands/PutEventSelectorsCommand.d.ts CHANGED
@@ -27,12 +27,35 @@ declare const PutEventSelectorsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Configures an event selector or advanced event selectors for your trail. Use event
31
- * selectors or advanced event selectors to specify management and data event settings for
32
- * your trail. If you want your trail to log Insights events, be sure the event selector
33
- * enables logging of the Insights event types you want configured for your trail. For more information about logging Insights events, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html">Logging Insights events</a> in the <i>CloudTrail User Guide</i>.
30
+ * <p>Configures event selectors (also referred to as <i>basic event selectors</i>) or advanced event selectors for your trail. You can use
31
+ * either <code>AdvancedEventSelectors</code> or <code>EventSelectors</code>, but not both. If
32
+ * you apply <code>AdvancedEventSelectors</code> to a trail, any existing
33
+ * <code>EventSelectors</code> are overwritten.</p>
34
+ * <p>You can use <code>AdvancedEventSelectors</code> to
35
+ * log management events, data events for all resource types, and network activity events.</p>
36
+ * <p>You can use <code>EventSelectors</code> to log management events and data events for the following resource types:</p>
37
+ * <ul>
38
+ * <li>
39
+ * <p>
40
+ * <code>AWS::DynamoDB::Table</code>
41
+ * </p>
42
+ * </li>
43
+ * <li>
44
+ * <p>
45
+ * <code>AWS::Lambda::Function</code>
46
+ * </p>
47
+ * </li>
48
+ * <li>
49
+ * <p>
50
+ * <code>AWS::S3::Object</code>
51
+ * </p>
52
+ * </li>
53
+ * </ul>
54
+ * <p>You can't use <code>EventSelectors</code> to log network activity events.</p>
55
+ * <p>If you want your trail to log Insights events, be sure the event selector or advanced event selector enables
56
+ * logging of the Insights event types you want configured for your trail. For more information about logging Insights events, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html">Logging Insights events</a> in the <i>CloudTrail User Guide</i>.
34
57
  * By default, trails created without specific event selectors are configured to
35
- * log all read and write management events, and no data events.</p>
58
+ * log all read and write management events, and no data events or network activity events.</p>
36
59
  * <p>When an event occurs in your account, CloudTrail evaluates the event selectors or
37
60
  * advanced event selectors in all trails. For each trail, if the event matches any event
38
61
  * selector, the trail processes and logs the event. If the event doesn't match any event
@@ -40,7 +63,7 @@ declare const PutEventSelectorsCommand_base: {
40
63
  * <p>Example</p>
41
64
  * <ol>
42
65
  * <li>
43
- * <p>You create an event selector for a trail and specify that you want write-only
66
+ * <p>You create an event selector for a trail and specify that you want to log write-only
44
67
  * events.</p>
45
68
  * </li>
46
69
  * <li>
@@ -62,16 +85,13 @@ declare const PutEventSelectorsCommand_base: {
62
85
  * <p>The <code>PutEventSelectors</code> operation must be called from the Region in which the
63
86
  * trail was created; otherwise, an <code>InvalidHomeRegionException</code> exception is
64
87
  * thrown.</p>
65
- * <p>You can configure up to five event selectors for each trail. For more information, see
66
- * <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html">Logging management events</a>, <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html">Logging
67
- * data events</a>, and <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html">Quotas in CloudTrail</a> in the <i>CloudTrail User
68
- * Guide</i>.</p>
88
+ * <p>You can configure up to five event selectors for each trail.</p>
69
89
  * <p>You can add advanced event selectors, and conditions for your advanced event selectors,
70
- * up to a maximum of 500 values for all conditions and selectors on a trail. You can use
71
- * either <code>AdvancedEventSelectors</code> or <code>EventSelectors</code>, but not both. If
72
- * you apply <code>AdvancedEventSelectors</code> to a trail, any existing
73
- * <code>EventSelectors</code> are overwritten. For more information about advanced event
74
- * selectors, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html">Logging data events</a> in the <i>CloudTrail User Guide</i>.</p>
90
+ * up to a maximum of 500 values for all conditions and selectors on a trail. For more information, see
91
+ * <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html">Logging management events</a>, <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html">Logging
92
+ * data events</a>, <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html">Logging
93
+ * network activity events</a>, and <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html">Quotas in CloudTrail</a> in the <i>CloudTrail User
94
+ * Guide</i>.</p>
75
95
  * @example
76
96
  * Use a bare-bones client and the command you need to make an API call.
77
97
  * ```javascript
package/dist-types/commands/StartEventDataStoreIngestionCommand.d.ts CHANGED
@@ -28,7 +28,7 @@ declare const StartEventDataStoreIngestionCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>Starts the ingestion of live events on an event data store specified as either an ARN or the ID portion of the ARN. To start ingestion, the event data store <code>Status</code> must be <code>STOPPED_INGESTION</code>
31
- * and the <code>eventCategory</code> must be <code>Management</code>, <code>Data</code>, or <code>ConfigurationItem</code>.</p>
31
+ * and the <code>eventCategory</code> must be <code>Management</code>, <code>Data</code>, <code>NetworkActivity</code>, or <code>ConfigurationItem</code>.</p>
32
32
  * @example
33
33
  * Use a bare-bones client and the command you need to make an API call.
34
34
  * ```javascript
package/dist-types/commands/StopEventDataStoreIngestionCommand.d.ts CHANGED
@@ -28,7 +28,7 @@ declare const StopEventDataStoreIngestionCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>Stops the ingestion of live events on an event data store specified as either an ARN or the ID portion of the ARN. To stop ingestion, the event data store <code>Status</code> must be <code>ENABLED</code>
31
- * and the <code>eventCategory</code> must be <code>Management</code>, <code>Data</code>, or <code>ConfigurationItem</code>.</p>
31
+ * and the <code>eventCategory</code> must be <code>Management</code>, <code>Data</code>, <code>NetworkActivity</code>, or <code>ConfigurationItem</code>.</p>
32
32
  * @example
33
33
  * Use a bare-bones client and the command you need to make an API call.
34
34
  * ```javascript
package/dist-types/commands/UpdateEventDataStoreCommand.d.ts CHANGED
@@ -33,7 +33,7 @@ declare const UpdateEventDataStoreCommand_base: {
33
33
  * <code>RetentionPeriod</code> is in days, and valid values are integers between 7 and
34
34
  * 3653 if the <code>BillingMode</code> is set to <code>EXTENDABLE_RETENTION_PRICING</code>, or between 7 and 2557 if <code>BillingMode</code> is set to <code>FIXED_RETENTION_PRICING</code>. By default, <code>TerminationProtection</code> is enabled.</p>
35
35
  * <p>For event data stores for CloudTrail events, <code>AdvancedEventSelectors</code>
36
- * includes or excludes management or data events in your event data store. For more
36
+ * includes or excludes management, data, or network activity events in your event data store. For more
37
37
  * information about <code>AdvancedEventSelectors</code>, see <a href="https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html">AdvancedEventSelectors</a>.</p>
38
38
  * <p> For event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or non-Amazon Web Services events,
39
39
  * <code>AdvancedEventSelectors</code> includes events of that type in your event data store.</p>