aws-sdk-cloudtrail 1.49.0 → 1.50.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: dec5d187176c43abe1b0f9e22af755232ba56d77e6046d484a4941906e768822
4
- data.tar.gz: 031acc2864f6fd5fc8a6378177056166b3d6a13bc591565c69ced8c63513e5c4
3
+ metadata.gz: 92437a7a7cb64e0c36d4094799380ba953562fec2d133de0271299cfd9733f1b
4
+ data.tar.gz: a64de41244574754915618a7a79fc003a0c98ba7672fbff44ccdeebeab7a2895
5
5
  SHA512:
6
- metadata.gz: 55e951e6f59972a6cf10f73ceebc98d1764dfd9171d5dc84cee5b1b0f3618cb6d0ad6a2ae671357eca2cc30d43a6b282f19a2cef37667153033195a027b63c0e
7
- data.tar.gz: '0853615833aa071d8fce2194c44c1ae0c19f3c7d2e7c92ff79345f66b1b65abc9121ea292eacdd452f555dd2e92084c70d09d75e696d221591d0e43f4e8459d7'
6
+ metadata.gz: 3abd5b513985fe3c06e1497f965fbaa318686a627f5870f742204378909b24361c4a465308770a61530b10eebd6334b2238748ae3e5c606a3edc1d70651bff41
7
+ data.tar.gz: 0e89f2c4758a430eb4bdca0bc7d1a855bef3da80911cdb36f43686ebe570d2264d03da11d9f286f4cfeb88bcb629ff9199a5ce713b09ebf58e9ff1df5ee47578
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.50.0 (2022-09-09)
5
+ ------------------
6
+
7
+ * Feature - This release adds CloudTrail getChannel and listChannels APIs to allow customer to view the ServiceLinkedChannel configurations.
8
+
4
9
  1.49.0 (2022-04-27)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.49.0
1
+ 1.50.0
@@ -469,7 +469,7 @@ module Aws::CloudTrail
469
469
  #
470
470
  # @option params [Integer] :retention_period
471
471
  # The retention period of the event data store, in days. You can set a
472
- # retention period of up to 2555 days, the equivalent of seven years.
472
+ # retention period of up to 2557 days, the equivalent of seven years.
473
473
  #
474
474
  # @option params [Boolean] :termination_protection_enabled
475
475
  # Specifies whether termination protection is enabled for the event data
@@ -923,6 +923,63 @@ module Aws::CloudTrail
923
923
  req.send_request(options)
924
924
  end
925
925
 
926
+ # Returns the specified CloudTrail service-linked channel. Amazon Web
927
+ # Services services create service-linked channels to view CloudTrail
928
+ # events.
929
+ #
930
+ # @option params [required, String] :channel
931
+ # The Amazon Resource Name (ARN) of the CloudTrail service-linked
932
+ # channel.
933
+ #
934
+ # @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
935
+ #
936
+ # * {Types::GetChannelResponse#channel_arn #channel_arn} => String
937
+ # * {Types::GetChannelResponse#name #name} => String
938
+ # * {Types::GetChannelResponse#source #source} => String
939
+ # * {Types::GetChannelResponse#source_config #source_config} => Types::SourceConfig
940
+ # * {Types::GetChannelResponse#destinations #destinations} => Array<Types::Destination>
941
+ #
942
+ # @example Request syntax with placeholder values
943
+ #
944
+ # resp = client.get_channel({
945
+ # channel: "ChannelArn", # required
946
+ # })
947
+ #
948
+ # @example Response structure
949
+ #
950
+ # resp.channel_arn #=> String
951
+ # resp.name #=> String
952
+ # resp.source #=> String
953
+ # resp.source_config.apply_to_all_regions #=> Boolean
954
+ # resp.source_config.advanced_event_selectors #=> Array
955
+ # resp.source_config.advanced_event_selectors[0].name #=> String
956
+ # resp.source_config.advanced_event_selectors[0].field_selectors #=> Array
957
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].field #=> String
958
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].equals #=> Array
959
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
960
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
961
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
962
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
963
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
964
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
965
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
966
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
967
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
968
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
969
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
970
+ # resp.destinations #=> Array
971
+ # resp.destinations[0].type #=> String, one of "EVENT_DATA_STORE", "AWS_SERVICE"
972
+ # resp.destinations[0].location #=> String
973
+ #
974
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannel AWS API Documentation
975
+ #
976
+ # @overload get_channel(params = {})
977
+ # @param [Hash] params ({})
978
+ def get_channel(params = {}, options = {})
979
+ req = build_request(:get_channel, params)
980
+ req.send_request(options)
981
+ end
982
+
926
983
  # Returns information about an event data store specified as either an
