@aws-sdk/client-cloudtrail 3.288.0 → 3.290.0

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 (45) hide show
  1. package/dist-types/commands/AddTagsCommand.d.ts +82 -0
  2. package/dist-types/commands/CancelQueryCommand.d.ts +37 -0
  3. package/dist-types/commands/CreateChannelCommand.d.ts +45 -0
  4. package/dist-types/commands/CreateEventDataStoreCommand.d.ts +99 -0
  5. package/dist-types/commands/CreateTrailCommand.d.ts +137 -0
  6. package/dist-types/commands/DeleteChannelCommand.d.ts +14 -0
  7. package/dist-types/commands/DeleteEventDataStoreCommand.d.ts +46 -0
  8. package/dist-types/commands/DeleteResourcePolicyCommand.d.ts +24 -0
  9. package/dist-types/commands/DeleteTrailCommand.d.ts +71 -0
  10. package/dist-types/commands/DeregisterOrganizationDelegatedAdminCommand.d.ts +45 -0
  11. package/dist-types/commands/DescribeQueryCommand.d.ts +27 -0
  12. package/dist-types/commands/DescribeTrailsCommand.d.ts +34 -0
  13. package/dist-types/commands/GetChannelCommand.d.ts +14 -0
  14. package/dist-types/commands/GetEventDataStoreCommand.d.ts +21 -0
  15. package/dist-types/commands/GetEventSelectorsCommand.d.ts +51 -0
  16. package/dist-types/commands/GetImportCommand.d.ts +13 -0
  17. package/dist-types/commands/GetInsightSelectorsCommand.d.ts +56 -0
  18. package/dist-types/commands/GetQueryResultsCommand.d.ts +38 -0
  19. package/dist-types/commands/GetResourcePolicyCommand.d.ts +24 -0
  20. package/dist-types/commands/GetTrailCommand.d.ts +47 -0
  21. package/dist-types/commands/GetTrailStatusCommand.d.ts +47 -0
  22. package/dist-types/commands/ListChannelsCommand.d.ts +11 -0
  23. package/dist-types/commands/ListEventDataStoresCommand.d.ts +18 -0
  24. package/dist-types/commands/ListImportFailuresCommand.d.ts +11 -0
  25. package/dist-types/commands/ListImportsCommand.d.ts +18 -0
  26. package/dist-types/commands/ListPublicKeysCommand.d.ts +14 -0
  27. package/dist-types/commands/ListQueriesCommand.d.ts +39 -0
  28. package/dist-types/commands/ListTagsCommand.d.ts +63 -0
  29. package/dist-types/commands/ListTrailsCommand.d.ts +7 -0
  30. package/dist-types/commands/LookupEventsCommand.d.ts +25 -0
  31. package/dist-types/commands/PutEventSelectorsCommand.d.ts +95 -0
  32. package/dist-types/commands/PutInsightSelectorsCommand.d.ts +80 -0
  33. package/dist-types/commands/PutResourcePolicyCommand.d.ts +42 -0
  34. package/dist-types/commands/RegisterOrganizationDelegatedAdminCommand.d.ts +54 -0
  35. package/dist-types/commands/RemoveTagsCommand.d.ts +72 -0
  36. package/dist-types/commands/RestoreEventDataStoreCommand.d.ts +50 -0
  37. package/dist-types/commands/StartImportCommand.d.ts +42 -0
  38. package/dist-types/commands/StartLoggingCommand.d.ts +71 -0
  39. package/dist-types/commands/StartQueryCommand.d.ts +49 -0
  40. package/dist-types/commands/StopImportCommand.d.ts +13 -0
  41. package/dist-types/commands/StopLoggingCommand.d.ts +71 -0
  42. package/dist-types/commands/UpdateChannelCommand.d.ts +36 -0
  43. package/dist-types/commands/UpdateEventDataStoreCommand.d.ts +97 -0
  44. package/dist-types/commands/UpdateTrailCommand.d.ts +177 -0
  45. package/package.json +29 -29
@@ -32,6 +32,77 @@ export interface StartLoggingCommandOutput extends StartLoggingResponse, __Metad
32
32
  * @see {@link StartLoggingCommandOutput} for command's `response` shape.
33
33
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
34
34
  *
