aws-cdk-lib 2.173.4__py3-none-any.whl → 2.174.1__py3-none-any.whl

aws_cdk/aws_applicationautoscaling/__init__.py

@@ -2912,7 +2912,8 @@ class CfnScalingPolicy(
             *,
             metric_data_queries: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnScalingPolicy.PredictiveScalingMetricDataQueryProperty", typing.Dict[builtins.str, typing.Any]]]]],
         ) -> None:
-            '''
+            '''One or more metric data queries to provide data points for a metric specification.
+
             :param metric_data_queries: One or more metric data queries to provide data points for a metric specification.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-predictivescalingcustomizedscalingmetric.html
@@ -3658,6 +3659,8 @@ class CfnScalingPolicy(
         ) -> None:
             '''Represents a predictive scaling policy configuration.
 
+            Predictive scaling is supported on Amazon ECS services.
+
             :param metric_specifications: This structure includes the metrics and target utilization to use for predictive scaling. This is an array, but we currently only support a single metric specification. That is, you can specify a target value and a single metric pair, or a target value and one scaling metric and one load metric.
             :param max_capacity_breach_behavior: Defines the behavior that should be applied if the forecast capacity approaches or exceeds the maximum capacity. Defaults to ``HonorMaxCapacity`` if not specified.
             :param max_capacity_buffer: The size of the capacity buffer to use when the forecast capacity is close to or exceeds the maximum capacity. The value is specified as a percentage relative to the forecast capacity. For example, if the buffer is 10, this means a 10 percent buffer, such that if the forecast capacity is 50, and the maximum capacity is 40, then the effective maximum capacity is 55. Required if the ``MaxCapacityBreachBehavior`` property is set to ``IncreaseMaxCapacity`` , and cannot be used otherwise.

aws_cdk/aws_appsync/__init__.py

@@ -238,6 +238,10 @@ input DemoInput {
 type Mutation {
   callStepFunction(input: DemoInput!): job
 }
+
+type Query {
+  _placeholder: String
+}
 ```
 
 GraphQL request mapping template `request.vtl`:

aws_cdk/aws_autoscaling/__init__.py

@@ -779,6 +779,30 @@ autoscaling.AutoScalingGroup(self, "ASG",
 )
 ```
 
+## Capacity Distribution Strategy
+
+If launches fail in an Availability Zone, the following strategies are available.
+
+* `BALANCED_BEST_EFFORT` (default) - If launches fail in an Availability Zone, Auto Scaling will attempt to launch in another healthy Availability Zone instead.
+* `BALANCED_ONLY` - If launches fail in an Availability Zone, Auto Scaling will continue to attempt to launch in the unhealthy zone to preserve a balanced distribution.
+
+```python
+# vpc: ec2.Vpc
+# instance_type: ec2.InstanceType
+# machine_image: ec2.IMachineImage
+
+
+autoscaling.AutoScalingGroup(self, "ASG",
+    vpc=vpc,
+    instance_type=instance_type,
+    machine_image=machine_image,
+
+    # ...
+
+    az_capacity_distribution_strategy=autoscaling.CapacityDistributionStrategy.BALANCED_ONLY
+)
+```
+
 ## Future work
 
 * [ ] CloudWatch Events (impossible to add currently as the AutoScalingGroup ARN is
@@ -2341,6 +2365,36 @@ class BlockDeviceVolume(
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "virtualName"))
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_autoscaling.CapacityDistributionStrategy")
+class CapacityDistributionStrategy(enum.Enum):
+    '''The strategies for when launches fail in an Availability Zone.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # vpc: ec2.Vpc
+        # instance_type: ec2.InstanceType
+        # machine_image: ec2.IMachineImage
+        
+        
+        autoscaling.AutoScalingGroup(self, "ASG",
+            vpc=vpc,
+            instance_type=instance_type,
+            machine_image=machine_image,
+        
+            # ...
+        
+            az_capacity_distribution_strategy=autoscaling.CapacityDistributionStrategy.BALANCED_ONLY
+        )
+    '''
+
+    BALANCED_ONLY = "BALANCED_ONLY"
+    '''If launches fail in an Availability Zone, Auto Scaling will continue to attempt to launch in the unhealthy zone to preserve a balanced distribution.'''
+    BALANCED_BEST_EFFORT = "BALANCED_BEST_EFFORT"
+    '''If launches fail in an Availability Zone, Auto Scaling will attempt to launch in another healthy Availability Zone instead.'''
+
+
 @jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
 class CfnAutoScalingGroup(
     _CfnResource_9df397a6,
@@ -13247,6 +13301,7 @@ class CfnWarmPoolProps:
         "allow_all_outbound": "allowAllOutbound",
         "associate_public_ip_address": "associatePublicIpAddress",
         "auto_scaling_group_name": "autoScalingGroupName",
+        "az_capacity_distribution_strategy": "azCapacityDistributionStrategy",
         "block_devices": "blockDevices",
         "capacity_rebalance": "capacityRebalance",
         "cooldown": "cooldown",
@@ -13279,6 +13334,7 @@ class CommonAutoScalingGroupProps:
         allow_all_outbound: typing.Optional[builtins.bool] = None,
         associate_public_ip_address: typing.Optional[builtins.bool] = None,
         auto_scaling_group_name: typing.Optional[builtins.str] = None,
+        az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
         block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
         capacity_rebalance: typing.Optional[builtins.bool] = None,
         cooldown: typing.Optional[_Duration_4839e8c3] = None,
@@ -13311,6 +13367,7 @@ class CommonAutoScalingGroupProps:
         :param allow_all_outbound: Whether the instances can initiate connections to anywhere by default. Default: true
         :param associate_public_ip_address: Whether instances in the Auto Scaling Group should have public IP addresses associated with them. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Use subnet setting.
         :param auto_scaling_group_name: The name of the Auto Scaling group. This name must be unique per Region per account. Default: - Auto generated by CloudFormation
+        :param az_capacity_distribution_strategy: The strategy for distributing instances across Availability Zones. Default: None
         :param block_devices: Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes. Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Uses the block device mapping of the AMI
         :param capacity_rebalance: Indicates whether Capacity Rebalancing is enabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of interruption. After launching a new instance, it then terminates an old instance. Default: false
         :param cooldown: Default scaling cooldown for this AutoScalingGroup. Default: Duration.minutes(5)
@@ -13361,6 +13418,7 @@ class CommonAutoScalingGroupProps:
                 allow_all_outbound=False,
                 associate_public_ip_address=False,
                 auto_scaling_group_name="autoScalingGroupName",
+                az_capacity_distribution_strategy=autoscaling.CapacityDistributionStrategy.BALANCED_ONLY,
                 block_devices=[autoscaling.BlockDevice(
                     device_name="deviceName",
                     volume=block_device_volume
@@ -13408,6 +13466,7 @@ class CommonAutoScalingGroupProps:
             check_type(argname="argument allow_all_outbound", value=allow_all_outbound, expected_type=type_hints["allow_all_outbound"])
             check_type(argname="argument associate_public_ip_address", value=associate_public_ip_address, expected_type=type_hints["associate_public_ip_address"])
             check_type(argname="argument auto_scaling_group_name", value=auto_scaling_group_name, expected_type=type_hints["auto_scaling_group_name"])
+            check_type(argname="argument az_capacity_distribution_strategy", value=az_capacity_distribution_strategy, expected_type=type_hints["az_capacity_distribution_strategy"])
             check_type(argname="argument block_devices", value=block_devices, expected_type=type_hints["block_devices"])
             check_type(argname="argument capacity_rebalance", value=capacity_rebalance, expected_type=type_hints["capacity_rebalance"])
             check_type(argname="argument cooldown", value=cooldown, expected_type=type_hints["cooldown"])
@@ -13438,6 +13497,8 @@ class CommonAutoScalingGroupProps:
             self._values["associate_public_ip_address"] = associate_public_ip_address
         if auto_scaling_group_name is not None:
             self._values["auto_scaling_group_name"] = auto_scaling_group_name
+        if az_capacity_distribution_strategy is not None:
+            self._values["az_capacity_distribution_strategy"] = az_capacity_distribution_strategy
         if block_devices is not None:
             self._values["block_devices"] = block_devices
         if capacity_rebalance is not None:
@@ -13516,6 +13577,17 @@ class CommonAutoScalingGroupProps:
         result = self._values.get("auto_scaling_group_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def az_capacity_distribution_strategy(
+        self,
+    ) -> typing.Optional[CapacityDistributionStrategy]:
+        '''The strategy for distributing instances across Availability Zones.
+
+        :default: None
+        '''
+        result = self._values.get("az_capacity_distribution_strategy")
+        return typing.cast(typing.Optional[CapacityDistributionStrategy], result)
+
     @builtins.property
     def block_devices(self) -> typing.Optional[typing.List[BlockDevice]]:
         '''Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes.