927
984
  # ARN or the ID portion of the ARN.
928
985
  #
@@ -1308,6 +1365,44 @@ module Aws::CloudTrail
1308
1365
  req.send_request(options)
1309
1366
  end
1310
1367
 
1368
+ # Returns all CloudTrail channels.
1369
+ #
1370
+ # @option params [Integer] :max_results
1371
+ # The maximum number of CloudTrail channels to display on a single page.
1372
+ #
1373
+ # @option params [String] :next_token
1374
+ # A token you can use to get the next page of results.
1375
+ #
1376
+ # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1377
+ #
1378
+ # * {Types::ListChannelsResponse#channels #channels} => Array<Types::Channel>
1379
+ # * {Types::ListChannelsResponse#next_token #next_token} => String
1380
+ #
1381
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1382
+ #
1383
+ # @example Request syntax with placeholder values
1384
+ #
1385
+ # resp = client.list_channels({
1386
+ # max_results: 1,
1387
+ # next_token: "PaginationToken",
1388
+ # })
1389
+ #
1390
+ # @example Response structure
1391
+ #
1392
+ # resp.channels #=> Array
1393
+ # resp.channels[0].channel_arn #=> String
1394
+ # resp.channels[0].name #=> String
1395
+ # resp.next_token #=> String
1396
+ #
1397
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannels AWS API Documentation
1398
+ #
1399
+ # @overload list_channels(params = {})
1400
+ # @param [Hash] params ({})
1401
+ def list_channels(params = {}, options = {})
1402
+ req = build_request(:list_channels, params)
1403
+ req.send_request(options)
1404
+ end
1405
+
1311
1406
  # Returns information about all event data stores in the account, in the
1312
1407
  # current region.
1313
1408
  #
@@ -1540,7 +1635,7 @@ module Aws::CloudTrail
1540
1635
  # @option params [String] :next_token
1541
1636
  # The token to use to get the next page of results after a previous API
1542
1637
  # call. This token must be passed in with the same parameters that were
1543
- # specified in the the original call. For example, if the original call
1638
+ # specified in the original call. For example, if the original call
1544
1639
  # specified an AttributeKey of 'Username' with a value of 'root',
1545
1640
  # the call with NextToken should include those same parameters.
1546
1641
  #
@@ -1642,7 +1737,7 @@ module Aws::CloudTrail
1642
1737
  # @option params [String] :next_token
1643
1738
  # The token to use to get the next page of results after a previous API
1644
1739
  # call. This token must be passed in with the same parameters that were
1645
- # specified in the the original call. For example, if the original call
1740
+ # specified in the original call. For example, if the original call
1646
1741
  # specified an AttributeKey of 'Username' with a value of 'root',
1647
1742
  # the call with NextToken should include those same parameters.
1648
1743
  #
@@ -2113,7 +2208,7 @@ module Aws::CloudTrail
2113
2208
  # ARN or the ID portion of the ARN. Other parameters are optional, but
2114
2209
  # at least one optional parameter must be specified, or CloudTrail
2115
2210
  # throws an error. `RetentionPeriod` is in days, and valid values are
2116
- # integers between 90 and 2555. By default, `TerminationProtection` is
2211
+ # integers between 90 and 2557. By default, `TerminationProtection` is
2117
2212
  # enabled. `AdvancedEventSelectors` includes or excludes management and
2118
2213
  # data events in your event data store; for more information about
2119
2214
  # `AdvancedEventSelectors`, see
@@ -2418,7 +2513,7 @@ module Aws::CloudTrail
2418
2513
  params: params,
2419
2514
  config: config)
2420
2515
  context[:gem_name] = 'aws-sdk-cloudtrail'
2421
- context[:gem_version] = '1.49.0'
2516
+ context[:gem_version] = '1.50.0'
2422
2517
  Seahorse::Client::Request.new(handlers, context)
2423
2518
  end
2424
2519
 
@@ -23,6 +23,12 @@ module Aws::CloudTrail
23
23
  ByteBuffer = Shapes::BlobShape.new(name: 'ByteBuffer')
