aws-sdk-applicationsignals 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29733e28d2b169e35edf78ce52615cba06b54831f390346f9e3db9562afd42d6
-  data.tar.gz: 9805421d7de6245f91d8a4a0e52cca4c3ebc8a0e4ed5eff9df3c7003eae170b0
+  metadata.gz: 6180ed619103793a7ca32c2397f78b9fb19136fea9bfdc9c64ab2f1ad9557d8d
+  data.tar.gz: 663110d37a967526a7d2a56420ff0426f6c53ea65338504b3ce280360be4dff1
 SHA512:
-  metadata.gz: 4012a8b640b19231c247ee5b1229dcaa0068c8f606e639c21bc7f30c3508fe01314cba59baaecfae93cd3312e5db71694c60b115fd9e12ff833651f3acf678db
-  data.tar.gz: b08391ac3fe3a557b75cbc2f7d7edf7aba3f079a5d44b056beab9e1fe091ba69abfec12fab60551c90557c980072aee17cef6b04325343246562b2f833ecb4c7
+  metadata.gz: f0fc227b6ce4b07e571abb29256bcd198d035dcbf02c20dd20c60911c0737b85a36f728a0d493ddabcc757b2bd9d7f64ebd81422c841d88d1a4470624582bafd
+  data.tar.gz: a8741f7200c31c0e007e7a9105014f117b5b795d2b29d5635155e01ab8c0c4a380bdd76ea994a867a6cc5db37c59baf97249dffb7205d7a0516e3a766f9e4849

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.13.0 (2024-11-13)
+------------------
+
+* Feature - Amazon CloudWatch Application Signals now supports creating Service Level Objectives with burn rates. Users can now create or update SLOs with burn rate configurations to meet their specific business requirements.
+
 1.12.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.12.0
+1.13.0

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

@@ -715,6 +715,11 @@ module Aws::ApplicationSignals
     #   use them to scope user permissions by granting a user permission to
     #   access or change only resources with certain tag values.
     #
+    # @option params [Array<Types::BurnRateConfiguration>] :burn_rate_configurations
+    #   Use this array to create *burn rates* for this SLO. Each burn rate is
+    #   a metric that indicates how fast the service is consuming the error
+    #   budget, relative to the attainment goal of the SLO.
+    #
     # @return [Types::CreateServiceLevelObjectiveOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceLevelObjectiveOutput#slo #slo} => Types::ServiceLevelObjective
