aws-cdk-lib 2.173.4__py3-none-any.whl → 2.174.0__py3-none-any.whl

aws_cdk/aws_ram/__init__.py

@@ -452,7 +452,7 @@ class CfnResourceShare(
         :param permission_arns: Specifies the `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html>`_ of the AWS RAM permission to associate with the resource share. If you do not specify an ARN for the permission, AWS RAM automatically attaches the default version of the permission for each resource type. You can associate only one permission with each resource type included in the resource share.
         :param principals: Specifies the principals to associate with the resource share. The possible values are:. - An AWS account ID - An Amazon Resource Name (ARN) of an organization in AWS Organizations - An ARN of an organizational unit (OU) in AWS Organizations - An ARN of an IAM role - An ARN of an IAM user .. epigraph:: Not all resource types can be shared with IAM roles and users. For more information, see the column *Can share with IAM roles and users* in the tables on `Shareable AWS resources <https://docs.aws.amazon.com/ram/latest/userguide/shareable.html>`_ in the *AWS Resource Access Manager User Guide* .
         :param resource_arns: Specifies a list of one or more ARNs of the resources to associate with the resource share.
-        :param sources: 
+        :param sources: Specifies from which source accounts the service principal has access to the resources in this resource share.
         :param tags: Specifies one or more tags to attach to the resource share itself. It doesn't attach the tags to the resources associated with the resource share.
         '''
         if __debug__:
@@ -510,14 +510,6 @@ class CfnResourceShare(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
 
-    @builtins.property
-    @jsii.member(jsii_name="attrId")
-    def attr_id(self) -> builtins.str:
-        '''
-        :cloudformationAttribute: Id
-        '''
-        return typing.cast(builtins.str, jsii.get(self, "attrId"))
-
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -608,6 +600,7 @@ class CfnResourceShare(
     @builtins.property
     @jsii.member(jsii_name="sources")
     def sources(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''Specifies from which source accounts the service principal has access to the resources in this resource share.'''
         return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "sources"))
 
     @sources.setter
@@ -663,7 +656,7 @@ class CfnResourceShareProps:
         :param permission_arns: Specifies the `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html>`_ of the AWS RAM permission to associate with the resource share. If you do not specify an ARN for the permission, AWS RAM automatically attaches the default version of the permission for each resource type. You can associate only one permission with each resource type included in the resource share.
         :param principals: Specifies the principals to associate with the resource share. The possible values are:. - An AWS account ID - An Amazon Resource Name (ARN) of an organization in AWS Organizations - An ARN of an organizational unit (OU) in AWS Organizations - An ARN of an IAM role - An ARN of an IAM user .. epigraph:: Not all resource types can be shared with IAM roles and users. For more information, see the column *Can share with IAM roles and users* in the tables on `Shareable AWS resources <https://docs.aws.amazon.com/ram/latest/userguide/shareable.html>`_ in the *AWS Resource Access Manager User Guide* .
         :param resource_arns: Specifies a list of one or more ARNs of the resources to associate with the resource share.
-        :param sources: 
+        :param sources: Specifies from which source accounts the service principal has access to the resources in this resource share.
         :param tags: Specifies one or more tags to attach to the resource share itself. It doesn't attach the tags to the resources associated with the resource share.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ram-resourceshare.html
@@ -777,7 +770,8 @@ class CfnResourceShareProps:
 
     @builtins.property
     def sources(self) -> typing.Optional[typing.List[builtins.str]]:
