aws-cdk-lib 2.146.0__py3-none-any.whl → 2.147.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (67) hide show
  1. aws_cdk/__init__.py +10 -11
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.146.0.jsii.tgz → aws-cdk-lib@2.147.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_apigateway/__init__.py +32 -12
  5. aws_cdk/aws_apigatewayv2/__init__.py +48 -2
  6. aws_cdk/aws_apigatewayv2_integrations/__init__.py +142 -4
  7. aws_cdk/aws_appconfig/__init__.py +8 -4
  8. aws_cdk/aws_applicationsignals/__init__.py +1766 -0
  9. aws_cdk/aws_auditmanager/__init__.py +5 -1
  10. aws_cdk/aws_autoscaling/__init__.py +65 -20
  11. aws_cdk/aws_batch/__init__.py +215 -0
  12. aws_cdk/aws_bedrock/__init__.py +272 -103
  13. aws_cdk/aws_cloudformation/__init__.py +5 -11
  14. aws_cdk/aws_cloudfront/__init__.py +10 -3
  15. aws_cdk/aws_cloudtrail/__init__.py +56 -2
  16. aws_cdk/aws_codebuild/__init__.py +62 -29
  17. aws_cdk/aws_codepipeline/__init__.py +10 -5
  18. aws_cdk/aws_datazone/__init__.py +80 -68
  19. aws_cdk/aws_deadline/__init__.py +603 -17
  20. aws_cdk/aws_ec2/__init__.py +237 -112
  21. aws_cdk/aws_ecs/__init__.py +20 -18
  22. aws_cdk/aws_eks/__init__.py +15 -9
  23. aws_cdk/aws_elasticloadbalancingv2/__init__.py +11 -5
  24. aws_cdk/aws_emrserverless/__init__.py +5 -5
  25. aws_cdk/aws_events/__init__.py +36 -16
  26. aws_cdk/aws_fsx/__init__.py +126 -21
  27. aws_cdk/aws_globalaccelerator/__init__.py +2 -1
  28. aws_cdk/aws_globalaccelerator_endpoints/__init__.py +35 -4
  29. aws_cdk/aws_glue/__init__.py +26 -0
  30. aws_cdk/aws_grafana/__init__.py +4 -4
  31. aws_cdk/aws_groundstation/__init__.py +55 -35
  32. aws_cdk/aws_guardduty/__init__.py +826 -0
  33. aws_cdk/aws_iot/__init__.py +3 -3
  34. aws_cdk/aws_lambda/__init__.py +7 -5
  35. aws_cdk/aws_lightsail/__init__.py +1 -1
  36. aws_cdk/aws_location/__init__.py +10 -11
  37. aws_cdk/aws_mediapackagev2/__init__.py +38 -20
  38. aws_cdk/aws_mediatailor/__init__.py +2 -2
  39. aws_cdk/aws_msk/__init__.py +4 -4
  40. aws_cdk/aws_mwaa/__init__.py +16 -8
  41. aws_cdk/aws_nimblestudio/__init__.py +9 -9
  42. aws_cdk/aws_opensearchservice/__init__.py +5 -4
  43. aws_cdk/aws_opsworks/__init__.py +3 -3
  44. aws_cdk/aws_osis/__init__.py +33 -4
  45. aws_cdk/aws_pipes/__init__.py +97 -45
  46. aws_cdk/aws_quicksight/__init__.py +23 -21
  47. aws_cdk/aws_rds/__init__.py +43 -11
  48. aws_cdk/aws_refactorspaces/__init__.py +3 -3
  49. aws_cdk/aws_rolesanywhere/__init__.py +21 -14
  50. aws_cdk/aws_sagemaker/__init__.py +5 -2
  51. aws_cdk/aws_securityhub/__init__.py +163 -78
  52. aws_cdk/aws_securitylake/__init__.py +7 -5
  53. aws_cdk/aws_ses/__init__.py +117 -0
  54. aws_cdk/aws_simspaceweaver/__init__.py +2 -2
  55. aws_cdk/aws_sns/__init__.py +6 -4
  56. aws_cdk/aws_sqs/__init__.py +3 -3
  57. aws_cdk/aws_stepfunctions/__init__.py +51 -28
  58. aws_cdk/aws_stepfunctions_tasks/__init__.py +56 -2
  59. aws_cdk/aws_transfer/__init__.py +8 -2
  60. aws_cdk/aws_wafv2/__init__.py +10 -10
  61. aws_cdk/aws_workspacesweb/__init__.py +8 -8
  62. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/METADATA +1 -1
  63. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/RECORD +67 -66
  64. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/LICENSE +0 -0
  65. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/NOTICE +0 -0
  66. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/WHEEL +0 -0
  67. {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.0.dist-info}/top_level.txt +0 -0