24
24
  CancelQueryRequest = Shapes::StructureShape.new(name: 'CancelQueryRequest')
25
25
  CancelQueryResponse = Shapes::StructureShape.new(name: 'CancelQueryResponse')
26
+ Channel = Shapes::StructureShape.new(name: 'Channel')
27
+ ChannelARNInvalidException = Shapes::StructureShape.new(name: 'ChannelARNInvalidException')
28
+ ChannelArn = Shapes::StringShape.new(name: 'ChannelArn')
29
+ ChannelName = Shapes::StringShape.new(name: 'ChannelName')
30
+ ChannelNotFoundException = Shapes::StructureShape.new(name: 'ChannelNotFoundException')
31
+ Channels = Shapes::ListShape.new(name: 'Channels')
26
32
  CloudTrailARNInvalidException = Shapes::StructureShape.new(name: 'CloudTrailARNInvalidException')
27
33
  CloudTrailAccessNotEnabledException = Shapes::StructureShape.new(name: 'CloudTrailAccessNotEnabledException')
28
34
  CloudTrailInvalidClientTokenIdException = Shapes::StructureShape.new(name: 'CloudTrailInvalidClientTokenIdException')
@@ -44,6 +50,9 @@ module Aws::CloudTrail
44
50
  DescribeQueryResponse = Shapes::StructureShape.new(name: 'DescribeQueryResponse')
45
51
  DescribeTrailsRequest = Shapes::StructureShape.new(name: 'DescribeTrailsRequest')
46
52
  DescribeTrailsResponse = Shapes::StructureShape.new(name: 'DescribeTrailsResponse')
53
+ Destination = Shapes::StructureShape.new(name: 'Destination')
54
+ DestinationType = Shapes::StringShape.new(name: 'DestinationType')
55
+ Destinations = Shapes::ListShape.new(name: 'Destinations')
47
56
  ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
48
57
  Event = Shapes::StructureShape.new(name: 'Event')
49
58
  EventCategory = Shapes::StringShape.new(name: 'EventCategory')
@@ -61,6 +70,8 @@ module Aws::CloudTrail
61
70
  EventSelectors = Shapes::ListShape.new(name: 'EventSelectors')
62
71
  EventsList = Shapes::ListShape.new(name: 'EventsList')
63
72
  ExcludeManagementEventSources = Shapes::ListShape.new(name: 'ExcludeManagementEventSources')
73
+ GetChannelRequest = Shapes::StructureShape.new(name: 'GetChannelRequest')
74
+ GetChannelResponse = Shapes::StructureShape.new(name: 'GetChannelResponse')
64
75
  GetEventDataStoreRequest = Shapes::StructureShape.new(name: 'GetEventDataStoreRequest')
65
76
  GetEventDataStoreResponse = Shapes::StructureShape.new(name: 'GetEventDataStoreResponse')
66
77
  GetEventSelectorsRequest = Shapes::StructureShape.new(name: 'GetEventSelectorsRequest')
@@ -110,6 +121,9 @@ module Aws::CloudTrail
110
121
  KmsException = Shapes::StructureShape.new(name: 'KmsException')
111
122
  KmsKeyDisabledException = Shapes::StructureShape.new(name: 'KmsKeyDisabledException')
112
123
  KmsKeyNotFoundException = Shapes::StructureShape.new(name: 'KmsKeyNotFoundException')
124
+ ListChannelsMaxResultsCount = Shapes::IntegerShape.new(name: 'ListChannelsMaxResultsCount')
125
+ ListChannelsRequest = Shapes::StructureShape.new(name: 'ListChannelsRequest')
126
+ ListChannelsResponse = Shapes::StructureShape.new(name: 'ListChannelsResponse')
113
127
  ListEventDataStoresMaxResultsCount = Shapes::IntegerShape.new(name: 'ListEventDataStoresMaxResultsCount')
114
128
  ListEventDataStoresRequest = Shapes::StructureShape.new(name: 'ListEventDataStoresRequest')
115
129
  ListEventDataStoresResponse = Shapes::StructureShape.new(name: 'ListEventDataStoresResponse')
@@ -122,6 +136,7 @@ module Aws::CloudTrail
122
136
  ListTagsResponse = Shapes::StructureShape.new(name: 'ListTagsResponse')
