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

aws_cdk/aws_cloudformation/__init__.py

@@ -3234,9 +3234,6 @@ class CfnStack(
         from aws_cdk import aws_cloudformation as cloudformation
         
         cfn_stack = cloudformation.CfnStack(self, "MyCfnStack",
-            template_url="templateUrl",
-        
-            # the properties below are optional
             notification_arns=["notificationArns"],
             parameters={
                 "parameters_key": "parameters"
@@ -3245,6 +3242,7 @@ class CfnStack(
                 key="key",
                 value="value"
             )],
+            template_url="templateUrl",
             timeout_in_minutes=123
         )
     '''
@@ -3254,19 +3252,19 @@ class CfnStack(
         scope: _constructs_77d1e7e8.Construct,
         id: builtins.str,
         *,
-        template_url: builtins.str,
         notification_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
         parameters: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        template_url: typing.Optional[builtins.str] = None,
         timeout_in_minutes: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param template_url: Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param notification_arns: The Amazon Simple Notification Service (Amazon SNS) topic ARNs to publish stack related events. You can find your Amazon SNS topic ARNs using the Amazon SNS console or your Command Line Interface (CLI).
         :param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks. Conditional. Required if the nested stack requires input parameters. Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param tags: Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.
+        :param template_url: Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param timeout_in_minutes: The length of time, in minutes, that CloudFormation waits for the nested stack to reach the ``CREATE_COMPLETE`` state. The default is no timeout. When CloudFormation detects that the nested stack has reached the ``CREATE_COMPLETE`` state, it marks the nested stack resource as ``CREATE_COMPLETE`` in the parent stack and resumes creating the parent stack. If the timeout period expires before the nested stack reaches ``CREATE_COMPLETE`` , CloudFormation marks the nested stack as failed and rolls back both the nested stack and parent stack. Updates aren't supported.
         '''
         if __debug__:
@@ -3274,10 +3272,10 @@ class CfnStack(
             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 = CfnStackProps(
-            template_url=template_url,
             notification_arns=notification_arns,
             parameters=parameters,
             tags=tags,
+            template_url=template_url,
             timeout_in_minutes=timeout_in_minutes,
         )
 
@@ -3314,12 +3312,68 @@ class CfnStack(
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
     @builtins.property
-    @jsii.member(jsii_name="attrId")
-    def attr_id(self) -> builtins.str:
+    @jsii.member(jsii_name="attrChangeSetId")
+    def attr_change_set_id(self) -> builtins.str:
         '''
-        :cloudformationAttribute: Id
+        :cloudformationAttribute: ChangeSetId
         '''
-        return typing.cast(builtins.str, jsii.get(self, "attrId"))
+        return typing.cast(builtins.str, jsii.get(self, "attrChangeSetId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrCreationTime")
+    def attr_creation_time(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: CreationTime
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrCreationTime"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrLastUpdateTime")
+    def attr_last_update_time(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: LastUpdateTime
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrLastUpdateTime"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrOutputs")
+    def attr_outputs(self) -> _IResolvable_da3f097b:
+        '''
+        :cloudformationAttribute: Outputs
+        '''
+        return typing.cast(_IResolvable_da3f097b, jsii.get(self, "attrOutputs"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrParentId")
+    def attr_parent_id(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: ParentId
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrParentId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrRootId")
+    def attr_root_id(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: RootId
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrRootId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrStackId")
+    def attr_stack_id(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: StackId
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrStackId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="attrStackStatus")
+    def attr_stack_status(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: StackStatus
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrStackStatus"))
 
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
@@ -3332,19 +3386,6 @@ class CfnStack(
         '''Tag Manager which manages the tags for this resource.'''
         return typing.cast(_TagManager_0a598cb3, jsii.get(self, "tags"))
 
-    @builtins.property
-    @jsii.member(jsii_name="templateUrl")
-    def template_url(self) -> builtins.str:
-        '''Location of file containing the template body.'''
-        return typing.cast(builtins.str, jsii.get(self, "templateUrl"))
-
-    @template_url.setter
-    def template_url(self, value: builtins.str) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__3db469b6ac2b6930a53773a7067f28dcbe494d1c4c0aa67dc9ab276d28d07904)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "templateUrl", value)
-
     @builtins.property
     @jsii.member(jsii_name="notificationArns")
     def notification_arns(self) -> typing.Optional[typing.List[builtins.str]]:
@@ -3392,6 +3433,19 @@ class CfnStack(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "tagsRaw", value)
 
+    @builtins.property
+    @jsii.member(jsii_name="templateUrl")
+    def template_url(self) -> typing.Optional[builtins.str]:
+        '''Location of file containing the template body.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "templateUrl"))
+
+    @template_url.setter
+    def template_url(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__3db469b6ac2b6930a53773a7067f28dcbe494d1c4c0aa67dc9ab276d28d07904)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "templateUrl", value)
+
     @builtins.property
     @jsii.member(jsii_name="timeoutInMinutes")
     def timeout_in_minutes(self) -> typing.Optional[jsii.Number]:
@@ -3405,15 +3459,120 @@ class CfnStack(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "timeoutInMinutes", value)
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_cloudformation.CfnStack.OutputProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "description": "description",
+            "export_name": "exportName",
+            "output_key": "outputKey",
+            "output_value": "outputValue",
+        },
+    )
+    class OutputProperty:
+        def __init__(
+            self,
+            *,
+            description: typing.Optional[builtins.str] = None,
+            export_name: typing.Optional[builtins.str] = None,
+            output_key: typing.Optional[builtins.str] = None,
+            output_value: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''The Output data type.
+
+            :param description: User defined description associated with the output.
+            :param export_name: The name of the export associated with the output.
+            :param output_key: The key associated with the output.
+            :param output_value: The value associated with the output.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stack-output.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_cloudformation as cloudformation
+                
+                output_property = cloudformation.CfnStack.OutputProperty(
+                    description="description",
+                    export_name="exportName",
+                    output_key="outputKey",
+                    output_value="outputValue"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__a4b95d92bea1984ce15e37fa304b047ed771a4f764d414ffac328157423828dc)
+                check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+                check_type(argname="argument export_name", value=export_name, expected_type=type_hints["export_name"])
+                check_type(argname="argument output_key", value=output_key, expected_type=type_hints["output_key"])
+                check_type(argname="argument output_value", value=output_value, expected_type=type_hints["output_value"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if description is not None:
+                self._values["description"] = description
+            if export_name is not None:
+                self._values["export_name"] = export_name
+            if output_key is not None:
+                self._values["output_key"] = output_key
+            if output_value is not None:
+                self._values["output_value"] = output_value
+
+        @builtins.property
+        def description(self) -> typing.Optional[builtins.str]:
+            '''User defined description associated with the output.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stack-output.html#cfn-cloudformation-stack-output-description
+            '''
+            result = self._values.get("description")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def export_name(self) -> typing.Optional[builtins.str]:
+            '''The name of the export associated with the output.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stack-output.html#cfn-cloudformation-stack-output-exportname
+            '''
+            result = self._values.get("export_name")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def output_key(self) -> typing.Optional[builtins.str]:
+            '''The key associated with the output.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stack-output.html#cfn-cloudformation-stack-output-outputkey
+            '''
+            result = self._values.get("output_key")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def output_value(self) -> typing.Optional[builtins.str]:
+            '''The value associated with the output.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stack-output.html#cfn-cloudformation-stack-output-outputvalue
+            '''
+            result = self._values.get("output_value")
+            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 "OutputProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_cloudformation.CfnStackProps",
     jsii_struct_bases=[],
     name_mapping={
-        "template_url": "templateUrl",
         "notification_arns": "notificationArns",
         "parameters": "parameters",
         "tags": "tags",
+        "template_url": "templateUrl",
         "timeout_in_minutes": "timeoutInMinutes",
     },
 )
@@ -3421,18 +3580,18 @@ class CfnStackProps:
     def __init__(
         self,
         *,
-        template_url: builtins.str,
         notification_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
         parameters: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        template_url: typing.Optional[builtins.str] = None,
         timeout_in_minutes: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''Properties for defining a ``CfnStack``.
 
-        :param template_url: Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param notification_arns: The Amazon Simple Notification Service (Amazon SNS) topic ARNs to publish stack related events. You can find your Amazon SNS topic ARNs using the Amazon SNS console or your Command Line Interface (CLI).
         :param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks. Conditional. Required if the nested stack requires input parameters. Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param tags: Key-value pairs to associate with this stack. AWS CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.
+        :param template_url: Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
         :param timeout_in_minutes: The length of time, in minutes, that CloudFormation waits for the nested stack to reach the ``CREATE_COMPLETE`` state. The default is no timeout. When CloudFormation detects that the nested stack has reached the ``CREATE_COMPLETE`` state, it marks the nested stack resource as ``CREATE_COMPLETE`` in the parent stack and resumes creating the parent stack. If the timeout period expires before the nested stack reaches ``CREATE_COMPLETE`` , CloudFormation marks the nested stack as failed and rolls back both the nested stack and parent stack. Updates aren't supported.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html
@@ -3445,9 +3604,6 @@ class CfnStackProps:
             from aws_cdk import aws_cloudformation as cloudformation
             
             cfn_stack_props = cloudformation.CfnStackProps(
-                template_url="templateUrl",
-            
-                # the properties below are optional
                 notification_arns=["notificationArns"],
                 parameters={
                     "parameters_key": "parameters"
@@ -3456,42 +3612,29 @@ class CfnStackProps:
                     key="key",
                     value="value"
                 )],
+                template_url="templateUrl",
                 timeout_in_minutes=123
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4da59ffe076e92fe1011ac29ca869d93a69d1442f3b7a0d1c765cca951d09b20)
-            check_type(argname="argument template_url", value=template_url, expected_type=type_hints["template_url"])
             check_type(argname="argument notification_arns", value=notification_arns, expected_type=type_hints["notification_arns"])
             check_type(argname="argument parameters", value=parameters, expected_type=type_hints["parameters"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
+            check_type(argname="argument template_url", value=template_url, expected_type=type_hints["template_url"])
             check_type(argname="argument timeout_in_minutes", value=timeout_in_minutes, expected_type=type_hints["timeout_in_minutes"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {
-            "template_url": template_url,
-        }
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
         if notification_arns is not None:
             self._values["notification_arns"] = notification_arns
         if parameters is not None:
             self._values["parameters"] = parameters
         if tags is not None:
             self._values["tags"] = tags
+        if template_url is not None:
+            self._values["template_url"] = template_url
         if timeout_in_minutes is not None:
             self._values["timeout_in_minutes"] = timeout_in_minutes
 
-    @builtins.property
-    def template_url(self) -> builtins.str:
-        '''Location of file containing the template body.
-
-        The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ .
-
-        Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html#cfn-cloudformation-stack-templateurl
-        '''
-        result = self._values.get("template_url")
-        assert result is not None, "Required property 'template_url' is missing"
-        return typing.cast(builtins.str, result)
-
     @builtins.property
     def notification_arns(self) -> typing.Optional[typing.List[builtins.str]]:
         '''The Amazon Simple Notification Service (Amazon SNS) topic ARNs to publish stack related events.
@@ -3534,6 +3677,19 @@ class CfnStackProps:
         result = self._values.get("tags")
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
 
+    @builtins.property
+    def template_url(self) -> typing.Optional[builtins.str]:
+        '''Location of file containing the template body.
+
+        The URL must point to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket. For more information, see `Template anatomy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html>`_ .
+
+        Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html#cfn-cloudformation-stack-templateurl
+        '''
+        result = self._values.get("template_url")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def timeout_in_minutes(self) -> typing.Optional[jsii.Number]:
         '''The length of time, in minutes, that CloudFormation waits for the nested stack to reach the ``CREATE_COMPLETE`` state.
@@ -6556,10 +6712,10 @@ def _typecheckingstub__b03b296829d4f2eb356ceeb892ed7d61908e69c4949bd797def9d9980
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
     *,
-    template_url: builtins.str,
     notification_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
     parameters: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    template_url: typing.Optional[builtins.str] = None,
     timeout_in_minutes: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
@@ -6577,12 +6733,6 @@ def _typecheckingstub__6d5f666653aae50479803ed71839253ef19c348c5240cb3bebb449b6e
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__3db469b6ac2b6930a53773a7067f28dcbe494d1c4c0aa67dc9ab276d28d07904(
-    value: builtins.str,
-) -> None:
-    """Type checking stubs"""
-    pass
-
 def _typecheckingstub__d66d5e1fe390793c13ae8f3762505ddcb7c4e44a03b219a7d65987bc8ac48d68(
     value: typing.Optional[typing.List[builtins.str]],
 ) -> None:
@@ -6601,18 +6751,34 @@ def _typecheckingstub__3dd6f2b6a16bc08db2d10b1a6eff5f64991fe724d61645874b4235a7f
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__3db469b6ac2b6930a53773a7067f28dcbe494d1c4c0aa67dc9ab276d28d07904(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__2c9f0cec1de29739b017def3b496f6e5bf888854e8a565ee7e2a8695868506eb(
     value: typing.Optional[jsii.Number],
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__a4b95d92bea1984ce15e37fa304b047ed771a4f764d414ffac328157423828dc(
+    *,
+    description: typing.Optional[builtins.str] = None,
+    export_name: typing.Optional[builtins.str] = None,
+    output_key: typing.Optional[builtins.str] = None,
+    output_value: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__4da59ffe076e92fe1011ac29ca869d93a69d1442f3b7a0d1c765cca951d09b20(
     *,
-    template_url: builtins.str,
     notification_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
     parameters: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    template_url: typing.Optional[builtins.str] = None,
     timeout_in_minutes: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""