aws-sdk-cloudtrail 1.48.0 → 1.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea630b4679fdf4f58a77902585ce0f9f23e350bc7823e177fc59d8bcc0fd0411
-  data.tar.gz: aca1072855a3f93d0ed4e27a3d2af73f3f9f05ef3a064f00abc53047b4026efd
+  metadata.gz: dec5d187176c43abe1b0f9e22af755232ba56d77e6046d484a4941906e768822
+  data.tar.gz: 031acc2864f6fd5fc8a6378177056166b3d6a13bc591565c69ced8c63513e5c4
 SHA512:
-  metadata.gz: 574f25f888c454defe2cb10a5d9af137c70f40edaa0fb4371e78c556498cce9027fc074073fd08c56f953d3f1a0416bf6665c9080377cd0e9bf4d4ade9b9e00f
-  data.tar.gz: fe4e7b8f7eb8ed06cc5dc0a446280b94016daf1759b39f4068e0be49b0ab7dd49bb25b1532ab67d5cb177e27b37a7178f1c2172fd57adab6b81bd5efc1a178b4
+  metadata.gz: 55e951e6f59972a6cf10f73ceebc98d1764dfd9171d5dc84cee5b1b0f3618cb6d0ad6a2ae671357eca2cc30d43a6b282f19a2cef37667153033195a027b63c0e
+  data.tar.gz: '0853615833aa071d8fce2194c44c1ae0c19f3c7d2e7c92ff79345f66b1b65abc9121ea292eacdd452f555dd2e92084c70d09d75e696d221591d0e43f4e8459d7'

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.49.0 (2022-04-27)
+------------------
+
+* Feature - Increases the retention period maximum to 2557 days. Deprecates unused fields of the ListEventDataStores API response. Updates documentation.
+
 1.48.0 (2022-03-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.48.0
+1.49.0

data/lib/aws-sdk-cloudtrail/client.rb

@@ -361,18 +361,19 @@ module Aws::CloudTrail
 
     # @!group API Operations
 
-    # Adds one or more tags to a trail, up to a limit of 50. Overwrites an
-    # existing tag's value when a new value is specified for an existing
-    # tag key. Tag key names must be unique for a trail; you cannot have two
-    # keys with the same name but different values. If you specify a key
-    # without a value, the tag will be created with the specified key and a
-    # value of null. You can tag a trail that applies to all Amazon Web
-    # Services Regions only from the Region in which the trail was created
-    # (also known as its home region).
+    # Adds one or more tags to a trail or event data store, up to a limit of
+    # 50. Overwrites an existing tag's value when a new value is specified
+    # for an existing tag key. Tag key names must be unique for a trail; you
+    # cannot have two keys with the same name but different values. If you
+    # specify a key without a value, the tag will be created with the
+    # specified key and a value of null. You can tag a trail or event data
+    # store that applies to all Amazon Web Services Regions only from the
+    # Region in which the trail or event data store was created (also known
+    # as its home region).
     #
     # @option params [required, String] :resource_id
-    #   Specifies the ARN of the trail to which one or more tags will be
-    #   added. The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store to which one or
+    #   more tags will be added. The format of a trail ARN is:
     #
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #
@@ -1492,13 +1493,12 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Lists the tags for the trail in the current region.
+    # Lists the tags for the trail or event data store in the current
+    # region.
     #
     # @option params [required, Array<String>] :resource_id_list
-    #   Specifies a list of trail ARNs whose tags will be listed. The list has
-    #   a limit of 20 ARNs. The following is the format of a trail ARN.
-    #
-    #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #   Specifies a list of trail and event data store ARNs whose tags will be
+    #   listed. The list has a limit of 20 ARNs.
     #
     # @option params [String] :next_token
     #   Reserved for future use.
@@ -1911,14 +1911,18 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Removes the specified tags from a trail.
+    # Removes the specified tags from a trail or event data store.
     #
     # @option params [required, String] :resource_id
-    #   Specifies the ARN of the trail from which tags should be removed. The
-    #   format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store from which tags
+    #   should be removed.
     #
+    #   Example trail ARN format:
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #
+    #   Example event data store ARN format:
+    #   `arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
+    #
     # @option params [required, Array<Types::Tag>] :tags_list
     #   Specifies a list of tags to be removed.
     #
@@ -2414,7 +2418,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.48.0'
+      context[:gem_version] = '1.49.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudtrail/client_api.rb

@@ -343,14 +343,14 @@ module Aws::CloudTrail
 
     EventDataStore.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
     EventDataStore.add_member(:name, Shapes::ShapeRef.new(shape: EventDataStoreName, location_name: "Name"))
-    EventDataStore.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, location_name: "TerminationProtectionEnabled"))
-    EventDataStore.add_member(:status, Shapes::ShapeRef.new(shape: EventDataStoreStatus, location_name: "Status"))
-    EventDataStore.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
-    EventDataStore.add_member(:multi_region_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "MultiRegionEnabled"))
-    EventDataStore.add_member(:organization_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "OrganizationEnabled"))
-    EventDataStore.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, location_name: "RetentionPeriod"))
-    EventDataStore.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
-    EventDataStore.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
+    EventDataStore.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, deprecated: true, location_name: "TerminationProtectionEnabled", metadata: {"deprecatedMessage"=>"TerminationProtectionEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:status, Shapes::ShapeRef.new(shape: EventDataStoreStatus, deprecated: true, location_name: "Status", metadata: {"deprecatedMessage"=>"Status is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, deprecated: true, location_name: "AdvancedEventSelectors", metadata: {"deprecatedMessage"=>"AdvancedEventSelectors is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:multi_region_enabled, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "MultiRegionEnabled", metadata: {"deprecatedMessage"=>"MultiRegionEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:organization_enabled, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "OrganizationEnabled", metadata: {"deprecatedMessage"=>"OrganizationEnabled is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, deprecated: true, location_name: "RetentionPeriod", metadata: {"deprecatedMessage"=>"RetentionPeriod is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, deprecated: true, location_name: "CreatedTimestamp", metadata: {"deprecatedMessage"=>"CreatedTimestamp is no longer returned by ListEventDataStores"}))
+    EventDataStore.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, deprecated: true, location_name: "UpdatedTimestamp", metadata: {"deprecatedMessage"=>"UpdatedTimestamp is no longer returned by ListEventDataStores"}))
     EventDataStore.struct_class = Types::EventDataStore
 
     EventDataStoreARNInvalidException.struct_class = Types::EventDataStoreARNInvalidException