@@ -871,6 +876,11 @@ module Aws::ApplicationSignals
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     burn_rate_configurations: [
+    #       {
+    #         look_back_window_minutes: 1, # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -960,6 +970,8 @@ module Aws::ApplicationSignals
     #   resp.slo.goal.interval.calendar_interval.duration #=> Integer
     #   resp.slo.goal.attainment_goal #=> Float
     #   resp.slo.goal.warning_threshold #=> Float
+    #   resp.slo.burn_rate_configurations #=> Array
+    #   resp.slo.burn_rate_configurations[0].look_back_window_minutes #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/CreateServiceLevelObjective AWS API Documentation
     #
@@ -1189,6 +1201,8 @@ module Aws::ApplicationSignals
     #   resp.slo.goal.interval.calendar_interval.duration #=> Integer
     #   resp.slo.goal.attainment_goal #=> Float
     #   resp.slo.goal.warning_threshold #=> Float
+    #   resp.slo.burn_rate_configurations #=> Array
+    #   resp.slo.burn_rate_configurations[0].look_back_window_minutes #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/GetServiceLevelObjective AWS API Documentation
     #
@@ -1844,6 +1858,11 @@ module Aws::ApplicationSignals
     #   the SLO. This includes the time period for evaluation and the
     #   attainment threshold.
     #
+    # @option params [Array<Types::BurnRateConfiguration>] :burn_rate_configurations
+    #   Use this array to create *burn rates* for this SLO. Each burn rate is
+    #   a metric that indicates how fast the service is consuming the error
+    #   budget, relative to the attainment goal of the SLO.
+    #
     # @return [Types::UpdateServiceLevelObjectiveOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateServiceLevelObjectiveOutput#slo #slo} => Types::ServiceLevelObjective
@@ -1994,6 +2013,11 @@ module Aws::ApplicationSignals
     #       attainment_goal: 1.0,
     #       warning_threshold: 1.0,
     #     },
+    #     burn_rate_configurations: [
+    #       {
+    #         look_back_window_minutes: 1, # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -2083,6 +2107,8 @@ module Aws::ApplicationSignals
     #   resp.slo.goal.interval.calendar_interval.duration #=> Integer
     #   resp.slo.goal.attainment_goal #=> Float
     #   resp.slo.goal.warning_threshold #=> Float
+    #   resp.slo.burn_rate_configurations #=> Array
+    #   resp.slo.burn_rate_configurations[0].look_back_window_minutes #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/UpdateServiceLevelObjective AWS API Documentation
     #
@@ -2111,7 +2137,7 @@ module Aws::ApplicationSignals
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-applicationsignals'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.13.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -26,6 +26,9 @@ module Aws::ApplicationSignals
     BatchGetServiceLevelObjectiveBudgetReportOutput = Shapes::StructureShape.new(name: 'BatchGetServiceLevelObjectiveBudgetReportOutput')
     BudgetRequestsRemaining = Shapes::IntegerShape.new(name: 'BudgetRequestsRemaining')
     BudgetSecondsRemaining = Shapes::IntegerShape.new(name: 'BudgetSecondsRemaining')
+    BurnRateConfiguration = Shapes::StructureShape.new(name: 'BurnRateConfiguration')
+    BurnRateConfigurations = Shapes::ListShape.new(name: 'BurnRateConfigurations')
+    BurnRateLookBackWindowMinutes = Shapes::IntegerShape.new(name: 'BurnRateLookBackWindowMinutes')
     CalendarInterval = Shapes::StructureShape.new(name: 'CalendarInterval')
     CalendarIntervalDuration = Shapes::IntegerShape.new(name: 'CalendarIntervalDuration')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -171,6 +174,11 @@ module Aws::ApplicationSignals
     BatchGetServiceLevelObjectiveBudgetReportOutput.add_member(:errors, Shapes::ShapeRef.new(shape: ServiceLevelObjectiveBudgetReportErrors, required: true, location_name: "Errors"))
     BatchGetServiceLevelObjectiveBudgetReportOutput.struct_class = Types::BatchGetServiceLevelObjectiveBudgetReportOutput
 
+    BurnRateConfiguration.add_member(:look_back_window_minutes, Shapes::ShapeRef.new(shape: BurnRateLookBackWindowMinutes, required: true, location_name: "LookBackWindowMinutes"))
+    BurnRateConfiguration.struct_class = Types::BurnRateConfiguration
+
+    BurnRateConfigurations.member = Shapes::ShapeRef.new(shape: BurnRateConfiguration)
+
     CalendarInterval.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTime"))
     CalendarInterval.add_member(:duration_unit, Shapes::ShapeRef.new(shape: DurationUnit, required: true, location_name: "DurationUnit"))
     CalendarInterval.add_member(:duration, Shapes::ShapeRef.new(shape: CalendarIntervalDuration, required: true, location_name: "Duration"))
@@ -185,6 +193,7 @@ module Aws::ApplicationSignals
     CreateServiceLevelObjectiveInput.add_member(:request_based_sli_config, Shapes::ShapeRef.new(shape: RequestBasedServiceLevelIndicatorConfig, location_name: "RequestBasedSliConfig"))
     CreateServiceLevelObjectiveInput.add_member(:goal, Shapes::ShapeRef.new(shape: Goal, location_name: "Goal"))
     CreateServiceLevelObjectiveInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    CreateServiceLevelObjectiveInput.add_member(:burn_rate_configurations, Shapes::ShapeRef.new(shape: BurnRateConfigurations, location_name: "BurnRateConfigurations"))
     CreateServiceLevelObjectiveInput.struct_class = Types::CreateServiceLevelObjectiveInput
 
     CreateServiceLevelObjectiveOutput.add_member(:slo, Shapes::ShapeRef.new(shape: ServiceLevelObjective, required: true, location_name: "Slo"))
@@ -426,6 +435,7 @@ module Aws::ApplicationSignals
     ServiceLevelObjective.add_member(:request_based_sli, Shapes::ShapeRef.new(shape: RequestBasedServiceLevelIndicator, location_name: "RequestBasedSli"))
     ServiceLevelObjective.add_member(:evaluation_type, Shapes::ShapeRef.new(shape: EvaluationType, location_name: "EvaluationType"))
     ServiceLevelObjective.add_member(:goal, Shapes::ShapeRef.new(shape: Goal, required: true, location_name: "Goal"))
+    ServiceLevelObjective.add_member(:burn_rate_configurations, Shapes::ShapeRef.new(shape: BurnRateConfigurations, location_name: "BurnRateConfigurations"))
     ServiceLevelObjective.struct_class = Types::ServiceLevelObjective
 
     ServiceLevelObjectiveBudgetReport.add_member(:arn, Shapes::ShapeRef.new(shape: ServiceLevelObjectiveArn, required: true, location_name: "Arn"))
@@ -511,6 +521,7 @@ module Aws::ApplicationSignals
     UpdateServiceLevelObjectiveInput.add_member(:sli_config, Shapes::ShapeRef.new(shape: ServiceLevelIndicatorConfig, location_name: "SliConfig"))
     UpdateServiceLevelObjectiveInput.add_member(:request_based_sli_config, Shapes::ShapeRef.new(shape: RequestBasedServiceLevelIndicatorConfig, location_name: "RequestBasedSliConfig"))
     UpdateServiceLevelObjectiveInput.add_member(:goal, Shapes::ShapeRef.new(shape: Goal, location_name: "Goal"))
+    UpdateServiceLevelObjectiveInput.add_member(:burn_rate_configurations, Shapes::ShapeRef.new(shape: BurnRateConfigurations, location_name: "BurnRateConfigurations"))
     UpdateServiceLevelObjectiveInput.struct_class = Types::UpdateServiceLevelObjectiveInput
 
     UpdateServiceLevelObjectiveOutput.add_member(:slo, Shapes::ShapeRef.new(shape: ServiceLevelObjective, required: true, location_name: "Slo"))

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

@@ -67,6 +67,36 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
+    # This object defines the length of the look-back window used to
+    # calculate one burn rate metric for this SLO. The burn rate measures
+    # how fast the service is consuming the error budget, relative to the
+    # attainment goal of the SLO. A burn rate of exactly 1 indicates that
+    # the SLO goal will be met exactly.
+    #
+    # For example, if you specify 60 as the number of minutes in the
+    # look-back window, the burn rate is calculated as the following:
+    #
+    # *burn rate = error rate over the look-back window / (1 - attainment
+    # goal percentage)*
+    #
+    # For more information about burn rates, see [Calculate burn rates][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-ServiceLevelObjectives.html#CloudWatch-ServiceLevelObjectives-burn
+    #
+    # @!attribute [rw] look_back_window_minutes
+    #   The number of minutes to use as the look-back window.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/BurnRateConfiguration AWS API Documentation
+    #
+    class BurnRateConfiguration < Struct.new(
+      :look_back_window_minutes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # If the interval for this service level objective is a calendar
     # interval, this structure contains the interval specifications.
     #
@@ -157,6 +187,12 @@ module Aws::ApplicationSignals
     #   values.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] burn_rate_configurations
+    #   Use this array to create *burn rates* for this SLO. Each burn rate
+    #   is a metric that indicates how fast the service is consuming the
+    #   error budget, relative to the attainment goal of the SLO.
+    #   @return [Array<Types::BurnRateConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/CreateServiceLevelObjectiveInput AWS API Documentation
     #
     class CreateServiceLevelObjectiveInput < Struct.new(
@@ -165,7 +201,8 @@ module Aws::ApplicationSignals
       :sli_config,
       :request_based_sli_config,
       :goal,
-      :tags)
+      :tags,
+      :burn_rate_configurations)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1905,6 +1942,13 @@ module Aws::ApplicationSignals
     #   threshold.
     #   @return [Types::Goal]
     #
+    # @!attribute [rw] burn_rate_configurations
+    #   Each object in this array defines the length of the look-back window
+    #   used to calculate one burn rate metric for this SLO. The burn rate
+    #   measures how fast the service is consuming the error budget,
+    #   relative to the attainment goal of the SLO.
+    #   @return [Array<Types::BurnRateConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceLevelObjective AWS API Documentation
     #
     class ServiceLevelObjective < Struct.new(
@@ -1916,7 +1960,8 @@ module Aws::ApplicationSignals
       :sli,
       :request_based_sli,
       :evaluation_type,
-      :goal)
+      :goal,
+      :burn_rate_configurations)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2401,6 +2446,12 @@ module Aws::ApplicationSignals
     #   attainment threshold.
     #   @return [Types::Goal]
     #
