aws-cdk-lib 2.136.1__py3-none-any.whl → 2.138.0__py3-none-any.whl

aws_cdk/aws_sns/__init__.py

@@ -323,6 +323,23 @@ topic = sns.Topic(self, "MyTopic",
 ```
 
 **Note**: The `messageRetentionPeriodInDays` property is only available for FIFO topics.
+
+## TracingConfig
+
+Tracing mode of an Amazon SNS topic.
+
+If PassThrough, the topic passes trace headers received from the Amazon SNS publisher to its subscription.
+If set to Active, Amazon SNS will vend X-Ray segment data to topic owner account if the sampled flag in the tracing header is true.
+
+The default TracingConfig is `TracingConfig.PASS_THROUGH`.
+
+Example with a tracingConfig set to Active:
+
+```python
+topic = sns.Topic(self, "MyTopic",
+    tracing_config=sns.TracingConfig.ACTIVE
+)
+```
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -4301,6 +4318,81 @@ class SubscriptionProtocol(enum.Enum):
     '''Notifications put records into a firehose delivery stream.'''
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_sns.TopicAttributes",
+    jsii_struct_bases=[],
+    name_mapping={
+        "topic_arn": "topicArn",
+        "content_based_deduplication": "contentBasedDeduplication",
+    },
+)
+class TopicAttributes:
+    def __init__(
+        self,
+        *,
+        topic_arn: builtins.str,
+        content_based_deduplication: typing.Optional[builtins.bool] = None,
+    ) -> None:
+        '''Represents an SNS topic defined outside of this stack.
+
+        :param topic_arn: The ARN of the SNS topic.
+        :param content_based_deduplication: Whether content-based deduplication is enabled. Only applicable for FIFO topics. Default: false
+
+        :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_sns as sns
+            
+            topic_attributes = sns.TopicAttributes(
+                topic_arn="topicArn",
+            
+                # the properties below are optional
+                content_based_deduplication=False
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__b8362e16cf38fb93899cf1443c05ea87f926cf385d45c4f25eb95067bff9642a)
+            check_type(argname="argument topic_arn", value=topic_arn, expected_type=type_hints["topic_arn"])
+            check_type(argname="argument content_based_deduplication", value=content_based_deduplication, expected_type=type_hints["content_based_deduplication"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "topic_arn": topic_arn,
+        }
+        if content_based_deduplication is not None:
+            self._values["content_based_deduplication"] = content_based_deduplication
+
+    @builtins.property
+    def topic_arn(self) -> builtins.str:
+        '''The ARN of the SNS topic.'''
+        result = self._values.get("topic_arn")
+        assert result is not None, "Required property 'topic_arn' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def content_based_deduplication(self) -> typing.Optional[builtins.bool]:
+        '''Whether content-based deduplication is enabled.
+
+        Only applicable for FIFO topics.
+
+        :default: false
+        '''
+        result = self._values.get("content_based_deduplication")
+        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 "TopicAttributes(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.implements(ITopic)
 class TopicBase(
     _Resource_45bc6135,
@@ -5092,6 +5184,7 @@ class TopicPolicyProps:
         "message_retention_period_in_days": "messageRetentionPeriodInDays",
         "signature_version": "signatureVersion",
         "topic_name": "topicName",
+        "tracing_config": "tracingConfig",
     },
 )
 class TopicProps:
@@ -5107,6 +5200,7 @@ class TopicProps:
         message_retention_period_in_days: typing.Optional[jsii.Number] = None,
         signature_version: typing.Optional[builtins.str] = None,
         topic_name: typing.Optional[builtins.str] = None,
+        tracing_config: typing.Optional["TracingConfig"] = None,
     ) -> None:
         '''Properties for a new SNS topic.
 
@@ -5119,15 +5213,14 @@ class TopicProps:
         :param message_retention_period_in_days: The number of days Amazon SNS retains messages. It can only be set for FIFO topics. Default: - do not archive messages
         :param signature_version: The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS. Default: 1
         :param topic_name: A name for the topic. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the topic name. For more information, see Name Type. Default: Generated name
+        :param tracing_config: Tracing mode of an Amazon SNS topic. Default: TracingConfig.PASS_THROUGH
 
         :exampleMetadata: infused
 
         Example::
 
-            topic = sns.Topic(self, "Topic",
-                content_based_deduplication=True,
-                display_name="Customer subscription topic",
-                fifo=True
+            topic = sns.Topic(self, "MyTopic",
+                tracing_config=sns.TracingConfig.ACTIVE
             )
         '''
         if __debug__:
@@ -5141,6 +5234,7 @@ class TopicProps:
             check_type(argname="argument message_retention_period_in_days", value=message_retention_period_in_days, expected_type=type_hints["message_retention_period_in_days"])
             check_type(argname="argument signature_version", value=signature_version, expected_type=type_hints["signature_version"])
             check_type(argname="argument topic_name", value=topic_name, expected_type=type_hints["topic_name"])
+            check_type(argname="argument tracing_config", value=tracing_config, expected_type=type_hints["tracing_config"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if content_based_deduplication is not None:
             self._values["content_based_deduplication"] = content_based_deduplication
@@ -5160,6 +5254,8 @@ class TopicProps:
             self._values["signature_version"] = signature_version
         if topic_name is not None:
             self._values["topic_name"] = topic_name
+        if tracing_config is not None:
+            self._values["tracing_config"] = tracing_config
 
     @builtins.property
     def content_based_deduplication(self) -> typing.Optional[builtins.bool]:
@@ -5256,6 +5352,17 @@ class TopicProps:
         result = self._values.get("topic_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def tracing_config(self) -> typing.Optional["TracingConfig"]:
+        '''Tracing mode of an Amazon SNS topic.
+
+        :default: TracingConfig.PASS_THROUGH
+
+        :see: https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html
+        '''
+        result = self._values.get("tracing_config")
+        return typing.cast(typing.Optional["TracingConfig"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -5527,6 +5634,25 @@ class TopicSubscriptionConfig(SubscriptionOptions):
         )
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_sns.TracingConfig")
+class TracingConfig(enum.Enum):
+    '''The tracing mode of an Amazon SNS topic.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        topic = sns.Topic(self, "MyTopic",
+            tracing_config=sns.TracingConfig.ACTIVE
+        )
+    '''
+
+    PASS_THROUGH = "PASS_THROUGH"
+    '''The mode that topic passes trace headers received from the Amazon SNS publisher to its subscription.'''
+    ACTIVE = "ACTIVE"
+    '''The mode that Amazon SNS vend X-Ray segment data to topic owner account if the sampled flag in the tracing header is true.'''
+
+
 class Filter(
     FilterOrPolicy,
     metaclass=jsii.JSIIMeta,
@@ -5606,6 +5732,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
         message_retention_period_in_days: typing.Optional[jsii.Number] = None,
         signature_version: typing.Optional[builtins.str] = None,
         topic_name: typing.Optional[builtins.str] = None,
+        tracing_config: typing.Optional[TracingConfig] = None,
     ) -> None:
         '''
         :param scope: -
@@ -5619,6 +5746,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
         :param message_retention_period_in_days: The number of days Amazon SNS retains messages. It can only be set for FIFO topics. Default: - do not archive messages
         :param signature_version: The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS. Default: 1
         :param topic_name: A name for the topic. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the topic name. For more information, see Name Type. Default: Generated name
+        :param tracing_config: Tracing mode of an Amazon SNS topic. Default: TracingConfig.PASS_THROUGH
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__5bf7b7a1001dc600e81a7f1c5015e367dc471dcd727360f62a7eaf6ebf762afd)
@@ -5634,6 +5762,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
             message_retention_period_in_days=message_retention_period_in_days,
             signature_version=signature_version,
             topic_name=topic_name,
+            tracing_config=tracing_config,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -5659,6 +5788,34 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
             check_type(argname="argument topic_arn", value=topic_arn, expected_type=type_hints["topic_arn"])
         return typing.cast(ITopic, jsii.sinvoke(cls, "fromTopicArn", [scope, id, topic_arn]))
 
+    @jsii.member(jsii_name="fromTopicAttributes")
+    @builtins.classmethod
+    def from_topic_attributes(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        topic_arn: builtins.str,
+        content_based_deduplication: typing.Optional[builtins.bool] = None,
+    ) -> ITopic:
+        '''Import an existing SNS topic provided a topic attributes.
+
+        :param scope: The parent creating construct.
+        :param id: The construct's name.
+        :param topic_arn: The ARN of the SNS topic.
+        :param content_based_deduplication: Whether content-based deduplication is enabled. Only applicable for FIFO topics. Default: false
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__3116994a7284b362cb667f2b74c1b4035605be5e3339d6c2782787473f6131f6)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        attrs = TopicAttributes(
+            topic_arn=topic_arn,
+            content_based_deduplication=content_based_deduplication,
+        )
+
+        return typing.cast(ITopic, jsii.sinvoke(cls, "fromTopicAttributes", [scope, id, attrs]))
+
     @jsii.member(jsii_name="addLoggingConfig")
     def add_logging_config(
         self,
@@ -5747,11 +5904,13 @@ __all__ = [
     "SubscriptionProps",
     "SubscriptionProtocol",
     "Topic",
+    "TopicAttributes",
     "TopicBase",
     "TopicPolicy",
     "TopicPolicyProps",
     "TopicProps",
     "TopicSubscriptionConfig",
+    "TracingConfig",
 ]
 
 publication.publish()
@@ -6244,6 +6403,14 @@ def _typecheckingstub__ca027bfed18b17f0f94ff71f11bf24813f4ec24f9b1029e73d8da4ef8
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__b8362e16cf38fb93899cf1443c05ea87f926cf385d45c4f25eb95067bff9642a(
+    *,
+    topic_arn: builtins.str,
+    content_based_deduplication: typing.Optional[builtins.bool] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__e97a3ac4042ed403ad7f37324d239151dacf8c0ddc949fcb2cda9467c86d55c3(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
@@ -6338,6 +6505,7 @@ def _typecheckingstub__093960c1ab5457cc6797eb4a06c9e8fc74e41d4eaa9d0a17f00fa896d
     message_retention_period_in_days: typing.Optional[jsii.Number] = None,
     signature_version: typing.Optional[builtins.str] = None,
     topic_name: typing.Optional[builtins.str] = None,
+    tracing_config: typing.Optional[TracingConfig] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -6378,6 +6546,7 @@ def _typecheckingstub__5bf7b7a1001dc600e81a7f1c5015e367dc471dcd727360f62a7eaf6eb
     message_retention_period_in_days: typing.Optional[jsii.Number] = None,
     signature_version: typing.Optional[builtins.str] = None,
     topic_name: typing.Optional[builtins.str] = None,
+    tracing_config: typing.Optional[TracingConfig] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -6389,3 +6558,13 @@ def _typecheckingstub__957d6ca1d36d79217c9c31f9f5959901c25a458abcbfc9b7eb6aa5b70
 ) -> None:
     """Type checking stubs"""
     pass
+
+def _typecheckingstub__3116994a7284b362cb667f2b74c1b4035605be5e3339d6c2782787473f6131f6(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    topic_arn: builtins.str,
+    content_based_deduplication: typing.Optional[builtins.bool] = None,
+) -> None:
+    """Type checking stubs"""
+    pass

aws_cdk/aws_ssmcontacts/__init__.py

@@ -1652,11 +1652,11 @@ class CfnRotation(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param contact_ids: The Amazon Resource Names (ARNs) of the contacts to add to the rotation. The order in which you list the contacts is their shift order in the rotation schedule.
+        :param contact_ids: The Amazon Resource Names (ARNs) of the contacts to add to the rotation. .. epigraph:: Only the ``PERSONAL`` contact type is supported. The contact types ``ESCALATION`` and ``ONCALL_SCHEDULE`` are not supported for this operation. The order in which you list the contacts is their shift order in the rotation schedule.
         :param name: The name for the rotation.
         :param recurrence: Information about the rule that specifies when shift team members rotate.
         :param start_time: The date and time the rotation goes into effect.
-        :param time_zone_id: The time zone to base the rotation’s activity on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the `Time Zone Database <https://docs.aws.amazon.com/https://www.iana.org/time-zones>`_ on the IANA website.
+        :param time_zone_id: The time zone to base the rotation’s activity on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the `Time Zone Database <https://docs.aws.amazon.com/https://www.iana.org/time-zones>`_ on the IANA website. .. epigraph:: Designators for time zones that don’t support Daylight Savings Time rules, such as Pacific Standard Time (PST), are not supported.
         :param tags: Optional metadata to assign to the rotation. Tags enable you to categorize a resource in different ways, such as by purpose, owner, or environment. For more information, see `Tagging Incident Manager resources <https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html>`_ in the *Incident Manager User Guide* .
         '''
         if __debug__:
@@ -2277,11 +2277,11 @@ class CfnRotationProps:
     ) -> None:
         '''Properties for defining a ``CfnRotation``.
 
-        :param contact_ids: The Amazon Resource Names (ARNs) of the contacts to add to the rotation. The order in which you list the contacts is their shift order in the rotation schedule.
+        :param contact_ids: The Amazon Resource Names (ARNs) of the contacts to add to the rotation. .. epigraph:: Only the ``PERSONAL`` contact type is supported. The contact types ``ESCALATION`` and ``ONCALL_SCHEDULE`` are not supported for this operation. The order in which you list the contacts is their shift order in the rotation schedule.
         :param name: The name for the rotation.
         :param recurrence: Information about the rule that specifies when shift team members rotate.
         :param start_time: The date and time the rotation goes into effect.
-        :param time_zone_id: The time zone to base the rotation’s activity on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the `Time Zone Database <https://docs.aws.amazon.com/https://www.iana.org/time-zones>`_ on the IANA website.
+        :param time_zone_id: The time zone to base the rotation’s activity on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the `Time Zone Database <https://docs.aws.amazon.com/https://www.iana.org/time-zones>`_ on the IANA website. .. epigraph:: Designators for time zones that don’t support Daylight Savings Time rules, such as Pacific Standard Time (PST), are not supported.
         :param tags: Optional metadata to assign to the rotation. Tags enable you to categorize a resource in different ways, such as by purpose, owner, or environment. For more information, see `Tagging Incident Manager resources <https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html>`_ in the *Incident Manager User Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ssmcontacts-rotation.html
@@ -2350,6 +2350,10 @@ class CfnRotationProps:
     def contact_ids(self) -> typing.List[builtins.str]:
         '''The Amazon Resource Names (ARNs) of the contacts to add to the rotation.
 
+        .. epigraph::
+
+           Only the ``PERSONAL`` contact type is supported. The contact types ``ESCALATION`` and ``ONCALL_SCHEDULE`` are not supported for this operation.
+
         The order in which you list the contacts is their shift order in the rotation schedule.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ssmcontacts-rotation.html#cfn-ssmcontacts-rotation-contactids
@@ -2395,6 +2399,9 @@ class CfnRotationProps:
         '''The time zone to base the rotation’s activity on, in Internet Assigned Numbers Authority (IANA) format.
 
         For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the `Time Zone Database <https://docs.aws.amazon.com/https://www.iana.org/time-zones>`_ on the IANA website.
+        .. epigraph::
+
+           Designators for time zones that don’t support Daylight Savings Time rules, such as Pacific Standard Time (PST), are not supported.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ssmcontacts-rotation.html#cfn-ssmcontacts-rotation-timezoneid
         '''

aws_cdk/aws_stepfunctions/__init__.py

@@ -11645,23 +11645,15 @@ class TaskInput(
 
     Example::
 
-        import aws_cdk.aws_bedrock as bedrock
+        # fn: lambda.Function
         
-        
-        model = bedrock.FoundationModel.from_foundation_model_id(self, "Model", bedrock.FoundationModelIdentifier.AMAZON_TITAN_TEXT_G1_EXPRESS_V1)
-        
-        task = tasks.BedrockInvokeModel(self, "Prompt Model",
-            model=model,
-            body=sfn.TaskInput.from_object({
-                "input_text": "Generate a list of five first names.",
-                "text_generation_config": {
-                    "max_token_count": 100,
-                    "temperature": 1
-                }
-            }),
-            result_selector={
-                "names": sfn.JsonPath.string_at("$.Body.results[0].outputText")
-            }
+        tasks.LambdaInvoke(self, "Invoke with callback",
+            lambda_function=fn,
+            integration_pattern=sfn.IntegrationPattern.WAIT_FOR_TASK_TOKEN,
+            payload=sfn.TaskInput.from_object({
+                "token": sfn.JsonPath.task_token,
+                "input": sfn.JsonPath.string_at("$.someField")
+            })
         )
     '''