-        '''
+        '''Specifies from which source accounts the service principal has access to the resources in this resource share.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ram-resourceshare.html#cfn-ram-resourceshare-sources
         '''
         result = self._values.get("sources")

aws_cdk/aws_rbin/__init__.py

@@ -148,14 +148,14 @@ class CfnRule(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param resource_type: The resource type retained by the retention rule.
+        :param resource_type: The resource type to be retained by the retention rule. Currently, only Amazon EBS snapshots and EBS-backed AMIs are supported. To retain snapshots, specify ``EBS_SNAPSHOT`` . To retain EBS-backed AMIs, specify ``EC2_IMAGE`` .
         :param retention_period: Information about the retention period for which the retention rule is to retain resources.
         :param description: The retention rule description.
-        :param exclude_resource_tags: Information about the exclude resource tags used to identify resources that are excluded by the retention rule.
+        :param exclude_resource_tags: [Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule. Resources that have any of these tags are not retained by the retention rule upon deletion. You can't specify exclusion tags for tag-level retention rules.
         :param lock_configuration: Information about the retention rule lock configuration.
-        :param resource_tags: [Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.
+        :param resource_tags: [Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule. You can add the same tag key and value pair to a maximum or five retention rules. To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.
         :param status: The state of the retention rule. Only retention rules that are in the ``available`` state retain resources.
-        :param tags: Information about the tags assigned to the retention rule.
+        :param tags: Information about the tags to assign to the retention rule.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__38111a34066818ca2f172524180ec7dec02ce564c681ac0c87097b02350ebe17)
@@ -250,7 +250,7 @@ class CfnRule(
     @builtins.property
     @jsii.member(jsii_name="resourceType")
     def resource_type(self) -> builtins.str:
-        '''The resource type retained by the retention rule.'''
+        '''The resource type to be retained by the retention rule.'''
         return typing.cast(builtins.str, jsii.get(self, "resourceType"))
 
     @resource_type.setter
@@ -296,7 +296,7 @@ class CfnRule(
     def exclude_resource_tags(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnRule.ResourceTagProperty"]]]]:
-        '''Information about the exclude resource tags used to identify resources that are excluded by the retention rule.'''
+        '''[Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnRule.ResourceTagProperty"]]]], jsii.get(self, "excludeResourceTags"))
 
     @exclude_resource_tags.setter
@@ -332,7 +332,7 @@ class CfnRule(
     def resource_tags(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnRule.ResourceTagProperty"]]]]:
-        '''[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.'''
+        '''[Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnRule.ResourceTagProperty"]]]], jsii.get(self, "resourceTags"))
 
     @resource_tags.setter
@@ -361,7 +361,7 @@ class CfnRule(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''Information about the tags assigned to the retention rule.'''
+        '''Information about the tags to assign to the retention rule.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -630,14 +630,14 @@ class CfnRuleProps:
     ) -> None:
         '''Properties for defining a ``CfnRule``.
 
-        :param resource_type: The resource type retained by the retention rule.
+        :param resource_type: The resource type to be retained by the retention rule. Currently, only Amazon EBS snapshots and EBS-backed AMIs are supported. To retain snapshots, specify ``EBS_SNAPSHOT`` . To retain EBS-backed AMIs, specify ``EC2_IMAGE`` .
         :param retention_period: Information about the retention period for which the retention rule is to retain resources.
         :param description: The retention rule description.
-        :param exclude_resource_tags: Information about the exclude resource tags used to identify resources that are excluded by the retention rule.
+        :param exclude_resource_tags: [Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule. Resources that have any of these tags are not retained by the retention rule upon deletion. You can't specify exclusion tags for tag-level retention rules.
         :param lock_configuration: Information about the retention rule lock configuration.
-        :param resource_tags: [Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.
+        :param resource_tags: [Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule. You can add the same tag key and value pair to a maximum or five retention rules. To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.
         :param status: The state of the retention rule. Only retention rules that are in the ``available`` state retain resources.
-        :param tags: Information about the tags assigned to the retention rule.
+        :param tags: Information about the tags to assign to the retention rule.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rbin-rule.html
         :exampleMetadata: fixture=_generated
@@ -705,7 +705,9 @@ class CfnRuleProps:
 
     @builtins.property
     def resource_type(self) -> builtins.str:
-        '''The resource type retained by the retention rule.
+        '''The resource type to be retained by the retention rule.
+
+        Currently, only Amazon EBS snapshots and EBS-backed AMIs are supported. To retain snapshots, specify ``EBS_SNAPSHOT`` . To retain EBS-backed AMIs, specify ``EC2_IMAGE`` .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rbin-rule.html#cfn-rbin-rule-resourcetype
         '''
@@ -738,7 +740,11 @@ class CfnRuleProps:
     def exclude_resource_tags(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnRule.ResourceTagProperty]]]]:
-        '''Information about the exclude resource tags used to identify resources that are excluded by the retention rule.
+        '''[Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule.
+
+        Resources that have any of these tags are not retained by the retention rule upon deletion.
+
+        You can't specify exclusion tags for tag-level retention rules.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rbin-rule.html#cfn-rbin-rule-excluderesourcetags
         '''
@@ -760,7 +766,13 @@ class CfnRuleProps:
     def resource_tags(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnRule.ResourceTagProperty]]]]:
-        '''[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.
+        '''[Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule.
+
+        For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule.
+
+        You can add the same tag key and value pair to a maximum or five retention rules.
+
+        To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rbin-rule.html#cfn-rbin-rule-resourcetags
         '''
@@ -780,7 +792,7 @@ class CfnRuleProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''Information about the tags assigned to the retention rule.
+        '''Information about the tags to assign to the retention rule.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rbin-rule.html#cfn-rbin-rule-tags
         '''