123
137
  ListTrailsRequest = Shapes::StructureShape.new(name: 'ListTrailsRequest')
124
138
  ListTrailsResponse = Shapes::StructureShape.new(name: 'ListTrailsResponse')
139
+ Location = Shapes::StringShape.new(name: 'Location')
125
140
  Long = Shapes::IntegerShape.new(name: 'Long')
126
141
  LookupAttribute = Shapes::StructureShape.new(name: 'LookupAttribute')
127
142
  LookupAttributeKey = Shapes::StringShape.new(name: 'LookupAttributeKey')
@@ -174,6 +189,8 @@ module Aws::CloudTrail
174
189
  S3BucketDoesNotExistException = Shapes::StructureShape.new(name: 'S3BucketDoesNotExistException')
175
190
  SelectorField = Shapes::StringShape.new(name: 'SelectorField')
176
191
  SelectorName = Shapes::StringShape.new(name: 'SelectorName')
192
+ Source = Shapes::StringShape.new(name: 'Source')
193
+ SourceConfig = Shapes::StructureShape.new(name: 'SourceConfig')
177
194
  StartLoggingRequest = Shapes::StructureShape.new(name: 'StartLoggingRequest')
178
195
  StartLoggingResponse = Shapes::StructureShape.new(name: 'StartLoggingResponse')
179
196
  StartQueryRequest = Shapes::StructureShape.new(name: 'StartQueryRequest')
@@ -233,6 +250,16 @@ module Aws::CloudTrail
233
250
  CancelQueryResponse.add_member(:query_status, Shapes::ShapeRef.new(shape: QueryStatus, required: true, location_name: "QueryStatus"))
234
251
  CancelQueryResponse.struct_class = Types::CancelQueryResponse
235
252
 
253
+ Channel.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "ChannelArn"))
254
+ Channel.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "Name"))
255
+ Channel.struct_class = Types::Channel
256
+
257
+ ChannelARNInvalidException.struct_class = Types::ChannelARNInvalidException
258
+
259
+ ChannelNotFoundException.struct_class = Types::ChannelNotFoundException
260
+
261
+ Channels.member = Shapes::ShapeRef.new(shape: Channel)
262
+
236
263
  CloudTrailARNInvalidException.struct_class = Types::CloudTrailARNInvalidException
237
264
 
238
265
  CloudTrailAccessNotEnabledException.struct_class = Types::CloudTrailAccessNotEnabledException
@@ -330,6 +357,12 @@ module Aws::CloudTrail
330
357
  DescribeTrailsResponse.add_member(:trail_list, Shapes::ShapeRef.new(shape: TrailList, location_name: "trailList"))
331
358
  DescribeTrailsResponse.struct_class = Types::DescribeTrailsResponse
332
359
 
360
+ Destination.add_member(:type, Shapes::ShapeRef.new(shape: DestinationType, required: true, location_name: "Type"))
361
+ Destination.add_member(:location, Shapes::ShapeRef.new(shape: Location, required: true, location_name: "Location"))
362
+ Destination.struct_class = Types::Destination
363
+
364
+ Destinations.member = Shapes::ShapeRef.new(shape: Destination)
365
+
333
366
  Event.add_member(:event_id, Shapes::ShapeRef.new(shape: String, location_name: "EventId"))
334
367
  Event.add_member(:event_name, Shapes::ShapeRef.new(shape: String, location_name: "EventName"))
335
368
  Event.add_member(:read_only, Shapes::ShapeRef.new(shape: String, location_name: "ReadOnly"))
@@ -377,6 +410,16 @@ module Aws::CloudTrail
377
410
 
378
411
  ExcludeManagementEventSources.member = Shapes::ShapeRef.new(shape: String)
379
412
 
413
+ GetChannelRequest.add_member(:channel, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "Channel"))
414
+ GetChannelRequest.struct_class = Types::GetChannelRequest
415
+
416
+ GetChannelResponse.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "ChannelArn"))
417
+ GetChannelResponse.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "Name"))
418
+ GetChannelResponse.add_member(:source, Shapes::ShapeRef.new(shape: Source, location_name: "Source"))
419
+ GetChannelResponse.add_member(:source_config, Shapes::ShapeRef.new(shape: SourceConfig, location_name: "SourceConfig"))
420
+ GetChannelResponse.add_member(:destinations, Shapes::ShapeRef.new(shape: Destinations, location_name: "Destinations"))
421
+ GetChannelResponse.struct_class = Types::GetChannelResponse
422
+
380
423
  GetEventDataStoreRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, required: true, location_name: "EventDataStore"))
