aws-cdk-lib 2.176.0__py3-none-any.whl → 2.177.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 (44) hide show
  1. aws_cdk/__init__.py +11 -1
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.176.0.jsii.tgz → aws-cdk-lib@2.177.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_apigatewayv2_integrations/__init__.py +2 -2
  5. aws_cdk/aws_appsync/__init__.py +4 -3
  6. aws_cdk/aws_batch/__init__.py +4 -2
  7. aws_cdk/aws_bedrock/__init__.py +5395 -2508
  8. aws_cdk/aws_cloudfront/__init__.py +12 -2
  9. aws_cdk/aws_cloudfront_origins/__init__.py +33 -2
  10. aws_cdk/aws_codepipeline/__init__.py +35 -0
  11. aws_cdk/aws_cognito/__init__.py +162 -139
  12. aws_cdk/aws_customerprofiles/__init__.py +3 -3
  13. aws_cdk/aws_datazone/__init__.py +195 -125
  14. aws_cdk/aws_ec2/__init__.py +5 -3
  15. aws_cdk/aws_ecs/__init__.py +27 -8
  16. aws_cdk/aws_efs/__init__.py +5 -5
  17. aws_cdk/aws_eks/__init__.py +24 -3
  18. aws_cdk/aws_emrserverless/__init__.py +86 -0
  19. aws_cdk/aws_fms/__init__.py +42 -0
  20. aws_cdk/aws_gamelift/__init__.py +8 -10
  21. aws_cdk/aws_iam/__init__.py +8 -0
  22. aws_cdk/aws_imagebuilder/__init__.py +62 -48
  23. aws_cdk/aws_lambda/__init__.py +13 -0
  24. aws_cdk/aws_logs/__init__.py +59 -59
  25. aws_cdk/aws_notifications/__init__.py +1390 -0
  26. aws_cdk/aws_notificationscontacts/__init__.py +593 -0
  27. aws_cdk/aws_rds/__init__.py +16 -22
  28. aws_cdk/aws_redshift/__init__.py +9 -5
  29. aws_cdk/aws_route53/__init__.py +4 -4
  30. aws_cdk/aws_route53_targets/__init__.py +15 -15
  31. aws_cdk/aws_s3/__init__.py +789 -0
  32. aws_cdk/aws_s3_notifications/__init__.py +5 -5
  33. aws_cdk/aws_s3tables/__init__.py +2 -2
  34. aws_cdk/aws_sns/__init__.py +39 -0
  35. aws_cdk/aws_ssm/__init__.py +5 -5
  36. aws_cdk/aws_synthetics/__init__.py +105 -32
  37. aws_cdk/cloud_assembly_schema/__init__.py +63 -4
  38. aws_cdk/cx_api/__init__.py +44 -4
  39. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/METADATA +3 -3
  40. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/RECORD +44 -42
  41. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/LICENSE +0 -0
  42. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/NOTICE +0 -0
  43. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/WHEEL +0 -0
  44. {aws_cdk_lib-2.176.0.dist-info → aws_cdk_lib-2.177.0.dist-info}/top_level.txt +0 -0