@@ -19072,6 +19144,7 @@ class AutoScalingGroup(
         allow_all_outbound: typing.Optional[builtins.bool] = None,
         associate_public_ip_address: typing.Optional[builtins.bool] = None,
         auto_scaling_group_name: typing.Optional[builtins.str] = None,
+        az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
         block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
         capacity_rebalance: typing.Optional[builtins.bool] = None,
         cooldown: typing.Optional[_Duration_4839e8c3] = None,
@@ -19115,6 +19188,7 @@ class AutoScalingGroup(
         :param allow_all_outbound: Whether the instances can initiate connections to anywhere by default. Default: true
         :param associate_public_ip_address: Whether instances in the Auto Scaling Group should have public IP addresses associated with them. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Use subnet setting.
         :param auto_scaling_group_name: The name of the Auto Scaling group. This name must be unique per Region per account. Default: - Auto generated by CloudFormation
+        :param az_capacity_distribution_strategy: The strategy for distributing instances across Availability Zones. Default: None
         :param block_devices: Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes. Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Uses the block device mapping of the AMI
         :param capacity_rebalance: Indicates whether Capacity Rebalancing is enabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of interruption. After launching a new instance, it then terminates an old instance. Default: false
         :param cooldown: Default scaling cooldown for this AutoScalingGroup. Default: Duration.minutes(5)
@@ -19160,6 +19234,7 @@ class AutoScalingGroup(
             allow_all_outbound=allow_all_outbound,
             associate_public_ip_address=associate_public_ip_address,
             auto_scaling_group_name=auto_scaling_group_name,
+            az_capacity_distribution_strategy=az_capacity_distribution_strategy,
             block_devices=block_devices,
             capacity_rebalance=capacity_rebalance,
             cooldown=cooldown,
@@ -19753,6 +19828,7 @@ class AutoScalingGroup(
         "allow_all_outbound": "allowAllOutbound",
         "associate_public_ip_address": "associatePublicIpAddress",
         "auto_scaling_group_name": "autoScalingGroupName",
+        "az_capacity_distribution_strategy": "azCapacityDistributionStrategy",
         "block_devices": "blockDevices",
         "capacity_rebalance": "capacityRebalance",
         "cooldown": "cooldown",
@@ -19798,6 +19874,7 @@ class AutoScalingGroupProps(CommonAutoScalingGroupProps):
         allow_all_outbound: typing.Optional[builtins.bool] = None,
         associate_public_ip_address: typing.Optional[builtins.bool] = None,
         auto_scaling_group_name: typing.Optional[builtins.str] = None,
+        az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
         block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
         capacity_rebalance: typing.Optional[builtins.bool] = None,
         cooldown: typing.Optional[_Duration_4839e8c3] = None,
@@ -19840,6 +19917,7 @@ class AutoScalingGroupProps(CommonAutoScalingGroupProps):
         :param allow_all_outbound: Whether the instances can initiate connections to anywhere by default. Default: true
         :param associate_public_ip_address: Whether instances in the Auto Scaling Group should have public IP addresses associated with them. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Use subnet setting.
         :param auto_scaling_group_name: The name of the Auto Scaling group. This name must be unique per Region per account. Default: - Auto generated by CloudFormation
+        :param az_capacity_distribution_strategy: The strategy for distributing instances across Availability Zones. Default: None
         :param block_devices: Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes. Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Uses the block device mapping of the AMI
         :param capacity_rebalance: Indicates whether Capacity Rebalancing is enabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of interruption. After launching a new instance, it then terminates an old instance. Default: false
         :param cooldown: Default scaling cooldown for this AutoScalingGroup. Default: Duration.minutes(5)
@@ -19911,6 +19989,7 @@ class AutoScalingGroupProps(CommonAutoScalingGroupProps):
             check_type(argname="argument allow_all_outbound", value=allow_all_outbound, expected_type=type_hints["allow_all_outbound"])
             check_type(argname="argument associate_public_ip_address", value=associate_public_ip_address, expected_type=type_hints["associate_public_ip_address"])
             check_type(argname="argument auto_scaling_group_name", value=auto_scaling_group_name, expected_type=type_hints["auto_scaling_group_name"])
+            check_type(argname="argument az_capacity_distribution_strategy", value=az_capacity_distribution_strategy, expected_type=type_hints["az_capacity_distribution_strategy"])
             check_type(argname="argument block_devices", value=block_devices, expected_type=type_hints["block_devices"])
             check_type(argname="argument capacity_rebalance", value=capacity_rebalance, expected_type=type_hints["capacity_rebalance"])
             check_type(argname="argument cooldown", value=cooldown, expected_type=type_hints["cooldown"])
@@ -19956,6 +20035,8 @@ class AutoScalingGroupProps(CommonAutoScalingGroupProps):
             self._values["associate_public_ip_address"] = associate_public_ip_address
         if auto_scaling_group_name is not None:
             self._values["auto_scaling_group_name"] = auto_scaling_group_name
+        if az_capacity_distribution_strategy is not None:
+            self._values["az_capacity_distribution_strategy"] = az_capacity_distribution_strategy
         if block_devices is not None:
             self._values["block_devices"] = block_devices
         if capacity_rebalance is not None:
@@ -20058,6 +20139,17 @@ class AutoScalingGroupProps(CommonAutoScalingGroupProps):
         result = self._values.get("auto_scaling_group_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def az_capacity_distribution_strategy(
+        self,
+    ) -> typing.Optional[CapacityDistributionStrategy]:
+        '''The strategy for distributing instances across Availability Zones.
+
+        :default: None
+        '''
+        result = self._values.get("az_capacity_distribution_strategy")
+        return typing.cast(typing.Optional[CapacityDistributionStrategy], result)
+
     @builtins.property
     def block_devices(self) -> typing.Optional[typing.List[BlockDevice]]:
         '''Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes.
@@ -20888,6 +20980,7 @@ __all__ = [
     "BindHookTargetOptions",
     "BlockDevice",
     "BlockDeviceVolume",
+    "CapacityDistributionStrategy",
     "CfnAutoScalingGroup",
     "CfnAutoScalingGroupProps",
     "CfnLaunchConfiguration",
@@ -22422,6 +22515,7 @@ def _typecheckingstub__e7df3cbef8de53a463241b6e60846fac6e519118c7118785f8f4efb6d
     allow_all_outbound: typing.Optional[builtins.bool] = None,
     associate_public_ip_address: typing.Optional[builtins.bool] = None,
     auto_scaling_group_name: typing.Optional[builtins.str] = None,
+    az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
     block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
     capacity_rebalance: typing.Optional[builtins.bool] = None,
     cooldown: typing.Optional[_Duration_4839e8c3] = None,
@@ -22968,6 +23062,7 @@ def _typecheckingstub__82981fc74407321badee3133fda3bd0a016f4ab7634f761219c1c808c
     allow_all_outbound: typing.Optional[builtins.bool] = None,
     associate_public_ip_address: typing.Optional[builtins.bool] = None,
     auto_scaling_group_name: typing.Optional[builtins.str] = None,
+    az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
     block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
     capacity_rebalance: typing.Optional[builtins.bool] = None,
     cooldown: typing.Optional[_Duration_4839e8c3] = None,
@@ -23175,6 +23270,7 @@ def _typecheckingstub__186ff14d58334848486a7ecd802c6b72a1b76f272f25349712b95361e
     allow_all_outbound: typing.Optional[builtins.bool] = None,
     associate_public_ip_address: typing.Optional[builtins.bool] = None,
     auto_scaling_group_name: typing.Optional[builtins.str] = None,
+    az_capacity_distribution_strategy: typing.Optional[CapacityDistributionStrategy] = None,
     block_devices: typing.Optional[typing.Sequence[typing.Union[BlockDevice, typing.Dict[builtins.str, typing.Any]]]] = None,
     capacity_rebalance: typing.Optional[builtins.bool] = None,
     cooldown: typing.Optional[_Duration_4839e8c3] = None,