+    # @!attribute [rw] burn_rate_configurations
+    #   Use this array to create *burn rates* for this SLO. Each burn rate
+    #   is a metric that indicates how fast the service is consuming the
+    #   error budget, relative to the attainment goal of the SLO.
+    #   @return [Array<Types::BurnRateConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/UpdateServiceLevelObjectiveInput AWS API Documentation
     #
     class UpdateServiceLevelObjectiveInput < Struct.new(
@@ -2408,7 +2459,8 @@ module Aws::ApplicationSignals
       :description,
       :sli_config,
       :request_based_sli_config,
-      :goal)
+      :goal,
+      :burn_rate_configurations)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-applicationsignals.rb

@@ -54,7 +54,7 @@ module Aws::ApplicationSignals
   autoload :EndpointProvider, 'aws-sdk-applicationsignals/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-applicationsignals/endpoints'
 
-  GEM_VERSION = '1.12.0'
+  GEM_VERSION = '1.13.0'
 
 end
 

data/sig/client.rbs

@@ -238,6 +238,11 @@ module Aws
                                                 key: ::String,
                                                 value: ::String
                                               },
+                                            ],
+                                            ?burn_rate_configurations: Array[
+                                              {
+                                                look_back_window_minutes: ::Integer
+                                              },
                                             ]
                                           ) -> _CreateServiceLevelObjectiveResponseSuccess
                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateServiceLevelObjectiveResponseSuccess
@@ -544,7 +549,12 @@ module Aws
                                               }?,
                                               attainment_goal: ::Float?,
                                               warning_threshold: ::Float?
-                                            }
+                                            },
+                                            ?burn_rate_configurations: Array[
+                                              {
+                                                look_back_window_minutes: ::Integer
+                                              },
+                                            ]
                                           ) -> _UpdateServiceLevelObjectiveResponseSuccess
                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateServiceLevelObjectiveResponseSuccess
     end

data/sig/types.rbs

@@ -26,6 +26,11 @@ module Aws::ApplicationSignals
       SENSITIVE: []
     end
 
+    class BurnRateConfiguration
+      attr_accessor look_back_window_minutes: ::Integer
+      SENSITIVE: []
+    end
+
     class CalendarInterval
       attr_accessor start_time: ::Time
       attr_accessor duration_unit: ("MINUTE" | "HOUR" | "DAY" | "MONTH")
@@ -45,6 +50,7 @@ module Aws::ApplicationSignals
       attr_accessor request_based_sli_config: Types::RequestBasedServiceLevelIndicatorConfig
       attr_accessor goal: Types::Goal
       attr_accessor tags: ::Array[Types::Tag]
+      attr_accessor burn_rate_configurations: ::Array[Types::BurnRateConfiguration]
       SENSITIVE: []
     end
 
@@ -363,6 +369,7 @@ module Aws::ApplicationSignals
       attr_accessor request_based_sli: Types::RequestBasedServiceLevelIndicator
       attr_accessor evaluation_type: ("PeriodBased" | "RequestBased")
       attr_accessor goal: Types::Goal
+      attr_accessor burn_rate_configurations: ::Array[Types::BurnRateConfiguration]
       SENSITIVE: []
     end
 
@@ -458,6 +465,7 @@ module Aws::ApplicationSignals
       attr_accessor sli_config: Types::ServiceLevelIndicatorConfig
       attr_accessor request_based_sli_config: Types::RequestBasedServiceLevelIndicatorConfig
       attr_accessor goal: Types::Goal
+      attr_accessor burn_rate_configurations: ::Array[Types::BurnRateConfiguration]
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-applicationsignals
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-18 00:00:00.000000000 Z
+date: 2024-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core