@@ -8389,8 +8389,8 @@ class CfnGameSessionQueue(
8389
8389
 
8390
8390
  Changing the priority order will affect how game sessions are placed.
8391
8391
 
8392
- :param location_order: The prioritization order to use for fleet locations, when the ``PriorityOrder`` property includes ``LOCATION`` . Locations are identified by AWS Region codes such as ``us-west-2`` . Each location can only be listed once.
8393
- :param priority_order: The recommended sequence to use when prioritizing where to place new game sessions. Each type can only be listed once. - ``LATENCY`` -- FleetIQ prioritizes locations where the average player latency (provided in each game session request) is lowest. - ``COST`` -- FleetIQ prioritizes destinations with the lowest current hosting costs. Cost is evaluated based on the location, instance type, and fleet type (Spot or On-Demand) for each destination in the queue. - ``DESTINATION`` -- FleetIQ prioritizes based on the order that destinations are listed in the queue configuration. - ``LOCATION`` -- FleetIQ prioritizes based on the provided order of locations, as defined in ``LocationOrder`` .
8392
+ :param location_order: The prioritization order to use for fleet locations, when the ``PriorityOrder`` property includes ``LOCATION`` . Locations can include AWS Region codes (such as ``us-west-2`` ), local zones, and custom locations (for Anywhere fleets). Each location must be listed only once. For details, see `Amazon GameLift service locations. <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-regions.html>`_
8393
+ :param priority_order: A custom sequence to use when prioritizing where to place new game sessions. Each priority type is listed once. - ``LATENCY`` -- Amazon GameLift prioritizes locations where the average player latency is lowest. Player latency data is provided in each game session placement request. - ``COST`` -- Amazon GameLift prioritizes destinations with the lowest current hosting costs. Cost is evaluated based on the location, instance type, and fleet type (Spot or On-Demand) of each destination in the queue. - ``DESTINATION`` -- Amazon GameLift prioritizes based on the list order of destinations in the queue configuration. - ``LOCATION`` -- Amazon GameLift prioritizes based on the provided order of locations, as defined in ``LocationOrder`` .
8394
8394
 
8395
8395
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-gamelift-gamesessionqueue-priorityconfiguration.html
8396
8396
  :exampleMetadata: fixture=_generated
@@ -8420,7 +8420,7 @@ class CfnGameSessionQueue(
8420
8420
  def location_order(self) -> typing.Optional[typing.List[builtins.str]]:
8421
8421
  '''The prioritization order to use for fleet locations, when the ``PriorityOrder`` property includes ``LOCATION`` .
8422
8422
 
8423
- Locations are identified by AWS Region codes such as ``us-west-2`` . Each location can only be listed once.
8423
+ Locations can include AWS Region codes (such as ``us-west-2`` ), local zones, and custom locations (for Anywhere fleets). Each location must be listed only once. For details, see `Amazon GameLift service locations. <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-regions.html>`_
8424
8424
 
8425
8425
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-gamelift-gamesessionqueue-priorityconfiguration.html#cfn-gamelift-gamesessionqueue-priorityconfiguration-locationorder
8426
8426
  '''
@@ -8429,14 +8429,12 @@ class CfnGameSessionQueue(
8429
8429
 
8430
8430
  @builtins.property
8431
8431
  def priority_order(self) -> typing.Optional[typing.List[builtins.str]]:
8432
- '''The recommended sequence to use when prioritizing where to place new game sessions.
8432
+ '''A custom sequence to use when prioritizing where to place new game sessions. Each priority type is listed once.
8433
8433
 
8434
- Each type can only be listed once.
8435
-
8436
- - ``LATENCY`` -- FleetIQ prioritizes locations where the average player latency (provided in each game session request) is lowest.
8437
- - ``COST`` -- FleetIQ prioritizes destinations with the lowest current hosting costs. Cost is evaluated based on the location, instance type, and fleet type (Spot or On-Demand) for each destination in the queue.
8438
- - ``DESTINATION`` -- FleetIQ prioritizes based on the order that destinations are listed in the queue configuration.
8439
- - ``LOCATION`` -- FleetIQ prioritizes based on the provided order of locations, as defined in ``LocationOrder`` .
8434
+ - ``LATENCY`` -- Amazon GameLift prioritizes locations where the average player latency is lowest. Player latency data is provided in each game session placement request.
8435
+ - ``COST`` -- Amazon GameLift prioritizes destinations with the lowest current hosting costs. Cost is evaluated based on the location, instance type, and fleet type (Spot or On-Demand) of each destination in the queue.
8436
+ - ``DESTINATION`` -- Amazon GameLift prioritizes based on the list order of destinations in the queue configuration.
8437
+ - ``LOCATION`` -- Amazon GameLift prioritizes based on the provided order of locations, as defined in ``LocationOrder`` .
8440
8438
 
8441
8439
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-gamelift-gamesessionqueue-priorityconfiguration.html#cfn-gamelift-gamesessionqueue-priorityconfiguration-priorityorder
8442
8440
  '''
@@ -724,6 +724,14 @@ thumbprint of the root certificate authority (CA) will automatically be obtained
724
724
  from the host as described
725
725
  [here](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc_verify-thumbprint.html).
726
726
 
727
+ Byy default, the custom resource enforces strict security practices by rejecting
728
+ any unauthorized connections when downloading CA thumbprints from the issuer URL.
729
+ If you need to connect to an unauthorized OIDC identity provider and understand the
730
+ implications, you can disable this behavior by setting the feature flag
731
+ `IAM_OIDC_REJECT_UNAUTHORIZED_CONNECTIONS` to `false` in your `cdk.context.json`
732
+ or `cdk.json`. Visit [CDK Feature Flag](https://docs.aws.amazon.com/cdk/v2/guide/featureflags.html)
733
+ for more information on how to configure feature flags.
734
+
727
735
  Once you define an OpenID connect provider, you can use it with AWS services
728
736
  that expect an IAM OIDC provider. For example, when you define an [Amazon
729
737
  Cognito identity
@@ -3789,7 +3789,7 @@ class CfnImage(
3789
3789
  You must have at least one build component to create a recipe, but test components are not required. If you have added tests, they run after the image is created, to ensure that the target image is functional and can be used reliably for launching Amazon EC2 instances.
3790
3790
 
3791
3791
  :param image_tests_enabled: Determines if tests should run after building the image. Image Builder defaults to enable tests to run following the image build, before image distribution.
3792
- :param timeout_minutes: The maximum time in minutes that tests are permitted to run. .. epigraph:: The timeout attribute is not currently active. This value is ignored.
3792
+ :param timeout_minutes: The maximum time in minutes that tests are permitted to run. .. epigraph:: The timeout property is not currently active. This value is ignored.
3793
3793
 
3794
3794
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-image-imagetestsconfiguration.html
3795
3795
  :exampleMetadata: fixture=_generated
@@ -3834,7 +3834,7 @@ class CfnImage(
3834
3834
 
3835
3835
  .. epigraph::
3836
3836
 
3837
- The timeout attribute is not currently active. This value is ignored.
3837
+ The timeout property is not currently active. This value is ignored.
3838
3838
 
3839
3839
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-image-imagetestsconfiguration.html#cfn-imagebuilder-image-imagetestsconfiguration-timeoutminutes
3840
3840
  '''
@@ -4609,7 +4609,7 @@ class CfnImagePipeline(
4609
4609
  You must have at least one build component to create a recipe, but test components are not required. Your pipeline runs tests after it builds the image, to ensure that the target image is functional and can be used reliably for launching Amazon EC2 instances.
4610
4610
 
4611
4611
  :param image_tests_enabled: Defines if tests should be executed when building this image. For example, ``true`` or ``false`` .
4612
- :param timeout_minutes: The maximum time in minutes that tests are permitted to run. .. epigraph:: The timeout attribute is not currently active. This value is ignored.
4612
+ :param timeout_minutes: The maximum time in minutes that tests are permitted to run. .. epigraph:: The timeout property is not currently active. This value is ignored.
4613
4613
 
4614
4614
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-imagepipeline-imagetestsconfiguration.html
4615
4615
  :exampleMetadata: fixture=_generated
@@ -4654,7 +4654,7 @@ class CfnImagePipeline(
4654
4654
 
4655
4655
  .. epigraph::
4656
4656
 
4657
- The timeout attribute is not currently active. This value is ignored.
4657
+ The timeout property is not currently active. This value is ignored.
4658
4658
 
4659
4659
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-imagebuilder-imagepipeline-imagetestsconfiguration.html#cfn-imagebuilder-imagepipeline-imagetestsconfiguration-timeoutminutes
4660
4660
  '''
@@ -6597,9 +6597,9 @@ class CfnInfrastructureConfiguration(
6597
6597
  metaclass=jsii.JSIIMeta,
6598
6598
  jsii_type="aws-cdk-lib.aws_imagebuilder.CfnInfrastructureConfiguration",
6599
6599
  ):
6600
- '''The infrastructure configuration allows you to specify the infrastructure within which to build and test your image.
6600
+ '''Creates a new infrastructure configuration.
6601
6601
 
6602
- In the infrastructure configuration, you can specify instance types, subnets, and security groups to associate with your instance. You can also associate an Amazon EC2 key pair with the instance used to build your image. This allows you to log on to your instance to troubleshoot if your build fails and you set terminateInstanceOnFailure to false.
6602
+ An infrastructure configuration defines the environment in which your image will be built and tested.
6603
6603
 
6604
6604
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html
6605
6605
  :cloudformationResource: AWS::ImageBuilder::InfrastructureConfiguration
@@ -6671,20 +6671,20 @@ class CfnInfrastructureConfiguration(
6671
6671
  '''
6672
6672
  :param scope: Scope in which this resource is defined.
6673
6673
  :param id: Construct identifier for this resource (unique in its scope).
6674
- :param instance_profile_name: The instance profile of the infrastructure configuration.
6674
+ :param instance_profile_name: The instance profile to associate with the instance used to customize your Amazon EC2 AMI.
6675
6675
  :param name: The name of the infrastructure configuration.
6676
6676
  :param description: The description of the infrastructure configuration.
6677
- :param instance_metadata_options: The instance metadata option settings for the infrastructure configuration.
6678
- :param instance_types: The instance types of the infrastructure configuration.
6679
- :param key_pair: The Amazon EC2 key pair of the infrastructure configuration.
6680
- :param logging: The logging configuration defines where Image Builder uploads your logs.
6677
+ :param instance_metadata_options: The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.
6678
+ :param instance_types: The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.
6679
+ :param key_pair: The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.
6680
+ :param logging: The logging configuration of the infrastructure configuration.
6681
6681
  :param placement: The instance placement settings that define where the instances that are launched from your image will run.
6682
- :param resource_tags: The tags attached to the resource created by Image Builder.
6683
- :param security_group_ids: The security group IDs of the infrastructure configuration.
6684
- :param sns_topic_arn: The Amazon Resource Name (ARN) of the SNS topic for the infrastructure configuration.
6685
- :param subnet_id: The subnet ID of the infrastructure configuration.
6686
- :param tags: The tags of the infrastructure configuration.
6687
- :param terminate_instance_on_failure: The terminate instance on failure configuration of the infrastructure configuration.
6682
+ :param resource_tags: The metadata tags to assign to the Amazon EC2 instance that Image Builder launches during the build process. Tags are formatted as key value pairs.
6683
+ :param security_group_ids: The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.
6684
+ :param sns_topic_arn: The Amazon Resource Name (ARN) for the SNS topic to which we send image build event notifications. .. epigraph:: EC2 Image Builder is unable to send notifications to SNS topics that are encrypted using keys from other accounts. The key that is used to encrypt the SNS topic must reside in the account that the Image Builder service runs under.
6685
+ :param subnet_id: The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.
6686
+ :param tags: The metadata tags to assign to the infrastructure configuration resource that Image Builder creates as output. Tags are formatted as key value pairs.
6687
+ :param terminate_instance_on_failure: The terminate instance on failure setting of the infrastructure configuration. Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.
6688
6688
  '''
6689
6689
  if __debug__:
6690
6690
  type_hints = typing.get_type_hints(_typecheckingstub__8df8a03094d1fe92963a315a657a78657df102ba9fbe66eda2c26bb8eac04479)
@@ -6773,7 +6773,7 @@ class CfnInfrastructureConfiguration(
6773
6773
  @builtins.property
6774
6774
  @jsii.member(jsii_name="instanceProfileName")
6775
6775
  def instance_profile_name(self) -> builtins.str:
6776
- '''The instance profile of the infrastructure configuration.'''
6776
+ '''The instance profile to associate with the instance used to customize your Amazon EC2 AMI.'''
6777
6777
  return typing.cast(builtins.str, jsii.get(self, "instanceProfileName"))
6778
6778
 
6779
6779
  @instance_profile_name.setter
@@ -6814,7 +6814,7 @@ class CfnInfrastructureConfiguration(
6814
6814
  def instance_metadata_options(
6815
6815
  self,
6816
6816
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnInfrastructureConfiguration.InstanceMetadataOptionsProperty"]]:
6817
- '''The instance metadata option settings for the infrastructure configuration.'''
6817
+ '''The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.'''
6818
6818
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnInfrastructureConfiguration.InstanceMetadataOptionsProperty"]], jsii.get(self, "instanceMetadataOptions"))
6819
6819
 
6820
6820
  @instance_metadata_options.setter
@@ -6843,7 +6843,7 @@ class CfnInfrastructureConfiguration(
6843
6843
  @builtins.property
6844
6844
  @jsii.member(jsii_name="keyPair")
6845
6845
  def key_pair(self) -> typing.Optional[builtins.str]:
6846
- '''The Amazon EC2 key pair of the infrastructure configuration.'''
6846
+ '''The key pair of the infrastructure configuration.'''
6847
6847
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "keyPair"))
6848
6848
 
6849
6849
  @key_pair.setter
@@ -6858,7 +6858,7 @@ class CfnInfrastructureConfiguration(
6858
6858
  def logging(
6859
6859
  self,
6860
6860
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnInfrastructureConfiguration.LoggingProperty"]]:
6861
- '''The logging configuration defines where Image Builder uploads your logs.'''
6861
+ '''The logging configuration of the infrastructure configuration.'''
6862
6862
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnInfrastructureConfiguration.LoggingProperty"]], jsii.get(self, "logging"))
6863
6863
 
6864
6864
  @logging.setter
@@ -6894,7 +6894,7 @@ class CfnInfrastructureConfiguration(
6894
6894
  def resource_tags(
6895
6895
  self,
6896
6896
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
6897
- '''The tags attached to the resource created by Image Builder.'''
6897
+ '''The metadata tags to assign to the Amazon EC2 instance that Image Builder launches during the build process.'''
6898
6898
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]], jsii.get(self, "resourceTags"))
6899
6899
 
6900
6900
  @resource_tags.setter
@@ -6910,7 +6910,7 @@ class CfnInfrastructureConfiguration(
6910
6910
  @builtins.property
6911
6911
  @jsii.member(jsii_name="securityGroupIds")
6912
6912
  def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
6913
- '''The security group IDs of the infrastructure configuration.'''
6913
+ '''The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.'''
6914
6914
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "securityGroupIds"))
6915
6915
 
6916
6916
  @security_group_ids.setter
@@ -6926,7 +6926,7 @@ class CfnInfrastructureConfiguration(
6926
6926
  @builtins.property
6927
6927
  @jsii.member(jsii_name="snsTopicArn")
6928
6928
  def sns_topic_arn(self) -> typing.Optional[builtins.str]:
6929
- '''The Amazon Resource Name (ARN) of the SNS topic for the infrastructure configuration.'''
6929
+ '''The Amazon Resource Name (ARN) for the SNS topic to which we send image build event notifications.'''
6930
6930
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "snsTopicArn"))
6931
6931
 
6932
6932
  @sns_topic_arn.setter
@@ -6939,7 +6939,7 @@ class CfnInfrastructureConfiguration(
6939
6939
  @builtins.property
6940
6940
  @jsii.member(jsii_name="subnetId")
6941
6941
  def subnet_id(self) -> typing.Optional[builtins.str]:
6942
- '''The subnet ID of the infrastructure configuration.'''
6942
+ '''The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.'''
6943
6943
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "subnetId"))
6944
6944
 
6945
6945
  @subnet_id.setter
@@ -6952,7 +6952,7 @@ class CfnInfrastructureConfiguration(
6952
6952
  @builtins.property
6953
6953
  @jsii.member(jsii_name="tagsRaw")
6954
6954
  def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
6955
- '''The tags of the infrastructure configuration.'''
6955
+ '''The metadata tags to assign to the infrastructure configuration resource that Image Builder creates as output.'''
6956
6956
  return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
6957
6957
 
6958
6958
  @tags_raw.setter
@@ -6970,7 +6970,7 @@ class CfnInfrastructureConfiguration(
6970
6970
  def terminate_instance_on_failure(
6971
6971
  self,
6972
6972
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
6973
- '''The terminate instance on failure configuration of the infrastructure configuration.'''
6973
+ '''The terminate instance on failure setting of the infrastructure configuration.'''
6974
6974
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "terminateInstanceOnFailure"))
6975
6975
 
6976
6976
  @terminate_instance_on_failure.setter
@@ -7357,20 +7357,20 @@ class CfnInfrastructureConfigurationProps:
7357
7357
  ) -> None:
7358
7358
  '''Properties for defining a ``CfnInfrastructureConfiguration``.
7359
7359
 
7360
- :param instance_profile_name: The instance profile of the infrastructure configuration.
7360
+ :param instance_profile_name: The instance profile to associate with the instance used to customize your Amazon EC2 AMI.
7361
7361
  :param name: The name of the infrastructure configuration.
7362
7362
  :param description: The description of the infrastructure configuration.
7363
- :param instance_metadata_options: The instance metadata option settings for the infrastructure configuration.
7364
- :param instance_types: The instance types of the infrastructure configuration.
7365
- :param key_pair: The Amazon EC2 key pair of the infrastructure configuration.
7366
- :param logging: The logging configuration defines where Image Builder uploads your logs.
7363
+ :param instance_metadata_options: The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.
7364
+ :param instance_types: The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.
7365
+ :param key_pair: The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.
7366
+ :param logging: The logging configuration of the infrastructure configuration.
7367
7367
  :param placement: The instance placement settings that define where the instances that are launched from your image will run.
7368
- :param resource_tags: The tags attached to the resource created by Image Builder.
7369
- :param security_group_ids: The security group IDs of the infrastructure configuration.
7370
- :param sns_topic_arn: The Amazon Resource Name (ARN) of the SNS topic for the infrastructure configuration.
7371
- :param subnet_id: The subnet ID of the infrastructure configuration.
7372
- :param tags: The tags of the infrastructure configuration.
7373
- :param terminate_instance_on_failure: The terminate instance on failure configuration of the infrastructure configuration.
7368
+ :param resource_tags: The metadata tags to assign to the Amazon EC2 instance that Image Builder launches during the build process. Tags are formatted as key value pairs.
7369
+ :param security_group_ids: The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.
7370
+ :param sns_topic_arn: The Amazon Resource Name (ARN) for the SNS topic to which we send image build event notifications. .. epigraph:: EC2 Image Builder is unable to send notifications to SNS topics that are encrypted using keys from other accounts. The key that is used to encrypt the SNS topic must reside in the account that the Image Builder service runs under.
7371
+ :param subnet_id: The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.
7372
+ :param tags: The metadata tags to assign to the infrastructure configuration resource that Image Builder creates as output. Tags are formatted as key value pairs.
7373
+ :param terminate_instance_on_failure: The terminate instance on failure setting of the infrastructure configuration. Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.
7374
7374
 
7375
7375
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html
7376
7376
  :exampleMetadata: fixture=_generated
@@ -7464,7 +7464,7 @@ class CfnInfrastructureConfigurationProps:
7464
7464
 
7465
7465
  @builtins.property
7466
7466
  def instance_profile_name(self) -> builtins.str:
7467
- '''The instance profile of the infrastructure configuration.
7467
+ '''The instance profile to associate with the instance used to customize your Amazon EC2 AMI.
7468
7468
 
7469
7469
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-instanceprofilename
7470
7470
  '''
@@ -7495,7 +7495,7 @@ class CfnInfrastructureConfigurationProps:
7495
7495
  def instance_metadata_options(
7496
7496
  self,
7497
7497
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnInfrastructureConfiguration.InstanceMetadataOptionsProperty]]:
7498
- '''The instance metadata option settings for the infrastructure configuration.
7498
+ '''The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.
7499
7499
 
7500
7500
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-instancemetadataoptions
7501
7501
  '''
@@ -7506,6 +7506,8 @@ class CfnInfrastructureConfigurationProps:
7506
7506
  def instance_types(self) -> typing.Optional[typing.List[builtins.str]]:
7507
7507
  '''The instance types of the infrastructure configuration.
7508
7508
 
7509
+ You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.
7510
+
7509
7511
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-instancetypes
7510
7512
  '''
7511
7513
  result = self._values.get("instance_types")
@@ -7513,7 +7515,9 @@ class CfnInfrastructureConfigurationProps:
7513
7515
 
7514
7516
  @builtins.property
7515
7517
  def key_pair(self) -> typing.Optional[builtins.str]:
7516
- '''The Amazon EC2 key pair of the infrastructure configuration.
7518
+ '''The key pair of the infrastructure configuration.
7519
+
7520
+ You can use this to log on to and debug the instance used to create your image.
7517
7521
 
7518
7522
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-keypair
7519
7523
  '''
@@ -7524,7 +7528,7 @@ class CfnInfrastructureConfigurationProps:
7524
7528
  def logging(
7525
7529
  self,
7526
7530
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnInfrastructureConfiguration.LoggingProperty]]:
7527
- '''The logging configuration defines where Image Builder uploads your logs.
7531
+ '''The logging configuration of the infrastructure configuration.
7528
7532
 
7529
7533
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-logging
7530
7534
  '''
@@ -7546,7 +7550,9 @@ class CfnInfrastructureConfigurationProps:
7546
7550
  def resource_tags(
7547
7551
  self,
7548
7552
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
7549
- '''The tags attached to the resource created by Image Builder.
7553
+ '''The metadata tags to assign to the Amazon EC2 instance that Image Builder launches during the build process.
7554
+
7555
+ Tags are formatted as key value pairs.
7550
7556
 
7551
7557
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-resourcetags
7552
7558
  '''
@@ -7555,7 +7561,7 @@ class CfnInfrastructureConfigurationProps:
7555
7561
 
7556
7562
  @builtins.property
7557
7563
  def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
7558
- '''The security group IDs of the infrastructure configuration.
7564
+ '''The security group IDs to associate with the instance used to customize your Amazon EC2 AMI.
7559
7565
 
7560
7566
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-securitygroupids
7561
7567
  '''
@@ -7564,7 +7570,11 @@ class CfnInfrastructureConfigurationProps:
7564
7570
 
7565
7571
  @builtins.property
7566
7572
  def sns_topic_arn(self) -> typing.Optional[builtins.str]:
7567
- '''The Amazon Resource Name (ARN) of the SNS topic for the infrastructure configuration.
7573
+ '''The Amazon Resource Name (ARN) for the SNS topic to which we send image build event notifications.
7574
+
7575
+ .. epigraph::
7576
+
7577
+ EC2 Image Builder is unable to send notifications to SNS topics that are encrypted using keys from other accounts. The key that is used to encrypt the SNS topic must reside in the account that the Image Builder service runs under.
7568
7578
 
7569
7579
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-snstopicarn
7570
7580
  '''
@@ -7573,7 +7583,7 @@ class CfnInfrastructureConfigurationProps:
7573
7583
 
7574
7584
  @builtins.property
7575
7585
  def subnet_id(self) -> typing.Optional[builtins.str]:
7576
- '''The subnet ID of the infrastructure configuration.
7586
+ '''The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.
7577
7587
 
7578
7588
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-subnetid
7579
7589
  '''
@@ -7582,7 +7592,9 @@ class CfnInfrastructureConfigurationProps:
7582
7592
 
7583
7593
  @builtins.property
7584
7594
  def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
7585
- '''The tags of the infrastructure configuration.
7595
+ '''The metadata tags to assign to the infrastructure configuration resource that Image Builder creates as output.
7596
+
7597
+ Tags are formatted as key value pairs.
7586
7598
 
7587
7599
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-tags
7588
7600
  '''
@@ -7593,7 +7605,9 @@ class CfnInfrastructureConfigurationProps:
7593
7605
  def terminate_instance_on_failure(
7594
7606
  self,
7595
7607
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
7596
- '''The terminate instance on failure configuration of the infrastructure configuration.
7608
+ '''The terminate instance on failure setting of the infrastructure configuration.
7609
+
7610
+ Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.
7597
7611
 
7598
7612
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-infrastructureconfiguration.html#cfn-imagebuilder-infrastructureconfiguration-terminateinstanceonfailure
7599
7613
  '''
@@ -11,6 +11,19 @@ fn = lambda_.Function(self, "MyFunction",
11
11
  )
12
12
  ```
13
13
 
14
+ When deployed, this construct creates or updates an existing
15
+ `AWS::Lambda::Function` resource. When updating, AWS CloudFormation calls the
16
+ [UpdateFunctionConfiguration](https://docs.aws.amazon.com/lambda/latest/api/API_UpdateFunctionConfiguration.html)
17
+ and [UpdateFunctionCode](https://docs.aws.amazon.com/lambda/latest/api/API_UpdateFunctionCode.html)
18
+ Lambda APIs under the hood. Because these calls happen sequentially, and
19
+ invocations can happen between these calls, your function may encounter errors
20
+ in the time between the calls. For example, if you update an existing Lambda
21
+ function by removing an environment variable and the code that references that
22
+ environment variable in the same CDK deployment, you may see invocation errors
23
+ related to a missing environment variable. To work around this, you can invoke
24
+ your function against a version or alias by default, rather than the `$LATEST`
25
+ version.
26
+
14
27
  ## Handler Code
15
28
 
16
29
  The `lambda.Code` class includes static convenience methods for various types of