aws-cdk-lib 2.186.0__py3-none-any.whl → 2.188.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 (85) hide show
  1. aws_cdk/__init__.py +303 -119
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.186.0.jsii.tgz → aws-cdk-lib@2.188.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_amplify/__init__.py +136 -0
  5. aws_cdk/aws_apigateway/__init__.py +69 -17
  6. aws_cdk/aws_apigatewayv2/__init__.py +88 -0
  7. aws_cdk/aws_appconfig/__init__.py +30 -14
  8. aws_cdk/aws_appsync/__init__.py +14 -5
  9. aws_cdk/aws_arczonalshift/__init__.py +4 -4
  10. aws_cdk/aws_bedrock/__init__.py +637 -32
  11. aws_cdk/aws_budgets/__init__.py +8 -8
  12. aws_cdk/aws_cassandra/__init__.py +4 -2
  13. aws_cdk/aws_ce/__init__.py +2 -2
  14. aws_cdk/aws_cloudformation/__init__.py +3 -3
  15. aws_cdk/aws_cloudfront/__init__.py +11 -0
  16. aws_cdk/aws_cloudtrail/__init__.py +4 -18
  17. aws_cdk/aws_cloudwatch/__init__.py +50 -50
  18. aws_cdk/aws_codebuild/__init__.py +32 -1
  19. aws_cdk/aws_codepipeline/__init__.py +47 -32
  20. aws_cdk/aws_codepipeline_actions/__init__.py +2786 -1042
  21. aws_cdk/aws_codestarnotifications/__init__.py +16 -16
  22. aws_cdk/aws_cognito/__init__.py +8 -2
  23. aws_cdk/aws_config/__init__.py +2 -5
  24. aws_cdk/aws_datazone/__init__.py +287 -226
  25. aws_cdk/aws_detective/__init__.py +3 -3
  26. aws_cdk/aws_dynamodb/__init__.py +37 -0
  27. aws_cdk/aws_ec2/__init__.py +2448 -442
  28. aws_cdk/aws_ecr/__init__.py +143 -0
  29. aws_cdk/aws_ecr_assets/__init__.py +115 -4
  30. aws_cdk/aws_ecs/__init__.py +51 -0
  31. aws_cdk/aws_eks/__init__.py +222 -6
  32. aws_cdk/aws_events/__init__.py +8 -11
  33. aws_cdk/aws_events_targets/__init__.py +136 -0
  34. aws_cdk/aws_forecast/__init__.py +1 -1
  35. aws_cdk/aws_fsx/__init__.py +2 -2
  36. aws_cdk/aws_gamelift/__init__.py +11 -11
  37. aws_cdk/aws_iam/__init__.py +6 -4
  38. aws_cdk/aws_identitystore/__init__.py +6 -4
  39. aws_cdk/aws_iotsitewise/__init__.py +623 -0
  40. aws_cdk/aws_kinesisfirehose/__init__.py +38 -0
  41. aws_cdk/aws_kms/__init__.py +10 -11
  42. aws_cdk/aws_lakeformation/__init__.py +3 -3
  43. aws_cdk/aws_lambda/__init__.py +105 -4
  44. aws_cdk/aws_lambda_event_sources/__init__.py +87 -25
  45. aws_cdk/aws_lambda_nodejs/__init__.py +5 -24
  46. aws_cdk/aws_lex/__init__.py +985 -5
  47. aws_cdk/aws_logs/__init__.py +18 -0
  48. aws_cdk/aws_logs_destinations/__init__.py +146 -0
  49. aws_cdk/aws_mediaconnect/__init__.py +714 -290
  50. aws_cdk/aws_mwaa/__init__.py +9 -9
  51. aws_cdk/aws_networkfirewall/__init__.py +44 -0
  52. aws_cdk/aws_notifications/__init__.py +4 -4
  53. aws_cdk/aws_omics/__init__.py +225 -1
  54. aws_cdk/aws_opensearchserverless/__init__.py +31 -23
  55. aws_cdk/aws_organizations/__init__.py +1 -1
  56. aws_cdk/aws_pcaconnectorad/__init__.py +3 -2
  57. aws_cdk/aws_quicksight/__init__.py +268 -50
  58. aws_cdk/aws_rds/__init__.py +186 -10
  59. aws_cdk/aws_route53/__init__.py +5 -5
  60. aws_cdk/aws_route53recoverycontrol/__init__.py +41 -2
  61. aws_cdk/aws_rum/__init__.py +13 -10
  62. aws_cdk/aws_s3/__init__.py +3 -6
  63. aws_cdk/aws_s3_assets/__init__.py +70 -1
  64. aws_cdk/aws_s3_deployment/__init__.py +4 -0
  65. aws_cdk/aws_sagemaker/__init__.py +47 -4
  66. aws_cdk/aws_scheduler_targets/__init__.py +4 -16
  67. aws_cdk/aws_securitylake/__init__.py +2 -2
  68. aws_cdk/aws_servicecatalog/__init__.py +4 -0
  69. aws_cdk/aws_sns/__init__.py +1 -1
  70. aws_cdk/aws_ssmincidents/__init__.py +10 -10
  71. aws_cdk/aws_stepfunctions/__init__.py +23 -17
  72. aws_cdk/aws_stepfunctions_tasks/__init__.py +4 -0
  73. aws_cdk/aws_synthetics/__init__.py +9 -0
  74. aws_cdk/aws_systemsmanagersap/__init__.py +160 -0
  75. aws_cdk/aws_transfer/__init__.py +19 -10
  76. aws_cdk/aws_wafv2/__init__.py +512 -1141
  77. aws_cdk/cloud_assembly_schema/__init__.py +60 -10
  78. aws_cdk/cx_api/__init__.py +38 -2
  79. aws_cdk/pipelines/__init__.py +52 -2
  80. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/METADATA +4 -4
  81. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/RECORD +85 -85
  82. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/WHEEL +1 -1
  83. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/LICENSE +0 -0
  84. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/NOTICE +0 -0
  85. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/top_level.txt +0 -0
aws_cdk/__init__.py CHANGED
@@ -1562,6 +1562,108 @@ from .cx_api import (
1562
1562
  )
1563
1563
 
1564
1564
 
