aws-sdk-cloudwatchevents 1.38.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0480117e540fcb334262c222149f76c73b8f529e11370e8eadb501ba879fa8b2'
-  data.tar.gz: c41361261ba74687c207804cb2e399e71a6dcf6612a67f9bcb1b162e4eae8946
+  metadata.gz: 0b03d535cd960bdd4710ecda4abb49dfb2428ff784d28f64fc221a5a2eb094af
+  data.tar.gz: 61364d1e8c1b596eb647c6af721be7fc289c1afb62efffb1ab474642434b6e66
 SHA512:
-  metadata.gz: 21137ed8b17d72281691ae5f921aa0f7a6d235eb0531ed3cf8c9b239d051da515d7f82431831bd9f6d501842cdf46c5dc594865b2a7748ebddb5c9fa15a8ce0d
-  data.tar.gz: 622d14da3f058ea97ae9a9b48f0c03cee1c31af34a5cb73a12d92a4c28e174a857a7bc8bd6120ea115d2e572aebe68312fab47b74e0b6cd670bbf6b8a71a33b8
+  metadata.gz: db0f56b7e24868dd4ce2deecc838134dee0328c56f46c62469512ae2a9bfdc0917f4cc8fe8798641fd3563d97e54f3a69700fda1109a5ab077dfa9155b691cfe
+  data.tar.gz: 22950e7b7f66d4bc5e9a918e3f633867b9bbb966236fe2796fd5218a6eb07b9eb7ece5bacee6b5daa506566310ba188479939ecf6af6344b83263db3eda50574

data/lib/aws-sdk-cloudwatchevents.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudwatchevents/customizations'
 # @!group service
 module Aws::CloudWatchEvents
 
-  GEM_VERSION = '1.38.0'
+  GEM_VERSION = '1.39.0'
 
 end

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

@@ -361,6 +361,92 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Cancels the specified replay.
+    #
+    # @option params [required, String] :replay_name
+    #   The name of the replay to cancel.
+    #
+    # @return [Types::CancelReplayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CancelReplayResponse#replay_arn #replay_arn} => String
+    #   * {Types::CancelReplayResponse#state #state} => String
+    #   * {Types::CancelReplayResponse#state_reason #state_reason} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_replay({
+    #     replay_name: "ReplayName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.replay_arn #=> String
+    #   resp.state #=> String, one of "STARTING", "RUNNING", "CANCELLING", "COMPLETED", "CANCELLED", "FAILED"
+    #   resp.state_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/CancelReplay AWS API Documentation
+    #
+    # @overload cancel_replay(params = {})
+    # @param [Hash] params ({})
+    def cancel_replay(params = {}, options = {})
+      req = build_request(:cancel_replay, params)
+      req.send_request(options)
+    end
+
+    # Creates an archive of events with the specified settings. When you
+    # create an archive, incoming events might not immediately start being
+    # sent to the archive. Allow a short period of time for changes to take
+    # effect.
+    #
+    # @option params [required, String] :archive_name
+    #   The name for the archive to create.
+    #
+    # @option params [required, String] :event_source_arn
+    #   The ARN of the event source associated with the archive.
+    #
+    # @option params [String] :description
+    #   A description for the archive.
+    #
+    # @option params [String] :event_pattern
+    #   An event pattern to use to filter events sent to the archive.
+    #
+    # @option params [Integer] :retention_days
+    #   The number of days to retain events for. Default value is 0. If set to
+    #   0, events are retained indefinitely
+    #
+    # @return [Types::CreateArchiveResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateArchiveResponse#archive_arn #archive_arn} => String
+    #   * {Types::CreateArchiveResponse#state #state} => String
+    #   * {Types::CreateArchiveResponse#state_reason #state_reason} => String
+    #   * {Types::CreateArchiveResponse#creation_time #creation_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_archive({
+    #     archive_name: "ArchiveName", # required
+    #     event_source_arn: "Arn", # required
+    #     description: "ArchiveDescription",
+    #     event_pattern: "EventPattern",
+    #     retention_days: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.archive_arn #=> String
+    #   resp.state #=> String, one of "ENABLED", "DISABLED", "CREATING", "UPDATING", "CREATE_FAILED", "UPDATE_FAILED"
+    #   resp.state_reason #=> String
+    #   resp.creation_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/CreateArchive AWS API Documentation
+    #
+    # @overload create_archive(params = {})
+    # @param [Hash] params ({})
+    def create_archive(params = {}, options = {})
+      req = build_request(:create_archive, params)
+      req.send_request(options)
+    end
+
     # Creates a new event bus within your account. This can be a custom
     # event bus which you can use to receive events from your custom
     # applications and services, or it can be a partner event bus which can