381
424
  GetEventDataStoreRequest.struct_class = Types::GetEventDataStoreRequest
382
425
 
@@ -519,6 +562,14 @@ module Aws::CloudTrail
519
562
 
520
563
  KmsKeyNotFoundException.struct_class = Types::KmsKeyNotFoundException
521
564
 
565
+ ListChannelsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListChannelsMaxResultsCount, location_name: "MaxResults"))
566
+ ListChannelsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
567
+ ListChannelsRequest.struct_class = Types::ListChannelsRequest
568
+
569
+ ListChannelsResponse.add_member(:channels, Shapes::ShapeRef.new(shape: Channels, location_name: "Channels"))
570
+ ListChannelsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
571
+ ListChannelsResponse.struct_class = Types::ListChannelsResponse
572
+
522
573
  ListEventDataStoresRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
523
574
  ListEventDataStoresRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListEventDataStoresMaxResultsCount, location_name: "MaxResults"))
524
575
  ListEventDataStoresRequest.struct_class = Types::ListEventDataStoresRequest
@@ -690,6 +741,10 @@ module Aws::CloudTrail
690
741
 
691
742
  S3BucketDoesNotExistException.struct_class = Types::S3BucketDoesNotExistException
692
743
 
744
+ SourceConfig.add_member(:apply_to_all_regions, Shapes::ShapeRef.new(shape: Boolean, location_name: "ApplyToAllRegions"))
745
+ SourceConfig.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
746
+ SourceConfig.struct_class = Types::SourceConfig
747
+
693
748
  StartLoggingRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
694
749
  StartLoggingRequest.struct_class = Types::StartLoggingRequest
695
750
 
@@ -971,6 +1026,18 @@ module Aws::CloudTrail
971
1026
  o.errors << Shapes::ShapeRef.new(shape: InvalidTrailNameException)
972
1027
  end)
973
1028
 
1029
+ api.add_operation(:get_channel, Seahorse::Model::Operation.new.tap do |o|
1030
+ o.name = "GetChannel"
1031
+ o.http_method = "POST"
1032
+ o.http_request_uri = "/"
1033
+ o.input = Shapes::ShapeRef.new(shape: GetChannelRequest)
1034
+ o.output = Shapes::ShapeRef.new(shape: GetChannelResponse)
1035
+ o.errors << Shapes::ShapeRef.new(shape: ChannelARNInvalidException)
1036
+ o.errors << Shapes::ShapeRef.new(shape: ChannelNotFoundException)
1037
+ o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
1038
+ o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
1039
+ end)
1040
+
974
1041
  api.add_operation(:get_event_data_store, Seahorse::Model::Operation.new.tap do |o|
975
1042
  o.name = "GetEventDataStore"
976
1043
  o.http_method = "POST"
@@ -1055,6 +1122,23 @@ module Aws::CloudTrail
1055
1122
  o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
1056
1123
  end)
1057
1124
 