1565
+ @jsii.data_type(
1566
+ jsii_type="aws-cdk-lib.AddDockerImageAssetOptions",
1567
+ jsii_struct_bases=[],
1568
+ name_mapping={"display_name": "displayName"},
1569
+ )
1570
+ class AddDockerImageAssetOptions:
1571
+ def __init__(self, *, display_name: typing.Optional[builtins.str] = None) -> None:
1572
+ '''Options for the addDockerImageAsset operation.
1573
+
1574
+ :param display_name: A display name to associate with the asset. Default: - No display name
1575
+
1576
+ :exampleMetadata: fixture=_generated
1577
+
1578
+ Example::
1579
+
1580
+ # The code below shows an example of how to instantiate this type.
1581
+ # The values are placeholders you should change.
1582
+ import aws_cdk as cdk
1583
+
1584
+ add_docker_image_asset_options = cdk.AddDockerImageAssetOptions(
1585
+ display_name="displayName"
1586
+ )
1587
+ '''
1588
+ if __debug__:
1589
+ type_hints = typing.get_type_hints(_typecheckingstub__5a1ac212aad6af3e005718717aa2d00b8a797e24b74644f38d11d9f5ced18b43)
1590
+ check_type(argname="argument display_name", value=display_name, expected_type=type_hints["display_name"])
1591
+ self._values: typing.Dict[builtins.str, typing.Any] = {}
1592
+ if display_name is not None:
1593
+ self._values["display_name"] = display_name
1594
+
1595
+ @builtins.property
1596
+ def display_name(self) -> typing.Optional[builtins.str]:
1597
+ '''A display name to associate with the asset.
1598
+
1599
+ :default: - No display name
1600
+ '''
1601
+ result = self._values.get("display_name")
1602
+ return typing.cast(typing.Optional[builtins.str], result)
1603
+
1604
+ def __eq__(self, rhs: typing.Any) -> builtins.bool:
1605
+ return isinstance(rhs, self.__class__) and rhs._values == self._values
1606
+
1607
+ def __ne__(self, rhs: typing.Any) -> builtins.bool:
1608
+ return not (rhs == self)
1609
+
1610
+ def __repr__(self) -> str:
1611
+ return "AddDockerImageAssetOptions(%s)" % ", ".join(
1612
+ k + "=" + repr(v) for k, v in self._values.items()
1613
+ )
1614
+
1615
+
1616
+ @jsii.data_type(
1617
+ jsii_type="aws-cdk-lib.AddFileAssetOptions",
1618
+ jsii_struct_bases=[],
1619
+ name_mapping={"display_name": "displayName"},
1620
+ )
1621
+ class AddFileAssetOptions:
1622
+ def __init__(self, *, display_name: typing.Optional[builtins.str] = None) -> None:
1623
+ '''Options for the addFileAsset operation.
1624
+
1625
+ :param display_name: A display name to associate with the asset. Default: - No display name
1626
+
1627
+ :exampleMetadata: fixture=_generated
1628
+
1629
+ Example::
1630
+
1631
+ # The code below shows an example of how to instantiate this type.
1632
+ # The values are placeholders you should change.
1633
+ import aws_cdk as cdk
1634
+
1635
+ add_file_asset_options = cdk.AddFileAssetOptions(
1636
+ display_name="displayName"
1637
+ )
1638
+ '''
1639
+ if __debug__:
1640
+ type_hints = typing.get_type_hints(_typecheckingstub__3b7bb14c4d35bab2918fcff6fafc6bf8560391fa80cf7e743756928a3ff744a2)
1641
+ check_type(argname="argument display_name", value=display_name, expected_type=type_hints["display_name"])
1642
+ self._values: typing.Dict[builtins.str, typing.Any] = {}
1643
+ if display_name is not None:
1644
+ self._values["display_name"] = display_name
1645
+
1646
+ @builtins.property
1647
+ def display_name(self) -> typing.Optional[builtins.str]:
1648
+ '''A display name to associate with the asset.
1649
+
1650
+ :default: - No display name
1651
+ '''
1652
+ result = self._values.get("display_name")
1653
+ return typing.cast(typing.Optional[builtins.str], result)
1654
+
1655
+ def __eq__(self, rhs: typing.Any) -> builtins.bool:
1656
+ return isinstance(rhs, self.__class__) and rhs._values == self._values
1657
+
1658
+ def __ne__(self, rhs: typing.Any) -> builtins.bool:
1659
+ return not (rhs == self)
1660
+
1661
+ def __repr__(self) -> str:
1662
+ return "AddFileAssetOptions(%s)" % ", ".join(
1663
+ k + "=" + repr(v) for k, v in self._values.items()
1664
+ )
1665
+
1666
+
1565
1667
  class Annotations(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Annotations"):
1566
1668
  '''Includes API for attaching annotations such as warning messages to constructs.
1567
1669
 
@@ -2562,13 +2664,9 @@ class AssetManifestBuilder(
2562
2664
  stack: "Stack",
2563
2665
  source_hash: builtins.str,
2564
2666
  source: typing.Union[_DockerImageSource_5db2cfa3, typing.Dict[builtins.str, typing.Any]],
2667
+ dest: typing.Union[_DockerImageDestination_132046c7, typing.Dict[builtins.str, typing.Any]],
2565
2668
  *,
2566
- image_tag: builtins.str,
2567
- repository_name: builtins.str,
2568
- assume_role_additional_options: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
2569
- assume_role_arn: typing.Optional[builtins.str] = None,
2570
- assume_role_external_id: typing.Optional[builtins.str] = None,
2571
- region: typing.Optional[builtins.str] = None,
2669
+ display_name: typing.Optional[builtins.str] = None,
2572
2670
  ) -> _DockerImageDestination_132046c7:
2573
2671
  '''Add a docker asset source and destination to the manifest.
2574
2672
 
@@ -2577,28 +2675,18 @@ class AssetManifestBuilder(
2577
2675
  :param stack: -
2578
2676
  :param source_hash: -
2579
2677
  :param source: -
2580
- :param image_tag: Tag of the image to publish.
2581
- :param repository_name: Name of the ECR repository to publish to.
2582
- :param assume_role_additional_options: Additional options to pass to STS when assuming the role. - ``RoleArn`` should not be used. Use the dedicated ``assumeRoleArn`` property instead. - ``ExternalId`` should not be used. Use the dedicated ``assumeRoleExternalId`` instead. Default: - No additional options.
2583
- :param assume_role_arn: The role that needs to be assumed while publishing this asset. Default: - No role will be assumed
2584
- :param assume_role_external_id: The ExternalId that needs to be supplied while assuming this role. Default: - No ExternalId will be supplied
2585
- :param region: The region where this asset will need to be published. Default: - Current region
2678
+ :param dest: -
2679
+ :param display_name: A display name to associate with the asset. Default: - No display name
2586
2680
  '''
2587
2681
  if __debug__:
2588
2682
  type_hints = typing.get_type_hints(_typecheckingstub__e4e4609083793a8b31752be2f457b6b1f1220145a70469bafc48a142860684a6)
2589
2683
  check_type(argname="argument stack", value=stack, expected_type=type_hints["stack"])
2590
2684
  check_type(argname="argument source_hash", value=source_hash, expected_type=type_hints["source_hash"])
2591
2685
  check_type(argname="argument source", value=source, expected_type=type_hints["source"])
2592
- dest = _DockerImageDestination_132046c7(
2593
- image_tag=image_tag,
2594
- repository_name=repository_name,
2595
- assume_role_additional_options=assume_role_additional_options,
2596
- assume_role_arn=assume_role_arn,
2597
- assume_role_external_id=assume_role_external_id,
2598
- region=region,
2599
- )
2686
+ check_type(argname="argument dest", value=dest, expected_type=type_hints["dest"])
2687
+ options = AddDockerImageAssetOptions(display_name=display_name)
2600
2688
 
2601
- return typing.cast(_DockerImageDestination_132046c7, jsii.invoke(self, "addDockerImageAsset", [stack, source_hash, source, dest]))
2689
+ return typing.cast(_DockerImageDestination_132046c7, jsii.invoke(self, "addDockerImageAsset", [stack, source_hash, source, dest, options]))
2602
2690
 
2603
2691
  @jsii.member(jsii_name="addFileAsset")
2604
2692
  def add_file_asset(
@@ -2606,13 +2694,9 @@ class AssetManifestBuilder(
2606
2694
  stack: "Stack",
2607
2695
  source_hash: builtins.str,
2608
2696
  source: typing.Union[_FileSource_66254048, typing.Dict[builtins.str, typing.Any]],
2697
+ dest: typing.Union[_FileDestination_7d285b38, typing.Dict[builtins.str, typing.Any]],
2609
2698
  *,
2610
- bucket_name: builtins.str,
2611
- object_key: builtins.str,
2612
- assume_role_additional_options: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
2613
- assume_role_arn: typing.Optional[builtins.str] = None,
2614
- assume_role_external_id: typing.Optional[builtins.str] = None,
2615
- region: typing.Optional[builtins.str] = None,
2699
+ display_name: typing.Optional[builtins.str] = None,
2616
2700
  ) -> _FileDestination_7d285b38:
2617
2701
  '''Add a file asset source and destination to the manifest.
2618
2702
 
@@ -2621,38 +2705,27 @@ class AssetManifestBuilder(
2621
2705
  :param stack: -
2622
2706
  :param source_hash: -
2623
2707
  :param source: -
2624
- :param bucket_name: The name of the bucket.
2625
- :param object_key: The destination object key.
2626
- :param assume_role_additional_options: Additional options to pass to STS when assuming the role. - ``RoleArn`` should not be used. Use the dedicated ``assumeRoleArn`` property instead. - ``ExternalId`` should not be used. Use the dedicated ``assumeRoleExternalId`` instead. Default: - No additional options.
2627
- :param assume_role_arn: The role that needs to be assumed while publishing this asset. Default: - No role will be assumed
2628
- :param assume_role_external_id: The ExternalId that needs to be supplied while assuming this role. Default: - No ExternalId will be supplied
2629
- :param region: The region where this asset will need to be published. Default: - Current region
2708
+ :param dest: -
2709
+ :param display_name: A display name to associate with the asset. Default: - No display name
2630
2710
  '''
2631
2711
  if __debug__:
2632
2712
  type_hints = typing.get_type_hints(_typecheckingstub__f12f649e9db582bca540895dead136ba4f8ce5c52abc11eb50e5224da26e06f5)
2633
2713
  check_type(argname="argument stack", value=stack, expected_type=type_hints["stack"])
2634
2714
  check_type(argname="argument source_hash", value=source_hash, expected_type=type_hints["source_hash"])
2635
2715
  check_type(argname="argument source", value=source, expected_type=type_hints["source"])
2636
- dest = _FileDestination_7d285b38(
2637
- bucket_name=bucket_name,
2638
- object_key=object_key,
2639
- assume_role_additional_options=assume_role_additional_options,
2640
- assume_role_arn=assume_role_arn,
2641
- assume_role_external_id=assume_role_external_id,
2642
- region=region,
2643
- )
2716
+ check_type(argname="argument dest", value=dest, expected_type=type_hints["dest"])
2717
+ options = AddFileAssetOptions(display_name=display_name)
2644
2718
 
2645
- return typing.cast(_FileDestination_7d285b38, jsii.invoke(self, "addFileAsset", [stack, source_hash, source, dest]))
2719
+ return typing.cast(_FileDestination_7d285b38, jsii.invoke(self, "addFileAsset", [stack, source_hash, source, dest, options]))
2646
2720
 
2647
2721
  @jsii.member(jsii_name="defaultAddDockerImageAsset")
2648
2722
  def default_add_docker_image_asset(
2649
2723
  self,
2650
2724
  stack: "Stack",
2651
2725
  asset: typing.Union["DockerImageAssetSource", typing.Dict[builtins.str, typing.Any]],
2726
+ target: typing.Union["AssetManifestDockerImageDestination", typing.Dict[builtins.str, typing.Any]],
2652
2727
  *,
2653
- repository_name: builtins.str,
2654
- docker_tag_prefix: typing.Optional[builtins.str] = None,
2655
- role: typing.Optional[typing.Union["RoleOptions", typing.Dict[builtins.str, typing.Any]]] = None,
2728
+ display_name: typing.Optional[builtins.str] = None,
2656
2729
  ) -> _DockerImageDestination_132046c7:
2657
2730
  '''Add a docker image asset to the manifest with default settings.
2658
2731
 
@@ -2660,31 +2733,26 @@ class AssetManifestBuilder(
2660
2733
 
2661
2734
  :param stack: -
2662
2735
  :param asset: -
2663
- :param repository_name: Repository name where the docker image asset should be written.
2664
- :param docker_tag_prefix: Prefix to add to the asset hash to make the Docker image tag. Default: ''
2665
- :param role: Role to use to perform the upload. Default: - No role
2736
+ :param target: -
2737
+ :param display_name: A display name to associate with the asset. Default: - No display name
2666
2738
  '''
2667
2739
  if __debug__:
2668
2740
  type_hints = typing.get_type_hints(_typecheckingstub__d8572c82a112aaa61153d2b958b8042f9e061141b483b1b0ce6429f9f7c11296)
2669
2741
  check_type(argname="argument stack", value=stack, expected_type=type_hints["stack"])
2670
2742
  check_type(argname="argument asset", value=asset, expected_type=type_hints["asset"])
2671
- target = AssetManifestDockerImageDestination(
2672
- repository_name=repository_name,
2673
- docker_tag_prefix=docker_tag_prefix,
2674
- role=role,
2675
- )
2743
+ check_type(argname="argument target", value=target, expected_type=type_hints["target"])
2744
+ options = AddDockerImageAssetOptions(display_name=display_name)
2676
2745
 
2677
- return typing.cast(_DockerImageDestination_132046c7, jsii.invoke(self, "defaultAddDockerImageAsset", [stack, asset, target]))
2746
+ return typing.cast(_DockerImageDestination_132046c7, jsii.invoke(self, "defaultAddDockerImageAsset", [stack, asset, target, options]))
2678
2747
 
2679
2748
  @jsii.member(jsii_name="defaultAddFileAsset")
2680
2749
  def default_add_file_asset(
2681
2750
  self,
2682
2751
  stack: "Stack",
2683
2752
  asset: typing.Union["FileAssetSource", typing.Dict[builtins.str, typing.Any]],
2753
+ target: typing.Union["AssetManifestFileDestination", typing.Dict[builtins.str, typing.Any]],
2684
2754
  *,
2685
- bucket_name: builtins.str,
2686
- bucket_prefix: typing.Optional[builtins.str] = None,
2687
- role: typing.Optional[typing.Union["RoleOptions", typing.Dict[builtins.str, typing.Any]]] = None,
2755
+ display_name: typing.Optional[builtins.str] = None,
2688
2756
  ) -> _FileDestination_7d285b38:
2689
2757
  '''Add a file asset to the manifest with default settings.
2690
2758
 
@@ -2693,19 +2761,17 @@ class AssetManifestBuilder(
2693
2761
 
2694
2762
  :param stack: -
2695
2763
  :param asset: -
2696
- :param bucket_name: Bucket name where the file asset should be written.
2697
- :param bucket_prefix: Prefix to prepend to the asset hash. Default: ''
2698
- :param role: Role to use for uploading. Default: - current role
2764
+ :param target: -
2765
+ :param display_name: A display name to associate with the asset. Default: - No display name
2699
2766
  '''
2700
2767
  if __debug__:
2701
2768
  type_hints = typing.get_type_hints(_typecheckingstub__085bf08106379af70653604775528303d429c31168f56c2439ed96f6b61197be)
2702
2769
  check_type(argname="argument stack", value=stack, expected_type=type_hints["stack"])
2703
2770
  check_type(argname="argument asset", value=asset, expected_type=type_hints["asset"])
2704
- target = AssetManifestFileDestination(
2705
- bucket_name=bucket_name, bucket_prefix=bucket_prefix, role=role
2706
- )
2771
+ check_type(argname="argument target", value=target, expected_type=type_hints["target"])
2772
+ options = AddFileAssetOptions(display_name=display_name)
2707
2773
 
2708
- return typing.cast(_FileDestination_7d285b38, jsii.invoke(self, "defaultAddFileAsset", [stack, asset, target]))
2774
+ return typing.cast(_FileDestination_7d285b38, jsii.invoke(self, "defaultAddFileAsset", [stack, asset, target, options]))
2709
2775
 
2710
2776
  @jsii.member(jsii_name="emitManifest")
2711
2777
  def emit_manifest(
@@ -3813,6 +3879,7 @@ class CfnAutoScalingReplacingUpdate:
3813
3879
  jsii_struct_bases=[],
3814
3880
  name_mapping={
3815
3881
  "max_batch_size": "maxBatchSize",
3882
+ "min_active_instances_percent": "minActiveInstancesPercent",
3816
3883
  "min_instances_in_service": "minInstancesInService",
3817
3884
  "min_successful_instances_percent": "minSuccessfulInstancesPercent",
3818
3885
  "pause_time": "pauseTime",
@@ -3825,6 +3892,7 @@ class CfnAutoScalingRollingUpdate:
3825
3892
  self,
3826
3893
  *,
3827
3894
  max_batch_size: typing.Optional[jsii.Number] = None,
3895
+ min_active_instances_percent: typing.Optional[jsii.Number] = None,
3828
3896
  min_instances_in_service: typing.Optional[jsii.Number] = None,
3829
3897
  min_successful_instances_percent: typing.Optional[jsii.Number] = None,
3830
3898
  pause_time: typing.Optional[builtins.str] = None,
@@ -3837,6 +3905,7 @@ class CfnAutoScalingRollingUpdate:
3837
3905
  group in batches or all at once.
3838
3906
 
3839
3907
  :param max_batch_size: Specifies the maximum number of instances that AWS CloudFormation updates.
3908
+ :param min_active_instances_percent: Specifies the percentage of instances in an Auto Scaling group that must remain in service while AWS CloudFormation updates old instances. You can specify a value from 0 to 100. AWS CloudFormation rounds to the nearest tenth of a percent. For example, if you update five instances with a minimum active percentage of 50, three instances must remain in service.
3840
3909
  :param min_instances_in_service: Specifies the minimum number of instances that must be in service within the Auto Scaling group while AWS CloudFormation updates old instances.
3841
3910
  :param min_successful_instances_percent: Specifies the percentage of instances in an Auto Scaling rolling update that must signal success for an update to succeed. You can specify a value from 0 to 100. AWS CloudFormation rounds to the nearest tenth of a percent. For example, if you update five instances with a minimum successful percentage of 50, three instances must signal success. If an instance doesn't send a signal within the time specified in the PauseTime property, AWS CloudFormation assumes that the instance wasn't updated. If you specify this property, you must also enable the WaitOnResourceSignals and PauseTime properties.
3842
3911
  :param pause_time: The amount of time that AWS CloudFormation pauses after making a change to a batch of instances to give those instances time to start software applications. For example, you might need to specify PauseTime when scaling up the number of instances in an Auto Scaling group. If you enable the WaitOnResourceSignals property, PauseTime is the amount of time that AWS CloudFormation should wait for the Auto Scaling group to receive the required number of valid signals from added or replaced instances. If the PauseTime is exceeded before the Auto Scaling group receives the required number of signals, the update fails. For best results, specify a time period that gives your applications sufficient time to get started. If the update needs to be rolled back, a short PauseTime can cause the rollback to fail. Specify PauseTime in the ISO8601 duration format (in the format PT#H#M#S, where each # is the number of hours, minutes, and seconds, respectively). The maximum PauseTime is one hour (PT1H).
@@ -3853,6 +3922,7 @@ class CfnAutoScalingRollingUpdate:
3853
3922
 
3854
3923
  cfn_auto_scaling_rolling_update = cdk.CfnAutoScalingRollingUpdate(
3855
3924
  max_batch_size=123,
3925
+ min_active_instances_percent=123,
3856
3926
  min_instances_in_service=123,
3857
3927
  min_successful_instances_percent=123,
3858
3928
  pause_time="pauseTime",
@@ -3863,6 +3933,7 @@ class CfnAutoScalingRollingUpdate:
3863
3933
  if __debug__:
3864
3934
  type_hints = typing.get_type_hints(_typecheckingstub__085b6d44b1c6b74e8060adbd78e13b1a188913a88389f19dce989d64cd5d0b7b)
3865
3935
  check_type(argname="argument max_batch_size", value=max_batch_size, expected_type=type_hints["max_batch_size"])
3936
+ check_type(argname="argument min_active_instances_percent", value=min_active_instances_percent, expected_type=type_hints["min_active_instances_percent"])
3866
3937
  check_type(argname="argument min_instances_in_service", value=min_instances_in_service, expected_type=type_hints["min_instances_in_service"])
3867
3938
  check_type(argname="argument min_successful_instances_percent", value=min_successful_instances_percent, expected_type=type_hints["min_successful_instances_percent"])
3868
3939
  check_type(argname="argument pause_time", value=pause_time, expected_type=type_hints["pause_time"])
@@ -3871,6 +3942,8 @@ class CfnAutoScalingRollingUpdate:
3871
3942
  self._values: typing.Dict[builtins.str, typing.Any] = {}
3872
3943
  if max_batch_size is not None:
3873
3944
  self._values["max_batch_size"] = max_batch_size
3945
+ if min_active_instances_percent is not None:
3946
+ self._values["min_active_instances_percent"] = min_active_instances_percent
3874
3947
  if min_instances_in_service is not None:
3875
3948
  self._values["min_instances_in_service"] = min_instances_in_service
3876
3949
  if min_successful_instances_percent is not None:
@@ -3888,6 +3961,16 @@ class CfnAutoScalingRollingUpdate:
3888
3961
  result = self._values.get("max_batch_size")
3889
3962
  return typing.cast(typing.Optional[jsii.Number], result)
3890
3963
 
3964
+ @builtins.property
3965
+ def min_active_instances_percent(self) -> typing.Optional[jsii.Number]:
3966
+ '''Specifies the percentage of instances in an Auto Scaling group that must remain in service while AWS CloudFormation updates old instances.
3967
+
3968
+ You can specify a value from 0 to 100. AWS CloudFormation rounds to the nearest tenth of a percent.
3969
+ For example, if you update five instances with a minimum active percentage of 50, three instances must remain in service.
3970
+ '''
3971
+ result = self._values.get("min_active_instances_percent")
3972
+ return typing.cast(typing.Optional[jsii.Number], result)
3973
+
3891
3974
  @builtins.property
3892
3975
  def min_instances_in_service(self) -> typing.Optional[jsii.Number]:
3893
3976
  '''Specifies the minimum number of instances that must be in service within the Auto Scaling group while AWS CloudFormation updates old instances.'''
@@ -10128,6 +10211,7 @@ class CfnUpdatePolicy:
10128
10211
  ),
10129
10212
  auto_scaling_rolling_update=cdk.CfnAutoScalingRollingUpdate(
10130
10213
  max_batch_size=123,
10214
+ min_active_instances_percent=123,
10131
10215
  min_instances_in_service=123,
10132
10216
  min_successful_instances_percent=123,
10133
10217
  pause_time="pauseTime",
@@ -12375,6 +12459,7 @@ class DockerImageAssetLocation:
12375
12459
  "source_hash": "sourceHash",
12376
12460
  "asset_name": "assetName",
12377
12461
  "directory_name": "directoryName",
12462
+ "display_name": "displayName",
12378
12463
  "docker_build_args": "dockerBuildArgs",
12379
12464
  "docker_build_secrets": "dockerBuildSecrets",
12380
12465
  "docker_build_ssh": "dockerBuildSsh",
@@ -12396,6 +12481,7 @@ class DockerImageAssetSource:
12396
12481
  source_hash: builtins.str,
12397
12482
  asset_name: typing.Optional[builtins.str] = None,
12398
12483
  directory_name: typing.Optional[builtins.str] = None,
12484
+ display_name: typing.Optional[builtins.str] = None,
12399
12485
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
12400
12486
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
12401
12487
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -12413,6 +12499,7 @@ class DockerImageAssetSource:
12413
12499
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
12414
12500
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
12415
12501
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
12502
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
12416
12503
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
12417
12504
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
12418
12505
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -12440,6 +12527,7 @@ class DockerImageAssetSource:
12440
12527
  # the properties below are optional
12441
12528
  asset_name="assetName",
12442
12529
  directory_name="directoryName",
12530
+ display_name="displayName",
12443
12531
  docker_build_args={
12444
12532
  "docker_build_args_key": "dockerBuildArgs"
12445
12533
  },
@@ -12479,6 +12567,7 @@ class DockerImageAssetSource:
12479
12567
  check_type(argname="argument source_hash", value=source_hash, expected_type=type_hints["source_hash"])
12480
12568
  check_type(argname="argument asset_name", value=asset_name, expected_type=type_hints["asset_name"])
12481
12569
  check_type(argname="argument directory_name", value=directory_name, expected_type=type_hints["directory_name"])
12570
+ check_type(argname="argument display_name", value=display_name, expected_type=type_hints["display_name"])
12482
12571
  check_type(argname="argument docker_build_args", value=docker_build_args, expected_type=type_hints["docker_build_args"])
12483
12572
  check_type(argname="argument docker_build_secrets", value=docker_build_secrets, expected_type=type_hints["docker_build_secrets"])
12484
12573
  check_type(argname="argument docker_build_ssh", value=docker_build_ssh, expected_type=type_hints["docker_build_ssh"])
@@ -12498,6 +12587,8 @@ class DockerImageAssetSource:
12498
12587
  self._values["asset_name"] = asset_name
12499
12588
  if directory_name is not None:
12500
12589
  self._values["directory_name"] = directory_name
12590
+ if display_name is not None:
12591
+ self._values["display_name"] = display_name
12501
12592
  if docker_build_args is not None:
12502
12593
  self._values["docker_build_args"] = docker_build_args
12503
12594
  if docker_build_secrets is not None:
@@ -12558,6 +12649,18 @@ class DockerImageAssetSource:
12558
12649
  result = self._values.get("directory_name")
12559
12650
  return typing.cast(typing.Optional[builtins.str], result)
12560
12651
 
12652
+ @builtins.property
12653
+ def display_name(self) -> typing.Optional[builtins.str]:
12654
+ '''A display name for this asset.
12655
+
12656
+ If supplied, the display name will be used in locations where the asset
12657
+ identifier is printed, like in the CLI progress information.
12658
+
12659
+ :default: - The asset hash is used to display the asset
12660
+ '''
12661
+ result = self._values.get("display_name")
12662
+ return typing.cast(typing.Optional[builtins.str], result)
12663
+
12561
12664
  @builtins.property
12562
12665
  def docker_build_args(
12563
12666
  self,
@@ -13894,6 +13997,7 @@ class FileAssetPackaging(enum.Enum):
13894
13997
  name_mapping={
13895
13998
  "source_hash": "sourceHash",
13896
13999
  "deploy_time": "deployTime",
14000
+ "display_name": "displayName",
13897
14001
  "executable": "executable",
13898
14002
  "file_name": "fileName",
13899
14003
  "packaging": "packaging",
@@ -13905,6 +14009,7 @@ class FileAssetSource:
13905
14009
  *,
13906
14010
  source_hash: builtins.str,
13907
14011
  deploy_time: typing.Optional[builtins.bool] = None,
14012
+ display_name: typing.Optional[builtins.str] = None,
13908
14013
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
13909
14014
  file_name: typing.Optional[builtins.str] = None,
13910
14015
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -13913,6 +14018,7 @@ class FileAssetSource:
13913
14018
 
13914
14019
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
13915
14020
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
14021
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
13916
14022
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
13917
14023
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
13918
14024
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -13930,6 +14036,7 @@ class FileAssetSource:
13930
14036
 
13931
14037
  # the properties below are optional
13932
14038
  deploy_time=False,
14039
+ display_name="displayName",
13933
14040
  executable=["executable"],
13934
14041
  file_name="fileName",
13935
14042
  packaging=cdk.FileAssetPackaging.ZIP_DIRECTORY
@@ -13939,6 +14046,7 @@ class FileAssetSource:
13939
14046
  type_hints = typing.get_type_hints(_typecheckingstub__6a2ffcc71f7081ed98f77dcff398894a56d300191a4893d6469a2218ffed2957)
13940
14047
  check_type(argname="argument source_hash", value=source_hash, expected_type=type_hints["source_hash"])
13941
14048
  check_type(argname="argument deploy_time", value=deploy_time, expected_type=type_hints["deploy_time"])
14049
+ check_type(argname="argument display_name", value=display_name, expected_type=type_hints["display_name"])
13942
14050
  check_type(argname="argument executable", value=executable, expected_type=type_hints["executable"])
13943
14051
  check_type(argname="argument file_name", value=file_name, expected_type=type_hints["file_name"])
13944
14052
  check_type(argname="argument packaging", value=packaging, expected_type=type_hints["packaging"])
@@ -13947,6 +14055,8 @@ class FileAssetSource:
13947
14055
  }
13948
14056
  if deploy_time is not None:
13949
14057
  self._values["deploy_time"] = deploy_time
14058
+ if display_name is not None:
14059
+ self._values["display_name"] = display_name
13950
14060
  if executable is not None:
13951
14061
  self._values["executable"] = executable
13952
14062
  if file_name is not None:
@@ -13985,6 +14095,18 @@ class FileAssetSource:
13985
14095
  result = self._values.get("deploy_time")
13986
14096
  return typing.cast(typing.Optional[builtins.bool], result)
13987
14097
 
14098
+ @builtins.property
14099
+ def display_name(self) -> typing.Optional[builtins.str]:
14100
+ '''A display name for this asset.
14101
+
14102
+ If supplied, the display name will be used in locations where the asset
14103
+ identifier is printed, like in the CLI progress information.
14104
+
14105
+ :default: - The asset hash is used to display the asset
14106
+ '''
14107
+ result = self._values.get("display_name")
14108
+ return typing.cast(typing.Optional[builtins.str], result)
14109
+
13988
14110
  @builtins.property
13989
14111
  def executable(self) -> typing.Optional[typing.List[builtins.str]]:
13990
14112
  '''An external command that will produce the packaged asset.
@@ -16699,6 +16821,7 @@ class IStackSynthesizer(typing_extensions.Protocol):
16699
16821
  source_hash: builtins.str,
16700
16822
  asset_name: typing.Optional[builtins.str] = None,
16701
16823
  directory_name: typing.Optional[builtins.str] = None,
16824
+ display_name: typing.Optional[builtins.str] = None,
16702
16825
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
16703
16826
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
16704
16827
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -16719,6 +16842,7 @@ class IStackSynthesizer(typing_extensions.Protocol):
16719
16842
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
16720
16843
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
16721
16844
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
16845
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
16722
16846
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
16723
16847
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
16724
16848
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -16740,6 +16864,7 @@ class IStackSynthesizer(typing_extensions.Protocol):
16740
16864
  *,
16741
16865
  source_hash: builtins.str,
16742
16866
  deploy_time: typing.Optional[builtins.bool] = None,
16867
+ display_name: typing.Optional[builtins.str] = None,
16743
16868
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
16744
16869
  file_name: typing.Optional[builtins.str] = None,
16745
16870
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -16750,6 +16875,7 @@ class IStackSynthesizer(typing_extensions.Protocol):
16750
16875
 
16751
16876
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
16752
16877
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
16878
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
16753
16879
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
16754
16880
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
16755
16881
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -16805,6 +16931,7 @@ class _IStackSynthesizerProxy:
16805
16931
  source_hash: builtins.str,
16806
16932
  asset_name: typing.Optional[builtins.str] = None,
16807
16933
  directory_name: typing.Optional[builtins.str] = None,
16934
+ display_name: typing.Optional[builtins.str] = None,
16808
16935
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
16809
16936
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
16810
16937
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -16825,6 +16952,7 @@ class _IStackSynthesizerProxy:
16825
16952
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
16826
16953
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
16827
16954
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
16955
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
16828
16956
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
16829
16957
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
16830
16958
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -16842,6 +16970,7 @@ class _IStackSynthesizerProxy:
16842
16970
  source_hash=source_hash,
16843
16971
  asset_name=asset_name,
16844
16972
  directory_name=directory_name,
16973
+ display_name=display_name,
16845
16974
  docker_build_args=docker_build_args,
16846
16975
  docker_build_secrets=docker_build_secrets,
16847
16976
  docker_build_ssh=docker_build_ssh,
@@ -16864,6 +16993,7 @@ class _IStackSynthesizerProxy:
16864
16993
  *,
16865
16994
  source_hash: builtins.str,
16866
16995
  deploy_time: typing.Optional[builtins.bool] = None,
16996
+ display_name: typing.Optional[builtins.str] = None,
16867
16997
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
16868
16998
  file_name: typing.Optional[builtins.str] = None,
16869
16999
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -16874,6 +17004,7 @@ class _IStackSynthesizerProxy:
16874
17004
 
16875
17005
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
16876
17006
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
17007
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
16877
17008
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
16878
17009
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
16879
17010
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -16881,6 +17012,7 @@ class _IStackSynthesizerProxy:
16881
17012
  asset = FileAssetSource(
16882
17013
  source_hash=source_hash,
16883
17014
  deploy_time=deploy_time,
17015
+ display_name=display_name,
16884
17016
  executable=executable,
16885
17017
  file_name=file_name,
16886
17018
  packaging=packaging,
@@ -18405,6 +18537,24 @@ class Names(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Names"):
18405
18537
  check_type(argname="argument node", value=node, expected_type=type_hints["node"])
18406
18538
  return typing.cast(builtins.str, jsii.sinvoke(cls, "nodeUniqueId", [node]))
18407
18539
 
18540
+ @jsii.member(jsii_name="stackRelativeConstructPath")
18541
+ @builtins.classmethod
18542
+ def stack_relative_construct_path(
18543
+ cls,
18544
+ construct: _constructs_77d1e7e8.IConstruct,
18545
+ ) -> builtins.str:
18546
+ '''Return the construct path of the given construct, starting at the nearest enclosing Stack.
18547
+
18548
+ Skips over Nested Stacks, in other words Nested Stacks are included in the construct
18549
+ paths.
18550
+
18551
+ :param construct: -
18552
+ '''
18553
+ if __debug__:
18554
+ type_hints = typing.get_type_hints(_typecheckingstub__307d610951ef0b232f9222edc6ac5421fa347060bc21fb75e850a338e9aa77c7)
18555
+ check_type(argname="argument construct", value=construct, expected_type=type_hints["construct"])
18556
+ return typing.cast(builtins.str, jsii.sinvoke(cls, "stackRelativeConstructPath", [construct]))
18557
+
18408
18558
  @jsii.member(jsii_name="uniqueId")
18409
18559
  @builtins.classmethod
18410
18560
  def unique_id(cls, construct: _constructs_77d1e7e8.IConstruct) -> builtins.str:
@@ -19428,41 +19578,20 @@ class RemovalPolicy(enum.Enum):
19428
19578
 
19429
19579
  Example::
19430
19580
 
19431
- import aws_cdk.aws_opensearchservice as opensearch
19432
-
19433
- # api: appsync.GraphqlApi
19434
-
19435
-
19436
- user = iam.User(self, "User")
19437
- domain = opensearch.Domain(self, "Domain",
19438
- version=opensearch.EngineVersion.OPENSEARCH_2_3,
19439
- removal_policy=RemovalPolicy.DESTROY,
19440
- fine_grained_access_control=opensearch.AdvancedSecurityOptions(master_user_arn=user.user_arn),
19441
- encryption_at_rest=opensearch.EncryptionAtRestOptions(enabled=True),
19442
- node_to_node_encryption=True,
19443
- enforce_https=True
19444
- )
19445
- ds = api.add_open_search_data_source("ds", domain)
19581
+ # my_role: iam.Role
19446
19582
 
19447
- ds.create_resolver("QueryGetTestsResolver",
19448
- type_name="Query",
19449
- field_name="getTests",
19450
- request_mapping_template=appsync.MappingTemplate.from_string(JSON.stringify({
19451
- "version": "2017-02-28",
19452
- "operation": "GET",
19453
- "path": "/id/post/_search",
19454
- "params": {
19455
- "headers": {},
19456
- "query_string": {},
19457
- "body": {"from": 0, "size": 50}
19458
- }
19459
- })),
19460
- response_mapping_template=appsync.MappingTemplate.from_string("""[
19461
- #foreach($entry in $context.result.hits.hits)
19462
- #if( $velocityCount > 1 ) , #end
19463
- $utils.toJson($entry.get("_source"))
19464
- #end
19465
- ]""")
19583
+ cr.AwsCustomResource(self, "Customized",
19584
+ role=my_role, # must be assumable by the `lambda.amazonaws.com` service principal
19585
+ timeout=Duration.minutes(10), # defaults to 2 minutes
19586
+ memory_size=1025, # defaults to 512 if installLatestAwsSdk is true
19587
+ log_group=logs.LogGroup(self, "AwsCustomResourceLogs",
19588
+ retention=logs.RetentionDays.ONE_DAY
19589
+ ),
19590
+ function_name="my-custom-name", # defaults to a CloudFormation generated name
19591
+ removal_policy=RemovalPolicy.RETAIN, # defaults to `RemovalPolicy.DESTROY`
19592
+ policy=cr.AwsCustomResourcePolicy.from_sdk_calls(
19593
+ resources=cr.AwsCustomResourcePolicy.ANY_RESOURCE
19594
+ )
19466
19595
  )
19467
19596
  '''
19468
19597
 
@@ -22319,6 +22448,7 @@ class StackSynthesizer(
22319
22448
  source_hash: builtins.str,
22320
22449
  asset_name: typing.Optional[builtins.str] = None,
22321
22450
  directory_name: typing.Optional[builtins.str] = None,
22451
+ display_name: typing.Optional[builtins.str] = None,
22322
22452
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
22323
22453
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
22324
22454
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -22345,6 +22475,7 @@ class StackSynthesizer(
22345
22475
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
22346
22476
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
22347
22477
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
22478
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
22348
22479
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
22349
22480
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
22350
22481
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -22367,6 +22498,7 @@ class StackSynthesizer(
22367
22498
  *,
22368
22499
  source_hash: builtins.str,
22369
22500
  deploy_time: typing.Optional[builtins.bool] = None,
22501
+ display_name: typing.Optional[builtins.str] = None,
22370
22502
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
22371
22503
  file_name: typing.Optional[builtins.str] = None,
22372
22504
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -22383,6 +22515,7 @@ class StackSynthesizer(
22383
22515
 
22384
22516
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
22385
22517
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
22518
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
22386
22519
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
22387
22520
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
22388
22521
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -22675,6 +22808,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22675
22808
  source_hash: builtins.str,
22676
22809
  asset_name: typing.Optional[builtins.str] = None,
22677
22810
  directory_name: typing.Optional[builtins.str] = None,
22811
+ display_name: typing.Optional[builtins.str] = None,
22678
22812
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
22679
22813
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
22680
22814
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -22701,6 +22835,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22701
22835
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
22702
22836
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
22703
22837
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
22838
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
22704
22839
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
22705
22840
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
22706
22841
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -22718,6 +22853,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22718
22853
  source_hash=source_hash,
22719
22854
  asset_name=asset_name,
22720
22855
  directory_name=directory_name,
22856
+ display_name=display_name,
22721
22857
  docker_build_args=docker_build_args,
22722
22858
  docker_build_secrets=docker_build_secrets,
22723
22859
  docker_build_ssh=docker_build_ssh,
@@ -22740,6 +22876,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22740
22876
  *,
22741
22877
  source_hash: builtins.str,
22742
22878
  deploy_time: typing.Optional[builtins.bool] = None,
22879
+ display_name: typing.Optional[builtins.str] = None,
22743
22880
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
22744
22881
  file_name: typing.Optional[builtins.str] = None,
22745
22882
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -22756,6 +22893,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22756
22893
 
22757
22894
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
22758
22895
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
22896
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
22759
22897
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
22760
22898
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
22761
22899
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -22763,6 +22901,7 @@ class _StackSynthesizerProxy(StackSynthesizer):
22763
22901
  asset = FileAssetSource(
22764
22902
  source_hash=source_hash,
22765
22903
  deploy_time=deploy_time,
22904
+ display_name=display_name,
22766
22905
  executable=executable,
22767
22906
  file_name=file_name,
22768
22907
  packaging=packaging,
@@ -32538,7 +32677,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
32538
32677
  You must acknowledge IAM capabilities for nested stacks that contain IAM resources. Also, verify that you have cancel update stack permissions, which is required if an update rolls back. For more information about IAM and CloudFormation , see `Controlling access with AWS Identity and Access Management <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html>`_ in the *AWS CloudFormation User Guide* .
32539
32678
  .. epigraph::
32540
32679
 
32541
- A subset of ``AWS::CloudFormation::Stack`` resource type properties listed below are available to customers using CloudFormation , AWS CDK , and AWS Cloud Control API to configure.
32680
+ A subset of ``AWS::CloudFormation::Stack`` resource type properties listed below are available to customers using CloudFormation , AWS CDK , and Cloud Control to configure.
32542
32681
 
32543
32682
  - ``NotificationARNs``
32544
32683
  - ``Parameters``
@@ -32546,7 +32685,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
32546
32685
  - ``TemplateURL``
32547
32686
  - ``TimeoutInMinutes``
32548
32687
 
32549
- These properties can be configured only when using AWS Cloud Control API . This is because the below properties are set by the parent stack, and thus cannot be configured using CloudFormation or AWS CDK but only AWS Cloud Control API .
32688
+ These properties can be configured only when using Cloud Control . This is because the below properties are set by the parent stack, and thus cannot be configured using CloudFormation or AWS CDK but only Cloud Control .
32550
32689
 
32551
32690
  - ``Capabilities``
32552
32691
  - ``Description``
@@ -32561,7 +32700,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
32561
32700
 
32562
32701
  Customers that configure ``AWS::CloudFormation::Stack`` using CloudFormation and AWS CDK can do so for nesting a CloudFormation stack as a resource in their top-level template.
32563
32702
 
32564
- These read-only properties can be accessed only when using AWS Cloud Control API .
32703
+ These read-only properties can be accessed only when using Cloud Control .
32565
32704
 
32566
32705
  - ``ChangeSetId``
32567
32706
  - ``CreationTime``
@@ -35545,6 +35684,7 @@ class LegacyStackSynthesizer(
35545
35684
  source_hash: builtins.str,
35546
35685
  asset_name: typing.Optional[builtins.str] = None,
35547
35686
  directory_name: typing.Optional[builtins.str] = None,
35687
+ display_name: typing.Optional[builtins.str] = None,
35548
35688
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
35549
35689
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
35550
35690
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -35571,6 +35711,7 @@ class LegacyStackSynthesizer(
35571
35711
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
35572
35712
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
35573
35713
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
35714
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
35574
35715
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
35575
35716
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
35576
35717
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -35588,6 +35729,7 @@ class LegacyStackSynthesizer(
35588
35729
  source_hash=source_hash,
35589
35730
  asset_name=asset_name,
35590
35731
  directory_name=directory_name,
35732
+ display_name=display_name,
35591
35733
  docker_build_args=docker_build_args,
35592
35734
  docker_build_secrets=docker_build_secrets,
35593
35735
  docker_build_ssh=docker_build_ssh,
@@ -35610,6 +35752,7 @@ class LegacyStackSynthesizer(
35610
35752
  *,
35611
35753
  source_hash: builtins.str,
35612
35754
  deploy_time: typing.Optional[builtins.bool] = None,
35755
+ display_name: typing.Optional[builtins.str] = None,
35613
35756
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
35614
35757
  file_name: typing.Optional[builtins.str] = None,
35615
35758
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -35626,6 +35769,7 @@ class LegacyStackSynthesizer(
35626
35769
 
35627
35770
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
35628
35771
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
35772
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
35629
35773
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
35630
35774
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
35631
35775
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -35633,6 +35777,7 @@ class LegacyStackSynthesizer(
35633
35777
  asset = FileAssetSource(
35634
35778
  source_hash=source_hash,
35635
35779
  deploy_time=deploy_time,
35780
+ display_name=display_name,
35636
35781
  executable=executable,
35637
35782
  file_name=file_name,
35638
35783
  packaging=packaging,
@@ -35862,6 +36007,7 @@ class NestedStackSynthesizer(
35862
36007
  source_hash: builtins.str,
35863
36008
  asset_name: typing.Optional[builtins.str] = None,
35864
36009
  directory_name: typing.Optional[builtins.str] = None,
36010
+ display_name: typing.Optional[builtins.str] = None,
35865
36011
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
35866
36012
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
35867
36013
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -35888,6 +36034,7 @@ class NestedStackSynthesizer(
35888
36034
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
35889
36035
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
35890
36036
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
36037
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
35891
36038
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
35892
36039
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
35893
36040
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -35905,6 +36052,7 @@ class NestedStackSynthesizer(
35905
36052
  source_hash=source_hash,
35906
36053
  asset_name=asset_name,
35907
36054
  directory_name=directory_name,
36055
+ display_name=display_name,
35908
36056
  docker_build_args=docker_build_args,
35909
36057
  docker_build_secrets=docker_build_secrets,
35910
36058
  docker_build_ssh=docker_build_ssh,
@@ -35927,6 +36075,7 @@ class NestedStackSynthesizer(
35927
36075
  *,
35928
36076
  source_hash: builtins.str,
35929
36077
  deploy_time: typing.Optional[builtins.bool] = None,
36078
+ display_name: typing.Optional[builtins.str] = None,
35930
36079
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
35931
36080
  file_name: typing.Optional[builtins.str] = None,
35932
36081
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -35943,6 +36092,7 @@ class NestedStackSynthesizer(
35943
36092
 
35944
36093
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
35945
36094
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
36095
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
35946
36096
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
35947
36097
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
35948
36098
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -35950,6 +36100,7 @@ class NestedStackSynthesizer(
35950
36100
  asset = FileAssetSource(
35951
36101
  source_hash=source_hash,
35952
36102
  deploy_time=deploy_time,
36103
+ display_name=display_name,
35953
36104
  executable=executable,
35954
36105
  file_name=file_name,
35955
36106
  packaging=packaging,
@@ -36128,6 +36279,7 @@ class CliCredentialsStackSynthesizer(
36128
36279
  source_hash: builtins.str,
36129
36280
  asset_name: typing.Optional[builtins.str] = None,
36130
36281
  directory_name: typing.Optional[builtins.str] = None,
36282
+ display_name: typing.Optional[builtins.str] = None,
36131
36283
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36132
36284
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36133
36285
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -36154,6 +36306,7 @@ class CliCredentialsStackSynthesizer(
36154
36306
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
36155
36307
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
36156
36308
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
36309
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36157
36310
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
36158
36311
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
36159
36312
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -36171,6 +36324,7 @@ class CliCredentialsStackSynthesizer(
36171
36324
  source_hash=source_hash,
36172
36325
  asset_name=asset_name,
36173
36326
  directory_name=directory_name,
36327
+ display_name=display_name,
36174
36328
  docker_build_args=docker_build_args,
36175
36329
  docker_build_secrets=docker_build_secrets,
36176
36330
  docker_build_ssh=docker_build_ssh,
@@ -36193,6 +36347,7 @@ class CliCredentialsStackSynthesizer(
36193
36347
  *,
36194
36348
  source_hash: builtins.str,
36195
36349
  deploy_time: typing.Optional[builtins.bool] = None,
36350
+ display_name: typing.Optional[builtins.str] = None,
36196
36351
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
36197
36352
  file_name: typing.Optional[builtins.str] = None,
36198
36353
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -36209,6 +36364,7 @@ class CliCredentialsStackSynthesizer(
36209
36364
 
36210
36365
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
36211
36366
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
36367
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36212
36368
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
36213
36369
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
36214
36370
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -36216,6 +36372,7 @@ class CliCredentialsStackSynthesizer(
36216
36372
  asset = FileAssetSource(
36217
36373
  source_hash=source_hash,
36218
36374
  deploy_time=deploy_time,
36375
+ display_name=display_name,
36219
36376
  executable=executable,
36220
36377
  file_name=file_name,
36221
36378
  packaging=packaging,
@@ -36386,6 +36543,7 @@ class DefaultStackSynthesizer(
36386
36543
  source_hash: builtins.str,
36387
36544
  asset_name: typing.Optional[builtins.str] = None,
36388
36545
  directory_name: typing.Optional[builtins.str] = None,
36546
+ display_name: typing.Optional[builtins.str] = None,
36389
36547
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36390
36548
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36391
36549
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -36412,6 +36570,7 @@ class DefaultStackSynthesizer(
36412
36570
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
36413
36571
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
36414
36572
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
36573
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36415
36574
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
36416
36575
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
36417
36576
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -36429,6 +36588,7 @@ class DefaultStackSynthesizer(
36429
36588
  source_hash=source_hash,
36430
36589
  asset_name=asset_name,
36431
36590
  directory_name=directory_name,
36591
+ display_name=display_name,
36432
36592
  docker_build_args=docker_build_args,
36433
36593
  docker_build_secrets=docker_build_secrets,
36434
36594
  docker_build_ssh=docker_build_ssh,
@@ -36451,6 +36611,7 @@ class DefaultStackSynthesizer(
36451
36611
  *,
36452
36612
  source_hash: builtins.str,
36453
36613
  deploy_time: typing.Optional[builtins.bool] = None,
36614
+ display_name: typing.Optional[builtins.str] = None,
36454
36615
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
36455
36616
  file_name: typing.Optional[builtins.str] = None,
36456
36617
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -36467,6 +36628,7 @@ class DefaultStackSynthesizer(
36467
36628
 
36468
36629
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
36469
36630
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
36631
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36470
36632
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
36471
36633
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
36472
36634
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -36474,6 +36636,7 @@ class DefaultStackSynthesizer(
36474
36636
  asset = FileAssetSource(
36475
36637
  source_hash=source_hash,
36476
36638
  deploy_time=deploy_time,
36639
+ display_name=display_name,
36477
36640
  executable=executable,
36478
36641
  file_name=file_name,
36479
36642
  packaging=packaging,
@@ -36703,6 +36866,7 @@ class BootstraplessSynthesizer(
36703
36866
  source_hash: builtins.str,
36704
36867
  asset_name: typing.Optional[builtins.str] = None,
36705
36868
  directory_name: typing.Optional[builtins.str] = None,
36869
+ display_name: typing.Optional[builtins.str] = None,
36706
36870
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36707
36871
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
36708
36872
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -36729,6 +36893,7 @@ class BootstraplessSynthesizer(
36729
36893
  :param source_hash: The hash of the contents of the docker build context. This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change. NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).
36730
36894
  :param asset_name: Unique identifier of the docker image asset and its potential revisions. Required if using AppScopedStagingSynthesizer. Default: - no asset name
36731
36895
  :param directory_name: The directory where the Dockerfile is stored, must be relative to the cloud assembly root. Default: - Exactly one of ``directoryName`` and ``executable`` is required
36896
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36732
36897
  :param docker_build_args: Build args to pass to the ``docker build`` command. Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build args are passed
36733
36898
  :param docker_build_secrets: Build secrets to pass to the ``docker build`` command. Since Docker build secrets are resolved before deployment, keys and values cannot refer to unresolved tokens (such as ``lambda.functionArn`` or ``queue.queueUrl``). Only allowed when ``directoryName`` is specified. Default: - no build secrets are passed
36734
36899
  :param docker_build_ssh: SSH agent socket or keys to pass to the ``docker buildx`` command. Default: - no ssh arg is passed
@@ -36746,6 +36911,7 @@ class BootstraplessSynthesizer(
36746
36911
  source_hash=source_hash,
36747
36912
  asset_name=asset_name,
36748
36913
  directory_name=directory_name,
36914
+ display_name=display_name,
36749
36915
  docker_build_args=docker_build_args,
36750
36916
  docker_build_secrets=docker_build_secrets,
36751
36917
  docker_build_ssh=docker_build_ssh,
@@ -36768,6 +36934,7 @@ class BootstraplessSynthesizer(
36768
36934
  *,
36769
36935
  source_hash: builtins.str,
36770
36936
  deploy_time: typing.Optional[builtins.bool] = None,
36937
+ display_name: typing.Optional[builtins.str] = None,
36771
36938
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
36772
36939
  file_name: typing.Optional[builtins.str] = None,
36773
36940
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -36784,6 +36951,7 @@ class BootstraplessSynthesizer(
36784
36951
 
36785
36952
  :param source_hash: A hash on the content source. This hash is used to uniquely identify this asset throughout the system. If this value doesn't change, the asset will not be rebuilt or republished.
36786
36953
  :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
36954
+ :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. Default: - The asset hash is used to display the asset
36787
36955
  :param executable: An external command that will produce the packaged asset. The command should produce the location of a ZIP file on ``stdout``. Default: - Exactly one of ``fileName`` and ``executable`` is required
36788
36956
  :param file_name: The path, relative to the root of the cloud assembly, in which this asset source resides. This can be a path to a file or a directory, depending on the packaging type. Default: - Exactly one of ``fileName`` and ``executable`` is required
36789
36957
  :param packaging: Which type of packaging to perform. Default: - Required if ``fileName`` is specified.
@@ -36791,6 +36959,7 @@ class BootstraplessSynthesizer(
36791
36959
  _asset = FileAssetSource(
36792
36960
  source_hash=source_hash,
36793
36961
  deploy_time=deploy_time,
36962
+ display_name=display_name,
36794
36963
  executable=executable,
36795
36964
  file_name=file_name,
36796
36965
  packaging=packaging,
@@ -36811,6 +36980,8 @@ class BootstraplessSynthesizer(
36811
36980
 
36812
36981
 
36813
36982
  __all__ = [
36983
+ "AddDockerImageAssetOptions",
36984
+ "AddFileAssetOptions",
36814
36985
  "Annotations",
36815
36986
  "App",
36816
36987
  "AppProps",
@@ -37648,6 +37819,20 @@ from . import pipelines
37648
37819
  from . import region_info
37649
37820
  from . import triggers
37650
37821
 
37822
+ def _typecheckingstub__5a1ac212aad6af3e005718717aa2d00b8a797e24b74644f38d11d9f5ced18b43(
37823
+ *,
37824
+ display_name: typing.Optional[builtins.str] = None,
37825
+ ) -> None:
37826
+ """Type checking stubs"""
37827
+ pass
37828
+
37829
+ def _typecheckingstub__3b7bb14c4d35bab2918fcff6fafc6bf8560391fa80cf7e743756928a3ff744a2(
37830
+ *,
37831
+ display_name: typing.Optional[builtins.str] = None,
37832
+ ) -> None:
37833
+ """Type checking stubs"""
37834
+ pass
37835
+
37651
37836
  def _typecheckingstub__cfddeb4c359528028785fb7ca8a01e86bcda81d53c82cdaef6ad18dd0520ab91(
37652
37837
  scope: _constructs_77d1e7e8.IConstruct,
37653
37838
  ) -> None:
@@ -37781,13 +37966,9 @@ def _typecheckingstub__e4e4609083793a8b31752be2f457b6b1f1220145a70469bafc48a1428
37781
37966
  stack: Stack,
37782
37967
  source_hash: builtins.str,
37783
37968
  source: typing.Union[_DockerImageSource_5db2cfa3, typing.Dict[builtins.str, typing.Any]],
37969
+ dest: typing.Union[_DockerImageDestination_132046c7, typing.Dict[builtins.str, typing.Any]],
37784
37970
  *,
37785
- image_tag: builtins.str,
37786
- repository_name: builtins.str,
37787
- assume_role_additional_options: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
37788
- assume_role_arn: typing.Optional[builtins.str] = None,
37789
- assume_role_external_id: typing.Optional[builtins.str] = None,
37790
- region: typing.Optional[builtins.str] = None,
37971
+ display_name: typing.Optional[builtins.str] = None,
37791
37972
  ) -> None:
37792
37973
  """Type checking stubs"""
37793
37974
  pass
@@ -37796,13 +37977,9 @@ def _typecheckingstub__f12f649e9db582bca540895dead136ba4f8ce5c52abc11eb50e5224da
37796
37977
  stack: Stack,
37797
37978
  source_hash: builtins.str,
37798
37979
  source: typing.Union[_FileSource_66254048, typing.Dict[builtins.str, typing.Any]],
37980
+ dest: typing.Union[_FileDestination_7d285b38, typing.Dict[builtins.str, typing.Any]],
37799
37981
  *,
37800
- bucket_name: builtins.str,
37801
- object_key: builtins.str,
37802
- assume_role_additional_options: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
37803
- assume_role_arn: typing.Optional[builtins.str] = None,
37804
- assume_role_external_id: typing.Optional[builtins.str] = None,
37805
- region: typing.Optional[builtins.str] = None,
37982
+ display_name: typing.Optional[builtins.str] = None,
37806
37983
  ) -> None:
37807
37984
  """Type checking stubs"""
37808
37985
  pass
@@ -37810,10 +37987,9 @@ def _typecheckingstub__f12f649e9db582bca540895dead136ba4f8ce5c52abc11eb50e5224da
37810
37987
  def _typecheckingstub__d8572c82a112aaa61153d2b958b8042f9e061141b483b1b0ce6429f9f7c11296(
37811
37988
  stack: Stack,
37812
37989
  asset: typing.Union[DockerImageAssetSource, typing.Dict[builtins.str, typing.Any]],
37990
+ target: typing.Union[AssetManifestDockerImageDestination, typing.Dict[builtins.str, typing.Any]],
37813
37991
  *,
37814
- repository_name: builtins.str,
37815
- docker_tag_prefix: typing.Optional[builtins.str] = None,
37816
- role: typing.Optional[typing.Union[RoleOptions, typing.Dict[builtins.str, typing.Any]]] = None,
37992
+ display_name: typing.Optional[builtins.str] = None,
37817
37993
  ) -> None:
37818
37994
  """Type checking stubs"""
37819
37995
  pass
@@ -37821,10 +37997,9 @@ def _typecheckingstub__d8572c82a112aaa61153d2b958b8042f9e061141b483b1b0ce6429f9f
37821
37997
  def _typecheckingstub__085bf08106379af70653604775528303d429c31168f56c2439ed96f6b61197be(
37822
37998
  stack: Stack,
37823
37999
  asset: typing.Union[FileAssetSource, typing.Dict[builtins.str, typing.Any]],
38000
+ target: typing.Union[AssetManifestFileDestination, typing.Dict[builtins.str, typing.Any]],
37824
38001
  *,
37825
- bucket_name: builtins.str,
37826
- bucket_prefix: typing.Optional[builtins.str] = None,
37827
- role: typing.Optional[typing.Union[RoleOptions, typing.Dict[builtins.str, typing.Any]]] = None,
38002
+ display_name: typing.Optional[builtins.str] = None,
37828
38003
  ) -> None:
37829
38004
  """Type checking stubs"""
37830
38005
  pass
@@ -37925,6 +38100,7 @@ def _typecheckingstub__64a4624c19dc262f58fbe1c1e7fe44bc86dfef800d569565b2a5f863d
37925
38100
  def _typecheckingstub__085b6d44b1c6b74e8060adbd78e13b1a188913a88389f19dce989d64cd5d0b7b(
37926
38101
  *,
37927
38102
  max_batch_size: typing.Optional[jsii.Number] = None,
38103
+ min_active_instances_percent: typing.Optional[jsii.Number] = None,
37928
38104
  min_instances_in_service: typing.Optional[jsii.Number] = None,
37929
38105
  min_successful_instances_percent: typing.Optional[jsii.Number] = None,
37930
38106
  pause_time: typing.Optional[builtins.str] = None,
@@ -38871,6 +39047,7 @@ def _typecheckingstub__9dc551978a96bea78751c4b4d32e87775d67d2a68f351884cf05c35d5
38871
39047
  source_hash: builtins.str,
38872
39048
  asset_name: typing.Optional[builtins.str] = None,
38873
39049
  directory_name: typing.Optional[builtins.str] = None,
39050
+ display_name: typing.Optional[builtins.str] = None,
38874
39051
  docker_build_args: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
38875
39052
  docker_build_secrets: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
38876
39053
  docker_build_ssh: typing.Optional[builtins.str] = None,
@@ -39071,6 +39248,7 @@ def _typecheckingstub__6a2ffcc71f7081ed98f77dcff398894a56d300191a4893d6469a2218f
39071
39248
  *,
39072
39249
  source_hash: builtins.str,
39073
39250
  deploy_time: typing.Optional[builtins.bool] = None,
39251
+ display_name: typing.Optional[builtins.str] = None,
39074
39252
  executable: typing.Optional[typing.Sequence[builtins.str]] = None,
39075
39253
  file_name: typing.Optional[builtins.str] = None,
39076
39254
  packaging: typing.Optional[FileAssetPackaging] = None,
@@ -39777,6 +39955,12 @@ def _typecheckingstub__569ac5c6adbac9575b4137a0343aea0625df007d849957bfacf2e65a0
39777
39955
  """Type checking stubs"""
39778
39956
  pass
39779
39957
 
39958
+ def _typecheckingstub__307d610951ef0b232f9222edc6ac5421fa347060bc21fb75e850a338e9aa77c7(
39959
+ construct: _constructs_77d1e7e8.IConstruct,
39960
+ ) -> None:
39961
+ """Type checking stubs"""
39962
+ pass
39963
+
39780
39964
  def _typecheckingstub__8c1ba4bae2d17f227472b42e48bc60d8c4a5dd7a3c60793d3b332fc432589917(
39781
39965
  construct: _constructs_77d1e7e8.IConstruct,
39782
39966
  ) -> None: