aws-cdk-lib 2.158.0__py3-none-any.whl → 2.159.0__py3-none-any.whl

aws_cdk/aws_applicationsignals/__init__.py

@@ -91,9 +91,23 @@ class CfnServiceLevelObjective(
 
     Create an SLO to set a target for a service or operation’s availability or latency. CloudWatch measures this target frequently you can find whether it has been breached.
 
-    When you create an SLO, you set an *attainment goal* for it. An *attainment goal* is the ratio of good periods that meet the threshold requirements to the total periods within the interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state.
+    The target performance quality that is defined for an SLO is the *attainment goal* . An attainment goal is the percentage of time or requests that the SLI is expected to meet the threshold over each time interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state.
 
-    After you have created an SLO, you can retrieve error budget reports for it. An *error budget* is the number of periods or amount of time that your service can accumulate during an interval before your overall SLO budget health is breached and the SLO is considered to be unmet. for example, an SLO with a threshold that 99.95% of requests must be completed under 2000ms every month translates to an error budget of 21.9 minutes of downtime per month.
+    When you create an SLO, you specify whether it is a *period-based SLO* or a *request-based SLO* . Each type of SLO has a different way of evaluating your application's performance against its attainment goal.
+
+    - A *period-based SLO* uses defined *periods* of time within a specified total time interval. For each period of time, Application Signals determines whether the application met its goal. The attainment rate is calculated as the ``number of good periods/number of total periods`` .
+
+    For example, for a period-based SLO, meeting an attainment goal of 99.9% means that within your interval, your application must meet its performance goal during at least 99.9% of the time periods.
+
+    - A *request-based SLO* doesn't use pre-defined periods of time. Instead, the SLO measures ``number of good requests/number of total requests`` during the interval. At any time, you can find the ratio of good requests to total requests for the interval up to the time stamp that you specify, and measure that ratio against the goal set in your SLO.
+
+    After you have created an SLO, you can retrieve error budget reports for it. An *error budget* is the amount of time or amount of requests that your application can be non-compliant with the SLO's goal, and still have your application meet the goal.
+
+    - For a period-based SLO, the error budget starts at a number defined by the highest number of periods that can fail to meet the threshold, while still meeting the overall goal. The *remaining error budget* decreases with every failed period that is recorded. The error budget within one interval can never increase.
+
+    For example, an SLO with a threshold that 99.95% of requests must be completed under 2000ms every month translates to an error budget of 21.9 minutes of downtime per month.
+
+    - For a request-based SLO, the remaining error budget is dynamic and can increase or decrease, depending on the ratio of good requests to total requests.
 
     When you call this operation, Application Signals creates the *AWSServiceRoleForCloudWatchApplicationSignals* service-linked role, if it doesn't already exist in your account. This service- linked role has the following permissions:
 
@@ -107,6 +121,8 @@ class CfnServiceLevelObjective(
 
     You can easily set SLO targets for your applications that are discovered by Application Signals, using critical metrics such as latency and availability. You can also set SLOs against any CloudWatch metric or math expression that produces a time series.
 
+    You cannot change from a period-based SLO to a request-based SLO, or change from a request-based SLO to a period-based SLO.
+
     For more information about SLOs, see `Service level objectives (SLOs) <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-ServiceLevelObjectives.html>`_ .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationsignals-servicelevelobjective.html
@@ -121,42 +137,6 @@ class CfnServiceLevelObjective(
         
         cfn_service_level_objective = applicationsignals.CfnServiceLevelObjective(self, "MyCfnServiceLevelObjective",
             name="name",
-            sli=applicationsignals.CfnServiceLevelObjective.SliProperty(
-                comparison_operator="comparisonOperator",
-                metric_threshold=123,
-                sli_metric=applicationsignals.CfnServiceLevelObjective.SliMetricProperty(
-                    key_attributes={
-                        "key_attributes_key": "keyAttributes"
-                    },
-                    metric_data_queries=[applicationsignals.CfnServiceLevelObjective.MetricDataQueryProperty(
-                        id="id",
-        
-                        # the properties below are optional
-                        account_id="accountId",
-                        expression="expression",
-                        metric_stat=applicationsignals.CfnServiceLevelObjective.MetricStatProperty(
-                            metric=applicationsignals.CfnServiceLevelObjective.MetricProperty(
-                                dimensions=[applicationsignals.CfnServiceLevelObjective.DimensionProperty(
-                                    name="name",
-                                    value="value"
-                                )],
-                                metric_name="metricName",
-                                namespace="namespace"
-                            ),
-                            period=123,
-                            stat="stat",
-        
-                            # the properties below are optional
-                            unit="unit"
-                        ),
-                        return_data=False
-                    )],
-                    metric_type="metricType",
-                    operation_name="operationName",
-                    period_seconds=123,
-                    statistic="statistic"
-                )
-            ),
         
             # the properties below are optional
             description="description",
@@ -259,6 +239,42 @@ class CfnServiceLevelObjective(
                 comparison_operator="comparisonOperator",
                 metric_threshold=123
             ),
+            sli=applicationsignals.CfnServiceLevelObjective.SliProperty(
+                comparison_operator="comparisonOperator",
+                metric_threshold=123,
+                sli_metric=applicationsignals.CfnServiceLevelObjective.SliMetricProperty(
+                    key_attributes={
+                        "key_attributes_key": "keyAttributes"
+                    },
+                    metric_data_queries=[applicationsignals.CfnServiceLevelObjective.MetricDataQueryProperty(
+                        id="id",
+        
+                        # the properties below are optional
+                        account_id="accountId",
+                        expression="expression",
+                        metric_stat=applicationsignals.CfnServiceLevelObjective.MetricStatProperty(
+                            metric=applicationsignals.CfnServiceLevelObjective.MetricProperty(
+                                dimensions=[applicationsignals.CfnServiceLevelObjective.DimensionProperty(
+                                    name="name",
+                                    value="value"
+                                )],
+                                metric_name="metricName",
+                                namespace="namespace"
+                            ),
+                            period=123,
+                            stat="stat",
+        
+                            # the properties below are optional
+                            unit="unit"
+                        ),
+                        return_data=False
+                    )],
+                    metric_type="metricType",
+                    operation_name="operationName",
+                    period_seconds=123,
+                    statistic="statistic"
+                )
+            ),
             tags=[CfnTag(
                 key="key",
                 value="value"
@@ -272,20 +288,20 @@ class CfnServiceLevelObjective(
         id: builtins.str,
         *,
         name: builtins.str,
-        sli: typing.Union[_IResolvable_da3f097b, typing.Union["CfnServiceLevelObjective.SliProperty", typing.Dict[builtins.str, typing.Any]]],
         description: typing.Optional[builtins.str] = None,
         goal: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnServiceLevelObjective.GoalProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         request_based_sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnServiceLevelObjective.RequestBasedSliProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnServiceLevelObjective.SliProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: A name for this SLO.
-        :param sli: A structure containing information about the performance metric that this SLO monitors.
         :param description: An optional description for this SLO. Default: - "No description"
         :param goal: This structure contains the attributes that determine the goal of an SLO. This includes the time period for evaluation and the attainment threshold.
-        :param request_based_sli: This structure contains information about the performance metric that a request-based SLO monitors.
+        :param request_based_sli: A structure containing information about the performance metric that this SLO monitors, if this is a request-based SLO.
+        :param sli: A structure containing information about the performance metric that this SLO monitors, if this is a period-based SLO.
         :param tags: A list of key-value pairs to associate with the SLO. You can associate as many as 50 tags with an SLO. To be able to associate tags with the SLO when you create the SLO, you must have the cloudwatch:TagResource permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
         '''
         if __debug__:
@@ -294,10 +310,10 @@ class CfnServiceLevelObjective(
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = CfnServiceLevelObjectiveProps(
             name=name,
-            sli=sli,
             description=description,
             goal=goal,
             request_based_sli=request_based_sli,
+            sli=sli,
             tags=tags,
         )
 
@@ -393,24 +409,6 @@ class CfnServiceLevelObjective(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "name", value) # pyright: ignore[reportArgumentType]
 
-    @builtins.property
-    @jsii.member(jsii_name="sli")
-    def sli(
-        self,
-    ) -> typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"]:
-        '''A structure containing information about the performance metric that this SLO monitors.'''
-        return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"], jsii.get(self, "sli"))
-
-    @sli.setter
-    def sli(
-        self,
-        value: typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"],
-    ) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__938ccf6991aba4b5875a4ca09dfcdb00a5c7e9a92bba0e785ddfbebb228037c3)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "sli", value) # pyright: ignore[reportArgumentType]
-
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
@@ -447,7 +445,7 @@ class CfnServiceLevelObjective(
     def request_based_sli(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.RequestBasedSliProperty"]]:
-        '''This structure contains information about the performance metric that a request-based SLO monitors.'''
+        '''A structure containing information about the performance metric that this SLO monitors, if this is a request-based SLO.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.RequestBasedSliProperty"]], jsii.get(self, "requestBasedSli"))
 
     @request_based_sli.setter
@@ -460,6 +458,24 @@ class CfnServiceLevelObjective(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "requestBasedSli", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="sli")
+    def sli(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"]]:
+        '''A structure containing information about the performance metric that this SLO monitors, if this is a period-based SLO.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"]], jsii.get(self, "sli"))
+
+    @sli.setter
+    def sli(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.SliProperty"]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__938ccf6991aba4b5875a4ca09dfcdb00a5c7e9a92bba0e785ddfbebb228037c3)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "sli", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
@@ -666,7 +682,7 @@ class CfnServiceLevelObjective(
 
             This includes the time period for evaluation and the attainment threshold.
 
-            :param attainment_goal: The threshold that determines if the goal is being met. An *attainment goal* is the ratio of good periods that meet the threshold requirements to the total periods within the interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state. If you omit this parameter, 99 is used to represent 99% as the attainment goal.
+            :param attainment_goal: The threshold that determines if the goal is being met. If this is a period-based SLO, the attainment goal is the percentage of good periods that meet the threshold requirements to the total periods within the interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state. If this is a request-based SLO, the attainment goal is the percentage of requests that must be successful to meet the attainment goal. If you omit this parameter, 99 is used to represent 99% as the attainment goal.
             :param interval: The time period used to evaluate the SLO. It can be either a calendar interval or rolling interval. If you omit this parameter, a rolling interval of 7 days is used.
             :param warning_threshold: The percentage of remaining budget over total budget that you want to get warnings for. If you omit this parameter, the default of 50.0 is used.
 
@@ -712,7 +728,9 @@ class CfnServiceLevelObjective(
         def attainment_goal(self) -> typing.Optional[jsii.Number]:
             '''The threshold that determines if the goal is being met.
 
-            An *attainment goal* is the ratio of good periods that meet the threshold requirements to the total periods within the interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state.
+            If this is a period-based SLO, the attainment goal is the percentage of good periods that meet the threshold requirements to the total periods within the interval. For example, an attainment goal of 99.9% means that within your interval, you are targeting 99.9% of the periods to be in healthy state.
+
+            If this is a request-based SLO, the attainment goal is the percentage of requests that must be successful to meet the attainment goal.
 
             If you omit this parameter, 99 is used to represent 99% as the attainment goal.
 
@@ -1242,8 +1260,8 @@ class CfnServiceLevelObjective(
 
             This value observed for the metric defined in ``TotalRequestCountMetric`` is divided by the number found for ``MonitoredRequestCountMetric`` to determine the percentage of successful requests that this SLO tracks.
 
-            :param bad_count_metric: If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
-            :param good_count_metric: If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
+            :param bad_count_metric: If you want to count "bad requests" to determine the percentage of successful requests for this request-based SLO, specify the metric to use as "bad requests" in this structure.
+            :param good_count_metric: If you want to count "good requests" to determine the percentage of successful requests for this request-based SLO, specify the metric to use as "good requests" in this structure.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-monitoredrequestcountmetric.html
             :exampleMetadata: fixture=_generated
@@ -1317,7 +1335,7 @@ class CfnServiceLevelObjective(
         def bad_count_metric(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.MetricDataQueryProperty"]]]]:
-            '''If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
+            '''If you want to count "bad requests" to determine the percentage of successful requests for this request-based SLO, specify the metric to use as "bad requests" in this structure.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-monitoredrequestcountmetric.html#cfn-applicationsignals-servicelevelobjective-monitoredrequestcountmetric-badcountmetric
             '''
@@ -1328,7 +1346,7 @@ class CfnServiceLevelObjective(
         def good_count_metric(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.MetricDataQueryProperty"]]]]:
-            '''If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
+            '''If you want to count "good requests" to determine the percentage of successful requests for this request-based SLO, specify the metric to use as "good requests" in this structure.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-monitoredrequestcountmetric.html#cfn-applicationsignals-servicelevelobjective-monitoredrequestcountmetric-goodcountmetric
             '''
@@ -1369,11 +1387,11 @@ class CfnServiceLevelObjective(
         ) -> None:
             '''This structure contains the information about the metric that is used for a request-based SLO.
 
-            :param key_attributes: This is a string-to-string map that contains information about the type of object that this SLO is related to.
-            :param metric_type: If the SLO monitors either the LATENCY or AVAILABILITY metric that Application Signals collects, this field displays which of those metrics is used.
-            :param monitored_request_count_metric: This structure defines the metric that is used as the "good request" or "bad request" value for a request-based SLO. This value observed for the metric defined in ``TotalRequestCountMetric`` is divided by the number found for ``MonitoredRequestCountMetric`` to determine the percentage of successful requests that this SLO tracks.
+            :param key_attributes: This is a string-to-string map that contains information about the type of object that this SLO is related to. It can include the following fields. - ``Type`` designates the type of object that this SLO is related to. - ``ResourceType`` specifies the type of the resource. This field is used only when the value of the ``Type`` field is ``Resource`` or ``AWS::Resource`` . - ``Name`` specifies the name of the object. This is used only if the value of the ``Type`` field is ``Service`` , ``RemoteService`` , or ``AWS::Service`` . - ``Identifier`` identifies the resource objects of this resource. This is used only if the value of the ``Type`` field is ``Resource`` or ``AWS::Resource`` . - ``Environment`` specifies the location where this object is hosted, or what it belongs to.
+            :param metric_type: If the SLO monitors either the ``LATENCY`` or ``AVAILABILITY`` metric that Application Signals collects, this field displays which of those metrics is used.
+            :param monitored_request_count_metric: Use this structure to define the metric that you want to use as the "good request" or "bad request" value for a request-based SLO. This value observed for the metric defined in ``TotalRequestCountMetric`` will be divided by the number found for ``MonitoredRequestCountMetric`` to determine the percentage of successful requests that this SLO tracks.
             :param operation_name: If the SLO monitors a specific operation of the service, this field displays that operation name.
-            :param total_request_count_metric: If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
+            :param total_request_count_metric: This structure defines the metric that is used as the "total requests" number for a request-based SLO. The number observed for this metric is divided by the number of "good requests" or "bad requests" that is observed for the metric defined in ``MonitoredRequestCountMetric`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedslimetric.html
             :exampleMetadata: fixture=_generated
@@ -1488,6 +1506,14 @@ class CfnServiceLevelObjective(
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
             '''This is a string-to-string map that contains information about the type of object that this SLO is related to.
 
+            It can include the following fields.
+
+            - ``Type`` designates the type of object that this SLO is related to.
+            - ``ResourceType`` specifies the type of the resource. This field is used only when the value of the ``Type`` field is ``Resource`` or ``AWS::Resource`` .
+            - ``Name`` specifies the name of the object. This is used only if the value of the ``Type`` field is ``Service`` , ``RemoteService`` , or ``AWS::Service`` .
+            - ``Identifier`` identifies the resource objects of this resource. This is used only if the value of the ``Type`` field is ``Resource`` or ``AWS::Resource`` .
+            - ``Environment`` specifies the location where this object is hosted, or what it belongs to.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedslimetric.html#cfn-applicationsignals-servicelevelobjective-requestbasedslimetric-keyattributes
             '''
             result = self._values.get("key_attributes")
@@ -1495,7 +1521,7 @@ class CfnServiceLevelObjective(
 
         @builtins.property
         def metric_type(self) -> typing.Optional[builtins.str]:
-            '''If the SLO monitors either the LATENCY or AVAILABILITY metric that Application Signals collects, this field displays which of those metrics is used.
+            '''If the SLO monitors either the ``LATENCY`` or ``AVAILABILITY`` metric that Application Signals collects, this field displays which of those metrics is used.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedslimetric.html#cfn-applicationsignals-servicelevelobjective-requestbasedslimetric-metrictype
             '''
@@ -1506,9 +1532,9 @@ class CfnServiceLevelObjective(
         def monitored_request_count_metric(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.MonitoredRequestCountMetricProperty"]]:
-            '''This structure defines the metric that is used as the "good request" or "bad request" value for a request-based SLO.
+            '''Use this structure to define the metric that you want to use as the "good request" or "bad request" value for a request-based SLO.
 
-            This value observed for the metric defined in ``TotalRequestCountMetric`` is divided by the number found for ``MonitoredRequestCountMetric`` to determine the percentage of successful requests that this SLO tracks.
+            This value observed for the metric defined in ``TotalRequestCountMetric`` will be divided by the number found for ``MonitoredRequestCountMetric`` to determine the percentage of successful requests that this SLO tracks.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedslimetric.html#cfn-applicationsignals-servicelevelobjective-requestbasedslimetric-monitoredrequestcountmetric
             '''
@@ -1528,7 +1554,9 @@ class CfnServiceLevelObjective(
         def total_request_count_metric(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.MetricDataQueryProperty"]]]]:
-            '''If this SLO monitors a CloudWatch metric or the result of a CloudWatch metric math expression, this structure includes the information about that metric or expression.
+            '''This structure defines the metric that is used as the "total requests" number for a request-based SLO.
+
+            The number observed for this metric is divided by the number of "good requests" or "bad requests" that is observed for the metric defined in ``MonitoredRequestCountMetric`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedslimetric.html#cfn-applicationsignals-servicelevelobjective-requestbasedslimetric-totalrequestcountmetric
             '''
@@ -1565,9 +1593,9 @@ class CfnServiceLevelObjective(
         ) -> None:
             '''This structure contains information about the performance metric that a request-based SLO monitors.
 
-            :param request_based_sli_metric: This structure contains the information about the metric that is used for a request-based SLO.
+            :param request_based_sli_metric: A structure that contains information about the metric that the SLO monitors.
             :param comparison_operator: The arithmetic operation used when comparing the specified metric to the threshold.
-            :param metric_threshold: The value that the SLI metric is compared to.
+            :param metric_threshold: This value is the threshold that the observed metric values of the SLI metric are compared to.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedsli.html
             :exampleMetadata: fixture=_generated
@@ -1680,7 +1708,7 @@ class CfnServiceLevelObjective(
         def request_based_sli_metric(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnServiceLevelObjective.RequestBasedSliMetricProperty"]:
-            '''This structure contains the information about the metric that is used for a request-based SLO.
+            '''A structure that contains information about the metric that the SLO monitors.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedsli.html#cfn-applicationsignals-servicelevelobjective-requestbasedsli-requestbasedslimetric
             '''
@@ -1699,7 +1727,7 @@ class CfnServiceLevelObjective(
 
         @builtins.property
         def metric_threshold(self) -> typing.Optional[jsii.Number]:
-            '''The value that the SLI metric is compared to.
+            '''This value is the threshold that the observed metric values of the SLI metric are compared to.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationsignals-servicelevelobjective-requestbasedsli.html#cfn-applicationsignals-servicelevelobjective-requestbasedsli-metricthreshold
             '''
@@ -2098,10 +2126,10 @@ class CfnServiceLevelObjective(
     jsii_struct_bases=[],
     name_mapping={
         "name": "name",
-        "sli": "sli",
         "description": "description",
         "goal": "goal",
         "request_based_sli": "requestBasedSli",
+        "sli": "sli",
         "tags": "tags",
     },
 )
@@ -2110,19 +2138,19 @@ class CfnServiceLevelObjectiveProps:
         self,
         *,
         name: builtins.str,
-        sli: typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]],
         description: typing.Optional[builtins.str] = None,
         goal: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.GoalProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         request_based_sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.RequestBasedSliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''Properties for defining a ``CfnServiceLevelObjective``.
 
         :param name: A name for this SLO.
-        :param sli: A structure containing information about the performance metric that this SLO monitors.
         :param description: An optional description for this SLO. Default: - "No description"
         :param goal: This structure contains the attributes that determine the goal of an SLO. This includes the time period for evaluation and the attainment threshold.
-        :param request_based_sli: This structure contains information about the performance metric that a request-based SLO monitors.
+        :param request_based_sli: A structure containing information about the performance metric that this SLO monitors, if this is a request-based SLO.
+        :param sli: A structure containing information about the performance metric that this SLO monitors, if this is a period-based SLO.
         :param tags: A list of key-value pairs to associate with the SLO. You can associate as many as 50 tags with an SLO. To be able to associate tags with the SLO when you create the SLO, you must have the cloudwatch:TagResource permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationsignals-servicelevelobjective.html
@@ -2136,42 +2164,6 @@ class CfnServiceLevelObjectiveProps:
             
             cfn_service_level_objective_props = applicationsignals.CfnServiceLevelObjectiveProps(
                 name="name",
-                sli=applicationsignals.CfnServiceLevelObjective.SliProperty(
-                    comparison_operator="comparisonOperator",
-                    metric_threshold=123,
-                    sli_metric=applicationsignals.CfnServiceLevelObjective.SliMetricProperty(
-                        key_attributes={
-                            "key_attributes_key": "keyAttributes"
-                        },
-                        metric_data_queries=[applicationsignals.CfnServiceLevelObjective.MetricDataQueryProperty(
-                            id="id",
-            
-                            # the properties below are optional
-                            account_id="accountId",
-                            expression="expression",
-                            metric_stat=applicationsignals.CfnServiceLevelObjective.MetricStatProperty(
-                                metric=applicationsignals.CfnServiceLevelObjective.MetricProperty(
-                                    dimensions=[applicationsignals.CfnServiceLevelObjective.DimensionProperty(
-                                        name="name",
-                                        value="value"
-                                    )],
-                                    metric_name="metricName",
-                                    namespace="namespace"
-                                ),
-                                period=123,
-                                stat="stat",
-            
-                                # the properties below are optional
-                                unit="unit"
-                            ),
-                            return_data=False
-                        )],
-                        metric_type="metricType",
-                        operation_name="operationName",
-                        period_seconds=123,
-                        statistic="statistic"
-                    )
-                ),
             
                 # the properties below are optional
                 description="description",
@@ -2274,6 +2266,42 @@ class CfnServiceLevelObjectiveProps:
                     comparison_operator="comparisonOperator",
                     metric_threshold=123
                 ),
+                sli=applicationsignals.CfnServiceLevelObjective.SliProperty(
+                    comparison_operator="comparisonOperator",
+                    metric_threshold=123,
+                    sli_metric=applicationsignals.CfnServiceLevelObjective.SliMetricProperty(
+                        key_attributes={
+                            "key_attributes_key": "keyAttributes"
+                        },
+                        metric_data_queries=[applicationsignals.CfnServiceLevelObjective.MetricDataQueryProperty(
+                            id="id",
+            
+                            # the properties below are optional
+                            account_id="accountId",
+                            expression="expression",
+                            metric_stat=applicationsignals.CfnServiceLevelObjective.MetricStatProperty(
+                                metric=applicationsignals.CfnServiceLevelObjective.MetricProperty(
+                                    dimensions=[applicationsignals.CfnServiceLevelObjective.DimensionProperty(
+                                        name="name",
+                                        value="value"
+                                    )],
+                                    metric_name="metricName",
+                                    namespace="namespace"
+                                ),
+                                period=123,
+                                stat="stat",
+            
+                                # the properties below are optional
+                                unit="unit"
+                            ),
+                            return_data=False
+                        )],
+                        metric_type="metricType",
+                        operation_name="operationName",
+                        period_seconds=123,
+                        statistic="statistic"
+                    )
+                ),
                 tags=[CfnTag(
                     key="key",
                     value="value"
@@ -2283,14 +2311,13 @@ class CfnServiceLevelObjectiveProps:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__8a302456885343cc9ce5e0497feed773de1ef0f44e2934f97458bfdc5a810dee)
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
-            check_type(argname="argument sli", value=sli, expected_type=type_hints["sli"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument goal", value=goal, expected_type=type_hints["goal"])
             check_type(argname="argument request_based_sli", value=request_based_sli, expected_type=type_hints["request_based_sli"])
+            check_type(argname="argument sli", value=sli, expected_type=type_hints["sli"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "name": name,
-            "sli": sli,
         }
         if description is not None:
             self._values["description"] = description
@@ -2298,6 +2325,8 @@ class CfnServiceLevelObjectiveProps:
             self._values["goal"] = goal
         if request_based_sli is not None:
             self._values["request_based_sli"] = request_based_sli
+        if sli is not None:
+            self._values["sli"] = sli
         if tags is not None:
             self._values["tags"] = tags
 
@@ -2311,18 +2340,6 @@ class CfnServiceLevelObjectiveProps:
         assert result is not None, "Required property 'name' is missing"
         return typing.cast(builtins.str, result)
 
-    @builtins.property
-    def sli(
-        self,
-    ) -> typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty]:
-        '''A structure containing information about the performance metric that this SLO monitors.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationsignals-servicelevelobjective.html#cfn-applicationsignals-servicelevelobjective-sli
-        '''
-        result = self._values.get("sli")
-        assert result is not None, "Required property 'sli' is missing"
-        return typing.cast(typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty], result)
-
     @builtins.property
     def description(self) -> typing.Optional[builtins.str]:
         '''An optional description for this SLO.
@@ -2351,13 +2368,24 @@ class CfnServiceLevelObjectiveProps:
     def request_based_sli(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.RequestBasedSliProperty]]:
-        '''This structure contains information about the performance metric that a request-based SLO monitors.
+        '''A structure containing information about the performance metric that this SLO monitors, if this is a request-based SLO.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationsignals-servicelevelobjective.html#cfn-applicationsignals-servicelevelobjective-requestbasedsli
         '''
         result = self._values.get("request_based_sli")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.RequestBasedSliProperty]], result)
 
+    @builtins.property
+    def sli(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty]]:
+        '''A structure containing information about the performance metric that this SLO monitors, if this is a period-based SLO.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationsignals-servicelevelobjective.html#cfn-applicationsignals-servicelevelobjective-sli
+        '''
+        result = self._values.get("sli")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty]], result)
+
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
         '''A list of key-value pairs to associate with the SLO.
@@ -2395,10 +2423,10 @@ def _typecheckingstub__8476d024be5b448cfb8f9ae2f80fa7f2083296f712cdb7cd12e69365d
     id: builtins.str,
     *,
     name: builtins.str,
-    sli: typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]],
     description: typing.Optional[builtins.str] = None,
     goal: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.GoalProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     request_based_sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.RequestBasedSliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -2422,12 +2450,6 @@ def _typecheckingstub__e7d1b42972f3b8a4430dca27e7ecab3fce56490ad1edcfabdc346becf
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__938ccf6991aba4b5875a4ca09dfcdb00a5c7e9a92bba0e785ddfbebb228037c3(
-    value: typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty],
-) -> None:
-    """Type checking stubs"""
-    pass
-
 def _typecheckingstub__c6761a51565a6d9d6b93723803df5fa7735ec11aa5f14c9cc222e4e60eb54506(
     value: typing.Optional[builtins.str],
 ) -> None:
@@ -2446,6 +2468,12 @@ def _typecheckingstub__85c3a53f1420ec52267d0c5ef83b407de2a88d1eff567b79facf44748
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__938ccf6991aba4b5875a4ca09dfcdb00a5c7e9a92bba0e785ddfbebb228037c3(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnServiceLevelObjective.SliProperty]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__45578973503123093d3b0c8f845e2df0c9ad023b7df510f3a7b7ee7abcccd506(
     value: typing.Optional[typing.List[_CfnTag_f6864754]],
 ) -> None:
@@ -2576,10 +2604,10 @@ def _typecheckingstub__fcb2d383c03844ff1706f4720c7bf04c5a00252d1e49f3ecb2c00c22b
 def _typecheckingstub__8a302456885343cc9ce5e0497feed773de1ef0f44e2934f97458bfdc5a810dee(
     *,
     name: builtins.str,
-    sli: typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]],
     description: typing.Optional[builtins.str] = None,
     goal: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.GoalProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     request_based_sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.RequestBasedSliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    sli: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnServiceLevelObjective.SliProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""