35
+ * @throws {@link CloudTrailARNInvalidException} (client fault)
36
+ * <p>This exception is thrown when an operation is called with a trail ARN that is not valid.
37
+ * The following is the format of a trail ARN.</p>
38
+ * <p>
39
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
40
+ * </p>
41
+ * <p>This exception is also thrown when you call <code>AddTags</code> or <code>RemoveTags</code> on a trail, event data store, or channel with a resource ARN that is not valid.</p>
42
+ * <p>The following is the format of an event data store ARN:
43
+ * <code>arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
44
+ * </p>
45
+ * <p>The following is the format of a channel ARN:
46
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
47
+ * </p>
48
+ *
49
+ * @throws {@link ConflictException} (client fault)
50
+ * <p>This exception is thrown when the specified resource is not ready for an operation. This
51
+ * can occur when you try to run an operation on a resource before CloudTrail has time
52
+ * 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
53
+ * operation again.</p>
54
+ *
55
+ * @throws {@link InsufficientDependencyServiceAccessPermissionException} (client fault)
56
+ * <p>This exception is thrown when the IAM user or role that is used to create
57
+ * the organization resource lacks one or more required permissions for creating an
58
+ * organization resource in a required service.</p>
59
+ *
60
+ * @throws {@link InvalidHomeRegionException} (client fault)
61
+ * <p>This exception is thrown when an operation is called on a trail from a region other than
62
+ * the region in which the trail was created.</p>
63
+ *
64
+ * @throws {@link InvalidTrailNameException} (client fault)
65
+ * <p>This exception is thrown when the provided trail name is not valid. Trail names must
66
+ * meet the following requirements:</p>
67
+ * <ul>
68
+ * <li>
69
+ * <p>Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores
70
+ * (_), or dashes (-)</p>
71
+ * </li>
72
+ * <li>
73
+ * <p>Start with a letter or number, and end with a letter or number</p>
74
+ * </li>
75
+ * <li>
76
+ * <p>Be between 3 and 128 characters</p>
77
+ * </li>
78
+ * <li>
79
+ * <p>Have no adjacent periods, underscores or dashes. Names like
80
+ * <code>my-_namespace</code> and <code>my--namespace</code> are not valid.</p>
81
+ * </li>
82
+ * <li>
83
+ * <p>Not be in IP address format (for example, 192.168.5.4)</p>
84
+ * </li>
85
+ * </ul>
86
+ *
87
+ * @throws {@link NoManagementAccountSLRExistsException} (client fault)
88
+ * <p> This exception is thrown when the management account does not have a service-linked
89
+ * role. </p>
90
+ *
91
+ * @throws {@link NotOrganizationMasterAccountException} (client fault)
92
+ * <p>This exception is thrown when the Amazon Web Services account making the request to
93
+ * create or update an organization trail or event data store is not the management account
94
+ * 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> or <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html">Create an event data store</a>.</p>
95
+ *
96
+ * @throws {@link OperationNotPermittedException} (client fault)
97
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
98
+ *
99
+ * @throws {@link TrailNotFoundException} (client fault)
100
+ * <p>This exception is thrown when the trail with the given name is not found.</p>
101
+ *
102
+ * @throws {@link UnsupportedOperationException} (client fault)
103
+ * <p>This exception is thrown when the requested operation is not supported.</p>
104
+ *
105
+ *
35
106
  */