@@ -109,7 +109,8 @@ class CfnPipeline(
109
109
  subnet_ids=["subnetIds"],
110
110
 
111
111
  # the properties below are optional
112
- security_group_ids=["securityGroupIds"]
112
+ security_group_ids=["securityGroupIds"],
113
+ vpc_endpoint_management="vpcEndpointManagement"
113
114
  )
114
115
  )
115
116
  '''
@@ -219,6 +220,15 @@ class CfnPipeline(
219
220
  '''
220
221
  return typing.cast(_IResolvable_da3f097b, jsii.get(self, "attrVpcEndpoints"))
221
222
 
223
+ @builtins.property
224
+ @jsii.member(jsii_name="attrVpcEndpointService")
225
+ def attr_vpc_endpoint_service(self) -> builtins.str:
226
+ '''The VPC endpoint service name for the pipeline.
227
+
228
+ :cloudformationAttribute: VpcEndpointService
229
+ '''
230
+ return typing.cast(builtins.str, jsii.get(self, "attrVpcEndpointService"))
231
+
222
232
  @builtins.property
223
233
  @jsii.member(jsii_name="cfnProperties")
224
234
  def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -657,7 +667,8 @@ class CfnPipeline(
657
667
  subnet_ids=["subnetIds"],
658
668
 
659
669
  # the properties below are optional
660
- security_group_ids=["securityGroupIds"]
670
+ security_group_ids=["securityGroupIds"],
671
+ vpc_endpoint_management="vpcEndpointManagement"
661
672
  )
662
673
  )
663
674
  '''
@@ -722,6 +733,7 @@ class CfnPipeline(
722
733
  name_mapping={
723
734
  "subnet_ids": "subnetIds",
724
735
  "security_group_ids": "securityGroupIds",
736
+ "vpc_endpoint_management": "vpcEndpointManagement",
725
737
  },
726
738
  )
727
739
  class VpcOptionsProperty:
@@ -730,11 +742,13 @@ class CfnPipeline(
730
742
  *,
731
743
  subnet_ids: typing.Sequence[builtins.str],
732
744
  security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
745
+ vpc_endpoint_management: typing.Optional[builtins.str] = None,
733
746
  ) -> None:
734
747
  '''Options that specify the subnets and security groups for an OpenSearch Ingestion VPC endpoint.
735
748
 
736
749
  :param subnet_ids: A list of subnet IDs associated with the VPC endpoint.
737
750
  :param security_group_ids: A list of security groups associated with the VPC endpoint.
751
+ :param vpc_endpoint_management: Defines whether you or Amazon OpenSearch Ingestion service create and manage the VPC endpoint configured for the pipeline.
738
752
 
739
753
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-osis-pipeline-vpcoptions.html
740
754
  :exampleMetadata: fixture=_generated
@@ -749,18 +763,22 @@ class CfnPipeline(
749
763
  subnet_ids=["subnetIds"],
750
764
 
751
765
  # the properties below are optional
752
- security_group_ids=["securityGroupIds"]
766
+ security_group_ids=["securityGroupIds"],
767
+ vpc_endpoint_management="vpcEndpointManagement"
753
768
  )
754
769
  '''
755
770
  if __debug__:
756
771
  type_hints = typing.get_type_hints(_typecheckingstub__d6c7fc6663c9baefdd81f02e0e69deb4e81a8e210a00a4346752ffa95aa926ac)
757
772
  check_type(argname="argument subnet_ids", value=subnet_ids, expected_type=type_hints["subnet_ids"])
758
773
  check_type(argname="argument security_group_ids", value=security_group_ids, expected_type=type_hints["security_group_ids"])
774
+ check_type(argname="argument vpc_endpoint_management", value=vpc_endpoint_management, expected_type=type_hints["vpc_endpoint_management"])
759
775
  self._values: typing.Dict[builtins.str, typing.Any] = {
760
776
  "subnet_ids": subnet_ids,
761
777
  }
762
778
  if security_group_ids is not None:
763
779
  self._values["security_group_ids"] = security_group_ids
780
+ if vpc_endpoint_management is not None:
781
+ self._values["vpc_endpoint_management"] = vpc_endpoint_management
764
782
 
765
783
  @builtins.property
766
784
  def subnet_ids(self) -> typing.List[builtins.str]:
@@ -781,6 +799,15 @@ class CfnPipeline(
781
799
  result = self._values.get("security_group_ids")
782
800
  return typing.cast(typing.Optional[typing.List[builtins.str]], result)
783
801
 
802
+ @builtins.property
803
+ def vpc_endpoint_management(self) -> typing.Optional[builtins.str]:
804
+ '''Defines whether you or Amazon OpenSearch Ingestion service create and manage the VPC endpoint configured for the pipeline.
805
+
806
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-osis-pipeline-vpcoptions.html#cfn-osis-pipeline-vpcoptions-vpcendpointmanagement
807
+ '''
808
+ result = self._values.get("vpc_endpoint_management")
809
+ return typing.cast(typing.Optional[builtins.str], result)
810
+
784
811
  def __eq__(self, rhs: typing.Any) -> builtins.bool:
785
812
  return isinstance(rhs, self.__class__) and rhs._values == self._values
786
813
 
@@ -870,7 +897,8 @@ class CfnPipelineProps:
870
897
  subnet_ids=["subnetIds"],
871
898
 
872
899
  # the properties below are optional
873
- security_group_ids=["securityGroupIds"]
900
+ security_group_ids=["securityGroupIds"],
901
+ vpc_endpoint_management="vpcEndpointManagement"
874
902
  )
875
903
  )
876
904
  '''