1125
+ api.add_operation(:list_channels, Seahorse::Model::Operation.new.tap do |o|
1126
+ o.name = "ListChannels"
1127
+ o.http_method = "POST"
1128
+ o.http_request_uri = "/"
1129
+ o.input = Shapes::ShapeRef.new(shape: ListChannelsRequest)
1130
+ o.output = Shapes::ShapeRef.new(shape: ListChannelsResponse)
1131
+ o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
1132
+ o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
1133
+ o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
1134
+ o[:pager] = Aws::Pager.new(
1135
+ limit_key: "max_results",
1136
+ tokens: {
1137
+ "next_token" => "next_token"
1138
+ }
1139
+ )
1140
+ end)
1141
+
1058
1142
  api.add_operation(:list_event_data_stores, Seahorse::Model::Operation.new.tap do |o|
1059
1143
  o.name = "ListEventDataStores"
1060
1144
  o.http_method = "POST"
@@ -27,6 +27,8 @@ module Aws::CloudTrail
27
27
  # See {Seahorse::Client::RequestContext} for more information.
28
28
  #
29
29
  # ## Error Classes
30
+ # * {ChannelARNInvalidException}
31
+ # * {ChannelNotFoundException}
30
32
  # * {CloudTrailARNInvalidException}
31
33
  # * {CloudTrailAccessNotEnabledException}
32
34
  # * {CloudTrailInvalidClientTokenIdException}
@@ -92,6 +94,26 @@ module Aws::CloudTrail
92
94
 
93
95
  extend Aws::Errors::DynamicErrors
94
96
 
97
+ class ChannelARNInvalidException < ServiceError
98
+
99
+ # @param [Seahorse::Client::RequestContext] context
100
+ # @param [String] message
101
+ # @param [Aws::CloudTrail::Types::ChannelARNInvalidException] data
102
+ def initialize(context, message, data = Aws::EmptyStructure.new)
103
+ super(context, message, data)
104
+ end
105
+ end
106
+
107
+ class ChannelNotFoundException < ServiceError
108
+
109
+ # @param [Seahorse::Client::RequestContext] context
110
+ # @param [String] message
111
+ # @param [Aws::CloudTrail::Types::ChannelNotFoundException] data
112
+ def initialize(context, message, data = Aws::EmptyStructure.new)
113
+ super(context, message, data)
114
+ end
115
+ end
116
+
95
117
  class CloudTrailARNInvalidException < ServiceError
96
118
 
97
119
  # @param [Seahorse::Client::RequestContext] context
@@ -136,9 +136,9 @@ module Aws::CloudTrail
136
136
  #
137
137
  # * <b> <code>readOnly</code> </b> - Optional. Can be set to `Equals`
138
138
  # a value of `true` or `false`. If you do not add this field,
139
- # CloudTrail logs both both `read` and `write` events. A value of
140
- # `true` logs only `read` events. A value of `false` logs only
141
- # `write` events.
139
+ # CloudTrail logs both `read` and `write` events. A value of `true`
140
+ # logs only `read` events. A value of `false` logs only `write`
141
+ # events.
142
142
  #
143
143
  # * <b> <code>eventSource</code> </b> - For filtering management
144
144
  # events only. This can be set only to `NotEquals`
@@ -363,6 +363,42 @@ module Aws::CloudTrail
363
363
  include Aws::Structure
364
364
  end
365
365
 
366
+ # Contains information about a returned CloudTrail channel.
367
+ #
368
+ # @!attribute [rw] channel_arn
369
+ # The Amazon Resource Name (ARN) of the channel.
370
+ # @return [String]
371
+ #
372
+ # @!attribute [rw] name
373
+ # The name of the CloudTrail channel. For service-linked channels, the
374
+ # name is `aws-service-channel/service-name/custom-suffix` where
375
+ # `service-name` represents the name of the Amazon Web Services
376
+ # service that created the channel and `custom-suffix` represents the
377
+ # suffix created by the Amazon Web Services service.
378
+ # @return [String]
379
+ #
380
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Channel AWS API Documentation
381
+ #
382
+ class Channel < Struct.new(
383
+ :channel_arn,
384
+ :name)
385
+ SENSITIVE = []
386
+ include Aws::Structure
387
+ end
388
+
389
+ # The specified channel ARN is not valid or does not map to a channel in
390
+ # your account.
391
+ #
392
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelARNInvalidException AWS API Documentation
393
+ #
394
+ class ChannelARNInvalidException < Aws::EmptyStructure; end
395
+
396
+ # The specified channel was not found.
397
+ #
398
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelNotFoundException AWS API Documentation
399
+ #
400
+ class ChannelNotFoundException < Aws::EmptyStructure; end
401
+
366
402
  # This exception is thrown when an operation is called with a trail ARN
367
403
  # that is not valid. The following is the format of a trail ARN.
368
404
  #
@@ -472,7 +508,7 @@ module Aws::CloudTrail
472
508
  #
473
509
  # @!attribute [rw] retention_period
474
510
  # The retention period of the event data store, in days. You can set a
475
- # retention period of up to 2555 days, the equivalent of seven years.
511
+ # retention period of up to 2557 days, the equivalent of seven years.
476
512
  # @return [Integer]
477
513
  #
478
514
  # @!attribute [rw] termination_protection_enabled
@@ -1172,6 +1208,28 @@ module Aws::CloudTrail
1172
1208
  include Aws::Structure
1173
1209
  end
1174
1210
 
1211
+ # Contains information about the service where CloudTrail delivers
1212
+ # events.
1213
+ #
1214
+ # @!attribute [rw] type
1215
+ # The type of service. For service-linked channels, the value is
1216
+ # `AWS_SERVICE`.
1217
+ # @return [String]
1218
+ #
1219
+ # @!attribute [rw] location
1220
+ # The location of the service. For service-linked channels, this is
1221
+ # the name of the Amazon Web Services service.
1222
+ # @return [String]
1223
+ #
1224
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Destination AWS API Documentation
1225
+ #
1226
+ class Destination < Struct.new(
1227
+ :type,
1228
+ :location)
1229
+ SENSITIVE = []
1230
+ include Aws::Structure
1231
+ end
1232
+
1175
1233
  # Contains information about an event that was returned by a lookup
1176
1234
  # request. The result includes a representation of a CloudTrail event.
1177
1235
  #
@@ -1233,7 +1291,7 @@ module Aws::CloudTrail
1233
1291
 
1234
1292
  # A storage lake of event data against which you can run complex
1235
1293
  # SQL-based queries. An event data store can include events that you
1236
- # have logged on your account from the last 90 to 2555 days (about three
1294
+ # have logged on your account from the last 90 to 2557 days (about three
1237
1295
  # months to up to seven years). To select events for an event data
1238
1296
  # store, use [advanced event selectors][1].
1239
1297
  #
@@ -1436,6 +1494,67 @@ module Aws::CloudTrail
1436
1494
  include Aws::Structure
1437
1495
  end
1438
1496
 
1497
+ # @note When making an API call, you may pass GetChannelRequest
1498
+ # data as a hash:
1499
+ #
1500
+ # {
1501
+ # channel: "ChannelArn", # required
1502
+ # }
1503
+ #
1504
+ # @!attribute [rw] channel
1505
+ # The Amazon Resource Name (ARN) of the CloudTrail service-linked
1506
+ # channel.
1507
+ # @return [String]
1508
+ #
1509
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelRequest AWS API Documentation
1510
+ #
1511
+ class GetChannelRequest < Struct.new(
1512
+ :channel)
1513
+ SENSITIVE = []
1514
+ include Aws::Structure
1515
+ end
1516
+
1517
+ # @!attribute [rw] channel_arn
1518
+ # The ARN of the CloudTrail service-linked channel.
1519
+ # @return [String]
1520
+ #
1521
+ # @!attribute [rw] name
1522
+ # The name of the CloudTrail service-linked channel. For
1523
+ # service-linked channels, the value is
1524
+ # `aws-service-channel/service-name/custom-suffix` where
1525
+ # `service-name` represents the name of the Amazon Web Services
1526
+ # service that created the channel and `custom-suffix` represents the
1527
+ # suffix generated by the Amazon Web Services service.
1528
+ # @return [String]
1529
+ #
1530
+ # @!attribute [rw] source
1531
+ # The trail or event data store for the CloudTrail service-linked
1532
+ # channel.
1533
+ # @return [String]
1534
+ #
1535
+ # @!attribute [rw] source_config
1536
+ # Provides information about the advanced event selectors configured
1537
+ # for the service-linked channel, and whether the service-linked
1538
+ # channel applies to all regions or one region.
1539
+ # @return [Types::SourceConfig]
1540
+ #
1541
+ # @!attribute [rw] destinations
1542
+ # The Amazon Web Services service that created the CloudTrail
1543
+ # service-linked channel.
1544
+ # @return [Array<Types::Destination>]
1545
+ #
1546
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelResponse AWS API Documentation
1547
+ #
1548
+ class GetChannelResponse < Struct.new(
1549
+ :channel_arn,
1550
+ :name,
1551
+ :source,
1552
+ :source_config,
1553
+ :destinations)
1554
+ SENSITIVE = []
1555
+ include Aws::Structure
1556
+ end
1557
+
1439
1558
  # @note When making an API call, you may pass GetEventDataStoreRequest
1440
1559
  # data as a hash:
1441
1560
  #
@@ -2201,6 +2320,49 @@ module Aws::CloudTrail
2201
2320
  #
2202
2321
  class KmsKeyNotFoundException < Aws::EmptyStructure; end
2203
2322
 
2323
+ # @note When making an API call, you may pass ListChannelsRequest
2324
+ # data as a hash:
2325
+ #
2326
+ # {
2327
+ # max_results: 1,
2328
+ # next_token: "PaginationToken",
2329
+ # }
2330
+ #
2331
+ # @!attribute [rw] max_results
2332
+ # The maximum number of CloudTrail channels to display on a single
2333
+ # page.
2334
+ # @return [Integer]
2335
+ #
2336
+ # @!attribute [rw] next_token
2337
+ # A token you can use to get the next page of results.
2338
+ # @return [String]
2339
+ #
2340
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsRequest AWS API Documentation
2341
+ #
2342
+ class ListChannelsRequest < Struct.new(
2343
+ :max_results,
2344
+ :next_token)
2345
+ SENSITIVE = []
2346
+ include Aws::Structure
2347
+ end
2348
+
2349
+ # @!attribute [rw] channels
2350
+ # The list of CloudTrail channels.
2351
+ # @return [Array<Types::Channel>]
2352
+ #
2353
+ # @!attribute [rw] next_token
2354
+ # A token used to get the next page of results.
2355
+ # @return [String]
2356
+ #
2357
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsResponse AWS API Documentation
2358
+ #
2359
+ class ListChannelsResponse < Struct.new(
2360
+ :channels,
2361
+ :next_token)
2362
+ SENSITIVE = []
2363
+ include Aws::Structure
2364
+ end
2365
+
2204
2366
  # @note When making an API call, you may pass ListEventDataStoresRequest
2205
2367
  # data as a hash:
2206
2368
  #
@@ -2436,9 +2598,9 @@ module Aws::CloudTrail
2436
2598
  # @!attribute [rw] next_token
2437
2599
  # The token to use to get the next page of results after a previous
2438
2600
  # API call. This token must be passed in with the same parameters that
2439
- # were specified in the the original call. For example, if the
2440
- # original call specified an AttributeKey of 'Username' with a value
2441
- # of 'root', the call with NextToken should include those same
2601
+ # were specified in the original call. For example, if the original
2602
+ # call specified an AttributeKey of 'Username' with a value of
2603
+ # 'root', the call with NextToken should include those same
2442
2604
  # parameters.
2443
2605
  # @return [String]
2444
2606
  #
@@ -2551,9 +2713,9 @@ module Aws::CloudTrail
2551
2713
  # @!attribute [rw] next_token
2552
2714
  # The token to use to get the next page of results after a previous
2553
2715
  # API call. This token must be passed in with the same parameters that
2554
- # were specified in the the original call. For example, if the
2555
- # original call specified an AttributeKey of 'Username' with a value
2556
- # of 'root', the call with NextToken should include those same
2716
+ # were specified in the original call. For example, if the original
2717
+ # call specified an AttributeKey of 'Username' with a value of
2718
+ # 'root', the call with NextToken should include those same
2557
2719
  # parameters.
2558
2720
  # @return [String]
2559
2721
  #
@@ -3141,6 +3303,27 @@ module Aws::CloudTrail
3141
3303
  #
3142
3304
  class S3BucketDoesNotExistException < Aws::EmptyStructure; end
3143
3305
 
3306
+ # Contains configuration information about the service-linked channel.
3307
+ #
3308
+ # @!attribute [rw] apply_to_all_regions
3309
+ # Specifies whether the service-linked channel applies to one region
3310
+ # or all regions.
3311
+ # @return [Boolean]
3312
+ #
3313
+ # @!attribute [rw] advanced_event_selectors
3314
+ # The advanced event selectors configured for the service-linked
3315
+ # channel.
3316
+ # @return [Array<Types::AdvancedEventSelector>]
3317
+ #
3318
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/SourceConfig AWS API Documentation
3319
+ #
3320
+ class SourceConfig < Struct.new(
3321
+ :apply_to_all_regions,
3322
+ :advanced_event_selectors)
3323
+ SENSITIVE = []
3324
+ include Aws::Structure
3325
+ end
3326
+
3144
3327
  # The request to CloudTrail to start logging Amazon Web Services API
3145
3328
  # calls for an account.
3146
3329
  #
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
48
48
  # @!group service
49
49
  module Aws::CloudTrail
50
50
 
51
- GEM_VERSION = '1.49.0'
51
+ GEM_VERSION = '1.50.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudtrail
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.49.0
4
+ version: 1.50.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-04-27 00:00:00.000000000 Z
11
+ date: 2022-09-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core