aws-cdk-lib 2.171.0__py3-none-any.whl → 2.172.0__py3-none-any.whl

aws_cdk/aws_cloudtrail/__init__.py

@@ -241,6 +241,7 @@ from .. import (
     IInspectable as _IInspectable_c2943556,
     IResolvable as _IResolvable_da3f097b,
     ITaggable as _ITaggable_36806126,
+    ITaggableV2 as _ITaggableV2_4e6798f8,
     Resource as _Resource_45bc6135,
     TagManager as _TagManager_0a598cb3,
     TreeInspector as _TreeInspector_488e0dd5,
@@ -718,6 +719,664 @@ class CfnChannelProps:
         )
 
 
+@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+class CfnDashboard(
+    _CfnResource_9df397a6,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_cloudtrail.CfnDashboard",
+):
+    '''The Amazon CloudTrail dashboard resource allows customers to manage managed dashboards and create custom dashboards.
+
+    You can manually refresh custom and managed dashboards. For custom dashboards, you can also set up an automatic refresh schedule and modify dashboard widgets.
+
+    :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html
+    :cloudformationResource: AWS::CloudTrail::Dashboard
+    :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_cloudtrail as cloudtrail
+        
+        cfn_dashboard = cloudtrail.CfnDashboard(self, "MyCfnDashboard",
+            name="name",
+            refresh_schedule=cloudtrail.CfnDashboard.RefreshScheduleProperty(
+                frequency=cloudtrail.CfnDashboard.FrequencyProperty(
+                    unit="unit",
+                    value=123
+                ),
+                status="status",
+                time_of_day="timeOfDay"
+            ),
+            tags=[CfnTag(
+                key="key",
+                value="value"
+            )],
+            termination_protection_enabled=False,
+            widgets=[cloudtrail.CfnDashboard.WidgetProperty(
+                query_statement="queryStatement",
+        
+                # the properties below are optional
+                query_parameters=["queryParameters"],
+                view_properties={
+                    "view_properties_key": "viewProperties"
+                }
+            )]
+        )
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        name: typing.Optional[builtins.str] = None,
+        refresh_schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDashboard.RefreshScheduleProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        termination_protection_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        widgets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDashboard.WidgetProperty", 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: The name of the dashboard.
+        :param refresh_schedule: Configures the automatic refresh schedule for the dashboard. Includes the frequency unit (DAYS or HOURS) and value, as well as the status (ENABLED or DISABLED) of the refresh schedule.
+        :param tags: 
+        :param termination_protection_enabled: Indicates whether the dashboard is protected from termination.
+        :param widgets: List of widgets on the dashboard.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__65875e3ceabcc57155f97b1541ff9d435e4456c9c7f0c980c1dea0ac9bffc3ce)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = CfnDashboardProps(
+            name=name,
+            refresh_schedule=refresh_schedule,
+            tags=tags,
+            termination_protection_enabled=termination_protection_enabled,
+            widgets=widgets,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="inspect")
+    def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
+        '''Examines the CloudFormation resource and discloses attributes.
+
+        :param inspector: tree inspector to collect and process attributes.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__80aa78b7039f0746d57f08dc22b8127693ce2c2c4b3ede574289925bdfd4379f)
+            check_type(argname="argument inspector", value=inspector, expected_type=type_hints["inspector"])
+        return typing.cast(None, jsii.invoke(self, "inspect", [inspector]))
+
+    @jsii.member(jsii_name="renderProperties")
+    def _render_properties(
+        self,
+        props: typing.Mapping[builtins.str, typing.Any],
+    ) -> typing.Mapping[builtins.str, typing.Any]:
+        '''
+        :param props: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e96a4620eb54251cb180709e3338de0cb20f46ad1ac13bee113fa445de8bc7dc)
+            check_type(argname="argument props", value=props, expected_type=type_hints["props"])
+        return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.invoke(self, "renderProperties", [props]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="CFN_RESOURCE_TYPE_NAME")
+    def CFN_RESOURCE_TYPE_NAME(cls) -> builtins.str:
+        '''The CloudFormation resource type name for this resource class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrCreatedTimestamp")
+    def attr_created_timestamp(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: CreatedTimestamp
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrCreatedTimestamp"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrDashboardArn")
+    def attr_dashboard_arn(self) -> builtins.str:
+        '''The ARN of the dashboard.
+
+        :cloudformationAttribute: DashboardArn
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrDashboardArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrStatus")
+    def attr_status(self) -> builtins.str:
+        '''The status of the dashboard.
+
+        Values are CREATING, CREATED, UPDATING, UPDATED and DELETING.
+
+        :cloudformationAttribute: Status
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrStatus"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrType")
+    def attr_type(self) -> builtins.str:
+        '''The type of the dashboard.
+
+        Values are CUSTOM and MANAGED.
+
+        :cloudformationAttribute: Type
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrType"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrUpdatedTimestamp")
+    def attr_updated_timestamp(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: UpdatedTimestamp
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrUpdatedTimestamp"))
+
+    @builtins.property
+    @jsii.member(jsii_name="cdkTagManager")
+    def cdk_tag_manager(self) -> _TagManager_0a598cb3:
+        '''Tag Manager which manages the tags for this resource.'''
+        return typing.cast(_TagManager_0a598cb3, jsii.get(self, "cdkTagManager"))
+
+    @builtins.property
+    @jsii.member(jsii_name="cfnProperties")
+    def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
+        return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
+
+    @builtins.property
+    @jsii.member(jsii_name="name")
+    def name(self) -> typing.Optional[builtins.str]:
+        '''The name of the dashboard.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "name"))
+
+    @name.setter
+    def name(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__ad3cc4c5ce87019f2d65bf513eb6f6987758697d7edaf71a8c25d63e5adcd28a)
+            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="refreshSchedule")
+    def refresh_schedule(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDashboard.RefreshScheduleProperty"]]:
+        '''Configures the automatic refresh schedule for the dashboard.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDashboard.RefreshScheduleProperty"]], jsii.get(self, "refreshSchedule"))
+
+    @refresh_schedule.setter
+    def refresh_schedule(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDashboard.RefreshScheduleProperty"]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c189822248b924f49d3f78593489ebfdb50baaa5632423120ffc582017517a62)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "refreshSchedule", value) # pyright: ignore[reportArgumentType]
+
+    @builtins.property
+    @jsii.member(jsii_name="tags")
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
+
+    @tags.setter
+    def tags(self, value: typing.Optional[typing.List[_CfnTag_f6864754]]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__f30292137ba2f648895c0e1f3beefbf660ef3c12168b20e06516352a881c1581)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "tags", value) # pyright: ignore[reportArgumentType]
+
+    @builtins.property
+    @jsii.member(jsii_name="terminationProtectionEnabled")
+    def termination_protection_enabled(
+        self,
+    ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+        '''Indicates whether the dashboard is protected from termination.'''
+        return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "terminationProtectionEnabled"))
+
+    @termination_protection_enabled.setter
+    def termination_protection_enabled(
+        self,
+        value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__784f2dc9097025d1492e66bc4ea947ce69164f00c1538ca507daa506ba7efe22)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "terminationProtectionEnabled", value) # pyright: ignore[reportArgumentType]
+
+    @builtins.property
+    @jsii.member(jsii_name="widgets")
+    def widgets(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDashboard.WidgetProperty"]]]]:
+        '''List of widgets on the dashboard.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDashboard.WidgetProperty"]]]], jsii.get(self, "widgets"))
+
+    @widgets.setter
+    def widgets(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDashboard.WidgetProperty"]]]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__15acb7e7b87191d3aa52a0f02842d9b876d6cd2175319b3e4dd3ac6b352b2755)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "widgets", value) # pyright: ignore[reportArgumentType]
+
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_cloudtrail.CfnDashboard.FrequencyProperty",
+        jsii_struct_bases=[],
+        name_mapping={"unit": "unit", "value": "value"},
+    )
+    class FrequencyProperty:
+        def __init__(self, *, unit: builtins.str, value: jsii.Number) -> None:
+            '''
+            :param unit: The frequency unit. Supported values are HOURS and DAYS.
+            :param value: The frequency value.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-frequency.html
+            :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_cloudtrail as cloudtrail
+                
+                frequency_property = cloudtrail.CfnDashboard.FrequencyProperty(
+                    unit="unit",
+                    value=123
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__2f2203e866b3e98fa21e0e9b0a804e36298f95797b075211e843ddc70bd28b8c)
+                check_type(argname="argument unit", value=unit, expected_type=type_hints["unit"])
+                check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "unit": unit,
+                "value": value,
+            }
+
+        @builtins.property
+        def unit(self) -> builtins.str:
+            '''The frequency unit.
+
+            Supported values are HOURS and DAYS.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-frequency.html#cfn-cloudtrail-dashboard-frequency-unit
+            '''
+            result = self._values.get("unit")
+            assert result is not None, "Required property 'unit' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def value(self) -> jsii.Number:
+            '''The frequency value.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-frequency.html#cfn-cloudtrail-dashboard-frequency-value
+            '''
+            result = self._values.get("value")
+            assert result is not None, "Required property 'value' is missing"
+            return typing.cast(jsii.Number, 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 "FrequencyProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_cloudtrail.CfnDashboard.RefreshScheduleProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "frequency": "frequency",
+            "status": "status",
+            "time_of_day": "timeOfDay",
+        },
+    )
+    class RefreshScheduleProperty:
+        def __init__(
+            self,
+            *,
+            frequency: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDashboard.FrequencyProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+            status: typing.Optional[builtins.str] = None,
+            time_of_day: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''Configures the automatic refresh schedule for the dashboard.
+
+            Includes the frequency unit (DAYS or HOURS) and value, as well as the status (ENABLED or DISABLED) of the refresh schedule.
+
+            :param frequency: 
+            :param status: The status of the schedule. Supported values are ENABLED and DISABLED.
+            :param time_of_day: StartTime of the automatic schedule refresh.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-refreshschedule.html
+            :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_cloudtrail as cloudtrail
+                
+                refresh_schedule_property = cloudtrail.CfnDashboard.RefreshScheduleProperty(
+                    frequency=cloudtrail.CfnDashboard.FrequencyProperty(
+                        unit="unit",
+                        value=123
+                    ),
+                    status="status",
+                    time_of_day="timeOfDay"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__e38849bc2b8e26a855d5c01196725a15d72db451889d0b2ed0891ec262db60d8)
+                check_type(argname="argument frequency", value=frequency, expected_type=type_hints["frequency"])
+                check_type(argname="argument status", value=status, expected_type=type_hints["status"])
+                check_type(argname="argument time_of_day", value=time_of_day, expected_type=type_hints["time_of_day"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if frequency is not None:
+                self._values["frequency"] = frequency
+            if status is not None:
+                self._values["status"] = status
+            if time_of_day is not None:
+                self._values["time_of_day"] = time_of_day
+
+        @builtins.property
+        def frequency(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDashboard.FrequencyProperty"]]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-refreshschedule.html#cfn-cloudtrail-dashboard-refreshschedule-frequency
+            '''
+            result = self._values.get("frequency")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDashboard.FrequencyProperty"]], result)
+
+        @builtins.property
+        def status(self) -> typing.Optional[builtins.str]:
+            '''The status of the schedule.
+
+            Supported values are ENABLED and DISABLED.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-refreshschedule.html#cfn-cloudtrail-dashboard-refreshschedule-status
+            '''
+            result = self._values.get("status")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def time_of_day(self) -> typing.Optional[builtins.str]:
+            '''StartTime of the automatic schedule refresh.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-refreshschedule.html#cfn-cloudtrail-dashboard-refreshschedule-timeofday
+            '''
+            result = self._values.get("time_of_day")
+            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
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "RefreshScheduleProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_cloudtrail.CfnDashboard.WidgetProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "query_statement": "queryStatement",
+            "query_parameters": "queryParameters",
+            "view_properties": "viewProperties",
+        },
+    )
+    class WidgetProperty:
+        def __init__(
+            self,
+            *,
+            query_statement: builtins.str,
+            query_parameters: typing.Optional[typing.Sequence[builtins.str]] = None,
+            view_properties: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
+        ) -> None:
+            '''The dashboard widget.
+
+            :param query_statement: The SQL query statement on one or more event data stores.
+            :param query_parameters: The placeholder keys in the QueryStatement. For example: $StartTime$, $EndTime$, $Period$.
+            :param view_properties: The view properties of the widget.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-widget.html
+            :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_cloudtrail as cloudtrail
+                
+                widget_property = cloudtrail.CfnDashboard.WidgetProperty(
+                    query_statement="queryStatement",
+                
+                    # the properties below are optional
+                    query_parameters=["queryParameters"],
+                    view_properties={
+                        "view_properties_key": "viewProperties"
+                    }
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__dc8abf1361e0023c8b0a4cba28dced78eff4f36aa3c868efa3feed153cec95df)
+                check_type(argname="argument query_statement", value=query_statement, expected_type=type_hints["query_statement"])
+                check_type(argname="argument query_parameters", value=query_parameters, expected_type=type_hints["query_parameters"])
+                check_type(argname="argument view_properties", value=view_properties, expected_type=type_hints["view_properties"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "query_statement": query_statement,
+            }
+            if query_parameters is not None:
+                self._values["query_parameters"] = query_parameters
+            if view_properties is not None:
+                self._values["view_properties"] = view_properties
+
+        @builtins.property
+        def query_statement(self) -> builtins.str:
+            '''The SQL query statement on one or more event data stores.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-widget.html#cfn-cloudtrail-dashboard-widget-querystatement
+            '''
+            result = self._values.get("query_statement")
+            assert result is not None, "Required property 'query_statement' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def query_parameters(self) -> typing.Optional[typing.List[builtins.str]]:
+            '''The placeholder keys in the QueryStatement.
+
+            For example: $StartTime$, $EndTime$, $Period$.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-widget.html#cfn-cloudtrail-dashboard-widget-queryparameters
+            '''
+            result = self._values.get("query_parameters")
+            return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
+        @builtins.property
+        def view_properties(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
+            '''The view properties of the widget.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-dashboard-widget.html#cfn-cloudtrail-dashboard-widget-viewproperties
+            '''
+            result = self._values.get("view_properties")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]], 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 "WidgetProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_cloudtrail.CfnDashboardProps",
+    jsii_struct_bases=[],
+    name_mapping={
+        "name": "name",
+        "refresh_schedule": "refreshSchedule",
+        "tags": "tags",
+        "termination_protection_enabled": "terminationProtectionEnabled",
+        "widgets": "widgets",
+    },
+)
+class CfnDashboardProps:
+    def __init__(
+        self,
+        *,
+        name: typing.Optional[builtins.str] = None,
+        refresh_schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.RefreshScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        termination_protection_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        widgets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.WidgetProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+    ) -> None:
+        '''Properties for defining a ``CfnDashboard``.
+
+        :param name: The name of the dashboard.
+        :param refresh_schedule: Configures the automatic refresh schedule for the dashboard. Includes the frequency unit (DAYS or HOURS) and value, as well as the status (ENABLED or DISABLED) of the refresh schedule.
+        :param tags: 
+        :param termination_protection_enabled: Indicates whether the dashboard is protected from termination.
+        :param widgets: List of widgets on the dashboard.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html
+        :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_cloudtrail as cloudtrail
+            
+            cfn_dashboard_props = cloudtrail.CfnDashboardProps(
+                name="name",
+                refresh_schedule=cloudtrail.CfnDashboard.RefreshScheduleProperty(
+                    frequency=cloudtrail.CfnDashboard.FrequencyProperty(
+                        unit="unit",
+                        value=123
+                    ),
+                    status="status",
+                    time_of_day="timeOfDay"
+                ),
+                tags=[CfnTag(
+                    key="key",
+                    value="value"
+                )],
+                termination_protection_enabled=False,
+                widgets=[cloudtrail.CfnDashboard.WidgetProperty(
+                    query_statement="queryStatement",
+            
+                    # the properties below are optional
+                    query_parameters=["queryParameters"],
+                    view_properties={
+                        "view_properties_key": "viewProperties"
+                    }
+                )]
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__6929f557c8f41826314d27fdba0c2269a618fd42c6e748deaa518379a830e911)
+            check_type(argname="argument name", value=name, expected_type=type_hints["name"])
+            check_type(argname="argument refresh_schedule", value=refresh_schedule, expected_type=type_hints["refresh_schedule"])
+            check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
+            check_type(argname="argument termination_protection_enabled", value=termination_protection_enabled, expected_type=type_hints["termination_protection_enabled"])
+            check_type(argname="argument widgets", value=widgets, expected_type=type_hints["widgets"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if name is not None:
+            self._values["name"] = name
+        if refresh_schedule is not None:
+            self._values["refresh_schedule"] = refresh_schedule
+        if tags is not None:
+            self._values["tags"] = tags
+        if termination_protection_enabled is not None:
+            self._values["termination_protection_enabled"] = termination_protection_enabled
+        if widgets is not None:
+            self._values["widgets"] = widgets
+
+    @builtins.property
+    def name(self) -> typing.Optional[builtins.str]:
+        '''The name of the dashboard.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html#cfn-cloudtrail-dashboard-name
+        '''
+        result = self._values.get("name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def refresh_schedule(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDashboard.RefreshScheduleProperty]]:
+        '''Configures the automatic refresh schedule for the dashboard.
+
+        Includes the frequency unit (DAYS or HOURS) and value, as well as the status (ENABLED or DISABLED) of the refresh schedule.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html#cfn-cloudtrail-dashboard-refreshschedule
+        '''
+        result = self._values.get("refresh_schedule")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDashboard.RefreshScheduleProperty]], result)
+
+    @builtins.property
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html#cfn-cloudtrail-dashboard-tags
+        '''
+        result = self._values.get("tags")
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
+
+    @builtins.property
+    def termination_protection_enabled(
+        self,
+    ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+        '''Indicates whether the dashboard is protected from termination.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html#cfn-cloudtrail-dashboard-terminationprotectionenabled
+        '''
+        result = self._values.get("termination_protection_enabled")
+        return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
+
+    @builtins.property
+    def widgets(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnDashboard.WidgetProperty]]]]:
+        '''List of widgets on the dashboard.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-dashboard.html#cfn-cloudtrail-dashboard-widgets
+        '''
+        result = self._values.get("widgets")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnDashboard.WidgetProperty]]]], 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 "CfnDashboardProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
 class CfnEventDataStore(
     _CfnResource_9df397a6,
@@ -4406,6 +5065,8 @@ __all__ = [
     "AddEventSelectorOptions",
     "CfnChannel",
     "CfnChannelProps",
+    "CfnDashboard",
+    "CfnDashboardProps",
     "CfnEventDataStore",
     "CfnEventDataStoreProps",
     "CfnResourcePolicy",
@@ -4498,6 +5159,98 @@ def _typecheckingstub__767e83e8a394410f21e7f497da1effaf3ef0c04f6e829362db73a8f53
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__65875e3ceabcc57155f97b1541ff9d435e4456c9c7f0c980c1dea0ac9bffc3ce(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    name: typing.Optional[builtins.str] = None,
+    refresh_schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.RefreshScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    termination_protection_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    widgets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.WidgetProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__80aa78b7039f0746d57f08dc22b8127693ce2c2c4b3ede574289925bdfd4379f(
+    inspector: _TreeInspector_488e0dd5,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e96a4620eb54251cb180709e3338de0cb20f46ad1ac13bee113fa445de8bc7dc(
+    props: typing.Mapping[builtins.str, typing.Any],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__ad3cc4c5ce87019f2d65bf513eb6f6987758697d7edaf71a8c25d63e5adcd28a(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__c189822248b924f49d3f78593489ebfdb50baaa5632423120ffc582017517a62(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDashboard.RefreshScheduleProperty]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__f30292137ba2f648895c0e1f3beefbf660ef3c12168b20e06516352a881c1581(
+    value: typing.Optional[typing.List[_CfnTag_f6864754]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__784f2dc9097025d1492e66bc4ea947ce69164f00c1538ca507daa506ba7efe22(
+    value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__15acb7e7b87191d3aa52a0f02842d9b876d6cd2175319b3e4dd3ac6b352b2755(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnDashboard.WidgetProperty]]]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__2f2203e866b3e98fa21e0e9b0a804e36298f95797b075211e843ddc70bd28b8c(
+    *,
+    unit: builtins.str,
+    value: jsii.Number,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e38849bc2b8e26a855d5c01196725a15d72db451889d0b2ed0891ec262db60d8(
+    *,
+    frequency: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.FrequencyProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    status: typing.Optional[builtins.str] = None,
+    time_of_day: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__dc8abf1361e0023c8b0a4cba28dced78eff4f36aa3c868efa3feed153cec95df(
+    *,
+    query_statement: builtins.str,
+    query_parameters: typing.Optional[typing.Sequence[builtins.str]] = None,
+    view_properties: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__6929f557c8f41826314d27fdba0c2269a618fd42c6e748deaa518379a830e911(
+    *,
+    name: typing.Optional[builtins.str] = None,
+    refresh_schedule: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.RefreshScheduleProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    termination_protection_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    widgets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDashboard.WidgetProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__058a94222b13ad44b4607ad5932ec9b6a2defcb250ff436576e6e8976e7b2bee(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,