aws-cdk-lib 2.137.0__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__)
@@ -5167,6 +5184,7 @@ class TopicPolicyProps:
         "message_retention_period_in_days": "messageRetentionPeriodInDays",
         "signature_version": "signatureVersion",
         "topic_name": "topicName",
+        "tracing_config": "tracingConfig",
     },
 )
 class TopicProps:
@@ -5182,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.
 
@@ -5194,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__:
@@ -5216,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
@@ -5235,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]:
@@ -5331,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
 
@@ -5602,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,
@@ -5681,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: -
@@ -5694,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)
@@ -5709,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])
@@ -5856,6 +5910,7 @@ __all__ = [
     "TopicPolicyProps",
     "TopicProps",
     "TopicSubscriptionConfig",
+    "TracingConfig",
 ]
 
 publication.publish()
@@ -6450,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
@@ -6490,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

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")
+            })
         )
     '''