data/lib/aws-sdk-cloudtrail/types.rb

@@ -10,7 +10,7 @@
 module Aws::CloudTrail
   module Types
 
-    # Specifies the tags to add to a trail.
+    # Specifies the tags to add to a trail or event data store.
     #
     # @note When making an API call, you may pass AddTagsRequest
     #   data as a hash:
@@ -26,8 +26,8 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id
-    #   Specifies the ARN of the trail to which one or more tags will be
-    #   added. The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store to which one or
+    #   more tags will be added. The format of a trail ARN is:
     #
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
     #   @return [String]
@@ -403,8 +403,8 @@ module Aws::CloudTrail
 
     # This exception is thrown when the specified resource is not ready for
     # an operation. This can occur when you try to run an operation on a
-    # trail before CloudTrail has time to fully load the trail. If this
-    # exception occurs, wait a few minutes, and then try the operation
+    # resource before CloudTrail has time to fully load the resource. If
+    # this exception occurs, wait a few minutes, and then try the operation
     # again.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ConflictException AWS API Documentation
@@ -1250,42 +1250,44 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] termination_protection_enabled
-    #   Indicates whether the event data store is protected from
-    #   termination.
+    #   This field is being deprecated. Indicates whether the event data
+    #   store is protected from termination.
     #   @return [Boolean]
     #
     # @!attribute [rw] status
-    #   The status of an event data store. Values are `ENABLED` and
-    #   `PENDING_DELETION`.
+    #   This field is being deprecated. The status of an event data store.
+    #   Values are `ENABLED` and `PENDING_DELETION`.
     #   @return [String]
     #
     # @!attribute [rw] advanced_event_selectors
-    #   The advanced event selectors that were used to select events for the
-    #   data store.
+    #   This field is being deprecated. The advanced event selectors that
+    #   were used to select events for the data store.
     #   @return [Array<Types::AdvancedEventSelector>]
     #
     # @!attribute [rw] multi_region_enabled
-    #   Indicates whether the event data store includes events from all
-    #   regions, or only from the region in which it was created.
+    #   This field is being deprecated. Indicates whether the event data
+    #   store includes events from all regions, or only from the region in
+    #   which it was created.
     #   @return [Boolean]
     #
     # @!attribute [rw] organization_enabled
-    #   Indicates that an event data store is collecting logged events for
-    #   an organization.
+    #   This field is being deprecated. Indicates that an event data store
+    #   is collecting logged events for an organization.
     #   @return [Boolean]
     #
     # @!attribute [rw] retention_period
-    #   The retention period, in days.
+    #   This field is being deprecated. The retention period, in days.
     #   @return [Integer]
     #
     # @!attribute [rw] created_timestamp