@@ -507,6 +593,28 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Deletes the specified archive.
+    #
+    # @option params [required, String] :archive_name
+    #   The name of the archive to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_archive({
+    #     archive_name: "ArchiveName", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DeleteArchive AWS API Documentation
+    #
+    # @overload delete_archive(params = {})
+    # @param [Hash] params ({})
+    def delete_archive(params = {}, options = {})
+      req = build_request(:delete_archive, params)
+      req.send_request(options)
+    end
+
     # Deletes the specified custom event bus or partner event bus. All rules
     # associated with this event bus need to be deleted. You can't delete
     # your account's default event bus.
@@ -609,6 +717,54 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Retrieves details about an archive.
+    #
+    # @option params [required, String] :archive_name
+    #   The name of the archive to retrieve.
+    #
+    # @return [Types::DescribeArchiveResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeArchiveResponse#archive_arn #archive_arn} => String
+    #   * {Types::DescribeArchiveResponse#archive_name #archive_name} => String
+    #   * {Types::DescribeArchiveResponse#event_source_arn #event_source_arn} => String
+    #   * {Types::DescribeArchiveResponse#description #description} => String
+    #   * {Types::DescribeArchiveResponse#event_pattern #event_pattern} => String
+    #   * {Types::DescribeArchiveResponse#state #state} => String
+    #   * {Types::DescribeArchiveResponse#state_reason #state_reason} => String
+    #   * {Types::DescribeArchiveResponse#retention_days #retention_days} => Integer
+    #   * {Types::DescribeArchiveResponse#size_bytes #size_bytes} => Integer
+    #   * {Types::DescribeArchiveResponse#event_count #event_count} => Integer
+    #   * {Types::DescribeArchiveResponse#creation_time #creation_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_archive({
+    #     archive_name: "ArchiveName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.archive_arn #=> String
+    #   resp.archive_name #=> String
+    #   resp.event_source_arn #=> String
+    #   resp.description #=> String
+    #   resp.event_pattern #=> String
+    #   resp.state #=> String, one of "ENABLED", "DISABLED", "CREATING", "UPDATING", "CREATE_FAILED", "UPDATE_FAILED"
+    #   resp.state_reason #=> String
+    #   resp.retention_days #=> Integer
+    #   resp.size_bytes #=> Integer
+    #   resp.event_count #=> Integer
+    #   resp.creation_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DescribeArchive AWS API Documentation
+    #
+    # @overload describe_archive(params = {})
+    # @param [Hash] params ({})
+    def describe_archive(params = {}, options = {})
+      req = build_request(:describe_archive, params)
+      req.send_request(options)
+    end
+
     # Displays details about an event bus in your account. This can include
     # the external AWS accounts that are permitted to write events to your
     # default event bus, and the associated policy. For custom event buses
@@ -723,6 +879,67 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Retrieves details about a replay. Use `DescribeReplay` to determine
+    # the progress of a running replay. A replay processes events to replay
+    # based on the time in the event, and replays them using 1 minute
+    # intervals. If you use `StartReplay` and specify an `EventStartTime`
+    # and an `EventEndTime` that covers a 20 minute time range, the events
+    # are replayed from the first minute of that 20 minute range first. Then
+    # the events from the second minute are replayed. You can use
+    # `DescribeReplay` to determine the progress of a replay. The value
+    # returned for `EventLastReplayedTime` indicates the time within the
+    # specified time range associated with the last event replayed.
+    #
+    # @option params [required, String] :replay_name
+    #   The name of the replay to retrieve.
+    #
+    # @return [Types::DescribeReplayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeReplayResponse#replay_name #replay_name} => String
+    #   * {Types::DescribeReplayResponse#replay_arn #replay_arn} => String
+    #   * {Types::DescribeReplayResponse#description #description} => String
+    #   * {Types::DescribeReplayResponse#state #state} => String
+    #   * {Types::DescribeReplayResponse#state_reason #state_reason} => String
+    #   * {Types::DescribeReplayResponse#event_source_arn #event_source_arn} => String
+    #   * {Types::DescribeReplayResponse#destination #destination} => Types::ReplayDestination
+    #   * {Types::DescribeReplayResponse#event_start_time #event_start_time} => Time
+    #   * {Types::DescribeReplayResponse#event_end_time #event_end_time} => Time
+    #   * {Types::DescribeReplayResponse#event_last_replayed_time #event_last_replayed_time} => Time
+    #   * {Types::DescribeReplayResponse#replay_start_time #replay_start_time} => Time
+    #   * {Types::DescribeReplayResponse#replay_end_time #replay_end_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_replay({
+    #     replay_name: "ReplayName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.replay_name #=> String
+    #   resp.replay_arn #=> String
+    #   resp.description #=> String
+    #   resp.state #=> String, one of "STARTING", "RUNNING", "CANCELLING", "COMPLETED", "CANCELLED", "FAILED"
+    #   resp.state_reason #=> String
+    #   resp.event_source_arn #=> String
+    #   resp.destination.arn #=> String
+    #   resp.destination.filter_arns #=> Array
+    #   resp.destination.filter_arns[0] #=> String
+    #   resp.event_start_time #=> Time
+    #   resp.event_end_time #=> Time
+    #   resp.event_last_replayed_time #=> Time
+    #   resp.replay_start_time #=> Time
+    #   resp.replay_end_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DescribeReplay AWS API Documentation
+    #
+    # @overload describe_replay(params = {})
+    # @param [Hash] params ({})
+    def describe_replay(params = {}, options = {})
+      req = build_request(:describe_replay, params)
+      req.send_request(options)
+    end
+
     # Describes the specified rule.
     #
     # DescribeRule does not list the targets of a rule. To see the targets
