aws-sdk-cloudtrail 1.124.0 → 1.126.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudtrail/client.rb +382 -29
- data/lib/aws-sdk-cloudtrail/client_api.rb +6 -0
- data/lib/aws-sdk-cloudtrail/types.rb +61 -9
- data/lib/aws-sdk-cloudtrail.rb +1 -1
- data/sig/client.rbs +6 -2
- data/sig/types.rbs +5 -0
- metadata +3 -3
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 79152e7ba2328a4a8381e99249e2cb4c40f56d17a503e76a771f42911caa2a37
|
|
4
|
+
data.tar.gz: 9d125b683d092a48ebfc9684379774af3c2c4254070275400d26f48e08821d50
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 8cbd38086d7650afbebb9cb8d446b1b6928f98d57e7095f14bfd0c238fe7eeec963b43dbb3d996c7f7d31b74655d0c7cd08197f198a914a5b30442f6635b4ca7
|
|
7
|
+
data.tar.gz: a6bcb9036bad819f1b287a7860cf72f97a6b0758dfddb1f304ca2ec4e44b415a4ff2394d1ad8a3230c182f049307aa23bef26c523068169f511cc4ddef5449a8
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
Unreleased Changes
|
|
2
2
|
------------------
|
|
3
3
|
|
|
4
|
+
1.126.0 (2026-09-08)
|
|
5
|
+
------------------
|
|
6
|
+
|
|
7
|
+
* Feature - Adds support for the RecursiveLogging trail setting, which suppresses recursive events generated when CloudTrail delivers logs to a trail's destinations.
|
|
8
|
+
|
|
9
|
+
1.125.0 (2026-07-09)
|
|
10
|
+
------------------
|
|
11
|
+
|
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
|
13
|
+
|
|
4
14
|
1.124.0 (2026-05-29)
|
|
5
15
|
------------------
|
|
6
16
|
|
data/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.126.0
|
|
@@ -533,12 +533,22 @@ module Aws::CloudTrail
|
|
|
533
533
|
req.send_request(options)
|
|
534
534
|
end
|
|
535
535
|
|
|
536
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
537
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
538
|
+
# that date. Existing customers can continue to use the service as
|
|
539
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
540
|
+
# change][1].
|
|
541
|
+
#
|
|
536
542
|
# Cancels a query if the query is not in a terminated state, such as
|
|
537
543
|
# `CANCELLED`, `FAILED`, `TIMED_OUT`, or `FINISHED`. You must specify an
|
|
538
544
|
# ARN value for `EventDataStore`. The ID of the query that you want to
|
|
539
545
|
# cancel is also required. When you run `CancelQuery`, the query status
|
|
540
546
|
# might show as `CANCELLED` even if the operation is not yet finished.
|
|
541
547
|
#
|
|
548
|
+
#
|
|
549
|
+
#
|
|
550
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
551
|
+
#
|
|
542
552
|
# @option params [String] :event_data_store
|
|
543
553
|
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
|
544
554
|
# the specified query is running.
|
|
@@ -579,10 +589,20 @@ module Aws::CloudTrail
|
|
|
579
589
|
req.send_request(options)
|
|
580
590
|
end
|
|
581
591
|
|
|
592
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
593
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
594
|
+
# that date. Existing customers can continue to use the service as
|
|
595
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
596
|
+
# change][1].
|
|
597
|
+
#
|
|
582
598
|
# Creates a channel for CloudTrail to ingest events from a partner or
|
|
583
599
|
# external source. After you create a channel, a CloudTrail Lake event
|
|
584
600
|
# data store can log events from the partner or source that you specify.
|
|
585
601
|
#
|
|
602
|
+
#
|
|
603
|
+
#
|
|
604
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
605
|
+
#
|
|
586
606
|
# @option params [required, String] :name
|
|
587
607
|
# The name of the channel.
|
|
588
608
|
#
|
|
@@ -655,6 +675,12 @@ module Aws::CloudTrail
|
|
|
655
675
|
req.send_request(options)
|
|
656
676
|
end
|
|
657
677
|
|
|
678
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
679
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
680
|
+
# that date. Existing customers can continue to use the service as
|
|
681
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
682
|
+
# change][1].
|
|
683
|
+
#
|
|
658
684
|
# Creates a custom dashboard or the Highlights dashboard.
|
|
659
685
|
#
|
|
660
686
|
# * **Custom dashboards** - Custom dashboards allow you to query events
|
|
@@ -673,24 +699,25 @@ module Aws::CloudTrail
|
|
|
673
699
|
# run the `StartQuery` operation on your behalf. To provide permissions,
|
|
674
700
|
# run the `PutResourcePolicy` operation to attach a resource-based
|
|
675
701
|
# policy to each event data store. For more information, see [Example:
|
|
676
|
-
# Allow CloudTrail to run queries to populate a dashboard][
|
|
702
|
+
# Allow CloudTrail to run queries to populate a dashboard][2] in the
|
|
677
703
|
# *CloudTrail User Guide*.
|
|
678
704
|
#
|
|
679
705
|
# To set a refresh schedule, CloudTrail must be granted permissions to
|
|
680
706
|
# run the `StartDashboardRefresh` operation to refresh the dashboard on
|
|
681
707
|
# your behalf. To provide permissions, run the `PutResourcePolicy`
|
|
682
708
|
# operation to attach a resource-based policy to the dashboard. For more
|
|
683
|
-
# information, see [ Resource-based policy example for a dashboard][
|
|
709
|
+
# information, see [ Resource-based policy example for a dashboard][3]
|
|
684
710
|
# in the *CloudTrail User Guide*.
|
|
685
711
|
#
|
|
686
712
|
# For more information about dashboards, see [CloudTrail Lake
|
|
687
|
-
# dashboards][
|
|
713
|
+
# dashboards][4] in the *CloudTrail User Guide*.
|
|
688
714
|
#
|
|
689
715
|
#
|
|
690
716
|
#
|
|
691
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
|
692
|
-
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-
|
|
693
|
-
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
|
717
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
718
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-eds-dashboard
|
|
719
|
+
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-dashboards
|
|
720
|
+
# [4]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-dashboard.html
|
|
694
721
|
#
|
|
695
722
|
# @option params [required, String] :name
|
|
696
723
|
# The name of the dashboard. The name must be unique to your account.
|
|
@@ -789,8 +816,18 @@ module Aws::CloudTrail
|
|
|
789
816
|
req.send_request(options)
|
|
790
817
|
end
|
|
791
818
|
|
|
819
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
820
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
821
|
+
# that date. Existing customers can continue to use the service as
|
|
822
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
823
|
+
# change][1].
|
|
824
|
+
#
|
|
792
825
|
# Creates a new event data store.
|
|
793
826
|
#
|
|
827
|
+
#
|
|
828
|
+
#
|
|
829
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
830
|
+
#
|
|
794
831
|
# @option params [required, String] :name
|
|
795
832
|
# The name of the event data store.
|
|
796
833
|
#
|
|
@@ -1058,7 +1095,10 @@ module Aws::CloudTrail
|
|
|
1058
1095
|
#
|
|
1059
1096
|
# @option params [Boolean] :include_global_service_events
|
|
1060
1097
|
# Specifies whether the trail is publishing events from global services
|
|
1061
|
-
# such as IAM to the log files.
|
|
1098
|
+
# such as IAM to the log files. Setting this value to `true` only
|
|
1099
|
+
# delivers global service events to the trail if the trail is
|
|
1100
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
1101
|
+
# Region (for example, us-east-1).
|
|
1062
1102
|
#
|
|
1063
1103
|
# @option params [Boolean] :is_multi_region_trail
|
|
1064
1104
|
# Specifies whether the trail is created in the current Region or in all
|
|
@@ -1130,6 +1170,13 @@ module Aws::CloudTrail
|
|
|
1130
1170
|
# @option params [Array<Types::Tag>] :tags_list
|
|
1131
1171
|
# A list of tags.
|
|
1132
1172
|
#
|
|
1173
|
+
# @option params [Boolean] :recursive_logging
|
|
1174
|
+
# Specifies whether recursive logging is enabled for the trail. If you
|
|
1175
|
+
# set `RecursiveLogging` to `false`, CloudTrail suppresses events
|
|
1176
|
+
# generated by CloudTrail when it delivers log files to your trail's
|
|
1177
|
+
# destinations, including Amazon S3 and CloudWatch Logs. The default
|
|
1178
|
+
# value is `true`.
|
|
1179
|
+
#
|
|
1133
1180
|
# @return [Types::CreateTrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1134
1181
|
#
|
|
1135
1182
|
# * {Types::CreateTrailResponse#name #name} => String
|
|
@@ -1145,6 +1192,7 @@ module Aws::CloudTrail
|
|
|
1145
1192
|
# * {Types::CreateTrailResponse#cloud_watch_logs_role_arn #cloud_watch_logs_role_arn} => String
|
|
1146
1193
|
# * {Types::CreateTrailResponse#kms_key_id #kms_key_id} => String
|
|
1147
1194
|
# * {Types::CreateTrailResponse#is_organization_trail #is_organization_trail} => Boolean
|
|
1195
|
+
# * {Types::CreateTrailResponse#recursive_logging #recursive_logging} => Boolean
|
|
1148
1196
|
#
|
|
1149
1197
|
# @example Request syntax with placeholder values
|
|
1150
1198
|
#
|
|
@@ -1166,6 +1214,7 @@ module Aws::CloudTrail
|
|
|
1166
1214
|
# value: "TagValue",
|
|
1167
1215
|
# },
|
|
1168
1216
|
# ],
|
|
1217
|
+
# recursive_logging: false,
|
|
1169
1218
|
# })
|
|
1170
1219
|
#
|
|
1171
1220
|
# @example Response structure
|
|
@@ -1183,6 +1232,7 @@ module Aws::CloudTrail
|
|
|
1183
1232
|
# resp.cloud_watch_logs_role_arn #=> String
|
|
1184
1233
|
# resp.kms_key_id #=> String
|
|
1185
1234
|
# resp.is_organization_trail #=> Boolean
|
|
1235
|
+
# resp.recursive_logging #=> Boolean
|
|
1186
1236
|
#
|
|
1187
1237
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateTrail AWS API Documentation
|
|
1188
1238
|
#
|
|
@@ -1193,8 +1243,18 @@ module Aws::CloudTrail
|
|
|
1193
1243
|
req.send_request(options)
|
|
1194
1244
|
end
|
|
1195
1245
|
|
|
1246
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1247
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1248
|
+
# that date. Existing customers can continue to use the service as
|
|
1249
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1250
|
+
# change][1].
|
|
1251
|
+
#
|
|
1196
1252
|
# Deletes a channel.
|
|
1197
1253
|
#
|
|
1254
|
+
#
|
|
1255
|
+
#
|
|
1256
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1257
|
+
#
|
|
1198
1258
|
# @option params [required, String] :channel
|
|
1199
1259
|
# The ARN or the `UUID` value of the channel that you want to delete.
|
|
1200
1260
|
#
|
|
@@ -1215,9 +1275,19 @@ module Aws::CloudTrail
|
|
|
1215
1275
|
req.send_request(options)
|
|
1216
1276
|
end
|
|
1217
1277
|
|
|
1278
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1279
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1280
|
+
# that date. Existing customers can continue to use the service as
|
|
1281
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1282
|
+
# change][1].
|
|
1283
|
+
#
|
|
1218
1284
|
# Deletes the specified dashboard. You cannot delete a dashboard that
|
|
1219
1285
|
# has termination protection enabled.
|
|
1220
1286
|
#
|
|
1287
|
+
#
|
|
1288
|
+
#
|
|
1289
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1290
|
+
#
|
|
1221
1291
|
# @option params [required, String] :dashboard_id
|
|
1222
1292
|
# The name or ARN for the dashboard.
|
|
1223
1293
|
#
|
|
@@ -1238,6 +1308,12 @@ module Aws::CloudTrail
|
|
|
1238
1308
|
req.send_request(options)
|
|
1239
1309
|
end
|
|
1240
1310
|
|
|
1311
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1312
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1313
|
+
# that date. Existing customers can continue to use the service as
|
|
1314
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1315
|
+
# change][1].
|
|
1316
|
+
#
|
|
1241
1317
|
# Disables the event data store specified by `EventDataStore`, which
|
|
1242
1318
|
# accepts an event data store ARN. After you run `DeleteEventDataStore`,
|
|
1243
1319
|
# the event data store enters a `PENDING_DELETION` state, and is
|
|
@@ -1253,6 +1329,10 @@ module Aws::CloudTrail
|
|
|
1253
1329
|
# state. An event data store in the `PENDING_DELETION` state does not
|
|
1254
1330
|
# incur costs.
|
|
1255
1331
|
#
|
|
1332
|
+
#
|
|
1333
|
+
#
|
|
1334
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1335
|
+
#
|
|
1256
1336
|
# @option params [required, String] :event_data_store
|
|
1257
1337
|
# The ARN (or the ID suffix of the ARN) of the event data store to
|
|
1258
1338
|
# delete.
|
|
@@ -1377,6 +1457,12 @@ module Aws::CloudTrail
|
|
|
1377
1457
|
req.send_request(options)
|
|
1378
1458
|
end
|
|
1379
1459
|
|
|
1460
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1461
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1462
|
+
# that date. Existing customers can continue to use the service as
|
|
1463
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1464
|
+
# change][1].
|
|
1465
|
+
#
|
|
1380
1466
|
# Returns metadata about a query, including query run time in
|
|
1381
1467
|
# milliseconds, number of events scanned and matched, and query status.
|
|
1382
1468
|
# If the query results were delivered to an S3 bucket, the response also
|
|
@@ -1388,6 +1474,10 @@ module Aws::CloudTrail
|
|
|
1388
1474
|
# view the query results of a dashboard query for the specified
|
|
1389
1475
|
# `RefreshId`.
|
|
1390
1476
|
#
|
|
1477
|
+
#
|
|
1478
|
+
#
|
|
1479
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1480
|
+
#
|
|
1391
1481
|
# @option params [String] :event_data_store
|
|
1392
1482
|
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
|
1393
1483
|
# the specified query was run.
|
|
@@ -1515,6 +1605,7 @@ module Aws::CloudTrail
|
|
|
1515
1605
|
# resp.trail_list[0].has_custom_event_selectors #=> Boolean
|
|
1516
1606
|
# resp.trail_list[0].has_insight_selectors #=> Boolean
|
|
1517
1607
|
# resp.trail_list[0].is_organization_trail #=> Boolean
|
|
1608
|
+
# resp.trail_list[0].recursive_logging #=> Boolean
|
|
1518
1609
|
#
|
|
1519
1610
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeTrails AWS API Documentation
|
|
1520
1611
|
#
|
|
@@ -1525,6 +1616,12 @@ module Aws::CloudTrail
|
|
|
1525
1616
|
req.send_request(options)
|
|
1526
1617
|
end
|
|
1527
1618
|
|
|
1619
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1620
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1621
|
+
# that date. Existing customers can continue to use the service as
|
|
1622
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1623
|
+
# change][1].
|
|
1624
|
+
#
|
|
1528
1625
|
# Disables Lake query federation on the specified event data store. When
|
|
1529
1626
|
# you disable federation, CloudTrail disables the integration with Glue,
|
|
1530
1627
|
# Lake Formation, and Amazon Athena. After disabling Lake query
|
|
@@ -1533,6 +1630,10 @@ module Aws::CloudTrail
|
|
|
1533
1630
|
# No CloudTrail Lake data is deleted when you disable federation and you
|
|
1534
1631
|
# can continue to run queries in CloudTrail Lake.
|
|
1535
1632
|
#
|
|
1633
|
+
#
|
|
1634
|
+
#
|
|
1635
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1636
|
+
#
|
|
1536
1637
|
# @option params [required, String] :event_data_store
|
|
1537
1638
|
# The ARN (or ID suffix of the ARN) of the event data store for which
|
|
1538
1639
|
# you want to disable Lake query federation.
|
|
@@ -1562,9 +1663,15 @@ module Aws::CloudTrail
|
|
|
1562
1663
|
req.send_request(options)
|
|
1563
1664
|
end
|
|
1564
1665
|
|
|
1666
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1667
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1668
|
+
# that date. Existing customers can continue to use the service as
|
|
1669
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1670
|
+
# change][1].
|
|
1671
|
+
#
|
|
1565
1672
|
# Enables Lake query federation on the specified event data store.
|
|
1566
1673
|
# Federating an event data store lets you view the metadata associated
|
|
1567
|
-
# with the event data store in the Glue [Data Catalog][
|
|
1674
|
+
# with the event data store in the Glue [Data Catalog][2] and run SQL
|
|
1568
1675
|
# queries against your event data using Amazon Athena. The table
|
|
1569
1676
|
# metadata stored in the Glue Data Catalog lets the Athena query engine
|
|
1570
1677
|
# know how to find, read, and process the data that you want to query.
|
|
@@ -1573,18 +1680,19 @@ module Aws::CloudTrail
|
|
|
1573
1680
|
# database named `aws:cloudtrail` (if the database doesn't already
|
|
1574
1681
|
# exist) and a managed federated table in the Glue Data Catalog. The
|
|
1575
1682
|
# event data store ID is used for the table name. CloudTrail registers
|
|
1576
|
-
# the role ARN and event data store in [Lake Formation][
|
|
1683
|
+
# the role ARN and event data store in [Lake Formation][3], the service
|
|
1577
1684
|
# responsible for allowing fine-grained access control of the federated
|
|
1578
1685
|
# resources in the Glue Data Catalog.
|
|
1579
1686
|
#
|
|
1580
1687
|
# For more information about Lake query federation, see [Federate an
|
|
1581
|
-
# event data store][
|
|
1688
|
+
# event data store][4].
|
|
1582
1689
|
#
|
|
1583
1690
|
#
|
|
1584
1691
|
#
|
|
1585
|
-
# [1]: https://docs.aws.amazon.com/
|
|
1586
|
-
# [2]: https://docs.aws.amazon.com/
|
|
1587
|
-
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-federation.html
|
|
1692
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1693
|
+
# [2]: https://docs.aws.amazon.com/glue/latest/dg/components-overview.html#data-catalog-intro
|
|
1694
|
+
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-federation-lake-formation.html
|
|
1695
|
+
# [4]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-federation.html
|
|
1588
1696
|
#
|
|
1589
1697
|
# @option params [required, String] :event_data_store
|
|
1590
1698
|
# The ARN (or ID suffix of the ARN) of the event data store for which
|
|
@@ -1629,6 +1737,12 @@ module Aws::CloudTrail
|
|
|
1629
1737
|
req.send_request(options)
|
|
1630
1738
|
end
|
|
1631
1739
|
|
|
1740
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1741
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1742
|
+
# that date. Existing customers can continue to use the service as
|
|
1743
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1744
|
+
# change][1].
|
|
1745
|
+
#
|
|
1632
1746
|
# Generates a query from a natural language prompt. This operation uses
|
|
1633
1747
|
# generative artificial intelligence (generative AI) to produce a
|
|
1634
1748
|
# ready-to-use SQL query from the prompt.
|
|
@@ -1640,7 +1754,7 @@ module Aws::CloudTrail
|
|
|
1640
1754
|
#
|
|
1641
1755
|
# The prompt must be in English. For information about limitations,
|
|
1642
1756
|
# permissions, and supported Regions, see [Create CloudTrail Lake
|
|
1643
|
-
# queries from natural language prompts][
|
|
1757
|
+
# queries from natural language prompts][2] in the <i>CloudTrail </i>
|
|
1644
1758
|
# user guide.
|
|
1645
1759
|
#
|
|
1646
1760
|
# <note markdown="1"> Do not include any personally identifying, confidential, or sensitive
|
|
@@ -1653,7 +1767,8 @@ module Aws::CloudTrail
|
|
|
1653
1767
|
#
|
|
1654
1768
|
#
|
|
1655
1769
|
#
|
|
1656
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-
|
|
1770
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1771
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-query-generator.html
|
|
1657
1772
|
#
|
|
1658
1773
|
# @option params [required, Array<String>] :event_data_stores
|
|
1659
1774
|
# The ARN (or ID suffix of the ARN) of the event data store that you
|
|
@@ -1696,8 +1811,18 @@ module Aws::CloudTrail
|
|
|
1696
1811
|
req.send_request(options)
|
|
1697
1812
|
end
|
|
1698
1813
|
|
|
1814
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1815
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1816
|
+
# that date. Existing customers can continue to use the service as
|
|
1817
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1818
|
+
# change][1].
|
|
1819
|
+
#
|
|
1699
1820
|
# Returns information about a specific channel.
|
|
1700
1821
|
#
|
|
1822
|
+
#
|
|
1823
|
+
#
|
|
1824
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1825
|
+
#
|
|
1701
1826
|
# @option params [required, String] :channel
|
|
1702
1827
|
# The ARN or `UUID` of a channel.
|
|
1703
1828
|
#
|
|
@@ -1756,8 +1881,18 @@ module Aws::CloudTrail
|
|
|
1756
1881
|
req.send_request(options)
|
|
1757
1882
|
end
|
|
1758
1883
|
|
|
1884
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
1885
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
1886
|
+
# that date. Existing customers can continue to use the service as
|
|
1887
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
1888
|
+
# change][1].
|
|
1889
|
+
#
|
|
1759
1890
|
# Returns the specified dashboard.
|
|
1760
1891
|
#
|
|
1892
|
+
#
|
|
1893
|
+
#
|
|
1894
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
1895
|
+
#
|
|
1761
1896
|
# @option params [required, String] :dashboard_id
|
|
1762
1897
|
# The name or ARN for the dashboard.
|
|
1763
1898
|
#
|
|
@@ -1863,9 +1998,19 @@ module Aws::CloudTrail
|
|
|
1863
1998
|
req.send_request(options)
|
|
1864
1999
|
end
|
|
1865
2000
|
|
|
2001
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2002
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2003
|
+
# that date. Existing customers can continue to use the service as
|
|
2004
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2005
|
+
# change][1].
|
|
2006
|
+
#
|
|
1866
2007
|
# Returns information about an event data store specified as either an
|
|
1867
2008
|
# ARN or the ID portion of the ARN.
|
|
1868
2009
|
#
|
|
2010
|
+
#
|
|
2011
|
+
#
|
|
2012
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2013
|
+
#
|
|
1869
2014
|
# @option params [required, String] :event_data_store
|
|
1870
2015
|
# The ARN (or ID suffix of the ARN) of the event data store about which
|
|
1871
2016
|
# you want information.
|
|
@@ -2040,8 +2185,18 @@ module Aws::CloudTrail
|
|
|
2040
2185
|
req.send_request(options)
|
|
2041
2186
|
end
|
|
2042
2187
|
|
|
2188
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2189
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2190
|
+
# that date. Existing customers can continue to use the service as
|
|
2191
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2192
|
+
# change][1].
|
|
2193
|
+
#
|
|
2043
2194
|
# Returns information about a specific import.
|
|
2044
2195
|
#
|
|
2196
|
+
#
|
|
2197
|
+
#
|
|
2198
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2199
|
+
#
|
|
2045
2200
|
# @option params [required, String] :import_id
|
|
2046
2201
|
# The ID for the import.
|
|
2047
2202
|
#
|
|
@@ -2172,9 +2327,19 @@ module Aws::CloudTrail
|
|
|
2172
2327
|
req.send_request(options)
|
|
2173
2328
|
end
|
|
2174
2329
|
|
|
2330
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2331
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2332
|
+
# that date. Existing customers can continue to use the service as
|
|
2333
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2334
|
+
# change][1].
|
|
2335
|
+
#
|
|
2175
2336
|
# Gets event data results of a query. You must specify the `QueryID`
|
|
2176
2337
|
# value returned by the `StartQuery` operation.
|
|
2177
2338
|
#
|
|
2339
|
+
#
|
|
2340
|
+
#
|
|
2341
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2342
|
+
#
|
|
2178
2343
|
# @option params [String] :event_data_store
|
|
2179
2344
|
# The ARN (or ID suffix of the ARN) of the event data store against
|
|
2180
2345
|
# which the query was run.
|
|
@@ -2310,6 +2475,7 @@ module Aws::CloudTrail
|
|
|
2310
2475
|
# resp.trail.has_custom_event_selectors #=> Boolean
|
|
2311
2476
|
# resp.trail.has_insight_selectors #=> Boolean
|
|
2312
2477
|
# resp.trail.is_organization_trail #=> Boolean
|
|
2478
|
+
# resp.trail.recursive_logging #=> Boolean
|
|
2313
2479
|
#
|
|
2314
2480
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetTrail AWS API Documentation
|
|
2315
2481
|
#
|
|
@@ -2396,8 +2562,18 @@ module Aws::CloudTrail
|
|
|
2396
2562
|
req.send_request(options)
|
|
2397
2563
|
end
|
|
2398
2564
|
|
|
2565
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2566
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2567
|
+
# that date. Existing customers can continue to use the service as
|
|
2568
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2569
|
+
# change][1].
|
|
2570
|
+
#
|
|
2399
2571
|
# Lists the channels in the current account, and their source names.
|
|
2400
2572
|
#
|
|
2573
|
+
#
|
|
2574
|
+
#
|
|
2575
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2576
|
+
#
|
|
2401
2577
|
# @option params [Integer] :max_results
|
|
2402
2578
|
# The maximum number of CloudTrail channels to display on a single page.
|
|
2403
2579
|
#
|
|
@@ -2438,9 +2614,19 @@ module Aws::CloudTrail
|
|
|
2438
2614
|
req.send_request(options)
|
|
2439
2615
|
end
|
|
2440
2616
|
|
|
2617
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2618
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2619
|
+
# that date. Existing customers can continue to use the service as
|
|
2620
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2621
|
+
# change][1].
|
|
2622
|
+
#
|
|
2441
2623
|
# Returns information about all dashboards in the account, in the
|
|
2442
2624
|
# current Region.
|
|
2443
2625
|
#
|
|
2626
|
+
#
|
|
2627
|
+
#
|
|
2628
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2629
|
+
#
|
|
2444
2630
|
# @option params [String] :name_prefix
|
|
2445
2631
|
# Specify a name prefix to filter on.
|
|
2446
2632
|
#
|
|
@@ -2483,9 +2669,19 @@ module Aws::CloudTrail
|
|
|
2483
2669
|
req.send_request(options)
|
|
2484
2670
|
end
|
|
2485
2671
|
|
|
2672
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2673
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2674
|
+
# that date. Existing customers can continue to use the service as
|
|
2675
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2676
|
+
# change][1].
|
|
2677
|
+
#
|
|
2486
2678
|
# Returns information about all event data stores in the account, in the
|
|
2487
2679
|
# current Region.
|
|
2488
2680
|
#
|
|
2681
|
+
#
|
|
2682
|
+
#
|
|
2683
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2684
|
+
#
|
|
2489
2685
|
# @option params [String] :next_token
|
|
2490
2686
|
# A token you can use to get the next page of event data store results.
|
|
2491
2687
|
#
|
|
@@ -2545,8 +2741,18 @@ module Aws::CloudTrail
|
|
|
2545
2741
|
req.send_request(options)
|
|
2546
2742
|
end
|
|
2547
2743
|
|
|
2744
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2745
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2746
|
+
# that date. Existing customers can continue to use the service as
|
|
2747
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2748
|
+
# change][1].
|
|
2749
|
+
#
|
|
2548
2750
|
# Returns a list of failures for the specified import.
|
|
2549
2751
|
#
|
|
2752
|
+
#
|
|
2753
|
+
#
|
|
2754
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2755
|
+
#
|
|
2550
2756
|
# @option params [required, String] :import_id
|
|
2551
2757
|
# The ID of the import.
|
|
2552
2758
|
#
|
|
@@ -2590,9 +2796,19 @@ module Aws::CloudTrail
|
|
|
2590
2796
|
req.send_request(options)
|
|
2591
2797
|
end
|
|
2592
2798
|
|
|
2799
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
2800
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
2801
|
+
# that date. Existing customers can continue to use the service as
|
|
2802
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
2803
|
+
# change][1].
|
|
2804
|
+
#
|
|
2593
2805
|
# Returns information on all imports, or a select set of imports by
|
|
2594
2806
|
# `ImportStatus` or `Destination`.
|
|
2595
2807
|
#
|
|
2808
|
+
#
|
|
2809
|
+
#
|
|
2810
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
2811
|
+
#
|
|
2596
2812
|
# @option params [Integer] :max_results
|
|
2597
2813
|
# The maximum number of imports to display on a single page.
|
|
2598
2814
|
#
|
|
@@ -2662,6 +2878,14 @@ module Aws::CloudTrail
|
|
|
2662
2878
|
# per account, per Region. If this limit is exceeded, a throttling error
|
|
2663
2879
|
# occurs.
|
|
2664
2880
|
#
|
|
2881
|
+
# <note markdown="1"> For data event Insights on organization trails, only the management
|
|
2882
|
+
# account and delegated administrator accounts can call
|
|
2883
|
+
# `ListInsightsData`. For these callers, the API returns Insights events
|
|
2884
|
+
# only for the caller's own account. Member accounts cannot call this
|
|
2885
|
+
# API on organization trails.
|
|
2886
|
+
#
|
|
2887
|
+
# </note>
|
|
2888
|
+
#
|
|
2665
2889
|
# @option params [required, String] :insight_source
|
|
2666
2890
|
# The Amazon Resource Name(ARN) of the trail for which you want to
|
|
2667
2891
|
# retrieve Insights events.
|
|
@@ -2776,6 +3000,14 @@ module Aws::CloudTrail
|
|
|
2776
3000
|
# operation, you must have permissions to perform the
|
|
2777
3001
|
# `cloudtrail:LookupEvents` action.
|
|
2778
3002
|
#
|
|
3003
|
+
# <note markdown="1"> For data event Insights on organization trails, only the management
|
|
3004
|
+
# account and delegated administrator accounts can call
|
|
3005
|
+
# `ListInsightsMetricData`. For these callers, the API returns Insights
|
|
3006
|
+
# metrics only for the caller's own account. Member accounts cannot
|
|
3007
|
+
# call this API on organization trails.
|
|
3008
|
+
#
|
|
3009
|
+
# </note>
|
|
3010
|
+
#
|
|
2779
3011
|
# @option params [String] :trail_name
|
|
2780
3012
|
# The Amazon Resource Name(ARN) or name of the trail for which you want
|
|
2781
3013
|
# to retrieve Insights metrics data. This parameter should only be
|
|
@@ -2949,6 +3181,12 @@ module Aws::CloudTrail
|
|
|
2949
3181
|
req.send_request(options)
|
|
2950
3182
|
end
|
|
2951
3183
|
|
|
3184
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
3185
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
3186
|
+
# that date. Existing customers can continue to use the service as
|
|
3187
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
3188
|
+
# change][1].
|
|
3189
|
+
#
|
|
2952
3190
|
# Returns a list of queries and query statuses for the past seven days.
|
|
2953
3191
|
# You must specify an ARN value for `EventDataStore`. Optionally, to
|
|
2954
3192
|
# shorten the list of results, you can specify a time range, formatted
|
|
@@ -2956,6 +3194,10 @@ module Aws::CloudTrail
|
|
|
2956
3194
|
# `QueryStatus` value. Valid values for `QueryStatus` include `QUEUED`,
|
|
2957
3195
|
# `RUNNING`, `FINISHED`, `FAILED`, `TIMED_OUT`, or `CANCELLED`.
|
|
2958
3196
|
#
|
|
3197
|
+
#
|
|
3198
|
+
#
|
|
3199
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
3200
|
+
#
|
|
2959
3201
|
# @option params [required, String] :event_data_store
|
|
2960
3202
|
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
|
2961
3203
|
# queries were run.
|
|
@@ -3785,12 +4027,22 @@ module Aws::CloudTrail
|
|
|
3785
4027
|
req.send_request(options)
|
|
3786
4028
|
end
|
|
3787
4029
|
|
|
4030
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4031
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4032
|
+
# that date. Existing customers can continue to use the service as
|
|
4033
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4034
|
+
# change][1].
|
|
4035
|
+
#
|
|
3788
4036
|
# Restores a deleted event data store specified by `EventDataStore`,
|
|
3789
4037
|
# which accepts an event data store ARN. You can only restore a deleted
|
|
3790
4038
|
# event data store within the seven-day wait period after deletion.
|
|
3791
4039
|
# Restoring an event data store can take several minutes, depending on
|
|
3792
4040
|
# the size of the event data store.
|
|
3793
4041
|
#
|
|
4042
|
+
#
|
|
4043
|
+
#
|
|
4044
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4045
|
+
#
|
|
3794
4046
|
# @option params [required, String] :event_data_store
|
|
3795
4047
|
# The ARN (or the ID suffix of the ARN) of the event data store that you
|
|
3796
4048
|
# want to restore.
|
|
@@ -3855,10 +4107,20 @@ module Aws::CloudTrail
|
|
|
3855
4107
|
req.send_request(options)
|
|
3856
4108
|
end
|
|
3857
4109
|
|
|
4110
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4111
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4112
|
+
# that date. Existing customers can continue to use the service as
|
|
4113
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4114
|
+
# change][1].
|
|
4115
|
+
#
|
|
3858
4116
|
# Searches sample queries and returns a list of sample queries that are
|
|
3859
4117
|
# sorted by relevance. To search for sample queries, provide a natural
|
|
3860
4118
|
# language `SearchPhrase` in English.
|
|
3861
4119
|
#
|
|
4120
|
+
#
|
|
4121
|
+
#
|
|
4122
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4123
|
+
#
|
|
3862
4124
|
# @option params [required, String] :search_phrase
|
|
3863
4125
|
# The natural language phrase to use for the semantic search. The phrase
|
|
3864
4126
|
# must be in English. The length constraint is in characters, not words.
|
|
@@ -3902,6 +4164,12 @@ module Aws::CloudTrail
|
|
|
3902
4164
|
req.send_request(options)
|
|
3903
4165
|
end
|
|
3904
4166
|
|
|
4167
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4168
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4169
|
+
# that date. Existing customers can continue to use the service as
|
|
4170
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4171
|
+
# change][1].
|
|
4172
|
+
#
|
|
3905
4173
|
# Starts a refresh of the specified dashboard.
|
|
3906
4174
|
#
|
|
3907
4175
|
# Each time a dashboard is refreshed, CloudTrail runs queries to
|
|
@@ -3910,11 +4178,12 @@ module Aws::CloudTrail
|
|
|
3910
4178
|
# provide permissions, run the `PutResourcePolicy` operation to attach a
|
|
3911
4179
|
# resource-based policy to each event data store. For more information,
|
|
3912
4180
|
# see [Example: Allow CloudTrail to run queries to populate a
|
|
3913
|
-
# dashboard][
|
|
4181
|
+
# dashboard][2] in the *CloudTrail User Guide*.
|
|
3914
4182
|
#
|
|
3915
4183
|
#
|
|
3916
4184
|
#
|
|
3917
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
|
4185
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4186
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-eds-dashboard
|
|
3918
4187
|
#
|
|
3919
4188
|
# @option params [required, String] :dashboard_id
|
|
3920
4189
|
# The name or ARN of the dashboard.
|
|
@@ -3955,12 +4224,22 @@ module Aws::CloudTrail
|
|
|
3955
4224
|
req.send_request(options)
|
|
3956
4225
|
end
|
|
3957
4226
|
|
|
4227
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4228
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4229
|
+
# that date. Existing customers can continue to use the service as
|
|
4230
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4231
|
+
# change][1].
|
|
4232
|
+
#
|
|
3958
4233
|
# Starts the ingestion of live events on an event data store specified
|
|
3959
4234
|
# as either an ARN or the ID portion of the ARN. To start ingestion, the
|
|
3960
4235
|
# event data store `Status` must be `STOPPED_INGESTION` and the
|
|
3961
4236
|
# `eventCategory` must be `Management`, `Data`, `NetworkActivity`, or
|
|
3962
4237
|
# `ConfigurationItem`.
|
|
3963
4238
|
#
|
|
4239
|
+
#
|
|
4240
|
+
#
|
|
4241
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4242
|
+
#
|
|
3964
4243
|
# @option params [required, String] :event_data_store
|
|
3965
4244
|
# The ARN (or ID suffix of the ARN) of the event data store for which
|
|
3966
4245
|
# you want to start ingestion.
|
|
@@ -3982,6 +4261,12 @@ module Aws::CloudTrail
|
|
|
3982
4261
|
req.send_request(options)
|
|
3983
4262
|
end
|
|
3984
4263
|
|
|
4264
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4265
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4266
|
+
# that date. Existing customers can continue to use the service as
|
|
4267
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4268
|
+
# change][1].
|
|
4269
|
+
#
|
|
3985
4270
|
# Starts an import of logged trail events from a source S3 bucket to a
|
|
3986
4271
|
# destination event data store. By default, CloudTrail only imports
|
|
3987
4272
|
# events contained in the S3 bucket's `CloudTrail` prefix and the
|
|
@@ -3989,14 +4274,14 @@ module Aws::CloudTrail
|
|
|
3989
4274
|
# for other Amazon Web Services services. If you want to import
|
|
3990
4275
|
# CloudTrail events contained in another prefix, you must include the
|
|
3991
4276
|
# prefix in the `S3LocationUri`. For more considerations about importing
|
|
3992
|
-
# trail events, see [Considerations for copying trail events][
|
|
4277
|
+
# trail events, see [Considerations for copying trail events][2] in the
|
|
3993
4278
|
# *CloudTrail User Guide*.
|
|
3994
4279
|
#
|
|
3995
4280
|
# When you start a new import, the `Destinations` and `ImportSource`
|
|
3996
4281
|
# parameters are required. Before starting a new import, disable any
|
|
3997
4282
|
# access control lists (ACLs) attached to the source S3 bucket. For more
|
|
3998
4283
|
# information about disabling ACLs, see [Controlling ownership of
|
|
3999
|
-
# objects and disabling ACLs for your bucket][
|
|
4284
|
+
# objects and disabling ACLs for your bucket][3].
|
|
4000
4285
|
#
|
|
4001
4286
|
# When you retry an import, the `ImportID` parameter is required.
|
|
4002
4287
|
#
|
|
@@ -4008,8 +4293,9 @@ module Aws::CloudTrail
|
|
|
4008
4293
|
#
|
|
4009
4294
|
#
|
|
4010
4295
|
#
|
|
4011
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-
|
|
4012
|
-
# [2]: https://docs.aws.amazon.com/
|
|
4296
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4297
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-copy-trail-to-lake.html#cloudtrail-trail-copy-considerations
|
|
4298
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
|
4013
4299
|
#
|
|
4014
4300
|
# @option params [Array<String>] :destinations
|
|
4015
4301
|
# The ARN of the destination event data store. Use this parameter for a
|
|
@@ -4120,6 +4406,12 @@ module Aws::CloudTrail
|
|
|
4120
4406
|
req.send_request(options)
|
|
4121
4407
|
end
|
|
4122
4408
|
|
|
4409
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4410
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4411
|
+
# that date. Existing customers can continue to use the service as
|
|
4412
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4413
|
+
# change][1].
|
|
4414
|
+
#
|
|
4123
4415
|
# Starts a CloudTrail Lake query. Use the `QueryStatement` parameter to
|
|
4124
4416
|
# provide your SQL query, enclosed in single quotation marks. Use the
|
|
4125
4417
|
# optional `DeliveryS3Uri` parameter to deliver the query results to an
|
|
@@ -4130,6 +4422,10 @@ module Aws::CloudTrail
|
|
|
4130
4422
|
# release, the `QueryAlias` and `QueryParameters` parameters are used
|
|
4131
4423
|
# only for the queries that populate the CloudTrail Lake dashboards.
|
|
4132
4424
|
#
|
|
4425
|
+
#
|
|
4426
|
+
#
|
|
4427
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4428
|
+
#
|
|
4133
4429
|
# @option params [String] :query_statement
|
|
4134
4430
|
# The SQL code of your query.
|
|
4135
4431
|
#
|
|
@@ -4174,12 +4470,22 @@ module Aws::CloudTrail
|
|
|
4174
4470
|
req.send_request(options)
|
|
4175
4471
|
end
|
|
4176
4472
|
|
|
4473
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4474
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4475
|
+
# that date. Existing customers can continue to use the service as
|
|
4476
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4477
|
+
# change][1].
|
|
4478
|
+
#
|
|
4177
4479
|
# Stops the ingestion of live events on an event data store specified as
|
|
4178
4480
|
# either an ARN or the ID portion of the ARN. To stop ingestion, the
|
|
4179
4481
|
# event data store `Status` must be `ENABLED` and the `eventCategory`
|
|
4180
4482
|
# must be `Management`, `Data`, `NetworkActivity`, or
|
|
4181
4483
|
# `ConfigurationItem`.
|
|
4182
4484
|
#
|
|
4485
|
+
#
|
|
4486
|
+
#
|
|
4487
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4488
|
+
#
|
|
4183
4489
|
# @option params [required, String] :event_data_store
|
|
4184
4490
|
# The ARN (or ID suffix of the ARN) of the event data store for which
|
|
4185
4491
|
# you want to stop ingestion.
|
|
@@ -4201,8 +4507,18 @@ module Aws::CloudTrail
|
|
|
4201
4507
|
req.send_request(options)
|
|
4202
4508
|
end
|
|
4203
4509
|
|
|
4510
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4511
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4512
|
+
# that date. Existing customers can continue to use the service as
|
|
4513
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4514
|
+
# change][1].
|
|
4515
|
+
#
|
|
4204
4516
|
# Stops a specified import.
|
|
4205
4517
|
#
|
|
4518
|
+
#
|
|
4519
|
+
#
|
|
4520
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4521
|
+
#
|
|
4206
4522
|
# @option params [required, String] :import_id
|
|
4207
4523
|
# The ID of the import.
|
|
4208
4524
|
#
|
|
@@ -4286,8 +4602,18 @@ module Aws::CloudTrail
|
|
|
4286
4602
|
req.send_request(options)
|
|
4287
4603
|
end
|
|
4288
4604
|
|
|
4605
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4606
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4607
|
+
# that date. Existing customers can continue to use the service as
|
|
4608
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4609
|
+
# change][1].
|
|
4610
|
+
#
|
|
4289
4611
|
# Updates a channel specified by a required channel ARN or UUID.
|
|
4290
4612
|
#
|
|
4613
|
+
#
|
|
4614
|
+
#
|
|
4615
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4616
|
+
#
|
|
4291
4617
|
# @option params [required, String] :channel
|
|
4292
4618
|
# The ARN or ID (the ARN suffix) of the channel that you want to update.
|
|
4293
4619
|
#
|
|
@@ -4336,13 +4662,19 @@ module Aws::CloudTrail
|
|
|
4336
4662
|
req.send_request(options)
|
|
4337
4663
|
end
|
|
4338
4664
|
|
|
4665
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4666
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4667
|
+
# that date. Existing customers can continue to use the service as
|
|
4668
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4669
|
+
# change][1].
|
|
4670
|
+
#
|
|
4339
4671
|
# Updates the specified dashboard.
|
|
4340
4672
|
#
|
|
4341
4673
|
# To set a refresh schedule, CloudTrail must be granted permissions to
|
|
4342
4674
|
# run the `StartDashboardRefresh` operation to refresh the dashboard on
|
|
4343
4675
|
# your behalf. To provide permissions, run the `PutResourcePolicy`
|
|
4344
4676
|
# operation to attach a resource-based policy to the dashboard. For more
|
|
4345
|
-
# information, see [ Resource-based policy example for a dashboard][
|
|
4677
|
+
# information, see [ Resource-based policy example for a dashboard][2]
|
|
4346
4678
|
# in the *CloudTrail User Guide*.
|
|
4347
4679
|
#
|
|
4348
4680
|
# CloudTrail runs queries to populate the dashboard's widgets during a
|
|
@@ -4350,13 +4682,14 @@ module Aws::CloudTrail
|
|
|
4350
4682
|
# run the `StartQuery` operation on your behalf. To provide permissions,
|
|
4351
4683
|
# run the `PutResourcePolicy` operation to attach a resource-based
|
|
4352
4684
|
# policy to each event data store. For more information, see [Example:
|
|
4353
|
-
# Allow CloudTrail to run queries to populate a dashboard][
|
|
4685
|
+
# Allow CloudTrail to run queries to populate a dashboard][3] in the
|
|
4354
4686
|
# *CloudTrail User Guide*.
|
|
4355
4687
|
#
|
|
4356
4688
|
#
|
|
4357
4689
|
#
|
|
4358
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
|
4359
|
-
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-
|
|
4690
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4691
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-dashboards
|
|
4692
|
+
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/security_iam_resource-based-policy-examples.html#security_iam_resource-based-policy-examples-eds-dashboard
|
|
4360
4693
|
#
|
|
4361
4694
|
# @option params [required, String] :dashboard_id
|
|
4362
4695
|
# The name or ARN of the dashboard.
|
|
@@ -4444,6 +4777,12 @@ module Aws::CloudTrail
|
|
|
4444
4777
|
req.send_request(options)
|
|
4445
4778
|
end
|
|
4446
4779
|
|
|
4780
|
+
# CloudTrail Lake will no longer be open to new customers starting May
|
|
4781
|
+
# 31, 2026. If you would like to use CloudTrail Lake, sign up prior to
|
|
4782
|
+
# that date. Existing customers can continue to use the service as
|
|
4783
|
+
# normal. For more information, see [CloudTrail Lake availability
|
|
4784
|
+
# change][1].
|
|
4785
|
+
#
|
|
4447
4786
|
# Updates an event data store. The required `EventDataStore` value is an
|
|
4448
4787
|
# ARN or the ID portion of the ARN. Other parameters are optional, but
|
|
4449
4788
|
# at least one optional parameter must be specified, or CloudTrail
|
|
@@ -4456,7 +4795,7 @@ module Aws::CloudTrail
|
|
|
4456
4795
|
# For event data stores for CloudTrail events, `AdvancedEventSelectors`
|
|
4457
4796
|
# includes or excludes management, data, or network activity events in
|
|
4458
4797
|
# your event data store. For more information about
|
|
4459
|
-
# `AdvancedEventSelectors`, see [AdvancedEventSelectors][
|
|
4798
|
+
# `AdvancedEventSelectors`, see [AdvancedEventSelectors][2].
|
|
4460
4799
|
#
|
|
4461
4800
|
# For event data stores for CloudTrail Insights events, Config
|
|
4462
4801
|
# configuration items, Audit Manager evidence, or non-Amazon Web
|
|
@@ -4465,7 +4804,8 @@ module Aws::CloudTrail
|
|
|
4465
4804
|
#
|
|
4466
4805
|
#
|
|
4467
4806
|
#
|
|
4468
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/
|
|
4807
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-service-availability-change.html
|
|
4808
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html
|
|
4469
4809
|
#
|
|
4470
4810
|
# @option params [required, String] :event_data_store
|
|
4471
4811
|
# The ARN (or the ID suffix of the ARN) of the event data store that you
|
|
@@ -4724,7 +5064,10 @@ module Aws::CloudTrail
|
|
|
4724
5064
|
#
|
|
4725
5065
|
# @option params [Boolean] :include_global_service_events
|
|
4726
5066
|
# Specifies whether the trail is publishing events from global services
|
|
4727
|
-
# such as IAM to the log files.
|
|
5067
|
+
# such as IAM to the log files. Setting this value to `true` only
|
|
5068
|
+
# delivers global service events to the trail if the trail is
|
|
5069
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
5070
|
+
# Region (for example, us-east-1).
|
|
4728
5071
|
#
|
|
4729
5072
|
# @option params [Boolean] :is_multi_region_trail
|
|
4730
5073
|
# Specifies whether the trail applies only to the current Region or to
|
|
@@ -4807,6 +5150,13 @@ module Aws::CloudTrail
|
|
|
4807
5150
|
#
|
|
4808
5151
|
# </note>
|
|
4809
5152
|
#
|
|
5153
|
+
# @option params [Boolean] :recursive_logging
|
|
5154
|
+
# Specifies whether recursive logging is enabled for the trail. If you
|
|
5155
|
+
# set `RecursiveLogging` to `false`, CloudTrail suppresses events
|
|
5156
|
+
# generated by CloudTrail when it delivers log files to your trail's
|
|
5157
|
+
# destinations, including Amazon S3 and CloudWatch Logs. The default
|
|
5158
|
+
# value is `true`.
|
|
5159
|
+
#
|
|
4810
5160
|
# @return [Types::UpdateTrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
4811
5161
|
#
|
|
4812
5162
|
# * {Types::UpdateTrailResponse#name #name} => String
|
|
@@ -4822,6 +5172,7 @@ module Aws::CloudTrail
|
|
|
4822
5172
|
# * {Types::UpdateTrailResponse#cloud_watch_logs_role_arn #cloud_watch_logs_role_arn} => String
|
|
4823
5173
|
# * {Types::UpdateTrailResponse#kms_key_id #kms_key_id} => String
|
|
4824
5174
|
# * {Types::UpdateTrailResponse#is_organization_trail #is_organization_trail} => Boolean
|
|
5175
|
+
# * {Types::UpdateTrailResponse#recursive_logging #recursive_logging} => Boolean
|
|
4825
5176
|
#
|
|
4826
5177
|
# @example Request syntax with placeholder values
|
|
4827
5178
|
#
|
|
@@ -4837,6 +5188,7 @@ module Aws::CloudTrail
|
|
|
4837
5188
|
# cloud_watch_logs_role_arn: "String",
|
|
4838
5189
|
# kms_key_id: "String",
|
|
4839
5190
|
# is_organization_trail: false,
|
|
5191
|
+
# recursive_logging: false,
|
|
4840
5192
|
# })
|
|
4841
5193
|
#
|
|
4842
5194
|
# @example Response structure
|
|
@@ -4854,6 +5206,7 @@ module Aws::CloudTrail
|
|
|
4854
5206
|
# resp.cloud_watch_logs_role_arn #=> String
|
|
4855
5207
|
# resp.kms_key_id #=> String
|
|
4856
5208
|
# resp.is_organization_trail #=> Boolean
|
|
5209
|
+
# resp.recursive_logging #=> Boolean
|
|
4857
5210
|
#
|
|
4858
5211
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateTrail AWS API Documentation
|
|
4859
5212
|
#
|
|
@@ -4882,7 +5235,7 @@ module Aws::CloudTrail
|
|
|
4882
5235
|
tracer: tracer
|
|
4883
5236
|
)
|
|
4884
5237
|
context[:gem_name] = 'aws-sdk-cloudtrail'
|
|
4885
|
-
context[:gem_version] = '1.
|
|
5238
|
+
context[:gem_version] = '1.126.0'
|
|
4886
5239
|
Seahorse::Client::Request.new(handlers, context)
|
|
4887
5240
|
end
|
|
4888
5241
|
|
|
@@ -549,6 +549,7 @@ module Aws::CloudTrail
|
|
|
549
549
|
CreateTrailRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
|
|
550
550
|
CreateTrailRequest.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
|
|
551
551
|
CreateTrailRequest.add_member(:tags_list, Shapes::ShapeRef.new(shape: TagsList, location_name: "TagsList"))
|
|
552
|
+
CreateTrailRequest.add_member(:recursive_logging, Shapes::ShapeRef.new(shape: Boolean, location_name: "RecursiveLogging"))
|
|
552
553
|
CreateTrailRequest.struct_class = Types::CreateTrailRequest
|
|
553
554
|
|
|
554
555
|
CreateTrailResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
|
|
@@ -564,6 +565,7 @@ module Aws::CloudTrail
|
|
|
564
565
|
CreateTrailResponse.add_member(:cloud_watch_logs_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "CloudWatchLogsRoleArn"))
|
|
565
566
|
CreateTrailResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
|
|
566
567
|
CreateTrailResponse.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
|
|
568
|
+
CreateTrailResponse.add_member(:recursive_logging, Shapes::ShapeRef.new(shape: Boolean, location_name: "RecursiveLogging"))
|
|
567
569
|
CreateTrailResponse.struct_class = Types::CreateTrailResponse
|
|
568
570
|
|
|
569
571
|
DashboardDetail.add_member(:dashboard_arn, Shapes::ShapeRef.new(shape: DashboardArn, location_name: "DashboardArn"))
|
|
@@ -1432,6 +1434,7 @@ module Aws::CloudTrail
|
|
|
1432
1434
|
Trail.add_member(:has_custom_event_selectors, Shapes::ShapeRef.new(shape: Boolean, location_name: "HasCustomEventSelectors"))
|
|
1433
1435
|
Trail.add_member(:has_insight_selectors, Shapes::ShapeRef.new(shape: Boolean, location_name: "HasInsightSelectors"))
|
|
1434
1436
|
Trail.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
|
|
1437
|
+
Trail.add_member(:recursive_logging, Shapes::ShapeRef.new(shape: Boolean, location_name: "RecursiveLogging"))
|
|
1435
1438
|
Trail.struct_class = Types::Trail
|
|
1436
1439
|
|
|
1437
1440
|
TrailAlreadyExistsException.struct_class = Types::TrailAlreadyExistsException
|
|
@@ -1518,6 +1521,7 @@ module Aws::CloudTrail
|
|
|
1518
1521
|
UpdateTrailRequest.add_member(:cloud_watch_logs_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "CloudWatchLogsRoleArn"))
|
|
1519
1522
|
UpdateTrailRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
|
|
1520
1523
|
UpdateTrailRequest.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
|
|
1524
|
+
UpdateTrailRequest.add_member(:recursive_logging, Shapes::ShapeRef.new(shape: Boolean, location_name: "RecursiveLogging"))
|
|
1521
1525
|
UpdateTrailRequest.struct_class = Types::UpdateTrailRequest
|
|
1522
1526
|
|
|
1523
1527
|
UpdateTrailResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
|
|
@@ -1533,6 +1537,7 @@ module Aws::CloudTrail
|
|
|
1533
1537
|
UpdateTrailResponse.add_member(:cloud_watch_logs_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "CloudWatchLogsRoleArn"))
|
|
1534
1538
|
UpdateTrailResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
|
|
1535
1539
|
UpdateTrailResponse.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
|
|
1540
|
+
UpdateTrailResponse.add_member(:recursive_logging, Shapes::ShapeRef.new(shape: Boolean, location_name: "RecursiveLogging"))
|
|
1536
1541
|
UpdateTrailResponse.struct_class = Types::UpdateTrailResponse
|
|
1537
1542
|
|
|
1538
1543
|
ViewPropertiesMap.key = Shapes::ShapeRef.new(shape: ViewPropertiesKey)
|
|
@@ -2353,6 +2358,7 @@ module Aws::CloudTrail
|
|
|
2353
2358
|
o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
|
|
2354
2359
|
o.errors << Shapes::ShapeRef.new(shape: NotOrganizationMasterAccountException)
|
|
2355
2360
|
o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
|
|
2361
|
+
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
|
2356
2362
|
o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
|
|
2357
2363
|
end)
|
|
2358
2364
|
|
|
@@ -862,7 +862,10 @@ module Aws::CloudTrail
|
|
|
862
862
|
#
|
|
863
863
|
# @!attribute [rw] include_global_service_events
|
|
864
864
|
# Specifies whether the trail is publishing events from global
|
|
865
|
-
# services such as IAM to the log files.
|
|
865
|
+
# services such as IAM to the log files. Setting this value to `true`
|
|
866
|
+
# only delivers global service events to the trail if the trail is
|
|
867
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
868
|
+
# Region (for example, us-east-1).
|
|
866
869
|
# @return [Boolean]
|
|
867
870
|
#
|
|
868
871
|
# @!attribute [rw] is_multi_region_trail
|
|
@@ -942,6 +945,14 @@ module Aws::CloudTrail
|
|
|
942
945
|
# A list of tags.
|
|
943
946
|
# @return [Array<Types::Tag>]
|
|
944
947
|
#
|
|
948
|
+
# @!attribute [rw] recursive_logging
|
|
949
|
+
# Specifies whether recursive logging is enabled for the trail. If you
|
|
950
|
+
# set `RecursiveLogging` to `false`, CloudTrail suppresses events
|
|
951
|
+
# generated by CloudTrail when it delivers log files to your trail's
|
|
952
|
+
# destinations, including Amazon S3 and CloudWatch Logs. The default
|
|
953
|
+
# value is `true`.
|
|
954
|
+
# @return [Boolean]
|
|
955
|
+
#
|
|
945
956
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateTrailRequest AWS API Documentation
|
|
946
957
|
#
|
|
947
958
|
class CreateTrailRequest < Struct.new(
|
|
@@ -956,7 +967,8 @@ module Aws::CloudTrail
|
|
|
956
967
|
:cloud_watch_logs_role_arn,
|
|
957
968
|
:kms_key_id,
|
|
958
969
|
:is_organization_trail,
|
|
959
|
-
:tags_list
|
|
970
|
+
:tags_list,
|
|
971
|
+
:recursive_logging)
|
|
960
972
|
SENSITIVE = []
|
|
961
973
|
include Aws::Structure
|
|
962
974
|
end
|
|
@@ -997,7 +1009,10 @@ module Aws::CloudTrail
|
|
|
997
1009
|
#
|
|
998
1010
|
# @!attribute [rw] include_global_service_events
|
|
999
1011
|
# Specifies whether the trail is publishing events from global
|
|
1000
|
-
# services such as IAM to the log files.
|
|
1012
|
+
# services such as IAM to the log files. Setting this value to `true`
|
|
1013
|
+
# only delivers global service events to the trail if the trail is
|
|
1014
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
1015
|
+
# Region (for example, us-east-1).
|
|
1001
1016
|
# @return [Boolean]
|
|
1002
1017
|
#
|
|
1003
1018
|
# @!attribute [rw] is_multi_region_trail
|
|
@@ -1037,6 +1052,10 @@ module Aws::CloudTrail
|
|
|
1037
1052
|
# Specifies whether the trail is an organization trail.
|
|
1038
1053
|
# @return [Boolean]
|
|
1039
1054
|
#
|
|
1055
|
+
# @!attribute [rw] recursive_logging
|
|
1056
|
+
# Specifies whether recursive logging is enabled for the trail.
|
|
1057
|
+
# @return [Boolean]
|
|
1058
|
+
#
|
|
1040
1059
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateTrailResponse AWS API Documentation
|
|
1041
1060
|
#
|
|
1042
1061
|
class CreateTrailResponse < Struct.new(
|
|
@@ -1052,7 +1071,8 @@ module Aws::CloudTrail
|
|
|
1052
1071
|
:cloud_watch_logs_log_group_arn,
|
|
1053
1072
|
:cloud_watch_logs_role_arn,
|
|
1054
1073
|
:kms_key_id,
|
|
1055
|
-
:is_organization_trail
|
|
1074
|
+
:is_organization_trail,
|
|
1075
|
+
:recursive_logging)
|
|
1056
1076
|
SENSITIVE = []
|
|
1057
1077
|
include Aws::Structure
|
|
1058
1078
|
end
|
|
@@ -5486,6 +5506,9 @@ module Aws::CloudTrail
|
|
|
5486
5506
|
# @!attribute [rw] include_global_service_events
|
|
5487
5507
|
# Set to **True** to include Amazon Web Services API calls from Amazon
|
|
5488
5508
|
# Web Services global services such as IAM. Otherwise, **False**.
|
|
5509
|
+
# Setting this value to `true` only delivers global service events to
|
|
5510
|
+
# the trail if the trail is multi-Region or if the trail's home
|
|
5511
|
+
# Region is the partition leader Region (for example, us-east-1).
|
|
5489
5512
|
# @return [Boolean]
|
|
5490
5513
|
#
|
|
5491
5514
|
# @!attribute [rw] is_multi_region_trail
|
|
@@ -5539,6 +5562,14 @@ module Aws::CloudTrail
|
|
|
5539
5562
|
# Specifies whether the trail is an organization trail.
|
|
5540
5563
|
# @return [Boolean]
|
|
5541
5564
|
#
|
|
5565
|
+
# @!attribute [rw] recursive_logging
|
|
5566
|
+
# Specifies whether recursive logging is enabled for the trail. If you
|
|
5567
|
+
# set `RecursiveLogging` to `false`, CloudTrail suppresses events
|
|
5568
|
+
# generated by CloudTrail when it delivers log files to your trail's
|
|
5569
|
+
# destinations, including Amazon S3 and CloudWatch Logs. The default
|
|
5570
|
+
# value is `true`.
|
|
5571
|
+
# @return [Boolean]
|
|
5572
|
+
#
|
|
5542
5573
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Trail AWS API Documentation
|
|
5543
5574
|
#
|
|
5544
5575
|
class Trail < Struct.new(
|
|
@@ -5557,7 +5588,8 @@ module Aws::CloudTrail
|
|
|
5557
5588
|
:kms_key_id,
|
|
5558
5589
|
:has_custom_event_selectors,
|
|
5559
5590
|
:has_insight_selectors,
|
|
5560
|
-
:is_organization_trail
|
|
5591
|
+
:is_organization_trail,
|
|
5592
|
+
:recursive_logging)
|
|
5561
5593
|
SENSITIVE = []
|
|
5562
5594
|
include Aws::Structure
|
|
5563
5595
|
end
|
|
@@ -6040,7 +6072,10 @@ module Aws::CloudTrail
|
|
|
6040
6072
|
#
|
|
6041
6073
|
# @!attribute [rw] include_global_service_events
|
|
6042
6074
|
# Specifies whether the trail is publishing events from global
|
|
6043
|
-
# services such as IAM to the log files.
|
|
6075
|
+
# services such as IAM to the log files. Setting this value to `true`
|
|
6076
|
+
# only delivers global service events to the trail if the trail is
|
|
6077
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
6078
|
+
# Region (for example, us-east-1).
|
|
6044
6079
|
# @return [Boolean]
|
|
6045
6080
|
#
|
|
6046
6081
|
# @!attribute [rw] is_multi_region_trail
|
|
@@ -6131,6 +6166,14 @@ module Aws::CloudTrail
|
|
|
6131
6166
|
# </note>
|
|
6132
6167
|
# @return [Boolean]
|
|
6133
6168
|
#
|
|
6169
|
+
# @!attribute [rw] recursive_logging
|
|
6170
|
+
# Specifies whether recursive logging is enabled for the trail. If you
|
|
6171
|
+
# set `RecursiveLogging` to `false`, CloudTrail suppresses events
|
|
6172
|
+
# generated by CloudTrail when it delivers log files to your trail's
|
|
6173
|
+
# destinations, including Amazon S3 and CloudWatch Logs. The default
|
|
6174
|
+
# value is `true`.
|
|
6175
|
+
# @return [Boolean]
|
|
6176
|
+
#
|
|
6134
6177
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateTrailRequest AWS API Documentation
|
|
6135
6178
|
#
|
|
6136
6179
|
class UpdateTrailRequest < Struct.new(
|
|
@@ -6144,7 +6187,8 @@ module Aws::CloudTrail
|
|
|
6144
6187
|
:cloud_watch_logs_log_group_arn,
|
|
6145
6188
|
:cloud_watch_logs_role_arn,
|
|
6146
6189
|
:kms_key_id,
|
|
6147
|
-
:is_organization_trail
|
|
6190
|
+
:is_organization_trail,
|
|
6191
|
+
:recursive_logging)
|
|
6148
6192
|
SENSITIVE = []
|
|
6149
6193
|
include Aws::Structure
|
|
6150
6194
|
end
|
|
@@ -6185,7 +6229,10 @@ module Aws::CloudTrail
|
|
|
6185
6229
|
#
|
|
6186
6230
|
# @!attribute [rw] include_global_service_events
|
|
6187
6231
|
# Specifies whether the trail is publishing events from global
|
|
6188
|
-
# services such as IAM to the log files.
|
|
6232
|
+
# services such as IAM to the log files. Setting this value to `true`
|
|
6233
|
+
# only delivers global service events to the trail if the trail is
|
|
6234
|
+
# multi-Region or if the trail's home Region is the partition leader
|
|
6235
|
+
# Region (for example, us-east-1).
|
|
6189
6236
|
# @return [Boolean]
|
|
6190
6237
|
#
|
|
6191
6238
|
# @!attribute [rw] is_multi_region_trail
|
|
@@ -6225,6 +6272,10 @@ module Aws::CloudTrail
|
|
|
6225
6272
|
# Specifies whether the trail is an organization trail.
|
|
6226
6273
|
# @return [Boolean]
|
|
6227
6274
|
#
|
|
6275
|
+
# @!attribute [rw] recursive_logging
|
|
6276
|
+
# Specifies whether recursive logging is enabled for the trail.
|
|
6277
|
+
# @return [Boolean]
|
|
6278
|
+
#
|
|
6228
6279
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateTrailResponse AWS API Documentation
|
|
6229
6280
|
#
|
|
6230
6281
|
class UpdateTrailResponse < Struct.new(
|
|
@@ -6240,7 +6291,8 @@ module Aws::CloudTrail
|
|
|
6240
6291
|
:cloud_watch_logs_log_group_arn,
|
|
6241
6292
|
:cloud_watch_logs_role_arn,
|
|
6242
6293
|
:kms_key_id,
|
|
6243
|
-
:is_organization_trail
|
|
6294
|
+
:is_organization_trail,
|
|
6295
|
+
:recursive_logging)
|
|
6244
6296
|
SENSITIVE = []
|
|
6245
6297
|
include Aws::Structure
|
|
6246
6298
|
end
|
data/lib/aws-sdk-cloudtrail.rb
CHANGED
data/sig/client.rbs
CHANGED
|
@@ -219,6 +219,7 @@ module Aws
|
|
|
219
219
|
def cloud_watch_logs_role_arn: () -> ::String
|
|
220
220
|
def kms_key_id: () -> ::String
|
|
221
221
|
def is_organization_trail: () -> bool
|
|
222
|
+
def recursive_logging: () -> bool
|
|
222
223
|
end
|
|
223
224
|
# https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudTrail/Client.html#create_trail-instance_method
|
|
224
225
|
def create_trail: (
|
|
@@ -238,7 +239,8 @@ module Aws
|
|
|
238
239
|
key: ::String,
|
|
239
240
|
value: ::String?
|
|
240
241
|
}
|
|
241
|
-
]
|
|
242
|
+
],
|
|
243
|
+
?recursive_logging: bool
|
|
242
244
|
) -> _CreateTrailResponseSuccess
|
|
243
245
|
| (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateTrailResponseSuccess
|
|
244
246
|
|
|
@@ -1080,6 +1082,7 @@ module Aws
|
|
|
1080
1082
|
def cloud_watch_logs_role_arn: () -> ::String
|
|
1081
1083
|
def kms_key_id: () -> ::String
|
|
1082
1084
|
def is_organization_trail: () -> bool
|
|
1085
|
+
def recursive_logging: () -> bool
|
|
1083
1086
|
end
|
|
1084
1087
|
# https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudTrail/Client.html#update_trail-instance_method
|
|
1085
1088
|
def update_trail: (
|
|
@@ -1093,7 +1096,8 @@ module Aws
|
|
|
1093
1096
|
?cloud_watch_logs_log_group_arn: ::String,
|
|
1094
1097
|
?cloud_watch_logs_role_arn: ::String,
|
|
1095
1098
|
?kms_key_id: ::String,
|
|
1096
|
-
?is_organization_trail: bool
|
|
1099
|
+
?is_organization_trail: bool,
|
|
1100
|
+
?recursive_logging: bool
|
|
1097
1101
|
) -> _UpdateTrailResponseSuccess
|
|
1098
1102
|
| (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateTrailResponseSuccess
|
|
1099
1103
|
end
|
data/sig/types.rbs
CHANGED
|
@@ -198,6 +198,7 @@ module Aws::CloudTrail
|
|
|
198
198
|
attr_accessor kms_key_id: ::String
|
|
199
199
|
attr_accessor is_organization_trail: bool
|
|
200
200
|
attr_accessor tags_list: ::Array[Types::Tag]
|
|
201
|
+
attr_accessor recursive_logging: bool
|
|
201
202
|
SENSITIVE: []
|
|
202
203
|
end
|
|
203
204
|
|
|
@@ -215,6 +216,7 @@ module Aws::CloudTrail
|
|
|
215
216
|
attr_accessor cloud_watch_logs_role_arn: ::String
|
|
216
217
|
attr_accessor kms_key_id: ::String
|
|
217
218
|
attr_accessor is_organization_trail: bool
|
|
219
|
+
attr_accessor recursive_logging: bool
|
|
218
220
|
SENSITIVE: []
|
|
219
221
|
end
|
|
220
222
|
|
|
@@ -1319,6 +1321,7 @@ module Aws::CloudTrail
|
|
|
1319
1321
|
attr_accessor has_custom_event_selectors: bool
|
|
1320
1322
|
attr_accessor has_insight_selectors: bool
|
|
1321
1323
|
attr_accessor is_organization_trail: bool
|
|
1324
|
+
attr_accessor recursive_logging: bool
|
|
1322
1325
|
SENSITIVE: []
|
|
1323
1326
|
end
|
|
1324
1327
|
|
|
@@ -1419,6 +1422,7 @@ module Aws::CloudTrail
|
|
|
1419
1422
|
attr_accessor cloud_watch_logs_role_arn: ::String
|
|
1420
1423
|
attr_accessor kms_key_id: ::String
|
|
1421
1424
|
attr_accessor is_organization_trail: bool
|
|
1425
|
+
attr_accessor recursive_logging: bool
|
|
1422
1426
|
SENSITIVE: []
|
|
1423
1427
|
end
|
|
1424
1428
|
|
|
@@ -1436,6 +1440,7 @@ module Aws::CloudTrail
|
|
|
1436
1440
|
attr_accessor cloud_watch_logs_role_arn: ::String
|
|
1437
1441
|
attr_accessor kms_key_id: ::String
|
|
1438
1442
|
attr_accessor is_organization_trail: bool
|
|
1443
|
+
attr_accessor recursive_logging: bool
|
|
1439
1444
|
SENSITIVE: []
|
|
1440
1445
|
end
|
|
1441
1446
|
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: aws-sdk-cloudtrail
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.126.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Amazon Web Services
|
|
@@ -18,7 +18,7 @@ dependencies:
|
|
|
18
18
|
version: '3'
|
|
19
19
|
- - ">="
|
|
20
20
|
- !ruby/object:Gem::Version
|
|
21
|
-
version: 3.
|
|
21
|
+
version: 3.254.0
|
|
22
22
|
type: :runtime
|
|
23
23
|
prerelease: false
|
|
24
24
|
version_requirements: !ruby/object:Gem::Requirement
|
|
@@ -28,7 +28,7 @@ dependencies:
|
|
|
28
28
|
version: '3'
|
|
29
29
|
- - ">="
|
|
30
30
|
- !ruby/object:Gem::Version
|
|
31
|
-
version: 3.
|
|
31
|
+
version: 3.254.0
|
|
32
32
|
- !ruby/object:Gem::Dependency
|
|
33
33
|
name: aws-sigv4
|
|
34
34
|
requirement: !ruby/object:Gem::Requirement
|