-    #   The timestamp of the event data store's creation.
+    #   This field is being deprecated. The timestamp of the event data
+    #   store's creation.
     #   @return [Time]
     #
     # @!attribute [rw] updated_timestamp
-    #   The timestamp showing when an event data store was updated, if
-    #   applicable. `UpdatedTimestamp` is always either the same or newer
-    #   than the time shown in `CreatedTimestamp`.
+    #   This field is being deprecated. The timestamp showing when an event
+    #   data store was updated, if applicable. `UpdatedTimestamp` is always
+    #   either the same or newer than the time shown in `CreatedTimestamp`.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStore AWS API Documentation
@@ -1900,7 +1902,7 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # The event data store against which you ran your query is inactive.
+    # The event data store is inactive.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InactiveEventDataStoreException AWS API Documentation
     #
@@ -1945,14 +1947,9 @@ module Aws::CloudTrail
     end
 
     # This exception is thrown when the IAM user or role that is used to
-    # create the organization trail is lacking one or more required
-    # permissions for creating an organization trail in a required service.
-    # For more information, see [Prepare For Creating a Trail For Your
-    # Organization][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # create the organization resource lacks one or more required
+    # permissions for creating an organization resource in a required
+    # service.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InsufficientDependencyServiceAccessPermissionException AWS API Documentation
     #
@@ -1992,7 +1989,8 @@ module Aws::CloudTrail
     #
     class InvalidCloudWatchLogsRoleArnException < Aws::EmptyStructure; end
 
-    # A date range for the query was specified that is not valid. For more
+    # A date range for the query was specified that is not valid. Be sure
+    # that the start time is chronologically before the end time. For more
     # information about writing a query, see [Create or edit a query][1] in
     # the *CloudTrail User Guide*.
     #
@@ -2380,7 +2378,7 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # Specifies a list of trail tags to return.
+    # Specifies a list of tags to return.
     #
     # @note When making an API call, you may pass ListTagsRequest
     #   data as a hash:
@@ -2391,10 +2389,8 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id_list
-    #   Specifies a list of trail ARNs whose tags will be listed. The list
-    #   has a limit of 20 ARNs. The following is the format of a trail ARN.
-    #
-    #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #   Specifies a list of trail and event data store ARNs whose tags will
+    #   be listed. The list has a limit of 20 ARNs.
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
@@ -2614,14 +2610,15 @@ module Aws::CloudTrail
     class MaximumNumberOfTrailsExceededException < Aws::EmptyStructure; end
 
     # This exception is thrown when the Amazon Web Services account making
-    # the request to create or update an organization trail is not the
-    # management account for an organization in Organizations. For more
-    # information, see [Prepare For Creating a Trail For Your
-    # Organization][1].
+    # the request to create or update an organization trail or event data
+    # store is not the management account for an organization in
+    # Organizations. For more information, see [Prepare For Creating a Trail
+    # For Your Organization][1] or [Create an event data store][2].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store.html
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/NotOrganizationMasterAccountException AWS API Documentation
     #
@@ -2636,12 +2633,7 @@ module Aws::CloudTrail
 
     # This exception is thrown when Organizations is not configured to
     # support all features. All features must be enabled in Organizations to
-    # support creating an organization trail. For more information, see
-    # [Prepare For Creating a Trail For Your Organization][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-an-organizational-trail-prepare.html
+    # support creating an organization trail or event data store.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/OrganizationNotInAllFeaturesModeException AWS API Documentation
     #
@@ -2950,7 +2942,7 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # Specifies the tags to remove from a trail.
+    # Specifies the tags to remove from a trail or event data store.
     #
     # @note When making an API call, you may pass RemoveTagsRequest
     #   data as a hash:
@@ -2966,10 +2958,14 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] resource_id
-    #   Specifies the ARN of the trail from which tags should be removed.
-    #   The format of a trail ARN is:
+    #   Specifies the ARN of the trail or event data store from which tags
+    #   should be removed.
     #
+    #   Example trail ARN format:
     #   `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
+    #
+    #   Example event data store ARN format:
+    #   `arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
     #   @return [String]
     #
     # @!attribute [rw] tags_list

data/lib/aws-sdk-cloudtrail.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
 # @!group service
 module Aws::CloudTrail
 
-  GEM_VERSION = '1.48.0'
+  GEM_VERSION = '1.49.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudtrail
 version: !ruby/object:Gem::Version
-  version: 1.48.0
+  version: 1.49.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-02 00:00:00.000000000 Z
+date: 2022-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core