@@ -839,6 +1056,64 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Lists your archives. You can either list all the archives or you can
+    # provide a prefix to match to the archive names. Filter parameters are
+    # exclusive.
+    #
+    # @option params [String] :name_prefix
+    #   A name prefix to filter the archives returned. Only archives with name
+    #   that match the prefix are returned.
+    #
+    # @option params [String] :event_source_arn
+    #   The ARN of the event source associated with the archive.
+    #
+    # @option params [String] :state
+    #   The state of the archive.
+    #
+    # @option params [String] :next_token
+    #   The token returned by a previous call to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :limit
+    #   The maximum number of results to return.
+    #
+    # @return [Types::ListArchivesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListArchivesResponse#archives #archives} => Array<Types::Archive>
+    #   * {Types::ListArchivesResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_archives({
+    #     name_prefix: "ArchiveName",
+    #     event_source_arn: "Arn",
+    #     state: "ENABLED", # accepts ENABLED, DISABLED, CREATING, UPDATING, CREATE_FAILED, UPDATE_FAILED
+    #     next_token: "NextToken",
+    #     limit: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.archives #=> Array
+    #   resp.archives[0].archive_name #=> String
+    #   resp.archives[0].event_source_arn #=> String
+    #   resp.archives[0].state #=> String, one of "ENABLED", "DISABLED", "CREATING", "UPDATING", "CREATE_FAILED", "UPDATE_FAILED"
+    #   resp.archives[0].state_reason #=> String
+    #   resp.archives[0].retention_days #=> Integer
+    #   resp.archives[0].size_bytes #=> Integer
+    #   resp.archives[0].event_count #=> Integer
+    #   resp.archives[0].creation_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/ListArchives AWS API Documentation
+    #
+    # @overload list_archives(params = {})
+    # @param [Hash] params ({})
+    def list_archives(params = {}, options = {})
+      req = build_request(:list_archives, params)
+      req.send_request(options)
+    end
+
     # Lists all the event buses in your account, including the default event
     # bus, custom event buses, and partner event buses.
     #
@@ -1029,6 +1304,65 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Lists your replays. You can either list all the replays or you can
+    # provide a prefix to match to the replay names. Filter parameters are
+    # exclusive.
+    #
+    # @option params [String] :name_prefix
+    #   A name prefix to filter the archives returned. Only archives with name
+    #   that match the prefix are returned.
+    #
+    # @option params [String] :state
+    #   The state of the replay.
+    #
+    # @option params [String] :event_source_arn
+    #   The ARN of the event source associated with the replay.
+    #
+    # @option params [String] :next_token
+    #   The token returned by a previous call to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :limit
+    #   The maximum number of replays to retrieve.
+    #
+    # @return [Types::ListReplaysResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListReplaysResponse#replays #replays} => Array<Types::Replay>
+    #   * {Types::ListReplaysResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_replays({
+    #     name_prefix: "ReplayName",
+    #     state: "STARTING", # accepts STARTING, RUNNING, CANCELLING, COMPLETED, CANCELLED, FAILED
+    #     event_source_arn: "Arn",
+    #     next_token: "NextToken",
+    #     limit: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.replays #=> Array
+    #   resp.replays[0].replay_name #=> String
+    #   resp.replays[0].event_source_arn #=> String
+    #   resp.replays[0].state #=> String, one of "STARTING", "RUNNING", "CANCELLING", "COMPLETED", "CANCELLED", "FAILED"
+    #   resp.replays[0].state_reason #=> String
+    #   resp.replays[0].event_start_time #=> Time
+    #   resp.replays[0].event_end_time #=> Time
+    #   resp.replays[0].event_last_replayed_time #=> Time
+    #   resp.replays[0].replay_start_time #=> Time
+    #   resp.replays[0].replay_end_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/ListReplays AWS API Documentation
+    #
+    # @overload list_replays(params = {})
+    # @param [Hash] params ({})
+    def list_replays(params = {}, options = {})
+      req = build_request(:list_replays, params)
+      req.send_request(options)
+    end
+
     # Lists the rules for the specified target. You can see which of the
     # rules in Amazon EventBridge can invoke a specific target in your
     # account.
