aws-sdk-cloudtrail 1.41.0 → 1.45.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 +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudtrail/client.rb +728 -18
- data/lib/aws-sdk-cloudtrail/client_api.rb +478 -4
- data/lib/aws-sdk-cloudtrail/errors.rb +154 -0
- data/lib/aws-sdk-cloudtrail/types.rb +1106 -32
- data/lib/aws-sdk-cloudtrail.rb +1 -1
- metadata +4 -4
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
|
27
27
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
28
28
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
29
29
|
require 'aws-sdk-core/plugins/http_checksum.rb'
|
30
|
+
require 'aws-sdk-core/plugins/defaults_mode.rb'
|
30
31
|
require 'aws-sdk-core/plugins/signature_v4.rb'
|
31
32
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
32
33
|
|
@@ -73,6 +74,7 @@ module Aws::CloudTrail
|
|
73
74
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
74
75
|
add_plugin(Aws::Plugins::TransferEncoding)
|
75
76
|
add_plugin(Aws::Plugins::HttpChecksum)
|
77
|
+
add_plugin(Aws::Plugins::DefaultsMode)
|
76
78
|
add_plugin(Aws::Plugins::SignatureV4)
|
77
79
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
78
80
|
|
@@ -119,7 +121,9 @@ module Aws::CloudTrail
|
|
119
121
|
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
120
122
|
# are very aggressive. Construct and pass an instance of
|
121
123
|
# `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
|
122
|
-
# enable retries and extended timeouts.
|
124
|
+
# enable retries and extended timeouts. Instance profile credential
|
125
|
+
# fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
|
126
|
+
# to true.
|
123
127
|
#
|
124
128
|
# @option options [required, String] :region
|
125
129
|
# The AWS region to connect to. The configured `:region` is
|
@@ -173,6 +177,10 @@ module Aws::CloudTrail
|
|
173
177
|
# Used only in `standard` and adaptive retry modes. Specifies whether to apply
|
174
178
|
# a clock skew correction and retry requests with skewed client clocks.
|
175
179
|
#
|
180
|
+
# @option options [String] :defaults_mode ("legacy")
|
181
|
+
# See {Aws::DefaultsModeConfiguration} for a list of the
|
182
|
+
# accepted modes and the configuration defaults that are included.
|
183
|
+
#
|
176
184
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
177
185
|
# Set to true to disable SDK automatically adding host prefix
|
178
186
|
# to default service endpoint when available.
|
@@ -305,7 +313,7 @@ module Aws::CloudTrail
|
|
305
313
|
# seconds to wait when opening a HTTP session before raising a
|
306
314
|
# `Timeout::Error`.
|
307
315
|
#
|
308
|
-
# @option options [
|
316
|
+
# @option options [Float] :http_read_timeout (60) The default
|
309
317
|
# number of seconds to wait for response data. This value can
|
310
318
|
# safely be set per-request on the session.
|
311
319
|
#
|
@@ -321,6 +329,9 @@ module Aws::CloudTrail
|
|
321
329
|
# disables this behaviour. This value can safely be set per
|
322
330
|
# request on the session.
|
323
331
|
#
|
332
|
+
# @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
|
333
|
+
# in seconds.
|
334
|
+
#
|
324
335
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
325
336
|
# HTTP debug output will be sent to the `:logger`.
|
326
337
|
#
|
@@ -361,7 +372,7 @@ module Aws::CloudTrail
|
|
361
372
|
#
|
362
373
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
363
374
|
#
|
364
|
-
# @option params [Array<Types::Tag>] :tags_list
|
375
|
+
# @option params [required, Array<Types::Tag>] :tags_list
|
365
376
|
# Contains a list of tags, up to a limit of 50
|
366
377
|
#
|
367
378
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
@@ -370,10 +381,10 @@ module Aws::CloudTrail
|
|
370
381
|
#
|
371
382
|
# resp = client.add_tags({
|
372
383
|
# resource_id: "String", # required
|
373
|
-
# tags_list: [
|
384
|
+
# tags_list: [ # required
|
374
385
|
# {
|
375
|
-
# key: "
|
376
|
-
# value: "
|
386
|
+
# key: "TagKey", # required
|
387
|
+
# value: "TagValue",
|
377
388
|
# },
|
378
389
|
# ],
|
379
390
|
# })
|
@@ -387,6 +398,168 @@ module Aws::CloudTrail
|
|
387
398
|
req.send_request(options)
|
388
399
|
end
|
389
400
|
|
401
|
+
# Cancels a query if the query is not in a terminated state, such as
|
402
|
+
# `CANCELLED`, `FAILED` or `FINISHED`. You must specify an ARN value for
|
403
|
+
# `EventDataStore`. The ID of the query that you want to cancel is also
|
404
|
+
# required. When you run `CancelQuery`, the query status might show as
|
405
|
+
# `CANCELLED` even if the operation is not yet finished.
|
406
|
+
#
|
407
|
+
# @option params [required, String] :event_data_store
|
408
|
+
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
409
|
+
# the specified query is running.
|
410
|
+
#
|
411
|
+
# @option params [required, String] :query_id
|
412
|
+
# The ID of the query that you want to cancel. The `QueryId` comes from
|
413
|
+
# the response of a `StartQuery` operation.
|
414
|
+
#
|
415
|
+
# @return [Types::CancelQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
416
|
+
#
|
417
|
+
# * {Types::CancelQueryResponse#query_id #query_id} => String
|
418
|
+
# * {Types::CancelQueryResponse#query_status #query_status} => String
|
419
|
+
#
|
420
|
+
# @example Request syntax with placeholder values
|
421
|
+
#
|
422
|
+
# resp = client.cancel_query({
|
423
|
+
# event_data_store: "EventDataStoreArn", # required
|
424
|
+
# query_id: "UUID", # required
|
425
|
+
# })
|
426
|
+
#
|
427
|
+
# @example Response structure
|
428
|
+
#
|
429
|
+
# resp.query_id #=> String
|
430
|
+
# resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
|
431
|
+
#
|
432
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CancelQuery AWS API Documentation
|
433
|
+
#
|
434
|
+
# @overload cancel_query(params = {})
|
435
|
+
# @param [Hash] params ({})
|
436
|
+
def cancel_query(params = {}, options = {})
|
437
|
+
req = build_request(:cancel_query, params)
|
438
|
+
req.send_request(options)
|
439
|
+
end
|
440
|
+
|
441
|
+
# Creates a new event data store.
|
442
|
+
#
|
443
|
+
# @option params [required, String] :name
|
444
|
+
# The name of the event data store.
|
445
|
+
#
|
446
|
+
# @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
|
447
|
+
# The advanced event selectors to use to select the events for the data
|
448
|
+
# store. For more information about how to use advanced event selectors,
|
449
|
+
# see [Log events by using advanced event selectors][1] in the
|
450
|
+
# CloudTrail User Guide.
|
451
|
+
#
|
452
|
+
#
|
453
|
+
#
|
454
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-advanced
|
455
|
+
#
|
456
|
+
# @option params [Boolean] :multi_region_enabled
|
457
|
+
# Specifies whether the event data store includes events from all
|
458
|
+
# regions, or only from the region in which the event data store is
|
459
|
+
# created.
|
460
|
+
#
|
461
|
+
# @option params [Boolean] :organization_enabled
|
462
|
+
# Specifies whether an event data store collects events logged for an
|
463
|
+
# organization in Organizations.
|
464
|
+
#
|
465
|
+
# @option params [Integer] :retention_period
|
466
|
+
# The retention period of the event data store, in days. You can set a
|
467
|
+
# retention period of up to 2555 days, the equivalent of seven years.
|
468
|
+
#
|
469
|
+
# @option params [Boolean] :termination_protection_enabled
|
470
|
+
# Specifies whether termination protection is enabled for the event data
|
471
|
+
# store. If termination protection is enabled, you cannot delete the
|
472
|
+
# event data store until termination protection is disabled.
|
473
|
+
#
|
474
|
+
# @option params [Array<Types::Tag>] :tags_list
|
475
|
+
# A list of tags.
|
476
|
+
#
|
477
|
+
# @return [Types::CreateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
478
|
+
#
|
479
|
+
# * {Types::CreateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
|
480
|
+
# * {Types::CreateEventDataStoreResponse#name #name} => String
|
481
|
+
# * {Types::CreateEventDataStoreResponse#status #status} => String
|
482
|
+
# * {Types::CreateEventDataStoreResponse#advanced_event_selectors #advanced_event_selectors} => Array<Types::AdvancedEventSelector>
|
483
|
+
# * {Types::CreateEventDataStoreResponse#multi_region_enabled #multi_region_enabled} => Boolean
|
484
|
+
# * {Types::CreateEventDataStoreResponse#organization_enabled #organization_enabled} => Boolean
|
485
|
+
# * {Types::CreateEventDataStoreResponse#retention_period #retention_period} => Integer
|
486
|
+
# * {Types::CreateEventDataStoreResponse#termination_protection_enabled #termination_protection_enabled} => Boolean
|
487
|
+
# * {Types::CreateEventDataStoreResponse#tags_list #tags_list} => Array<Types::Tag>
|
488
|
+
# * {Types::CreateEventDataStoreResponse#created_timestamp #created_timestamp} => Time
|
489
|
+
# * {Types::CreateEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
|
490
|
+
#
|
491
|
+
# @example Request syntax with placeholder values
|
492
|
+
#
|
493
|
+
# resp = client.create_event_data_store({
|
494
|
+
# name: "EventDataStoreName", # required
|
495
|
+
# advanced_event_selectors: [
|
496
|
+
# {
|
497
|
+
# name: "SelectorName",
|
498
|
+
# field_selectors: [ # required
|
499
|
+
# {
|
500
|
+
# field: "SelectorField", # required
|
501
|
+
# equals: ["OperatorValue"],
|
502
|
+
# starts_with: ["OperatorValue"],
|
503
|
+
# ends_with: ["OperatorValue"],
|
504
|
+
# not_equals: ["OperatorValue"],
|
505
|
+
# not_starts_with: ["OperatorValue"],
|
506
|
+
# not_ends_with: ["OperatorValue"],
|
507
|
+
# },
|
508
|
+
# ],
|
509
|
+
# },
|
510
|
+
# ],
|
511
|
+
# multi_region_enabled: false,
|
512
|
+
# organization_enabled: false,
|
513
|
+
# retention_period: 1,
|
514
|
+
# termination_protection_enabled: false,
|
515
|
+
# tags_list: [
|
516
|
+
# {
|
517
|
+
# key: "TagKey", # required
|
518
|
+
# value: "TagValue",
|
519
|
+
# },
|
520
|
+
# ],
|
521
|
+
# })
|
522
|
+
#
|
523
|
+
# @example Response structure
|
524
|
+
#
|
525
|
+
# resp.event_data_store_arn #=> String
|
526
|
+
# resp.name #=> String
|
527
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
528
|
+
# resp.advanced_event_selectors #=> Array
|
529
|
+
# resp.advanced_event_selectors[0].name #=> String
|
530
|
+
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
531
|
+
# resp.advanced_event_selectors[0].field_selectors[0].field #=> String
|
532
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals #=> Array
|
533
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
|
534
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
|
535
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
|
536
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
|
537
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
|
538
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
|
539
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
|
540
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
|
541
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
|
542
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
|
543
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
|
544
|
+
# resp.multi_region_enabled #=> Boolean
|
545
|
+
# resp.organization_enabled #=> Boolean
|
546
|
+
# resp.retention_period #=> Integer
|
547
|
+
# resp.termination_protection_enabled #=> Boolean
|
548
|
+
# resp.tags_list #=> Array
|
549
|
+
# resp.tags_list[0].key #=> String
|
550
|
+
# resp.tags_list[0].value #=> String
|
551
|
+
# resp.created_timestamp #=> Time
|
552
|
+
# resp.updated_timestamp #=> Time
|
553
|
+
#
|
554
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStore AWS API Documentation
|
555
|
+
#
|
556
|
+
# @overload create_event_data_store(params = {})
|
557
|
+
# @param [Hash] params ({})
|
558
|
+
def create_event_data_store(params = {}, options = {})
|
559
|
+
req = build_request(:create_event_data_store, params)
|
560
|
+
req.send_request(options)
|
561
|
+
end
|
562
|
+
|
390
563
|
# Creates a trail that specifies the settings for delivery of log data
|
391
564
|
# to an Amazon S3 bucket.
|
392
565
|
#
|
@@ -530,8 +703,8 @@ module Aws::CloudTrail
|
|
530
703
|
# is_organization_trail: false,
|
531
704
|
# tags_list: [
|
532
705
|
# {
|
533
|
-
# key: "
|
534
|
-
# value: "
|
706
|
+
# key: "TagKey", # required
|
707
|
+
# value: "TagValue",
|
535
708
|
# },
|
536
709
|
# ],
|
537
710
|
# })
|
@@ -561,6 +734,41 @@ module Aws::CloudTrail
|
|
561
734
|
req.send_request(options)
|
562
735
|
end
|
563
736
|
|
737
|
+
# Disables the event data store specified by `EventDataStore`, which
|
738
|
+
# accepts an event data store ARN. After you run `DeleteEventDataStore`,
|
739
|
+
# the event data store enters a `PENDING_DELETION` state, and is
|
740
|
+
# automatically deleted after a wait period of seven days.
|
741
|
+
# `TerminationProtectionEnabled` must be set to `False` on the event
|
742
|
+
# data store; this operation cannot work if
|
743
|
+
# `TerminationProtectionEnabled` is `True`.
|
744
|
+
#
|
745
|
+
# After you run `DeleteEventDataStore` on an event data store, you
|
746
|
+
# cannot run `ListQueries`, `DescribeQuery`, or `GetQueryResults` on
|
747
|
+
# queries that are using an event data store in a `PENDING_DELETION`
|
748
|
+
# state. An event data store in the `PENDING_DELETION` state does not
|
749
|
+
# incur costs.
|
750
|
+
#
|
751
|
+
# @option params [required, String] :event_data_store
|
752
|
+
# The ARN (or the ID suffix of the ARN) of the event data store to
|
753
|
+
# delete.
|
754
|
+
#
|
755
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
756
|
+
#
|
757
|
+
# @example Request syntax with placeholder values
|
758
|
+
#
|
759
|
+
# resp = client.delete_event_data_store({
|
760
|
+
# event_data_store: "EventDataStoreArn", # required
|
761
|
+
# })
|
762
|
+
#
|
763
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DeleteEventDataStore AWS API Documentation
|
764
|
+
#
|
765
|
+
# @overload delete_event_data_store(params = {})
|
766
|
+
# @param [Hash] params ({})
|
767
|
+
def delete_event_data_store(params = {}, options = {})
|
768
|
+
req = build_request(:delete_event_data_store, params)
|
769
|
+
req.send_request(options)
|
770
|
+
end
|
771
|
+
|
564
772
|
# Deletes a trail. This operation must be called from the region in
|
565
773
|
# which the trail was created. `DeleteTrail` cannot be called on the
|
566
774
|
# shadow trails (replicated trails in other regions) of a trail that is
|
@@ -588,6 +796,53 @@ module Aws::CloudTrail
|
|
588
796
|
req.send_request(options)
|
589
797
|
end
|
590
798
|
|
799
|
+
# Returns metadata about a query, including query run time in
|
800
|
+
# milliseconds, number of events scanned and matched, and query status.
|
801
|
+
# You must specify an ARN for `EventDataStore`, and a value for
|
802
|
+
# `QueryID`.
|
803
|
+
#
|
804
|
+
# @option params [required, String] :event_data_store
|
805
|
+
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
806
|
+
# the specified query was run.
|
807
|
+
#
|
808
|
+
# @option params [required, String] :query_id
|
809
|
+
# The query ID.
|
810
|
+
#
|
811
|
+
# @return [Types::DescribeQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
812
|
+
#
|
813
|
+
# * {Types::DescribeQueryResponse#query_id #query_id} => String
|
814
|
+
# * {Types::DescribeQueryResponse#query_string #query_string} => String
|
815
|
+
# * {Types::DescribeQueryResponse#query_status #query_status} => String
|
816
|
+
# * {Types::DescribeQueryResponse#query_statistics #query_statistics} => Types::QueryStatisticsForDescribeQuery
|
817
|
+
# * {Types::DescribeQueryResponse#error_message #error_message} => String
|
818
|
+
#
|
819
|
+
# @example Request syntax with placeholder values
|
820
|
+
#
|
821
|
+
# resp = client.describe_query({
|
822
|
+
# event_data_store: "EventDataStoreArn", # required
|
823
|
+
# query_id: "UUID", # required
|
824
|
+
# })
|
825
|
+
#
|
826
|
+
# @example Response structure
|
827
|
+
#
|
828
|
+
# resp.query_id #=> String
|
829
|
+
# resp.query_string #=> String
|
830
|
+
# resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
|
831
|
+
# resp.query_statistics.events_matched #=> Integer
|
832
|
+
# resp.query_statistics.events_scanned #=> Integer
|
833
|
+
# resp.query_statistics.execution_time_in_millis #=> Integer
|
834
|
+
# resp.query_statistics.creation_time #=> Time
|
835
|
+
# resp.error_message #=> String
|
836
|
+
#
|
837
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQuery AWS API Documentation
|
838
|
+
#
|
839
|
+
# @overload describe_query(params = {})
|
840
|
+
# @param [Hash] params ({})
|
841
|
+
def describe_query(params = {}, options = {})
|
842
|
+
req = build_request(:describe_query, params)
|
843
|
+
req.send_request(options)
|
844
|
+
end
|
845
|
+
|
591
846
|
# Retrieves settings for one or more trails associated with the current
|
592
847
|
# region for your account.
|
593
848
|
#
|
@@ -662,6 +917,69 @@ module Aws::CloudTrail
|
|
662
917
|
req.send_request(options)
|
663
918
|
end
|
664
919
|
|
920
|
+
# Returns information about an event data store specified as either an
|
921
|
+
# ARN or the ID portion of the ARN.
|
922
|
+
#
|
923
|
+
# @option params [required, String] :event_data_store
|
924
|
+
# The ARN (or ID suffix of the ARN) of the event data store about which
|
925
|
+
# you want information.
|
926
|
+
#
|
927
|
+
# @return [Types::GetEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
928
|
+
#
|
929
|
+
# * {Types::GetEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
|
930
|
+
# * {Types::GetEventDataStoreResponse#name #name} => String
|
931
|
+
# * {Types::GetEventDataStoreResponse#status #status} => String
|
932
|
+
# * {Types::GetEventDataStoreResponse#advanced_event_selectors #advanced_event_selectors} => Array<Types::AdvancedEventSelector>
|
933
|
+
# * {Types::GetEventDataStoreResponse#multi_region_enabled #multi_region_enabled} => Boolean
|
934
|
+
# * {Types::GetEventDataStoreResponse#organization_enabled #organization_enabled} => Boolean
|
935
|
+
# * {Types::GetEventDataStoreResponse#retention_period #retention_period} => Integer
|
936
|
+
# * {Types::GetEventDataStoreResponse#termination_protection_enabled #termination_protection_enabled} => Boolean
|
937
|
+
# * {Types::GetEventDataStoreResponse#created_timestamp #created_timestamp} => Time
|
938
|
+
# * {Types::GetEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
|
939
|
+
#
|
940
|
+
# @example Request syntax with placeholder values
|
941
|
+
#
|
942
|
+
# resp = client.get_event_data_store({
|
943
|
+
# event_data_store: "EventDataStoreArn", # required
|
944
|
+
# })
|
945
|
+
#
|
946
|
+
# @example Response structure
|
947
|
+
#
|
948
|
+
# resp.event_data_store_arn #=> String
|
949
|
+
# resp.name #=> String
|
950
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
951
|
+
# resp.advanced_event_selectors #=> Array
|
952
|
+
# resp.advanced_event_selectors[0].name #=> String
|
953
|
+
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
954
|
+
# resp.advanced_event_selectors[0].field_selectors[0].field #=> String
|
955
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals #=> Array
|
956
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
|
957
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
|
958
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
|
959
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
|
960
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
|
961
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
|
962
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
|
963
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
|
964
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
|
965
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
|
966
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
|
967
|
+
# resp.multi_region_enabled #=> Boolean
|
968
|
+
# resp.organization_enabled #=> Boolean
|
969
|
+
# resp.retention_period #=> Integer
|
970
|
+
# resp.termination_protection_enabled #=> Boolean
|
971
|
+
# resp.created_timestamp #=> Time
|
972
|
+
# resp.updated_timestamp #=> Time
|
973
|
+
#
|
974
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetEventDataStore AWS API Documentation
|
975
|
+
#
|
976
|
+
# @overload get_event_data_store(params = {})
|
977
|
+
# @param [Hash] params ({})
|
978
|
+
def get_event_data_store(params = {}, options = {})
|
979
|
+
req = build_request(:get_event_data_store, params)
|
980
|
+
req.send_request(options)
|
981
|
+
end
|
982
|
+
|
665
983
|
# Describes the settings for the event selectors that you configured for
|
666
984
|
# your trail. The information returned for your event selectors includes
|
667
985
|
# the following:
|
@@ -812,6 +1130,63 @@ module Aws::CloudTrail
|
|
812
1130
|
req.send_request(options)
|
813
1131
|
end
|
814
1132
|
|
1133
|
+
# Gets event data results of a query. You must specify the `QueryID`
|
1134
|
+
# value returned by the `StartQuery` operation, and an ARN for
|
1135
|
+
# `EventDataStore`.
|
1136
|
+
#
|
1137
|
+
# @option params [required, String] :event_data_store
|
1138
|
+
# The ARN (or ID suffix of the ARN) of the event data store against
|
1139
|
+
# which the query was run.
|
1140
|
+
#
|
1141
|
+
# @option params [required, String] :query_id
|
1142
|
+
# The ID of the query for which you want to get results.
|
1143
|
+
#
|
1144
|
+
# @option params [String] :next_token
|
1145
|
+
# A token you can use to get the next page of query results.
|
1146
|
+
#
|
1147
|
+
# @option params [Integer] :max_query_results
|
1148
|
+
# The maximum number of query results to display on a single page.
|
1149
|
+
#
|
1150
|
+
# @return [Types::GetQueryResultsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1151
|
+
#
|
1152
|
+
# * {Types::GetQueryResultsResponse#query_status #query_status} => String
|
1153
|
+
# * {Types::GetQueryResultsResponse#query_statistics #query_statistics} => Types::QueryStatistics
|
1154
|
+
# * {Types::GetQueryResultsResponse#query_result_rows #query_result_rows} => Array<Array<Hash<String,String>>>
|
1155
|
+
# * {Types::GetQueryResultsResponse#next_token #next_token} => String
|
1156
|
+
# * {Types::GetQueryResultsResponse#error_message #error_message} => String
|
1157
|
+
#
|
1158
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1159
|
+
#
|
1160
|
+
# @example Request syntax with placeholder values
|
1161
|
+
#
|
1162
|
+
# resp = client.get_query_results({
|
1163
|
+
# event_data_store: "EventDataStoreArn", # required
|
1164
|
+
# query_id: "UUID", # required
|
1165
|
+
# next_token: "PaginationToken",
|
1166
|
+
# max_query_results: 1,
|
1167
|
+
# })
|
1168
|
+
#
|
1169
|
+
# @example Response structure
|
1170
|
+
#
|
1171
|
+
# resp.query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
|
1172
|
+
# resp.query_statistics.results_count #=> Integer
|
1173
|
+
# resp.query_statistics.total_results_count #=> Integer
|
1174
|
+
# resp.query_result_rows #=> Array
|
1175
|
+
# resp.query_result_rows[0] #=> Array
|
1176
|
+
# resp.query_result_rows[0][0] #=> Hash
|
1177
|
+
# resp.query_result_rows[0][0]["QueryResultKey"] #=> String
|
1178
|
+
# resp.next_token #=> String
|
1179
|
+
# resp.error_message #=> String
|
1180
|
+
#
|
1181
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetQueryResults AWS API Documentation
|
1182
|
+
#
|
1183
|
+
# @overload get_query_results(params = {})
|
1184
|
+
# @param [Hash] params ({})
|
1185
|
+
def get_query_results(params = {}, options = {})
|
1186
|
+
req = build_request(:get_query_results, params)
|
1187
|
+
req.send_request(options)
|
1188
|
+
end
|
1189
|
+
|
815
1190
|
# Returns settings information for a specified trail.
|
816
1191
|
#
|
817
1192
|
# @option params [required, String] :name
|
@@ -926,6 +1301,68 @@ module Aws::CloudTrail
|
|
926
1301
|
req.send_request(options)
|
927
1302
|
end
|
928
1303
|
|
1304
|
+
# Returns information about all event data stores in the account, in the
|
1305
|
+
# current region.
|
1306
|
+
#
|
1307
|
+
# @option params [String] :next_token
|
1308
|
+
# A token you can use to get the next page of event data store results.
|
1309
|
+
#
|
1310
|
+
# @option params [Integer] :max_results
|
1311
|
+
# The maximum number of event data stores to display on a single page.
|
1312
|
+
#
|
1313
|
+
# @return [Types::ListEventDataStoresResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1314
|
+
#
|
1315
|
+
# * {Types::ListEventDataStoresResponse#event_data_stores #event_data_stores} => Array<Types::EventDataStore>
|
1316
|
+
# * {Types::ListEventDataStoresResponse#next_token #next_token} => String
|
1317
|
+
#
|
1318
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1319
|
+
#
|
1320
|
+
# @example Request syntax with placeholder values
|
1321
|
+
#
|
1322
|
+
# resp = client.list_event_data_stores({
|
1323
|
+
# next_token: "PaginationToken",
|
1324
|
+
# max_results: 1,
|
1325
|
+
# })
|
1326
|
+
#
|
1327
|
+
# @example Response structure
|
1328
|
+
#
|
1329
|
+
# resp.event_data_stores #=> Array
|
1330
|
+
# resp.event_data_stores[0].event_data_store_arn #=> String
|
1331
|
+
# resp.event_data_stores[0].name #=> String
|
1332
|
+
# resp.event_data_stores[0].termination_protection_enabled #=> Boolean
|
1333
|
+
# resp.event_data_stores[0].status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
1334
|
+
# resp.event_data_stores[0].advanced_event_selectors #=> Array
|
1335
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].name #=> String
|
1336
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors #=> Array
|
1337
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].field #=> String
|
1338
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].equals #=> Array
|
1339
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
|
1340
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
|
1341
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
|
1342
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
|
1343
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
|
1344
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
|
1345
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
|
1346
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
|
1347
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
|
1348
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
|
1349
|
+
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
|
1350
|
+
# resp.event_data_stores[0].multi_region_enabled #=> Boolean
|
1351
|
+
# resp.event_data_stores[0].organization_enabled #=> Boolean
|
1352
|
+
# resp.event_data_stores[0].retention_period #=> Integer
|
1353
|
+
# resp.event_data_stores[0].created_timestamp #=> Time
|
1354
|
+
# resp.event_data_stores[0].updated_timestamp #=> Time
|
1355
|
+
# resp.next_token #=> String
|
1356
|
+
#
|
1357
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListEventDataStores AWS API Documentation
|
1358
|
+
#
|
1359
|
+
# @overload list_event_data_stores(params = {})
|
1360
|
+
# @param [Hash] params ({})
|
1361
|
+
def list_event_data_stores(params = {}, options = {})
|
1362
|
+
req = build_request(:list_event_data_stores, params)
|
1363
|
+
req.send_request(options)
|
1364
|
+
end
|
1365
|
+
|
929
1366
|
# Returns all public keys whose private keys were used to sign the
|
930
1367
|
# digest files within the specified time range. The public key is needed
|
931
1368
|
# to validate digest files that were signed with its corresponding
|
@@ -984,6 +1421,71 @@ module Aws::CloudTrail
|
|
984
1421
|
req.send_request(options)
|
985
1422
|
end
|
986
1423
|
|
1424
|
+
# Returns a list of queries and query statuses for the past seven days.
|
1425
|
+
# You must specify an ARN value for `EventDataStore`. Optionally, to
|
1426
|
+
# shorten the list of results, you can specify a time range, formatted
|
1427
|
+
# as timestamps, by adding `StartTime` and `EndTime` parameters, and a
|
1428
|
+
# `QueryStatus` value. Valid values for `QueryStatus` include `QUEUED`,
|
1429
|
+
# `RUNNING`, `FINISHED`, `FAILED`, or `CANCELLED`.
|
1430
|
+
#
|
1431
|
+
# @option params [required, String] :event_data_store
|
1432
|
+
# The ARN (or the ID suffix of the ARN) of an event data store on which
|
1433
|
+
# queries were run.
|
1434
|
+
#
|
1435
|
+
# @option params [String] :next_token
|
1436
|
+
# A token you can use to get the next page of results.
|
1437
|
+
#
|
1438
|
+
# @option params [Integer] :max_results
|
1439
|
+
# The maximum number of queries to show on a page.
|
1440
|
+
#
|
1441
|
+
# @option params [Time,DateTime,Date,Integer,String] :start_time
|
1442
|
+
# Use with `EndTime` to bound a `ListQueries` request, and limit its
|
1443
|
+
# results to only those queries run within a specified time period.
|
1444
|
+
#
|
1445
|
+
# @option params [Time,DateTime,Date,Integer,String] :end_time
|
1446
|
+
# Use with `StartTime` to bound a `ListQueries` request, and limit its
|
1447
|
+
# results to only those queries run within a specified time period.
|
1448
|
+
#
|
1449
|
+
# @option params [String] :query_status
|
1450
|
+
# The status of queries that you want to return in results. Valid values
|
1451
|
+
# for `QueryStatus` include `QUEUED`, `RUNNING`, `FINISHED`, `FAILED`,
|
1452
|
+
# or `CANCELLED`.
|
1453
|
+
#
|
1454
|
+
# @return [Types::ListQueriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1455
|
+
#
|
1456
|
+
# * {Types::ListQueriesResponse#queries #queries} => Array<Types::Query>
|
1457
|
+
# * {Types::ListQueriesResponse#next_token #next_token} => String
|
1458
|
+
#
|
1459
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1460
|
+
#
|
1461
|
+
# @example Request syntax with placeholder values
|
1462
|
+
#
|
1463
|
+
# resp = client.list_queries({
|
1464
|
+
# event_data_store: "EventDataStoreArn", # required
|
1465
|
+
# next_token: "PaginationToken",
|
1466
|
+
# max_results: 1,
|
1467
|
+
# start_time: Time.now,
|
1468
|
+
# end_time: Time.now,
|
1469
|
+
# query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED
|
1470
|
+
# })
|
1471
|
+
#
|
1472
|
+
# @example Response structure
|
1473
|
+
#
|
1474
|
+
# resp.queries #=> Array
|
1475
|
+
# resp.queries[0].query_id #=> String
|
1476
|
+
# resp.queries[0].query_status #=> String, one of "QUEUED", "RUNNING", "FINISHED", "FAILED", "CANCELLED"
|
1477
|
+
# resp.queries[0].creation_time #=> Time
|
1478
|
+
# resp.next_token #=> String
|
1479
|
+
#
|
1480
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListQueries AWS API Documentation
|
1481
|
+
#
|
1482
|
+
# @overload list_queries(params = {})
|
1483
|
+
# @param [Hash] params ({})
|
1484
|
+
def list_queries(params = {}, options = {})
|
1485
|
+
req = build_request(:list_queries, params)
|
1486
|
+
req.send_request(options)
|
1487
|
+
end
|
1488
|
+
|
987
1489
|
# Lists the tags for the trail in the current region.
|
988
1490
|
#
|
989
1491
|
# @option params [required, Array<String>] :resource_id_list
|
@@ -1360,17 +1862,17 @@ module Aws::CloudTrail
|
|
1360
1862
|
# Lets you enable Insights event logging by specifying the Insights
|
1361
1863
|
# selectors that you want to enable on an existing trail. You also use
|
1362
1864
|
# `PutInsightSelectors` to turn off Insights event logging, by passing
|
1363
|
-
# an empty list of insight types. The valid Insights event
|
1364
|
-
# release
|
1865
|
+
# an empty list of insight types. The valid Insights event types in this
|
1866
|
+
# release are `ApiErrorRateInsight` and `ApiCallRateInsight`.
|
1365
1867
|
#
|
1366
1868
|
# @option params [required, String] :trail_name
|
1367
1869
|
# The name of the CloudTrail trail for which you want to change or add
|
1368
1870
|
# Insights selectors.
|
1369
1871
|
#
|
1370
1872
|
# @option params [required, Array<Types::InsightSelector>] :insight_selectors
|
1371
|
-
# A JSON string that contains the
|
1372
|
-
#
|
1373
|
-
#
|
1873
|
+
# A JSON string that contains the insight types you want to log on a
|
1874
|
+
# trail. `ApiCallRateInsight` and `ApiErrorRateInsight` are valid
|
1875
|
+
# insight types.
|
1374
1876
|
#
|
1375
1877
|
# @return [Types::PutInsightSelectorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1376
1878
|
#
|
@@ -1411,7 +1913,7 @@ module Aws::CloudTrail
|
|
1411
1913
|
#
|
1412
1914
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
1413
1915
|
#
|
1414
|
-
# @option params [Array<Types::Tag>] :tags_list
|
1916
|
+
# @option params [required, Array<Types::Tag>] :tags_list
|
1415
1917
|
# Specifies a list of tags to be removed.
|
1416
1918
|
#
|
1417
1919
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
@@ -1420,10 +1922,10 @@ module Aws::CloudTrail
|
|
1420
1922
|
#
|
1421
1923
|
# resp = client.remove_tags({
|
1422
1924
|
# resource_id: "String", # required
|
1423
|
-
# tags_list: [
|
1925
|
+
# tags_list: [ # required
|
1424
1926
|
# {
|
1425
|
-
# key: "
|
1426
|
-
# value: "
|
1927
|
+
# key: "TagKey", # required
|
1928
|
+
# value: "TagValue",
|
1427
1929
|
# },
|
1428
1930
|
# ],
|
1429
1931
|
# })
|
@@ -1437,6 +1939,72 @@ module Aws::CloudTrail
|
|
1437
1939
|
req.send_request(options)
|
1438
1940
|
end
|
1439
1941
|
|
1942
|
+
# Restores a deleted event data store specified by `EventDataStore`,
|
1943
|
+
# which accepts an event data store ARN. You can only restore a deleted
|
1944
|
+
# event data store within the seven-day wait period after deletion.
|
1945
|
+
# Restoring an event data store can take several minutes, depending on
|
1946
|
+
# the size of the event data store.
|
1947
|
+
#
|
1948
|
+
# @option params [required, String] :event_data_store
|
1949
|
+
# The ARN (or the ID suffix of the ARN) of the event data store that you
|
1950
|
+
# want to restore.
|
1951
|
+
#
|
1952
|
+
# @return [Types::RestoreEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1953
|
+
#
|
1954
|
+
# * {Types::RestoreEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
|
1955
|
+
# * {Types::RestoreEventDataStoreResponse#name #name} => String
|
1956
|
+
# * {Types::RestoreEventDataStoreResponse#status #status} => String
|
1957
|
+
# * {Types::RestoreEventDataStoreResponse#advanced_event_selectors #advanced_event_selectors} => Array<Types::AdvancedEventSelector>
|
1958
|
+
# * {Types::RestoreEventDataStoreResponse#multi_region_enabled #multi_region_enabled} => Boolean
|
1959
|
+
# * {Types::RestoreEventDataStoreResponse#organization_enabled #organization_enabled} => Boolean
|
1960
|
+
# * {Types::RestoreEventDataStoreResponse#retention_period #retention_period} => Integer
|
1961
|
+
# * {Types::RestoreEventDataStoreResponse#termination_protection_enabled #termination_protection_enabled} => Boolean
|
1962
|
+
# * {Types::RestoreEventDataStoreResponse#created_timestamp #created_timestamp} => Time
|
1963
|
+
# * {Types::RestoreEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
|
1964
|
+
#
|
1965
|
+
# @example Request syntax with placeholder values
|
1966
|
+
#
|
1967
|
+
# resp = client.restore_event_data_store({
|
1968
|
+
# event_data_store: "EventDataStoreArn", # required
|
1969
|
+
# })
|
1970
|
+
#
|
1971
|
+
# @example Response structure
|
1972
|
+
#
|
1973
|
+
# resp.event_data_store_arn #=> String
|
1974
|
+
# resp.name #=> String
|
1975
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
1976
|
+
# resp.advanced_event_selectors #=> Array
|
1977
|
+
# resp.advanced_event_selectors[0].name #=> String
|
1978
|
+
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
1979
|
+
# resp.advanced_event_selectors[0].field_selectors[0].field #=> String
|
1980
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals #=> Array
|
1981
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
|
1982
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
|
1983
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
|
1984
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
|
1985
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
|
1986
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
|
1987
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
|
1988
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
|
1989
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
|
1990
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
|
1991
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
|
1992
|
+
# resp.multi_region_enabled #=> Boolean
|
1993
|
+
# resp.organization_enabled #=> Boolean
|
1994
|
+
# resp.retention_period #=> Integer
|
1995
|
+
# resp.termination_protection_enabled #=> Boolean
|
1996
|
+
# resp.created_timestamp #=> Time
|
1997
|
+
# resp.updated_timestamp #=> Time
|
1998
|
+
#
|
1999
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RestoreEventDataStore AWS API Documentation
|
2000
|
+
#
|
2001
|
+
# @overload restore_event_data_store(params = {})
|
2002
|
+
# @param [Hash] params ({})
|
2003
|
+
def restore_event_data_store(params = {}, options = {})
|
2004
|
+
req = build_request(:restore_event_data_store, params)
|
2005
|
+
req.send_request(options)
|
2006
|
+
end
|
2007
|
+
|
1440
2008
|
# Starts the recording of Amazon Web Services API calls and log file
|
1441
2009
|
# delivery for a trail. For a trail that is enabled in all regions, this
|
1442
2010
|
# operation must be called from the region in which the trail was
|
@@ -1468,6 +2036,35 @@ module Aws::CloudTrail
|
|
1468
2036
|
req.send_request(options)
|
1469
2037
|
end
|
1470
2038
|
|
2039
|
+
# Starts a CloudTrail Lake query. The required `QueryStatement`
|
2040
|
+
# parameter provides your SQL query, enclosed in single quotation marks.
|
2041
|
+
#
|
2042
|
+
# @option params [required, String] :query_statement
|
2043
|
+
# The SQL code of your query.
|
2044
|
+
#
|
2045
|
+
# @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2046
|
+
#
|
2047
|
+
# * {Types::StartQueryResponse#query_id #query_id} => String
|
2048
|
+
#
|
2049
|
+
# @example Request syntax with placeholder values
|
2050
|
+
#
|
2051
|
+
# resp = client.start_query({
|
2052
|
+
# query_statement: "QueryStatement", # required
|
2053
|
+
# })
|
2054
|
+
#
|
2055
|
+
# @example Response structure
|
2056
|
+
#
|
2057
|
+
# resp.query_id #=> String
|
2058
|
+
#
|
2059
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartQuery AWS API Documentation
|
2060
|
+
#
|
2061
|
+
# @overload start_query(params = {})
|
2062
|
+
# @param [Hash] params ({})
|
2063
|
+
def start_query(params = {}, options = {})
|
2064
|
+
req = build_request(:start_query, params)
|
2065
|
+
req.send_request(options)
|
2066
|
+
end
|
2067
|
+
|
1471
2068
|
# Suspends the recording of Amazon Web Services API calls and log file
|
1472
2069
|
# delivery for the specified trail. Under most circumstances, there is
|
1473
2070
|
# no need to use this action. You can update a trail without stopping it
|
@@ -1502,6 +2099,119 @@ module Aws::CloudTrail
|
|
1502
2099
|
req.send_request(options)
|
1503
2100
|
end
|
1504
2101
|
|
2102
|
+
# Updates an event data store. The required `EventDataStore` value is an
|
2103
|
+
# ARN or the ID portion of the ARN. Other parameters are optional, but
|
2104
|
+
# at least one optional parameter must be specified, or CloudTrail
|
2105
|
+
# throws an error. `RetentionPeriod` is in days, and valid values are
|
2106
|
+
# integers between 90 and 2555. By default, `TerminationProtection` is
|
2107
|
+
# enabled. `AdvancedEventSelectors` includes or excludes management and
|
2108
|
+
# data events in your event data store; for more information about
|
2109
|
+
# `AdvancedEventSelectors`, see
|
2110
|
+
# PutEventSelectorsRequest$AdvancedEventSelectors.
|
2111
|
+
#
|
2112
|
+
# @option params [required, String] :event_data_store
|
2113
|
+
# The ARN (or the ID suffix of the ARN) of the event data store that you
|
2114
|
+
# want to update.
|
2115
|
+
#
|
2116
|
+
# @option params [String] :name
|
2117
|
+
# The event data store name.
|
2118
|
+
#
|
2119
|
+
# @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
|
2120
|
+
# The advanced event selectors used to select events for the event data
|
2121
|
+
# store.
|
2122
|
+
#
|
2123
|
+
# @option params [Boolean] :multi_region_enabled
|
2124
|
+
# Specifies whether an event data store collects events from all
|
2125
|
+
# regions, or only from the region in which it was created.
|
2126
|
+
#
|
2127
|
+
# @option params [Boolean] :organization_enabled
|
2128
|
+
# Specifies whether an event data store collects events logged for an
|
2129
|
+
# organization in Organizations.
|
2130
|
+
#
|
2131
|
+
# @option params [Integer] :retention_period
|
2132
|
+
# The retention period, in days.
|
2133
|
+
#
|
2134
|
+
# @option params [Boolean] :termination_protection_enabled
|
2135
|
+
# Indicates that termination protection is enabled and the event data
|
2136
|
+
# store cannot be automatically deleted.
|
2137
|
+
#
|
2138
|
+
# @return [Types::UpdateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2139
|
+
#
|
2140
|
+
# * {Types::UpdateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
|
2141
|
+
# * {Types::UpdateEventDataStoreResponse#name #name} => String
|
2142
|
+
# * {Types::UpdateEventDataStoreResponse#status #status} => String
|
2143
|
+
# * {Types::UpdateEventDataStoreResponse#advanced_event_selectors #advanced_event_selectors} => Array<Types::AdvancedEventSelector>
|
2144
|
+
# * {Types::UpdateEventDataStoreResponse#multi_region_enabled #multi_region_enabled} => Boolean
|
2145
|
+
# * {Types::UpdateEventDataStoreResponse#organization_enabled #organization_enabled} => Boolean
|
2146
|
+
# * {Types::UpdateEventDataStoreResponse#retention_period #retention_period} => Integer
|
2147
|
+
# * {Types::UpdateEventDataStoreResponse#termination_protection_enabled #termination_protection_enabled} => Boolean
|
2148
|
+
# * {Types::UpdateEventDataStoreResponse#created_timestamp #created_timestamp} => Time
|
2149
|
+
# * {Types::UpdateEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
|
2150
|
+
#
|
2151
|
+
# @example Request syntax with placeholder values
|
2152
|
+
#
|
2153
|
+
# resp = client.update_event_data_store({
|
2154
|
+
# event_data_store: "EventDataStoreArn", # required
|
2155
|
+
# name: "EventDataStoreName",
|
2156
|
+
# advanced_event_selectors: [
|
2157
|
+
# {
|
2158
|
+
# name: "SelectorName",
|
2159
|
+
# field_selectors: [ # required
|
2160
|
+
# {
|
2161
|
+
# field: "SelectorField", # required
|
2162
|
+
# equals: ["OperatorValue"],
|
2163
|
+
# starts_with: ["OperatorValue"],
|
2164
|
+
# ends_with: ["OperatorValue"],
|
2165
|
+
# not_equals: ["OperatorValue"],
|
2166
|
+
# not_starts_with: ["OperatorValue"],
|
2167
|
+
# not_ends_with: ["OperatorValue"],
|
2168
|
+
# },
|
2169
|
+
# ],
|
2170
|
+
# },
|
2171
|
+
# ],
|
2172
|
+
# multi_region_enabled: false,
|
2173
|
+
# organization_enabled: false,
|
2174
|
+
# retention_period: 1,
|
2175
|
+
# termination_protection_enabled: false,
|
2176
|
+
# })
|
2177
|
+
#
|
2178
|
+
# @example Response structure
|
2179
|
+
#
|
2180
|
+
# resp.event_data_store_arn #=> String
|
2181
|
+
# resp.name #=> String
|
2182
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
2183
|
+
# resp.advanced_event_selectors #=> Array
|
2184
|
+
# resp.advanced_event_selectors[0].name #=> String
|
2185
|
+
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
2186
|
+
# resp.advanced_event_selectors[0].field_selectors[0].field #=> String
|
2187
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals #=> Array
|
2188
|
+
# resp.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
|
2189
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
|
2190
|
+
# resp.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
|
2191
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
|
2192
|
+
# resp.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
|
2193
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
|
2194
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
|
2195
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
|
2196
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
|
2197
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
|
2198
|
+
# resp.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
|
2199
|
+
# resp.multi_region_enabled #=> Boolean
|
2200
|
+
# resp.organization_enabled #=> Boolean
|
2201
|
+
# resp.retention_period #=> Integer
|
2202
|
+
# resp.termination_protection_enabled #=> Boolean
|
2203
|
+
# resp.created_timestamp #=> Time
|
2204
|
+
# resp.updated_timestamp #=> Time
|
2205
|
+
#
|
2206
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStore AWS API Documentation
|
2207
|
+
#
|
2208
|
+
# @overload update_event_data_store(params = {})
|
2209
|
+
# @param [Hash] params ({})
|
2210
|
+
def update_event_data_store(params = {}, options = {})
|
2211
|
+
req = build_request(:update_event_data_store, params)
|
2212
|
+
req.send_request(options)
|
2213
|
+
end
|
2214
|
+
|
1505
2215
|
# Updates trail settings that control what events you are logging, and
|
1506
2216
|
# how to handle log files. Changes to a trail do not require stopping
|
1507
2217
|
# the CloudTrail service. Use this action to designate an existing
|
@@ -1698,7 +2408,7 @@ module Aws::CloudTrail
|
|
1698
2408
|
params: params,
|
1699
2409
|
config: config)
|
1700
2410
|
context[:gem_name] = 'aws-sdk-cloudtrail'
|
1701
|
-
context[:gem_version] = '1.
|
2411
|
+
context[:gem_version] = '1.45.0'
|
1702
2412
|
Seahorse::Client::Request.new(handlers, context)
|
1703
2413
|
end
|
1704
2414
|
|