@@ -1141,6 +1169,7 @@ def _typecheckingstub__d6c7fc6663c9baefdd81f02e0e69deb4e81a8e210a00a4346752ffa95
1141
1169
  *,
1142
1170
  subnet_ids: typing.Sequence[builtins.str],
1143
1171
  security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
1172
+ vpc_endpoint_management: typing.Optional[builtins.str] = None,
1144
1173
  ) -> None:
1145
1174
  """Type checking stubs"""
1146
1175
  pass
@@ -1556,10 +1556,13 @@ class CfnPipe(
1556
1556
  dimension_value: builtins.str,
1557
1557
  dimension_value_type: builtins.str,
1558
1558
  ) -> None:
1559
- '''
1560
- :param dimension_name:
1561
- :param dimension_value:
1562
- :param dimension_value_type:
1559
+ '''Maps source data to a dimension in the target Timestream for LiveAnalytics table.
1560
+
1561
+ For more information, see `Amazon Timestream for LiveAnalytics concepts <https://docs.aws.amazon.com/timestream/latest/developerguide/concepts.html>`_
1562
+
1563
+ :param dimension_name: The metadata attributes of the time series. For example, the name and Availability Zone of an Amazon EC2 instance or the name of the manufacturer of a wind turbine are dimensions.
1564
+ :param dimension_value: Dynamic path to the dimension value in the source event.
1565
+ :param dimension_value_type: The data type of the dimension for the time-series data.
1563
1566
 
1564
1567
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-dimensionmapping.html
1565
1568
  :exampleMetadata: fixture=_generated
