aws-cdk-lib 2.96.2__py3-none-any.whl → 2.97.1__py3-none-any.whl

aws_cdk/aws_cloudwatch/__init__.py

@@ -434,7 +434,7 @@ dashboard.add_widgets(cloudwatch.GraphWidget(
 
 Using the methods `addLeftMetric()` and `addRightMetric()` you can add metrics to a graph widget later on.
 
-Graph widgets can also display annotations attached to the left or the right y-axis.
+Graph widgets can also display annotations attached to the left or right y-axis or the x-axis.
 
 ```python
 # dashboard: cloudwatch.Dashboard
@@ -444,6 +444,8 @@ dashboard.add_widgets(cloudwatch.GraphWidget(
     # ...
 
     left_annotations=[cloudwatch.HorizontalAnnotation(value=1800, label=Duration.minutes(30).to_human_string(), color=cloudwatch.Color.RED), cloudwatch.HorizontalAnnotation(value=3600, label="1 hour", color="#2ca02c")
+    ],
+    vertical_annotations=[cloudwatch.VerticalAnnotation(date="2022-10-19T00:00:00Z", label="Deployment", color=cloudwatch.Color.RED)
     ]
 ))
 ```
@@ -487,6 +489,21 @@ dashboard.add_widgets(cloudwatch.GraphWidget(
 ))
 ```
 
+The `start` and `end` properties can be used to specify the time range for each graph widget independently from those of the dashboard.
+The parameters can be specified at `GraphWidget`, `GaugeWidget`, and `SingleValueWidget`.
+
+```python
+# dashboard: cloudwatch.Dashboard
+
+
+dashboard.add_widgets(cloudwatch.GraphWidget(
+    # ...
+
+    start="-P7D",
+    end="2018-12-17T06:00:00.000Z"
+))
+```
+
 ### Gauge widget
 
 Gauge graph requires the max and min value of the left Y axis, if no value is informed the limits will be from 0 to 100.
@@ -9950,7 +9967,7 @@ class SearchComponents:
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_cloudwatch.Shading")
 class Shading(enum.Enum):
-    '''Fill shading options that will be used with an annotation.'''
+    '''Fill shading options that will be used with a horizontal annotation.'''
 
     NONE = "NONE"
     '''Don't add shading.'''
@@ -9969,10 +9986,12 @@ class Shading(enum.Enum):
         "title": "title",
         "width": "width",
         "metrics": "metrics",
+        "end": "end",
         "full_precision": "fullPrecision",
         "period": "period",
         "set_period_to_time_range": "setPeriodToTimeRange",
         "sparkline": "sparkline",
+        "start": "start",
     },
 )
 class SingleValueWidgetProps(MetricWidgetProps):
@@ -9984,10 +10003,12 @@ class SingleValueWidgetProps(MetricWidgetProps):
         title: typing.Optional[builtins.str] = None,
         width: typing.Optional[jsii.Number] = None,
         metrics: typing.Sequence[IMetric],
+        end: typing.Optional[builtins.str] = None,
         full_precision: typing.Optional[builtins.bool] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         sparkline: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for a SingleValueWidget.
 
@@ -9996,10 +10017,12 @@ class SingleValueWidgetProps(MetricWidgetProps):
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
         :param metrics: Metrics to display.
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param full_precision: Whether to show as many digits as can fit, before rounding. Default: false
         :param period: The default period for all metrics in this widget. The period is the length of time represented by one data point on the graph. This default can be overridden within each metric definition. Default: cdk.Duration.seconds(300)
         :param set_period_to_time_range: Whether to show the value from the entire time range. Default: false
         :param sparkline: Whether to show a graph below the value illustrating the value for the whole time range. Cannot be used in combination with ``setPeriodToTimeRange`` Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
 
         :exampleMetadata: infused
 
@@ -10021,10 +10044,12 @@ class SingleValueWidgetProps(MetricWidgetProps):
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
             check_type(argname="argument width", value=width, expected_type=type_hints["width"])
             check_type(argname="argument metrics", value=metrics, expected_type=type_hints["metrics"])
+            check_type(argname="argument end", value=end, expected_type=type_hints["end"])
             check_type(argname="argument full_precision", value=full_precision, expected_type=type_hints["full_precision"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument set_period_to_time_range", value=set_period_to_time_range, expected_type=type_hints["set_period_to_time_range"])
             check_type(argname="argument sparkline", value=sparkline, expected_type=type_hints["sparkline"])
+            check_type(argname="argument start", value=start, expected_type=type_hints["start"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "metrics": metrics,
         }
@@ -10036,6 +10061,8 @@ class SingleValueWidgetProps(MetricWidgetProps):
             self._values["title"] = title
         if width is not None:
             self._values["width"] = width
+        if end is not None:
+            self._values["end"] = end
         if full_precision is not None:
             self._values["full_precision"] = full_precision
         if period is not None:
@@ -10044,6 +10071,8 @@ class SingleValueWidgetProps(MetricWidgetProps):
             self._values["set_period_to_time_range"] = set_period_to_time_range
         if sparkline is not None:
             self._values["sparkline"] = sparkline
+        if start is not None:
+            self._values["start"] = start
 
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
@@ -10091,6 +10120,18 @@ class SingleValueWidgetProps(MetricWidgetProps):
         assert result is not None, "Required property 'metrics' is missing"
         return typing.cast(typing.List[IMetric], result)
 
+    @builtins.property
+    def end(self) -> typing.Optional[builtins.str]:
+        '''The end of the time range to use for each widget independently from those of the dashboard.
+
+        If you specify a value for end, you must also specify a value for start.
+        Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the end date will be the current time.
+        '''
+        result = self._values.get("end")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def full_precision(self) -> typing.Optional[builtins.bool]:
         '''Whether to show as many digits as can fit, before rounding.
@@ -10132,6 +10173,21 @@ class SingleValueWidgetProps(MetricWidgetProps):
         result = self._values.get("sparkline")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def start(self) -> typing.Optional[builtins.str]:
+        '''The start of the time range to use for each widget independently from those of the dashboard.
+
+        You can specify start without specifying end to specify a relative time range that ends with the current time.
+        In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for
+        minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months.
+        You can also use start along with an end field, to specify an absolute time range.
+        When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the start time will be the default time range.
+        '''
+        result = self._values.get("start")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -11205,6 +11261,139 @@ class VariableValue:
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_cloudwatch.VerticalAnnotation",
+    jsii_struct_bases=[],
+    name_mapping={
+        "date": "date",
+        "color": "color",
+        "fill": "fill",
+        "label": "label",
+        "visible": "visible",
+    },
+)
+class VerticalAnnotation:
+    def __init__(
+        self,
+        *,
+        date: builtins.str,
+        color: typing.Optional[builtins.str] = None,
+        fill: typing.Optional["VerticalShading"] = None,
+        label: typing.Optional[builtins.str] = None,
+        visible: typing.Optional[builtins.bool] = None,
+    ) -> None:
+        '''Vertical annotation to be added to a graph.
+
+        :param date: The date and time (in ISO 8601 format) in the graph where the vertical annotation line is to appear.
+        :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to be used for the annotation. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
+        :param fill: Add shading before or after the annotation. Default: No shading
+        :param label: Label for the annotation. Default: - No label
+        :param visible: Whether the annotation is visible. Default: true
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_cloudwatch as cloudwatch
+            
+            vertical_annotation = cloudwatch.VerticalAnnotation(
+                date="date",
+            
+                # the properties below are optional
+                color="color",
+                fill=cloudwatch.VerticalShading.NONE,
+                label="label",
+                visible=False
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c903f8a4aafff9c3e6b2539c8372df8551aba4035bb4187c0e0930b0ee60ff00)
+            check_type(argname="argument date", value=date, expected_type=type_hints["date"])
+            check_type(argname="argument color", value=color, expected_type=type_hints["color"])
+            check_type(argname="argument fill", value=fill, expected_type=type_hints["fill"])
+            check_type(argname="argument label", value=label, expected_type=type_hints["label"])
+            check_type(argname="argument visible", value=visible, expected_type=type_hints["visible"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "date": date,
+        }
+        if color is not None:
+            self._values["color"] = color
+        if fill is not None:
+            self._values["fill"] = fill
+        if label is not None:
+            self._values["label"] = label
+        if visible is not None:
+            self._values["visible"] = visible
+
+    @builtins.property
+    def date(self) -> builtins.str:
+        '''The date and time (in ISO 8601 format) in the graph where the vertical annotation line is to appear.'''
+        result = self._values.get("date")
+        assert result is not None, "Required property 'date' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def color(self) -> typing.Optional[builtins.str]:
+        '''The hex color code, prefixed with '#' (e.g. '#00ff00'), to be used for the annotation. The ``Color`` class has a set of standard colors that can be used here.
+
+        :default: - Automatic color
+        '''
+        result = self._values.get("color")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def fill(self) -> typing.Optional["VerticalShading"]:
+        '''Add shading before or after the annotation.
+
+        :default: No shading
+        '''
+        result = self._values.get("fill")
+        return typing.cast(typing.Optional["VerticalShading"], result)
+
+    @builtins.property
+    def label(self) -> typing.Optional[builtins.str]:
+        '''Label for the annotation.
+
+        :default: - No label
+        '''
+        result = self._values.get("label")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def visible(self) -> typing.Optional[builtins.bool]:
+        '''Whether the annotation is visible.
+
+        :default: true
+        '''
+        result = self._values.get("visible")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "VerticalAnnotation(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.enum(jsii_type="aws-cdk-lib.aws_cloudwatch.VerticalShading")
+class VerticalShading(enum.Enum):
+    '''Fill shading options that will be used with a vertical annotation.'''
+
+    NONE = "NONE"
+    '''Don't add shading.'''
+    BEFORE = "BEFORE"
+    '''Add shading before the annotation.'''
+    AFTER = "AFTER"
+    '''Add shading after the annotation.'''
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_cloudwatch.YAxisProps",
     jsii_struct_bases=[],
@@ -12017,12 +12206,14 @@ class GaugeWidget(
         self,
         *,
         annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
+        end: typing.Optional[builtins.str] = None,
         left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
         legend_position: typing.Optional[LegendPosition] = None,
         live_data: typing.Optional[builtins.bool] = None,
         metrics: typing.Optional[typing.Sequence[IMetric]] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
@@ -12031,12 +12222,14 @@ class GaugeWidget(
     ) -> None:
         '''
         :param annotations: Annotations for the left Y axis. Default: - No annotations
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left_y_axis: Left Y axis. Default: - None
         :param legend_position: Position of the legend. Default: - bottom
         :param live_data: Whether the graph should show live data. Default: false
         :param metrics: Metrics to display on left Y axis. Default: - No metrics
         :param period: The default period for all metrics in this widget. The period is the length of time represented by one data point on the graph. This default can be overridden within each metric definition. Default: cdk.Duration.seconds(300)
         :param set_period_to_time_range: Whether to show the value from the entire time range. Only applicable for Bar and Pie charts. If false, values will be from the most recent period of your chosen time range; if true, shows the value from the entire time range. Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
@@ -12045,12 +12238,14 @@ class GaugeWidget(
         '''
         props = GaugeWidgetProps(
             annotations=annotations,
+            end=end,
             left_y_axis=left_y_axis,
             legend_position=legend_position,
             live_data=live_data,
             metrics=metrics,
             period=period,
             set_period_to_time_range=set_period_to_time_range,
+            start=start,
             statistic=statistic,
             height=height,
             region=region,
@@ -12086,12 +12281,14 @@ class GaugeWidget(
         "title": "title",
         "width": "width",
         "annotations": "annotations",
+        "end": "end",
         "left_y_axis": "leftYAxis",
         "legend_position": "legendPosition",
         "live_data": "liveData",
         "metrics": "metrics",
         "period": "period",
         "set_period_to_time_range": "setPeriodToTimeRange",
+        "start": "start",
         "statistic": "statistic",
     },
 )
@@ -12104,12 +12301,14 @@ class GaugeWidgetProps(MetricWidgetProps):
         title: typing.Optional[builtins.str] = None,
         width: typing.Optional[jsii.Number] = None,
         annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
+        end: typing.Optional[builtins.str] = None,
         left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
         legend_position: typing.Optional[LegendPosition] = None,
         live_data: typing.Optional[builtins.bool] = None,
         metrics: typing.Optional[typing.Sequence[IMetric]] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for a GaugeWidget.
@@ -12119,12 +12318,14 @@ class GaugeWidgetProps(MetricWidgetProps):
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
         :param annotations: Annotations for the left Y axis. Default: - No annotations
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left_y_axis: Left Y axis. Default: - None
         :param legend_position: Position of the legend. Default: - bottom
         :param live_data: Whether the graph should show live data. Default: false
         :param metrics: Metrics to display on left Y axis. Default: - No metrics
         :param period: The default period for all metrics in this widget. The period is the length of time represented by one data point on the graph. This default can be overridden within each metric definition. Default: cdk.Duration.seconds(300)
         :param set_period_to_time_range: Whether to show the value from the entire time range. Only applicable for Bar and Pie charts. If false, values will be from the most recent period of your chosen time range; if true, shows the value from the entire time range. Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
 
         :exampleMetadata: infused
@@ -12153,12 +12354,14 @@ class GaugeWidgetProps(MetricWidgetProps):
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
             check_type(argname="argument width", value=width, expected_type=type_hints["width"])
             check_type(argname="argument annotations", value=annotations, expected_type=type_hints["annotations"])
+            check_type(argname="argument end", value=end, expected_type=type_hints["end"])
             check_type(argname="argument left_y_axis", value=left_y_axis, expected_type=type_hints["left_y_axis"])
             check_type(argname="argument legend_position", value=legend_position, expected_type=type_hints["legend_position"])
             check_type(argname="argument live_data", value=live_data, expected_type=type_hints["live_data"])
             check_type(argname="argument metrics", value=metrics, expected_type=type_hints["metrics"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument set_period_to_time_range", value=set_period_to_time_range, expected_type=type_hints["set_period_to_time_range"])
+            check_type(argname="argument start", value=start, expected_type=type_hints["start"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if height is not None:
@@ -12171,6 +12374,8 @@ class GaugeWidgetProps(MetricWidgetProps):
             self._values["width"] = width
         if annotations is not None:
             self._values["annotations"] = annotations
+        if end is not None:
+            self._values["end"] = end
         if left_y_axis is not None:
             self._values["left_y_axis"] = left_y_axis
         if legend_position is not None:
@@ -12183,6 +12388,8 @@ class GaugeWidgetProps(MetricWidgetProps):
             self._values["period"] = period
         if set_period_to_time_range is not None:
             self._values["set_period_to_time_range"] = set_period_to_time_range
+        if start is not None:
+            self._values["start"] = start
         if statistic is not None:
             self._values["statistic"] = statistic
 
@@ -12234,6 +12441,18 @@ class GaugeWidgetProps(MetricWidgetProps):
         result = self._values.get("annotations")
         return typing.cast(typing.Optional[typing.List[HorizontalAnnotation]], result)
 
+    @builtins.property
+    def end(self) -> typing.Optional[builtins.str]:
+        '''The end of the time range to use for each widget independently from those of the dashboard.
+
+        If you specify a value for end, you must also specify a value for start.
+        Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the end date will be the current time.
+        '''
+        result = self._values.get("end")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def left_y_axis(self) -> typing.Optional[YAxisProps]:
         '''Left Y axis.
@@ -12294,6 +12513,21 @@ class GaugeWidgetProps(MetricWidgetProps):
         result = self._values.get("set_period_to_time_range")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def start(self) -> typing.Optional[builtins.str]:
+        '''The start of the time range to use for each widget independently from those of the dashboard.
+
+        You can specify start without specifying end to specify a relative time range that ends with the current time.
+        In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for
+        minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months.
+        You can also use start along with an end field, to specify an absolute time range.
+        When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the start time will be the default time range.
+        '''
+        result = self._values.get("start")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def statistic(self) -> typing.Optional[builtins.str]:
         '''The default statistic to be displayed for each metric.
@@ -12341,6 +12575,7 @@ class GraphWidget(
     def __init__(
         self,
         *,
+        end: typing.Optional[builtins.str] = None,
         left: typing.Optional[typing.Sequence[IMetric]] = None,
         left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
         left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -12352,7 +12587,9 @@ class GraphWidget(
         right_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         stacked: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
+        vertical_annotations: typing.Optional[typing.Sequence[typing.Union[VerticalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
         view: typing.Optional[GraphWidgetView] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
@@ -12360,6 +12597,7 @@ class GraphWidget(
         width: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left: Metrics to display on left Y axis. Default: - No metrics
         :param left_annotations: Annotations for the left Y axis. Default: - No annotations
         :param left_y_axis: Left Y axis. Default: - None
@@ -12371,7 +12609,9 @@ class GraphWidget(
         :param right_y_axis: Right Y axis. Default: - None
         :param set_period_to_time_range: Whether to show the value from the entire time range. Only applicable for Bar and Pie charts. If false, values will be from the most recent period of your chosen time range; if true, shows the value from the entire time range. Default: false
         :param stacked: Whether the graph should be shown as stacked lines. Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
+        :param vertical_annotations: Annotations for the X axis. Default: - No annotations
         :param view: Display this metric. Default: TimeSeries
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
@@ -12379,6 +12619,7 @@ class GraphWidget(
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
         '''
         props = GraphWidgetProps(
+            end=end,
             left=left,
             left_annotations=left_annotations,
             left_y_axis=left_y_axis,
@@ -12390,7 +12631,9 @@ class GraphWidget(
             right_y_axis=right_y_axis,
             set_period_to_time_range=set_period_to_time_range,
             stacked=stacked,
+            start=start,
             statistic=statistic,
+            vertical_annotations=vertical_annotations,
             view=view,
             height=height,
             region=region,
@@ -12436,6 +12679,7 @@ class GraphWidget(
         "region": "region",
         "title": "title",
         "width": "width",
+        "end": "end",
         "left": "left",
         "left_annotations": "leftAnnotations",
         "left_y_axis": "leftYAxis",
@@ -12447,7 +12691,9 @@ class GraphWidget(
         "right_y_axis": "rightYAxis",
         "set_period_to_time_range": "setPeriodToTimeRange",
         "stacked": "stacked",
+        "start": "start",
         "statistic": "statistic",
+        "vertical_annotations": "verticalAnnotations",
         "view": "view",
     },
 )
@@ -12459,6 +12705,7 @@ class GraphWidgetProps(MetricWidgetProps):
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
         width: typing.Optional[jsii.Number] = None,
+        end: typing.Optional[builtins.str] = None,
         left: typing.Optional[typing.Sequence[IMetric]] = None,
         left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
         left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -12470,7 +12717,9 @@ class GraphWidgetProps(MetricWidgetProps):
         right_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         stacked: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
+        vertical_annotations: typing.Optional[typing.Sequence[typing.Union[VerticalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
         view: typing.Optional[GraphWidgetView] = None,
     ) -> None:
         '''Properties for a GraphWidget.
@@ -12479,6 +12728,7 @@ class GraphWidgetProps(MetricWidgetProps):
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left: Metrics to display on left Y axis. Default: - No metrics
         :param left_annotations: Annotations for the left Y axis. Default: - No annotations
         :param left_y_axis: Left Y axis. Default: - None
@@ -12490,7 +12740,9 @@ class GraphWidgetProps(MetricWidgetProps):
         :param right_y_axis: Right Y axis. Default: - None
         :param set_period_to_time_range: Whether to show the value from the entire time range. Only applicable for Bar and Pie charts. If false, values will be from the most recent period of your chosen time range; if true, shows the value from the entire time range. Default: false
         :param stacked: Whether the graph should be shown as stacked lines. Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
+        :param vertical_annotations: Annotations for the X axis. Default: - No annotations
         :param view: Display this metric. Default: TimeSeries
 
         :exampleMetadata: infused
@@ -12516,6 +12768,7 @@ class GraphWidgetProps(MetricWidgetProps):
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
             check_type(argname="argument width", value=width, expected_type=type_hints["width"])
+            check_type(argname="argument end", value=end, expected_type=type_hints["end"])
             check_type(argname="argument left", value=left, expected_type=type_hints["left"])
             check_type(argname="argument left_annotations", value=left_annotations, expected_type=type_hints["left_annotations"])
             check_type(argname="argument left_y_axis", value=left_y_axis, expected_type=type_hints["left_y_axis"])
@@ -12527,7 +12780,9 @@ class GraphWidgetProps(MetricWidgetProps):
             check_type(argname="argument right_y_axis", value=right_y_axis, expected_type=type_hints["right_y_axis"])
             check_type(argname="argument set_period_to_time_range", value=set_period_to_time_range, expected_type=type_hints["set_period_to_time_range"])
             check_type(argname="argument stacked", value=stacked, expected_type=type_hints["stacked"])
+            check_type(argname="argument start", value=start, expected_type=type_hints["start"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
+            check_type(argname="argument vertical_annotations", value=vertical_annotations, expected_type=type_hints["vertical_annotations"])
             check_type(argname="argument view", value=view, expected_type=type_hints["view"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if height is not None:
@@ -12538,6 +12793,8 @@ class GraphWidgetProps(MetricWidgetProps):
             self._values["title"] = title
         if width is not None:
             self._values["width"] = width
+        if end is not None:
+            self._values["end"] = end
         if left is not None:
             self._values["left"] = left
         if left_annotations is not None:
@@ -12560,8 +12817,12 @@ class GraphWidgetProps(MetricWidgetProps):
             self._values["set_period_to_time_range"] = set_period_to_time_range
         if stacked is not None:
             self._values["stacked"] = stacked
+        if start is not None:
+            self._values["start"] = start
         if statistic is not None:
             self._values["statistic"] = statistic
+        if vertical_annotations is not None:
+            self._values["vertical_annotations"] = vertical_annotations
         if view is not None:
             self._values["view"] = view
 
@@ -12604,6 +12865,18 @@ class GraphWidgetProps(MetricWidgetProps):
         result = self._values.get("width")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def end(self) -> typing.Optional[builtins.str]:
+        '''The end of the time range to use for each widget independently from those of the dashboard.
+
+        If you specify a value for end, you must also specify a value for start.
+        Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the end date will be the current time.
+        '''
+        result = self._values.get("end")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def left(self) -> typing.Optional[typing.List[IMetric]]:
         '''Metrics to display on left Y axis.
@@ -12709,6 +12982,21 @@ class GraphWidgetProps(MetricWidgetProps):
         result = self._values.get("stacked")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def start(self) -> typing.Optional[builtins.str]:
+        '''The start of the time range to use for each widget independently from those of the dashboard.
+
+        You can specify start without specifying end to specify a relative time range that ends with the current time.
+        In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for
+        minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months.
+        You can also use start along with an end field, to specify an absolute time range.
+        When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z.
+
+        :default: When the dashboard loads, the start time will be the default time range.
+        '''
+        result = self._values.get("start")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def statistic(self) -> typing.Optional[builtins.str]:
         '''The default statistic to be displayed for each metric.
@@ -12720,6 +13008,15 @@ class GraphWidgetProps(MetricWidgetProps):
         result = self._values.get("statistic")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def vertical_annotations(self) -> typing.Optional[typing.List[VerticalAnnotation]]:
+        '''Annotations for the X axis.
+
+        :default: - No annotations
+        '''
+        result = self._values.get("vertical_annotations")
+        return typing.cast(typing.Optional[typing.List[VerticalAnnotation]], result)
+
     @builtins.property
     def view(self) -> typing.Optional[GraphWidgetView]:
         '''Display this metric.
@@ -12883,10 +13180,12 @@ class SingleValueWidget(
         self,
         *,
         metrics: typing.Sequence[IMetric],
+        end: typing.Optional[builtins.str] = None,
         full_precision: typing.Optional[builtins.bool] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         sparkline: typing.Optional[builtins.bool] = None,
+        start: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -12894,10 +13193,12 @@ class SingleValueWidget(
     ) -> None:
         '''
         :param metrics: Metrics to display.
+        :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param full_precision: Whether to show as many digits as can fit, before rounding. Default: false
         :param period: The default period for all metrics in this widget. The period is the length of time represented by one data point on the graph. This default can be overridden within each metric definition. Default: cdk.Duration.seconds(300)
         :param set_period_to_time_range: Whether to show the value from the entire time range. Default: false
         :param sparkline: Whether to show a graph below the value illustrating the value for the whole time range. Cannot be used in combination with ``setPeriodToTimeRange`` Default: false
+        :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -12905,10 +13206,12 @@ class SingleValueWidget(
         '''
         props = SingleValueWidgetProps(
             metrics=metrics,
+            end=end,
             full_precision=full_precision,
             period=period,
             set_period_to_time_range=set_period_to_time_range,
             sparkline=sparkline,
+            start=start,
             height=height,
             region=region,
             title=title,
@@ -13677,6 +13980,8 @@ __all__ = [
     "VariableInputType",
     "VariableType",
     "VariableValue",
+    "VerticalAnnotation",
+    "VerticalShading",
     "YAxisProps",
 ]
 
@@ -14798,10 +15103,12 @@ def _typecheckingstub__4596565f40195bdcc9fe939fa585a3bdf484f8a4a6817e427c6f9e1e4
     title: typing.Optional[builtins.str] = None,
     width: typing.Optional[jsii.Number] = None,
     metrics: typing.Sequence[IMetric],
+    end: typing.Optional[builtins.str] = None,
     full_precision: typing.Optional[builtins.bool] = None,
     period: typing.Optional[_Duration_4839e8c3] = None,
     set_period_to_time_range: typing.Optional[builtins.bool] = None,
     sparkline: typing.Optional[builtins.bool] = None,
+    start: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -14934,6 +15241,17 @@ def _typecheckingstub__03c9a6d1a1a0197c51468b97744230720e131da2f17bd50bfcfa9f7a3
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__c903f8a4aafff9c3e6b2539c8372df8551aba4035bb4187c0e0930b0ee60ff00(
+    *,
+    date: builtins.str,
+    color: typing.Optional[builtins.str] = None,
+    fill: typing.Optional[VerticalShading] = None,
+    label: typing.Optional[builtins.str] = None,
+    visible: typing.Optional[builtins.bool] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ec63852e8e70001b1e7a1554d96ad9ddb32bcfee6e3c022b5ba672bf9259a3be(
     *,
     label: typing.Optional[builtins.str] = None,
@@ -15036,12 +15354,14 @@ def _typecheckingstub__c1f8fe2511861f7fc6d2225bf5821fc9134b7036355dffb1d0ddd86a9
     title: typing.Optional[builtins.str] = None,
     width: typing.Optional[jsii.Number] = None,
     annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
+    end: typing.Optional[builtins.str] = None,
     left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
     legend_position: typing.Optional[LegendPosition] = None,
     live_data: typing.Optional[builtins.bool] = None,
     metrics: typing.Optional[typing.Sequence[IMetric]] = None,
     period: typing.Optional[_Duration_4839e8c3] = None,
     set_period_to_time_range: typing.Optional[builtins.bool] = None,
+    start: typing.Optional[builtins.str] = None,
     statistic: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -15065,6 +15385,7 @@ def _typecheckingstub__3471ad100c9e34a517506d76368276ef9b137a3c7b33aecc91910b5dc
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
     width: typing.Optional[jsii.Number] = None,
+    end: typing.Optional[builtins.str] = None,
     left: typing.Optional[typing.Sequence[IMetric]] = None,
     left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
     left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -15076,7 +15397,9 @@ def _typecheckingstub__3471ad100c9e34a517506d76368276ef9b137a3c7b33aecc91910b5dc
     right_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
     set_period_to_time_range: typing.Optional[builtins.bool] = None,
     stacked: typing.Optional[builtins.bool] = None,
+    start: typing.Optional[builtins.str] = None,
     statistic: typing.Optional[builtins.str] = None,
+    vertical_annotations: typing.Optional[typing.Sequence[typing.Union[VerticalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
     view: typing.Optional[GraphWidgetView] = None,
 ) -> None:
     """Type checking stubs"""