@@ -1900,6 +2234,75 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Starts the specified replay. Events are not necessarily replayed in
+    # the exact same order that they were added to the archive. A replay
+    # processes events to replay based on the time in the event, and replays
+    # them using 1 minute intervals. If you specify an `EventStartTime` and
+    # an `EventEndTime` that covers a 20 minute time range, the events are
+    # replayed from the first minute of that 20 minute range first. Then the
+    # events from the second minute are replayed. You can use
+    # `DescribeReplay` to determine the progress of a replay. The value
+    # returned for `EventLastReplayedTime` indicates the time within the
+    # specified time range associated with the last event replayed.
+    #
+    # @option params [required, String] :replay_name
+    #   The name of the replay to start.
+    #
+    # @option params [String] :description
+    #   A description for the replay to start.
+    #
+    # @option params [required, String] :event_source_arn
+    #   The ARN of the archive to replay events from.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :event_start_time
+    #   A time stamp for the time to start replaying events. Only events that
+    #   occurred between the `EventStartTime` and `EventEndTime` are replayed.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :event_end_time
+    #   A time stamp for the time to stop replaying events. Only events that
+    #   occurred between the `EventStartTime` and `EventEndTime` are replayed.
+    #
+    # @option params [required, Types::ReplayDestination] :destination
+    #   A `ReplayDestination` object that includes details about the
+    #   destination for the replay.
+    #
+    # @return [Types::StartReplayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartReplayResponse#replay_arn #replay_arn} => String
+    #   * {Types::StartReplayResponse#state #state} => String
+    #   * {Types::StartReplayResponse#state_reason #state_reason} => String
+    #   * {Types::StartReplayResponse#replay_start_time #replay_start_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_replay({
+    #     replay_name: "ReplayName", # required
+    #     description: "ReplayDescription",
+    #     event_source_arn: "Arn", # required
+    #     event_start_time: Time.now, # required
+    #     event_end_time: Time.now, # required
+    #     destination: { # required
+    #       arn: "Arn", # required
+    #       filter_arns: ["Arn"],
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.replay_arn #=> String
+    #   resp.state #=> String, one of "STARTING", "RUNNING", "CANCELLING", "COMPLETED", "CANCELLED", "FAILED"
+    #   resp.state_reason #=> String
+    #   resp.replay_start_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/StartReplay AWS API Documentation
+    #
+    # @overload start_replay(params = {})
+    # @param [Hash] params ({})
+    def start_replay(params = {}, options = {})
+      req = build_request(:start_replay, params)
+      req.send_request(options)
+    end
+
     # Assigns one or more tags (key-value pairs) to the specified
     # EventBridge resource. Tags can help you organize and categorize your
     # resources. You can also use them to scope user permissions by granting
@@ -2017,6 +2420,52 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Updates the specified archive.
+    #
+    # @option params [required, String] :archive_name
+    #   The name of the archive to update.
+    #
+    # @option params [String] :description
+    #   The description for the archive.
+    #
+    # @option params [String] :event_pattern
+    #   The event pattern to use to filter events sent to the archive.
+    #
+    # @option params [Integer] :retention_days
+    #   The number of days to retain events in the archive.
+    #
+    # @return [Types::UpdateArchiveResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateArchiveResponse#archive_arn #archive_arn} => String
+    #   * {Types::UpdateArchiveResponse#state #state} => String
+    #   * {Types::UpdateArchiveResponse#state_reason #state_reason} => String
+    #   * {Types::UpdateArchiveResponse#creation_time #creation_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_archive({
+    #     archive_name: "ArchiveName", # required
+    #     description: "ArchiveDescription",
+    #     event_pattern: "EventPattern",
+    #     retention_days: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.archive_arn #=> String
+    #   resp.state #=> String, one of "ENABLED", "DISABLED", "CREATING", "UPDATING", "CREATE_FAILED", "UPDATE_FAILED"
+    #   resp.state_reason #=> String
+    #   resp.creation_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/UpdateArchive AWS API Documentation
+    #
+    # @overload update_archive(params = {})
+    # @param [Hash] params ({})
+    def update_archive(params = {}, options = {})
+      req = build_request(:update_archive, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2030,7 +2479,7 @@ module Aws::CloudWatchEvents
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchevents'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.39.0'
       Seahorse::Client::Request.new(handlers, context)
     end