@@ -1589,7 +1592,10 @@ class CfnPipe(
1589
1592
 
1590
1593
  @builtins.property
1591
1594
  def dimension_name(self) -> builtins.str:
1592
- '''
1595
+ '''The metadata attributes of the time series.
1596
+
1597
+ For example, the name and Availability Zone of an Amazon EC2 instance or the name of the manufacturer of a wind turbine are dimensions.
1598
+
1593
1599
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-dimensionmapping.html#cfn-pipes-pipe-dimensionmapping-dimensionname
1594
1600
  '''
1595
1601
  result = self._values.get("dimension_name")
@@ -1598,7 +1604,8 @@ class CfnPipe(
1598
1604
 
1599
1605
  @builtins.property
1600
1606
  def dimension_value(self) -> builtins.str:
1601
- '''
1607
+ '''Dynamic path to the dimension value in the source event.
1608
+
1602
1609
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-dimensionmapping.html#cfn-pipes-pipe-dimensionmapping-dimensionvalue
1603
1610
  '''
1604
1611
  result = self._values.get("dimension_value")
@@ -1607,7 +1614,8 @@ class CfnPipe(
1607
1614
 
1608
1615
  @builtins.property
1609
1616
  def dimension_value_type(self) -> builtins.str:
1610
- '''
1617
+ '''The data type of the dimension for the time-series data.
1618
+
1611
1619
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-dimensionmapping.html#cfn-pipes-pipe-dimensionmapping-dimensionvaluetype
1612
1620
  '''
1613
1621
  result = self._values.get("dimension_value_type")
@@ -2693,10 +2701,11 @@ class CfnPipe(
2693
2701
  measure_value_type: builtins.str,
2694
2702
  multi_measure_attribute_name: builtins.str,
2695
2703
  ) -> None:
2696
- '''
2697
- :param measure_value:
2698
- :param measure_value_type:
2699
- :param multi_measure_attribute_name:
2704
+ '''A mapping of a source event data field to a measure in a Timestream for LiveAnalytics record.
2705
+
2706
+ :param measure_value: Dynamic path to the measurement attribute in the source event.
2707
+ :param measure_value_type: Data type of the measurement attribute in the source event.
2708
+ :param multi_measure_attribute_name: Target measure name to be used.
2700
2709
 
2701
2710
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasureattributemapping.html
2702
2711
  :exampleMetadata: fixture=_generated
@@ -2726,7 +2735,8 @@ class CfnPipe(
2726
2735
 
2727
2736
  @builtins.property
2728
2737
  def measure_value(self) -> builtins.str:
2729
- '''
2738
+ '''Dynamic path to the measurement attribute in the source event.
2739
+
2730
2740
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasureattributemapping.html#cfn-pipes-pipe-multimeasureattributemapping-measurevalue
2731
2741
  '''
2732
2742
  result = self._values.get("measure_value")
@@ -2735,7 +2745,8 @@ class CfnPipe(
2735
2745
 
2736
2746
  @builtins.property
2737
2747
  def measure_value_type(self) -> builtins.str:
2738
- '''
2748
+ '''Data type of the measurement attribute in the source event.
2749
+
2739
2750
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasureattributemapping.html#cfn-pipes-pipe-multimeasureattributemapping-measurevaluetype
2740
2751
  '''
2741
2752
  result = self._values.get("measure_value_type")
@@ -2744,7 +2755,8 @@ class CfnPipe(
2744
2755
 
2745
2756
  @builtins.property
2746
2757
  def multi_measure_attribute_name(self) -> builtins.str:
2747
- '''
2758
+ '''Target measure name to be used.
2759
+
2748
2760
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasureattributemapping.html#cfn-pipes-pipe-multimeasureattributemapping-multimeasureattributename
2749
2761
  '''
2750
2762
  result = self._values.get("multi_measure_attribute_name")
@@ -2777,9 +2789,12 @@ class CfnPipe(
2777
2789
  multi_measure_attribute_mappings: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnPipe.MultiMeasureAttributeMappingProperty", typing.Dict[builtins.str, typing.Any]]]]],
2778
2790
  multi_measure_name: builtins.str,
2779
2791
  ) -> None:
2780
- '''
2781
- :param multi_measure_attribute_mappings:
2782
- :param multi_measure_name:
2792
+ '''Maps multiple measures from the source event to the same Timestream for LiveAnalytics record.
2793
+
2794
+ For more information, see `Amazon Timestream for LiveAnalytics concepts <https://docs.aws.amazon.com/timestream/latest/developerguide/concepts.html>`_
2795
+
2796
+ :param multi_measure_attribute_mappings: Mappings that represent multiple source event fields mapped to measures in the same Timestream for LiveAnalytics record.
2797
+ :param multi_measure_name: The name of the multiple measurements per record (multi-measure).
2783
2798
 
2784
2799
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasuremapping.html
2785
2800
  :exampleMetadata: fixture=_generated
@@ -2812,7 +2827,8 @@ class CfnPipe(
2812
2827
  def multi_measure_attribute_mappings(
2813
2828
  self,
2814
2829
  ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPipe.MultiMeasureAttributeMappingProperty"]]]:
2815
- '''
2830
+ '''Mappings that represent multiple source event fields mapped to measures in the same Timestream for LiveAnalytics record.
2831
+
2816
2832
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasuremapping.html#cfn-pipes-pipe-multimeasuremapping-multimeasureattributemappings
2817
2833
  '''
2818
2834
  result = self._values.get("multi_measure_attribute_mappings")
@@ -2821,7 +2837,8 @@ class CfnPipe(
2821
2837
 
2822
2838
  @builtins.property
2823
2839
  def multi_measure_name(self) -> builtins.str:
2824
- '''
2840
+ '''The name of the multiple measurements per record (multi-measure).
2841
+
2825
2842
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-multimeasuremapping.html#cfn-pipes-pipe-multimeasuremapping-multimeasurename
2826
2843
  '''
2827
2844
  result = self._values.get("multi_measure_name")
@@ -5601,7 +5618,7 @@ class CfnPipe(
5601
5618
  :param sage_maker_pipeline_parameters: The parameters for using a SageMaker pipeline as a target.
5602
5619
  :param sqs_queue_parameters: The parameters for using a Amazon SQS stream as a target.
5603
5620
  :param step_function_state_machine_parameters: The parameters for using a Step Functions state machine as a target.
5604
- :param timestream_parameters:
5621
+ :param timestream_parameters: The parameters for using a Timestream for LiveAnalytics table as a target.
5605
5622
 
5606
5623
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargetparameters.html
5607
5624
  :exampleMetadata: infused
@@ -5803,7 +5820,8 @@ class CfnPipe(
5803
5820
  def timestream_parameters(
5804
5821
  self,
5805
5822
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPipe.PipeTargetTimestreamParametersProperty"]]:
5806
- '''
5823
+ '''The parameters for using a Timestream for LiveAnalytics table as a target.
5824
+
5807
5825
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargetparameters.html#cfn-pipes-pipe-pipetargetparameters-timestreamparameters
5808
5826
  '''
5809
5827
  result = self._values.get("timestream_parameters")
@@ -6199,15 +6217,16 @@ class CfnPipe(
6199
6217
  time_field_type: typing.Optional[builtins.str] = None,
6200
6218
  timestamp_format: typing.Optional[builtins.str] = None,
6201
6219
  ) -> None:
6202
- '''
6203
- :param dimension_mappings:
6204
- :param time_value:
6205
- :param version_value:
6206
- :param epoch_time_unit:
6207
- :param multi_measure_mappings:
6208
- :param single_measure_mappings:
6209
- :param time_field_type:
6210
- :param timestamp_format:
6220
+ '''The parameters for using a Timestream for LiveAnalytics table as a target.
6221
+
6222
+ :param dimension_mappings: Map source data to dimensions in the target Timestream for LiveAnalytics table. For more information, see `Amazon Timestream for LiveAnalytics concepts <https://docs.aws.amazon.com/timestream/latest/developerguide/concepts.html>`_
6223
+ :param time_value: Dynamic path to the source data field that represents the time value for your data.
6224
+ :param version_value: 64 bit version value or source data field that represents the version value for your data. Write requests with a higher version number will update the existing measure values of the record and version. In cases where the measure value is the same, the version will still be updated. Default value is 1. Timestream for LiveAnalytics does not support updating partial measure values in a record. Write requests for duplicate data with a higher version number will update the existing measure value and version. In cases where the measure value is the same, ``Version`` will still be updated. Default value is ``1`` . .. epigraph:: ``Version`` must be ``1`` or greater, or you will receive a ``ValidationException`` error.
6225
+ :param epoch_time_unit: The granularity of the time units used. Default is ``MILLISECONDS`` . Required if ``TimeFieldType`` is specified as ``EPOCH`` .
6226
+ :param multi_measure_mappings: Maps multiple measures from the source event to the same record in the specified Timestream for LiveAnalytics table.
6227
+ :param single_measure_mappings: Mappings of single source data fields to individual records in the specified Timestream for LiveAnalytics table.
6228
+ :param time_field_type: The type of time value used. The default is ``EPOCH`` .
6229
+ :param timestamp_format: How to format the timestamps. For example, ``YYYY-MM-DDThh:mm:ss.sssTZD`` . Required if ``TimeFieldType`` is specified as ``TIMESTAMP_FORMAT`` .
6211
6230
 
6212
6231
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html
6213
6232
  :exampleMetadata: fixture=_generated
@@ -6276,7 +6295,10 @@ class CfnPipe(
6276
6295
  def dimension_mappings(
6277
6296
  self,
6278
6297
  ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPipe.DimensionMappingProperty"]]]:
6279
- '''
6298
+ '''Map source data to dimensions in the target Timestream for LiveAnalytics table.
6299
+
6300
+ For more information, see `Amazon Timestream for LiveAnalytics concepts <https://docs.aws.amazon.com/timestream/latest/developerguide/concepts.html>`_
6301
+
6280
6302
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-dimensionmappings
6281
6303
  '''
6282
6304
  result = self._values.get("dimension_mappings")
@@ -6285,7 +6307,8 @@ class CfnPipe(
6285
6307
 
6286
6308
  @builtins.property
6287
6309
  def time_value(self) -> builtins.str:
6288
- '''
6310
+ '''Dynamic path to the source data field that represents the time value for your data.
6311
+
6289
6312
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-timevalue
6290
6313
  '''
6291
6314
  result = self._values.get("time_value")
@@ -6294,7 +6317,19 @@ class CfnPipe(
6294
6317
 
6295
6318
  @builtins.property
6296
6319
  def version_value(self) -> builtins.str:
6297
- '''
6320
+ '''64 bit version value or source data field that represents the version value for your data.
6321
+
6322
+ Write requests with a higher version number will update the existing measure values of the record and version. In cases where the measure value is the same, the version will still be updated.
6323
+
6324
+ Default value is 1.
6325
+
6326
+ Timestream for LiveAnalytics does not support updating partial measure values in a record.
6327
+
6328
+ Write requests for duplicate data with a higher version number will update the existing measure value and version. In cases where the measure value is the same, ``Version`` will still be updated. Default value is ``1`` .
6329
+ .. epigraph::
6330
+
6331
+ ``Version`` must be ``1`` or greater, or you will receive a ``ValidationException`` error.
6332
+
6298
6333
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-versionvalue
6299
6334
  '''
6300
6335
  result = self._values.get("version_value")
@@ -6303,7 +6338,10 @@ class CfnPipe(
6303
6338
 
6304
6339
  @builtins.property
6305
6340
  def epoch_time_unit(self) -> typing.Optional[builtins.str]:
6306
- '''
6341
+ '''The granularity of the time units used. Default is ``MILLISECONDS`` .
6342
+
6343
+ Required if ``TimeFieldType`` is specified as ``EPOCH`` .
6344
+
6307
6345
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-epochtimeunit
6308
6346
  '''
6309
6347
  result = self._values.get("epoch_time_unit")
@@ -6313,7 +6351,8 @@ class CfnPipe(
6313
6351
  def multi_measure_mappings(
6314
6352
  self,
6315
6353
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPipe.MultiMeasureMappingProperty"]]]]:
6316
- '''
6354
+ '''Maps multiple measures from the source event to the same record in the specified Timestream for LiveAnalytics table.
6355
+
6317
6356
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-multimeasuremappings
6318
6357
  '''
6319
6358
  result = self._values.get("multi_measure_mappings")
@@ -6323,7 +6362,8 @@ class CfnPipe(
6323
6362
  def single_measure_mappings(
6324
6363
  self,
6325
6364
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnPipe.SingleMeasureMappingProperty"]]]]:
6326
- '''
6365
+ '''Mappings of single source data fields to individual records in the specified Timestream for LiveAnalytics table.
6366
+
6327
6367
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-singlemeasuremappings
6328
6368
  '''
6329
6369
  result = self._values.get("single_measure_mappings")
@@ -6331,7 +6371,10 @@ class CfnPipe(
6331
6371
 
6332
6372
  @builtins.property
6333
6373
  def time_field_type(self) -> typing.Optional[builtins.str]:
6334
- '''
6374
+ '''The type of time value used.
6375
+
6376
+ The default is ``EPOCH`` .
6377
+
6335
6378
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-timefieldtype
6336
6379
  '''
6337
6380
  result = self._values.get("time_field_type")
@@ -6339,7 +6382,10 @@ class CfnPipe(
6339
6382
 
6340
6383
  @builtins.property
6341
6384
  def timestamp_format(self) -> typing.Optional[builtins.str]:
6342
- '''
6385
+ '''How to format the timestamps. For example, ``YYYY-MM-DDThh:mm:ss.sssTZD`` .
6386
+
6387
+ Required if ``TimeFieldType`` is specified as ``TIMESTAMP_FORMAT`` .
6388
+
6343
6389
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-pipetargettimestreamparameters.html#cfn-pipes-pipe-pipetargettimestreamparameters-timestampformat
6344
6390
  '''
6345
6391
  result = self._values.get("timestamp_format")
@@ -6881,10 +6927,13 @@ class CfnPipe(
6881
6927
  measure_value: builtins.str,
6882
6928
  measure_value_type: builtins.str,
6883
6929
  ) -> None:
6884
- '''
6885
- :param measure_name:
6886
- :param measure_value:
6887
- :param measure_value_type:
6930
+ '''Maps a single source data field to a single record in the specified Timestream for LiveAnalytics table.
6931
+
6932
+ For more information, see `Amazon Timestream for LiveAnalytics concepts <https://docs.aws.amazon.com/timestream/latest/developerguide/concepts.html>`_
6933
+
6934
+ :param measure_name: Target measure name for the measurement attribute in the Timestream table.
6935
+ :param measure_value: Dynamic path of the source field to map to the measure in the record.
6936
+ :param measure_value_type: Data type of the source field.
6888
6937
 
6889
6938
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-singlemeasuremapping.html
6890
6939
  :exampleMetadata: fixture=_generated
@@ -6914,7 +6963,8 @@ class CfnPipe(
6914
6963
 
6915
6964
  @builtins.property
6916
6965
  def measure_name(self) -> builtins.str:
6917
- '''
6966
+ '''Target measure name for the measurement attribute in the Timestream table.
6967
+
6918
6968
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-singlemeasuremapping.html#cfn-pipes-pipe-singlemeasuremapping-measurename
6919
6969
  '''
6920
6970
  result = self._values.get("measure_name")
@@ -6923,7 +6973,8 @@ class CfnPipe(
6923
6973
 
6924
6974
  @builtins.property
6925
6975
  def measure_value(self) -> builtins.str:
6926
- '''
6976
+ '''Dynamic path of the source field to map to the measure in the record.
6977
+
6927
6978
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-singlemeasuremapping.html#cfn-pipes-pipe-singlemeasuremapping-measurevalue
6928
6979
  '''
6929
6980
  result = self._values.get("measure_value")
@@ -6932,7 +6983,8 @@ class CfnPipe(
6932
6983
 
6933
6984
  @builtins.property
6934
6985
  def measure_value_type(self) -> builtins.str:
6935
- '''
6986
+ '''Data type of the source field.
6987
+
6936
6988
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pipes-pipe-singlemeasuremapping.html#cfn-pipes-pipe-singlemeasuremapping-measurevaluetype
6937
6989
  '''
6938
6990
  result = self._values.get("measure_value_type")
@@ -142932,15 +142932,14 @@ class CfnDataSource(
142932
142932
  database_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
142933
142933
  database_user: typing.Optional[builtins.str] = None,
142934
142934
  ) -> None:
142935
- '''
142936
- For more information on the redshift:GetClusterCredentials API, see
142937
- GetClusterCredentials
142938
- .
142935
+ '''A structure that grants Amazon QuickSight access to your cluster and make a call to the ``redshift:GetClusterCredentials`` API.
142936
+
142937
+ For more information on the ``redshift:GetClusterCredentials`` API, see ```GetClusterCredentials`` <https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentials.html>`_ .
142939
142938
 
142940
- :param role_arn: The calling principal must have iam:PassRole access to pass the role to Amazon QuickSight. The role's trust policy must allow the Amazon QuickSight service principal to assume the role.
142941
- :param auto_create_database_user: If your database doesn't have a DatabaseUser, set this parameter to True. If there is no DatabaseUser, Amazon QuickSight can't connect to your cluster. The RoleArn that you use for this operation must grant access to redshift:CreateClusterUser to successfully create the user. Default: - false
142942
- :param database_groups: These permissions are combined with the permissions granted to Amazon QuickSight by the DatabaseUser. If you choose to include this parameter, the RoleArn must grant access to redshift:JoinGroup.
142943
- :param database_user: If this user already exists in your database, Amazon QuickSight is granted the same permissions that the user has. If the user doesn't exist, set the value of AutoCreateDatabaseUser to True to create a new user with PUBLIC permissions.
142939
+ :param role_arn: Use the ``RoleArn`` structure to allow Amazon QuickSight to call ``redshift:GetClusterCredentials`` on your cluster. The calling principal must have ``iam:PassRole`` access to pass the role to Amazon QuickSight. The role's trust policy must allow the Amazon QuickSight service principal to assume the role.
142940
+ :param auto_create_database_user: Automatically creates a database user. If your database doesn't have a ``DatabaseUser`` , set this parameter to ``True`` . If there is no ``DatabaseUser`` , Amazon QuickSight can't connect to your cluster. The ``RoleArn`` that you use for this operation must grant access to ``redshift:CreateClusterUser`` to successfully create the user. Default: - false
142941
+ :param database_groups: A list of groups whose permissions will be granted to Amazon QuickSight to access the cluster. These permissions are combined with the permissions granted to Amazon QuickSight by the ``DatabaseUser`` . If you choose to include this parameter, the ``RoleArn`` must grant access to ``redshift:JoinGroup`` .
142942
+ :param database_user: The user whose permissions and group memberships will be used by Amazon QuickSight to access the cluster. If this user already exists in your database, Amazon QuickSight is granted the same permissions that the user has. If the user doesn't exist, set the value of ``AutoCreateDatabaseUser`` to ``True`` to create a new user with PUBLIC permissions.
142944
142943
 
142945
142944
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-datasource-redshiftiamparameters.html
142946
142945
  :exampleMetadata: fixture=_generated
@@ -142978,8 +142977,9 @@ class CfnDataSource(
142978
142977
 
142979
142978
  @builtins.property
142980
142979
  def role_arn(self) -> builtins.str:
142981
- '''
142982
- The calling principal must have iam:PassRole access to pass the role to Amazon QuickSight. The role's trust policy must allow the Amazon QuickSight service principal to assume the role.
142980
+ '''Use the ``RoleArn`` structure to allow Amazon QuickSight to call ``redshift:GetClusterCredentials`` on your cluster.
142981
+
142982
+ The calling principal must have ``iam:PassRole`` access to pass the role to Amazon QuickSight. The role's trust policy must allow the Amazon QuickSight service principal to assume the role.
142983
142983
 
142984
142984
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-datasource-redshiftiamparameters.html#cfn-quicksight-datasource-redshiftiamparameters-rolearn
142985
142985
  '''
@@ -142991,8 +142991,9 @@ class CfnDataSource(
142991
142991
  def auto_create_database_user(
142992
142992
  self,
142993
142993
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
142994
- '''
142995
- If your database doesn't have a DatabaseUser, set this parameter to True. If there is no DatabaseUser, Amazon QuickSight can't connect to your cluster. The RoleArn that you use for this operation must grant access to redshift:CreateClusterUser to successfully create the user.
142994
+ '''Automatically creates a database user.
142995
+
142996
+ If your database doesn't have a ``DatabaseUser`` , set this parameter to ``True`` . If there is no ``DatabaseUser`` , Amazon QuickSight can't connect to your cluster. The ``RoleArn`` that you use for this operation must grant access to ``redshift:CreateClusterUser`` to successfully create the user.
142996
142997
 
142997
142998
  :default: - false
142998
142999
 
@@ -143003,8 +143004,9 @@ class CfnDataSource(
143003
143004
 
143004
143005
  @builtins.property
143005
143006
  def database_groups(self) -> typing.Optional[typing.List[builtins.str]]:
143006
- '''
143007
- These permissions are combined with the permissions granted to Amazon QuickSight by the DatabaseUser. If you choose to include this parameter, the RoleArn must grant access to redshift:JoinGroup.
143007
+ '''A list of groups whose permissions will be granted to Amazon QuickSight to access the cluster.
143008
+
143009
+ These permissions are combined with the permissions granted to Amazon QuickSight by the ``DatabaseUser`` . If you choose to include this parameter, the ``RoleArn`` must grant access to ``redshift:JoinGroup`` .
143008
143010
 
143009
143011
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-datasource-redshiftiamparameters.html#cfn-quicksight-datasource-redshiftiamparameters-databasegroups
143010
143012
  '''
@@ -143013,8 +143015,9 @@ class CfnDataSource(
143013
143015
 
143014
143016
  @builtins.property
143015
143017
  def database_user(self) -> typing.Optional[builtins.str]:
143016
- '''
143017
- If this user already exists in your database, Amazon QuickSight is granted the same permissions that the user has. If the user doesn't exist, set the value of AutoCreateDatabaseUser to True to create a new user with PUBLIC permissions.
143018
+ '''The user whose permissions and group memberships will be used by Amazon QuickSight to access the cluster.
143019
+
143020
+ If this user already exists in your database, Amazon QuickSight is granted the same permissions that the user has. If the user doesn't exist, set the value of ``AutoCreateDatabaseUser`` to ``True`` to create a new user with PUBLIC permissions.
143018
143021
 
143019
143022
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-datasource-redshiftiamparameters.html#cfn-quicksight-datasource-redshiftiamparameters-databaseuser
143020
143023
  '''
@@ -143062,7 +143065,7 @@ class CfnDataSource(
143062
143065
  :param database: Database.
143063
143066
  :param cluster_id: Cluster ID. This field can be blank if the ``Host`` and ``Port`` are provided.
143064
143067
  :param host: Host. This field can be blank if ``ClusterId`` is provided.
143065
- :param iam_parameters: For more information on the redshift:GetClusterCredentials API, see GetClusterCredentials .
143068
+ :param iam_parameters: An optional parameter that uses IAM authentication to grant Amazon QuickSight access to your cluster. This parameter can be used instead of `DataSourceCredentials <https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DataSourceCredentials.html>`_ .
143066
143069
  :param identity_center_configuration: An optional parameter that configures IAM Identity Center authentication to grant Amazon QuickSight access to your cluster. This parameter can only be specified if your Amazon QuickSight account is configured with IAM Identity Center.
143067
143070
  :param port: Port. This field can be blank if the ``ClusterId`` is provided. Default: - 0
143068
143071
 
@@ -143153,10 +143156,9 @@ class CfnDataSource(
143153
143156
  def iam_parameters(
143154
143157
  self,
143155
143158
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSource.RedshiftIAMParametersProperty"]]:
143156
- '''
143157
- For more information on the redshift:GetClusterCredentials API, see
143158
- GetClusterCredentials
143159
- .
143159
+ '''An optional parameter that uses IAM authentication to grant Amazon QuickSight access to your cluster.
143160
+
143161
+ This parameter can be used instead of `DataSourceCredentials <https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DataSourceCredentials.html>`_ .
143160
143162
 
143161
143163
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-datasource-redshiftparameters.html#cfn-quicksight-datasource-redshiftparameters-iamparameters
143162
143164
  '''