36
107
  export declare class StartLoggingCommand extends $Command<StartLoggingCommandInput, StartLoggingCommandOutput, CloudTrailClientResolvedConfig> {
37
108
  readonly input: StartLoggingCommandInput;
@@ -32,6 +32,55 @@ export interface StartQueryCommandOutput extends StartQueryResponse, __MetadataB
32
32
  * @see {@link StartQueryCommandOutput} for command's `response` shape.
33
33
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
34
34
  *
35
+ * @throws {@link EventDataStoreARNInvalidException} (client fault)
36
+ * <p>The specified event data store ARN is not valid or does not map to an event data store
37
+ * in your account.</p>
38
+ *
39
+ * @throws {@link EventDataStoreNotFoundException} (client fault)
40
+ * <p>The specified event data store was not found.</p>
41
+ *
42
+ * @throws {@link InactiveEventDataStoreException} (client fault)
43
+ * <p>The event data store is inactive.</p>
44
+ *
45
+ * @throws {@link InsufficientEncryptionPolicyException} (client fault)
46
+ * <p>This exception is thrown when the policy on the S3 bucket or KMS key does
47
+ * not have sufficient permissions for the operation.</p>
48
+ *
49
+ * @throws {@link InsufficientS3BucketPolicyException} (client fault)
50
+ * <p>This exception is thrown when the policy on the S3 bucket is not sufficient.</p>
51
+ *
52
+ * @throws {@link InvalidParameterException} (client fault)
53
+ * <p>The request includes a parameter that is not valid.</p>
54
+ *
55
+ * @throws {@link InvalidQueryStatementException} (client fault)
56
+ * <p>The query that was submitted has validation errors, or uses incorrect syntax or
57
+ * 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
58
+ * Guide</i>.</p>
59
+ *
60
+ * @throws {@link InvalidS3BucketNameException} (client fault)
61
+ * <p>This exception is thrown when the provided S3 bucket name is not valid.</p>
62
+ *
63
+ * @throws {@link InvalidS3PrefixException} (client fault)
64
+ * <p>This exception is thrown when the provided S3 prefix is not valid.</p>
65
+ *
66
+ * @throws {@link MaxConcurrentQueriesException} (client fault)
67
+ * <p>You are already running the maximum number of concurrent queries. Wait a minute for some
68
+ * queries to finish, and then run the query again.</p>
69
+ *
70
+ * @throws {@link NoManagementAccountSLRExistsException} (client fault)
71
+ * <p> This exception is thrown when the management account does not have a service-linked
72
+ * role. </p>
73
+ *
74
+ * @throws {@link OperationNotPermittedException} (client fault)
75
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
76
+ *
77
+ * @throws {@link S3BucketDoesNotExistException} (client fault)
78
+ * <p>This exception is thrown when the specified S3 bucket does not exist.</p>
79
+ *
80
+ * @throws {@link UnsupportedOperationException} (client fault)
81
+ * <p>This exception is thrown when the requested operation is not supported.</p>
82
+ *
83
+ *
35
84
  */
36
85
  export declare class StartQueryCommand extends $Command<StartQueryCommandInput, StartQueryCommandOutput, CloudTrailClientResolvedConfig> {
37
86
  readonly input: StartQueryCommandInput;
@@ -29,6 +29,19 @@ export interface StopImportCommandOutput extends StopImportResponse, __MetadataB
29
29
  * @see {@link StopImportCommandOutput} for command's `response` shape.
30
30
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
31
31
  *
32
+ * @throws {@link ImportNotFoundException} (client fault)
33
+ * <p> The specified import was not found. </p>
34
+ *
35
+ * @throws {@link InvalidParameterException} (client fault)
36
+ * <p>The request includes a parameter that is not valid.</p>
37
+ *
38
+ * @throws {@link OperationNotPermittedException} (client fault)
39
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
40
+ *
41
+ * @throws {@link UnsupportedOperationException} (client fault)
42
+ * <p>This exception is thrown when the requested operation is not supported.</p>
43
+ *
44
+ *
32
45
  */
33
46
  export declare class StopImportCommand extends $Command<StopImportCommandInput, StopImportCommandOutput, CloudTrailClientResolvedConfig> {
34
47
  readonly input: StopImportCommandInput;
@@ -35,6 +35,77 @@ export interface StopLoggingCommandOutput extends StopLoggingResponse, __Metadat
35
35
  * @see {@link StopLoggingCommandOutput} for command's `response` shape.
36
36
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
37
37
  *
38
+ * @throws {@link CloudTrailARNInvalidException} (client fault)
39
+ * <p>This exception is thrown when an operation is called with a trail ARN that is not valid.
40
+ * The following is the format of a trail ARN.</p>
41
+ * <p>
42
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
43
+ * </p>
44
+ * <p>This exception is also thrown when you call <code>AddTags</code> or <code>RemoveTags</code> on a trail, event data store, or channel with a resource ARN that is not valid.</p>
45
+ * <p>The following is the format of an event data store ARN:
46
+ * <code>arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
47
+ * </p>
48
+ * <p>The following is the format of a channel ARN:
49
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
50
+ * </p>
51
+ *
52
+ * @throws {@link ConflictException} (client fault)
53
+ * <p>This exception is thrown when the specified resource is not ready for an operation. This
54
+ * can occur when you try to run an operation on a resource before CloudTrail has time
55
+ * 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
56
+ * operation again.</p>
57
+ *
58
+ * @throws {@link InsufficientDependencyServiceAccessPermissionException} (client fault)
59
+ * <p>This exception is thrown when the IAM user or role that is used to create
60
+ * the organization resource lacks one or more required permissions for creating an
61
+ * organization resource in a required service.</p>
62
+ *
63
+ * @throws {@link InvalidHomeRegionException} (client fault)
64
+ * <p>This exception is thrown when an operation is called on a trail from a region other than
65
+ * the region in which the trail was created.</p>
66
+ *
67
+ * @throws {@link InvalidTrailNameException} (client fault)
68
+ * <p>This exception is thrown when the provided trail name is not valid. Trail names must
69
+ * meet the following requirements:</p>
70
+ * <ul>
71
+ * <li>
72
+ * <p>Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores
73
+ * (_), or dashes (-)</p>
74
+ * </li>
75
+ * <li>
76
+ * <p>Start with a letter or number, and end with a letter or number</p>
77
+ * </li>
78
+ * <li>
79
+ * <p>Be between 3 and 128 characters</p>
80
+ * </li>
81
+ * <li>
82
+ * <p>Have no adjacent periods, underscores or dashes. Names like
83
+ * <code>my-_namespace</code> and <code>my--namespace</code> are not valid.</p>
84
+ * </li>
85
+ * <li>
86
+ * <p>Not be in IP address format (for example, 192.168.5.4)</p>
87
+ * </li>
88
+ * </ul>
89
+ *
90
+ * @throws {@link NoManagementAccountSLRExistsException} (client fault)
91
+ * <p> This exception is thrown when the management account does not have a service-linked
92
+ * role. </p>
93
+ *
94
+ * @throws {@link NotOrganizationMasterAccountException} (client fault)
95
+ * <p>This exception is thrown when the Amazon Web Services account making the request to
96
+ * create or update an organization trail or event data store is not the management account
97
+ * 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> or <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html">Create an event data store</a>.</p>
98
+ *
99
+ * @throws {@link OperationNotPermittedException} (client fault)
100
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
101
+ *
102
+ * @throws {@link TrailNotFoundException} (client fault)
103
+ * <p>This exception is thrown when the trail with the given name is not found.</p>
104
+ *
105
+ * @throws {@link UnsupportedOperationException} (client fault)
106
+ * <p>This exception is thrown when the requested operation is not supported.</p>
107
+ *
108
+ *
38
109
  */
39
110
  export declare class StopLoggingCommand extends $Command<StopLoggingCommandInput, StopLoggingCommandOutput, CloudTrailClientResolvedConfig> {
40
111
  readonly input: StopLoggingCommandInput;
@@ -29,6 +29,42 @@ export interface UpdateChannelCommandOutput extends UpdateChannelResponse, __Met
29
29
  * @see {@link UpdateChannelCommandOutput} for command's `response` shape.
30
30
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
31
31
  *
32
+ * @throws {@link ChannelAlreadyExistsException} (client fault)
33
+ * <p>
34
+ * This exception is thrown when the provided channel already exists.
35
+ * </p>
36
+ *
37
+ * @throws {@link ChannelARNInvalidException} (client fault)
38
+ * <p>This exception is thrown when the specified value of <code>ChannelARN</code> is not
39
+ * valid.</p>
40
+ *
41
+ * @throws {@link ChannelNotFoundException} (client fault)
42
+ * <p>This exception is thrown when CloudTrail cannot find the specified channel.</p>
43
+ *
44
+ * @throws {@link EventDataStoreARNInvalidException} (client fault)
45
+ * <p>The specified event data store ARN is not valid or does not map to an event data store
46
+ * in your account.</p>
47
+ *
48
+ * @throws {@link EventDataStoreNotFoundException} (client fault)
49
+ * <p>The specified event data store was not found.</p>
50
+ *
51
+ * @throws {@link InactiveEventDataStoreException} (client fault)
52
+ * <p>The event data store is inactive.</p>
53
+ *
54
+ * @throws {@link InvalidEventDataStoreCategoryException} (client fault)
55
+ * <p>This exception is thrown when event categories of specified event data stores are not
56
+ * valid.</p>
57
+ *
58
+ * @throws {@link InvalidParameterException} (client fault)
59
+ * <p>The request includes a parameter that is not valid.</p>
60
+ *
61
+ * @throws {@link OperationNotPermittedException} (client fault)
62
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
63
+ *
64
+ * @throws {@link UnsupportedOperationException} (client fault)
65
+ * <p>This exception is thrown when the requested operation is not supported.</p>
66
+ *
67
+ *
32
68
  */
33
69
  export declare class UpdateChannelCommand extends $Command<UpdateChannelCommandInput, UpdateChannelCommandOutput, CloudTrailClientResolvedConfig> {
34
70
  readonly input: UpdateChannelCommandInput;
@@ -39,6 +39,103 @@ export interface UpdateEventDataStoreCommandOutput extends UpdateEventDataStoreR
39
39
  * @see {@link UpdateEventDataStoreCommandOutput} for command's `response` shape.
40
40
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
41
41
  *
42
+ * @throws {@link CloudTrailAccessNotEnabledException} (client fault)
43
+ * <p>This exception is thrown when trusted access has not been enabled between CloudTrail and Organizations. For more information, see <a href="https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html">Enabling Trusted Access with Other Amazon Web Services Services</a> and <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>
44
+ *
45
+ * @throws {@link EventDataStoreARNInvalidException} (client fault)
46
+ * <p>The specified event data store ARN is not valid or does not map to an event data store
47
+ * in your account.</p>
48
+ *
49
+ * @throws {@link EventDataStoreHasOngoingImportException} (client fault)
50
+ * <p> This exception is thrown when you try to update or delete an event data store that
51
+ * currently has an import in progress. </p>
52
+ *
53
+ * @throws {@link EventDataStoreNotFoundException} (client fault)
54
+ * <p>The specified event data store was not found.</p>
55
+ *
56
+ * @throws {@link InactiveEventDataStoreException} (client fault)
57
+ * <p>The event data store is inactive.</p>
58
+ *
59
+ * @throws {@link InsufficientDependencyServiceAccessPermissionException} (client fault)
60
+ * <p>This exception is thrown when the IAM user or role that is used to create
61
+ * the organization resource lacks one or more required permissions for creating an
62
+ * organization resource in a required service.</p>
63
+ *
64
+ * @throws {@link InsufficientEncryptionPolicyException} (client fault)
65
+ * <p>This exception is thrown when the policy on the S3 bucket or KMS key does
66
+ * not have sufficient permissions for the operation.</p>
67
+ *
68
+ * @throws {@link InvalidEventSelectorsException} (client fault)
69
+ * <p>This exception is thrown when the <code>PutEventSelectors</code> operation is called
70
+ * with a number of event selectors, advanced event selectors, or data resources that is not
71
+ * valid. The combination of event selectors or advanced event selectors and data resources is
72
+ * not valid. A trail can have up to 5 event selectors. If a trail uses advanced event
73
+ * selectors, a maximum of 500 total values for all conditions in all advanced event selectors
74
+ * is allowed. A trail is limited to 250 data resources. These data resources can be
75
+ * distributed across event selectors, but the overall total cannot exceed 250.</p>
76
+ * <p>You can:</p>
77
+ * <ul>
78
+ * <li>
79
+ * <p>Specify a valid number of event selectors (1 to 5) for a trail.</p>
80
+ * </li>
81
+ * <li>
82
+ * <p>Specify a valid number of data resources (1 to 250) for an event selector. The
83
+ * limit of number of resources on an individual event selector is configurable up to
84
+ * 250. However, this upper limit is allowed only if the total number of data resources
85
+ * does not exceed 250 across all event selectors for a trail.</p>
86
+ * </li>
87
+ * <li>
88
+ * <p>Specify up to 500 values for all conditions in all advanced event selectors for a
89
+ * trail.</p>
90
+ * </li>
91
+ * <li>
92
+ * <p>Specify a valid value for a parameter. For example, specifying the
93
+ * <code>ReadWriteType</code> parameter with a value of <code>read-only</code> is not
94
+ * valid.</p>
95
+ * </li>
96
+ * </ul>
97
+ *
98
+ * @throws {@link InvalidKmsKeyIdException} (client fault)
99
+ * <p>This exception is thrown when the KMS key ARN is not valid.</p>
100
+ *
101
+ * @throws {@link InvalidParameterException} (client fault)
102
+ * <p>The request includes a parameter that is not valid.</p>
103
+ *
104
+ * @throws {@link KmsException} (client fault)
105
+ * <p>This exception is thrown when there is an issue with the specified KMS
106
+ * key and the trail or event data store can't be updated.</p>
107
+ *
108
+ * @throws {@link KmsKeyNotFoundException} (client fault)
109
+ * <p>This exception is thrown when the KMS key does not exist, when the S3
110
+ * bucket and the KMS key are not in the same region, or when the KMS key associated with the Amazon SNS topic either does not exist or is
111
+ * not in the same region.</p>
112
+ *
113
+ * @throws {@link NoManagementAccountSLRExistsException} (client fault)
114
+ * <p> This exception is thrown when the management account does not have a service-linked
115
+ * role. </p>
116
+ *
117
+ * @throws {@link NotOrganizationMasterAccountException} (client fault)
118
+ * <p>This exception is thrown when the Amazon Web Services account making the request to
119
+ * create or update an organization trail or event data store is not the management account
120
+ * 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> or <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html">Create an event data store</a>.</p>
121
+ *
122
+ * @throws {@link OperationNotPermittedException} (client fault)
123
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
124
+ *
125
+ * @throws {@link OrganizationNotInAllFeaturesModeException} (client fault)
126
+ * <p>This exception is thrown when Organizations is not configured to support all
127
+ * features. All features must be enabled in Organizations to support creating an
128
+ * organization trail or event data store.</p>
129
+ *
130
+ * @throws {@link OrganizationsNotInUseException} (client fault)
131
+ * <p>This exception is thrown when the request is made from an Amazon Web Services account
132
+ * that is not a member of an organization. To make this request, sign in using the
133
+ * credentials of an account that belongs to an organization.</p>
134
+ *
135
+ * @throws {@link UnsupportedOperationException} (client fault)
136
+ * <p>This exception is thrown when the requested operation is not supported.</p>
137
+ *
138
+ *
42
139
  */
43
140
  export declare class UpdateEventDataStoreCommand extends $Command<UpdateEventDataStoreCommandInput, UpdateEventDataStoreCommandOutput, CloudTrailClientResolvedConfig> {
44
141
  readonly input: UpdateEventDataStoreCommandInput;
@@ -34,6 +34,183 @@ export interface UpdateTrailCommandOutput extends UpdateTrailResponse, __Metadat
34
34
  * @see {@link UpdateTrailCommandOutput} for command's `response` shape.
35
35
  * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape.
36
36
  *
37
+ * @throws {@link CloudTrailAccessNotEnabledException} (client fault)
38
+ * <p>This exception is thrown when trusted access has not been enabled between CloudTrail and Organizations. For more information, see <a href="https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html">Enabling Trusted Access with Other Amazon Web Services Services</a> and <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>
39
+ *
40
+ * @throws {@link CloudTrailARNInvalidException} (client fault)
41
+ * <p>This exception is thrown when an operation is called with a trail ARN that is not valid.
42
+ * The following is the format of a trail ARN.</p>
43
+ * <p>
44
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
45
+ * </p>
46
+ * <p>This exception is also thrown when you call <code>AddTags</code> or <code>RemoveTags</code> on a trail, event data store, or channel with a resource ARN that is not valid.</p>
47
+ * <p>The following is the format of an event data store ARN:
48
+ * <code>arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
49
+ * </p>
50
+ * <p>The following is the format of a channel ARN:
51
+ * <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
52
+ * </p>
53
+ *
54
+ * @throws {@link CloudTrailInvalidClientTokenIdException} (client fault)
55
+ * <p>This exception is thrown when a call results in the <code>InvalidClientTokenId</code>
56
+ * error code. This can occur when you are creating or updating a trail to send notifications
57
+ * to an Amazon SNS topic that is in a suspended Amazon Web Services account.</p>
58
+ *
59
+ * @throws {@link CloudWatchLogsDeliveryUnavailableException} (client fault)
60
+ * <p>Cannot set a CloudWatch Logs delivery for this region.</p>
61
+ *
62
+ * @throws {@link ConflictException} (client fault)
63
+ * <p>This exception is thrown when the specified resource is not ready for an operation. This
64
+ * can occur when you try to run an operation on a resource before CloudTrail has time
65
+ * 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
66
+ * operation again.</p>
67
+ *
68
+ * @throws {@link InsufficientDependencyServiceAccessPermissionException} (client fault)
69
+ * <p>This exception is thrown when the IAM user or role that is used to create
70
+ * the organization resource lacks one or more required permissions for creating an
71
+ * organization resource in a required service.</p>
72
+ *
73
+ * @throws {@link InsufficientEncryptionPolicyException} (client fault)
74
+ * <p>This exception is thrown when the policy on the S3 bucket or KMS key does
75
+ * not have sufficient permissions for the operation.</p>
76
+ *
77
+ * @throws {@link InsufficientS3BucketPolicyException} (client fault)
78
+ * <p>This exception is thrown when the policy on the S3 bucket is not sufficient.</p>
79
+ *
80
+ * @throws {@link InsufficientSnsTopicPolicyException} (client fault)
81
+ * <p>This exception is thrown when the policy on the Amazon SNS topic is not
82
+ * sufficient.</p>
83
+ *
84
+ * @throws {@link InvalidCloudWatchLogsLogGroupArnException} (client fault)
85
+ * <p>This exception is thrown when the provided CloudWatch Logs log group is not
86
+ * valid.</p>
87
+ *
88
+ * @throws {@link InvalidCloudWatchLogsRoleArnException} (client fault)
89
+ * <p>This exception is thrown when the provided role is not valid.</p>
90
+ *
91
+ * @throws {@link InvalidEventSelectorsException} (client fault)
92
+ * <p>This exception is thrown when the <code>PutEventSelectors</code> operation is called
93
+ * with a number of event selectors, advanced event selectors, or data resources that is not
94
+ * valid. The combination of event selectors or advanced event selectors and data resources is
95
+ * not valid. A trail can have up to 5 event selectors. If a trail uses advanced event
96
+ * selectors, a maximum of 500 total values for all conditions in all advanced event selectors
97
+ * is allowed. A trail is limited to 250 data resources. These data resources can be
98
+ * distributed across event selectors, but the overall total cannot exceed 250.</p>
99
+ * <p>You can:</p>
100
+ * <ul>
101
+ * <li>
102
+ * <p>Specify a valid number of event selectors (1 to 5) for a trail.</p>
103
+ * </li>
104
+ * <li>
105
+ * <p>Specify a valid number of data resources (1 to 250) for an event selector. The
106
+ * limit of number of resources on an individual event selector is configurable up to
107
+ * 250. However, this upper limit is allowed only if the total number of data resources
108
+ * does not exceed 250 across all event selectors for a trail.</p>
109
+ * </li>
110
+ * <li>
111
+ * <p>Specify up to 500 values for all conditions in all advanced event selectors for a
112
+ * trail.</p>
113
+ * </li>
114
+ * <li>
115
+ * <p>Specify a valid value for a parameter. For example, specifying the
116
+ * <code>ReadWriteType</code> parameter with a value of <code>read-only</code> is not
117
+ * valid.</p>
118
+ * </li>
119
+ * </ul>
120
+ *
121
+ * @throws {@link InvalidHomeRegionException} (client fault)
122
+ * <p>This exception is thrown when an operation is called on a trail from a region other than
123
+ * the region in which the trail was created.</p>
124
+ *
125
+ * @throws {@link InvalidKmsKeyIdException} (client fault)
126
+ * <p>This exception is thrown when the KMS key ARN is not valid.</p>
127
+ *
128
+ * @throws {@link InvalidParameterCombinationException} (client fault)
129
+ * <p>This exception is thrown when the combination of parameters provided is not
130
+ * valid.</p>
131
+ *
132
+ * @throws {@link InvalidParameterException} (client fault)
133
+ * <p>The request includes a parameter that is not valid.</p>
134
+ *
135
+ * @throws {@link InvalidS3BucketNameException} (client fault)
136
+ * <p>This exception is thrown when the provided S3 bucket name is not valid.</p>
137
+ *
138
+ * @throws {@link InvalidS3PrefixException} (client fault)
139
+ * <p>This exception is thrown when the provided S3 prefix is not valid.</p>
140
+ *
141
+ * @throws {@link InvalidSnsTopicNameException} (client fault)
142
+ * <p>This exception is thrown when the provided SNS topic name is not valid.</p>
143
+ *
144
+ * @throws {@link InvalidTrailNameException} (client fault)
145
+ * <p>This exception is thrown when the provided trail name is not valid. Trail names must
146
+ * meet the following requirements:</p>
147
+ * <ul>
148
+ * <li>
149
+ * <p>Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores
150
+ * (_), or dashes (-)</p>
151
+ * </li>
152
+ * <li>
153
+ * <p>Start with a letter or number, and end with a letter or number</p>
154
+ * </li>
155
+ * <li>
156
+ * <p>Be between 3 and 128 characters</p>
157
+ * </li>
158
+ * <li>
159
+ * <p>Have no adjacent periods, underscores or dashes. Names like
160
+ * <code>my-_namespace</code> and <code>my--namespace</code> are not valid.</p>
161
+ * </li>
162
+ * <li>
163
+ * <p>Not be in IP address format (for example, 192.168.5.4)</p>
164
+ * </li>
165
+ * </ul>
166
+ *
167
+ * @throws {@link KmsException} (client fault)
168
+ * <p>This exception is thrown when there is an issue with the specified KMS
169
+ * key and the trail or event data store can't be updated.</p>
170
+ *
171
+ * @throws {@link KmsKeyDisabledException} (client fault)
172
+ * <p>This exception is no longer in use.</p>
173
+ *
174
+ * @throws {@link KmsKeyNotFoundException} (client fault)
175
+ * <p>This exception is thrown when the KMS key does not exist, when the S3
176
+ * bucket and the KMS key are not in the same region, or when the KMS key associated with the Amazon SNS topic either does not exist or is
177
+ * not in the same region.</p>
178
+ *
179
+ * @throws {@link NoManagementAccountSLRExistsException} (client fault)
180
+ * <p> This exception is thrown when the management account does not have a service-linked
181
+ * role. </p>
182
+ *
183
+ * @throws {@link NotOrganizationMasterAccountException} (client fault)
184
+ * <p>This exception is thrown when the Amazon Web Services account making the request to
185
+ * create or update an organization trail or event data store is not the management account
186
+ * 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> or <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html">Create an event data store</a>.</p>
187
+ *
188
+ * @throws {@link OperationNotPermittedException} (client fault)
189
+ * <p>This exception is thrown when the requested operation is not permitted.</p>
190
+ *
191
+ * @throws {@link OrganizationNotInAllFeaturesModeException} (client fault)
192
+ * <p>This exception is thrown when Organizations is not configured to support all
193
+ * features. All features must be enabled in Organizations to support creating an
194
+ * organization trail or event data store.</p>
195
+ *
196
+ * @throws {@link OrganizationsNotInUseException} (client fault)
197
+ * <p>This exception is thrown when the request is made from an Amazon Web Services account
198
+ * that is not a member of an organization. To make this request, sign in using the
199
+ * credentials of an account that belongs to an organization.</p>
200
+ *
201
+ * @throws {@link S3BucketDoesNotExistException} (client fault)
202
+ * <p>This exception is thrown when the specified S3 bucket does not exist.</p>
203
+ *
204
+ * @throws {@link TrailNotFoundException} (client fault)
205
+ * <p>This exception is thrown when the trail with the given name is not found.</p>
206
+ *
207
+ * @throws {@link TrailNotProvidedException} (client fault)
208
+ * <p>This exception is no longer in use.</p>
209
+ *
210
+ * @throws {@link UnsupportedOperationException} (client fault)
211
+ * <p>This exception is thrown when the requested operation is not supported.</p>
212
+ *
213
+ *
37
214
  */
38
215
  export declare class UpdateTrailCommand extends $Command<UpdateTrailCommandInput, UpdateTrailCommandOutput, CloudTrailClientResolvedConfig> {
39
216
  readonly input: UpdateTrailCommandInput;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-cloudtrail",
3
3
  "description": "AWS SDK for JavaScript Cloudtrail Client for Node.js, Browser and React Native",
4
- "version": "3.288.0",
4
+ "version": "3.290.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,37 +20,37 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "3.0.0",
22
22
  "@aws-crypto/sha256-js": "3.0.0",
23
- "@aws-sdk/client-sts": "3.288.0",
24
- "@aws-sdk/config-resolver": "3.287.0",
25
- "@aws-sdk/credential-provider-node": "3.288.0",
26
- "@aws-sdk/fetch-http-handler": "3.282.0",
27
- "@aws-sdk/hash-node": "3.272.0",
28
- "@aws-sdk/invalid-dependency": "3.272.0",
29
- "@aws-sdk/middleware-content-length": "3.282.0",
30
- "@aws-sdk/middleware-endpoint": "3.282.0",
31
- "@aws-sdk/middleware-host-header": "3.282.0",
32
- "@aws-sdk/middleware-logger": "3.288.0",
33
- "@aws-sdk/middleware-recursion-detection": "3.282.0",
34
- "@aws-sdk/middleware-retry": "3.287.0",
35
- "@aws-sdk/middleware-serde": "3.272.0",
36
- "@aws-sdk/middleware-signing": "3.282.0",
37
- "@aws-sdk/middleware-stack": "3.272.0",
38
- "@aws-sdk/middleware-user-agent": "3.282.0",
39
- "@aws-sdk/node-config-provider": "3.287.0",
40
- "@aws-sdk/node-http-handler": "3.282.0",
41
- "@aws-sdk/protocol-http": "3.282.0",
42
- "@aws-sdk/smithy-client": "3.279.0",
43
- "@aws-sdk/types": "3.272.0",
44
- "@aws-sdk/url-parser": "3.272.0",
23
+ "@aws-sdk/client-sts": "3.290.0",
24
+ "@aws-sdk/config-resolver": "3.290.0",
25
+ "@aws-sdk/credential-provider-node": "3.290.0",
26
+ "@aws-sdk/fetch-http-handler": "3.290.0",
27
+ "@aws-sdk/hash-node": "3.290.0",
28
+ "@aws-sdk/invalid-dependency": "3.290.0",
29
+ "@aws-sdk/middleware-content-length": "3.290.0",
30
+ "@aws-sdk/middleware-endpoint": "3.290.0",
31
+ "@aws-sdk/middleware-host-header": "3.290.0",
32
+ "@aws-sdk/middleware-logger": "3.290.0",
33
+ "@aws-sdk/middleware-recursion-detection": "3.290.0",
34
+ "@aws-sdk/middleware-retry": "3.290.0",
35
+ "@aws-sdk/middleware-serde": "3.290.0",
36
+ "@aws-sdk/middleware-signing": "3.290.0",
37
+ "@aws-sdk/middleware-stack": "3.290.0",
38
+ "@aws-sdk/middleware-user-agent": "3.290.0",
39
+ "@aws-sdk/node-config-provider": "3.290.0",
40
+ "@aws-sdk/node-http-handler": "3.290.0",
41
+ "@aws-sdk/protocol-http": "3.290.0",
42
+ "@aws-sdk/smithy-client": "3.290.0",
43
+ "@aws-sdk/types": "3.290.0",
44
+ "@aws-sdk/url-parser": "3.290.0",
45
45
  "@aws-sdk/util-base64": "3.208.0",
46
46
  "@aws-sdk/util-body-length-browser": "3.188.0",
47
47
  "@aws-sdk/util-body-length-node": "3.208.0",
48
- "@aws-sdk/util-defaults-mode-browser": "3.279.0",
49
- "@aws-sdk/util-defaults-mode-node": "3.287.0",
50
- "@aws-sdk/util-endpoints": "3.272.0",
51
- "@aws-sdk/util-retry": "3.272.0",
52
- "@aws-sdk/util-user-agent-browser": "3.282.0",
53
- "@aws-sdk/util-user-agent-node": "3.287.0",
48
+ "@aws-sdk/util-defaults-mode-browser": "3.290.0",
49
+ "@aws-sdk/util-defaults-mode-node": "3.290.0",
50
+ "@aws-sdk/util-endpoints": "3.290.0",
51
+ "@aws-sdk/util-retry": "3.290.0",
52
+ "@aws-sdk/util-user-agent-browser": "3.290.0",
53
+ "@aws-sdk/util-user-agent-node": "3.290.0",
54
54
  "@aws-sdk/util-utf8": "3.254.0",
55
55
  "tslib": "^2.3.1"
56
56
  },