aws-cdk-lib 2.115.0__py3-none-any.whl → 2.116.1__py3-none-any.whl

aws_cdk/aws_apigatewayv2_integrations/__init__.py

@@ -271,17 +271,16 @@ class HttpAlbIntegration(
 
         from aws_cdk.aws_apigatewayv2_integrations import HttpAlbIntegration
         
-        # lb: elbv2.ApplicationLoadBalancer
         
+        vpc = ec2.Vpc(self, "VPC")
+        lb = elbv2.ApplicationLoadBalancer(self, "lb", vpc=vpc)
         listener = lb.add_listener("listener", port=80)
         listener.add_targets("target",
             port=80
         )
         
         http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
-            default_integration=HttpAlbIntegration("DefaultIntegration", listener,
-                parameter_mapping=apigwv2.ParameterMapping().custom("myKey", "myValue")
-            )
+            default_integration=HttpAlbIntegration("DefaultIntegration", listener)
         )
     '''
 
@@ -1321,7 +1320,7 @@ class HttpAlbIntegrationProps(HttpPrivateIntegrationOptions):
             
             http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
                 default_integration=HttpAlbIntegration("DefaultIntegration", listener,
-                    parameter_mapping=apigwv2.ParameterMapping().append_header("header2", apigwv2.MappingValue.request_header("header1")).remove_header("header1")
+                    parameter_mapping=apigwv2.ParameterMapping().custom("myKey", "myValue")
                 )
             )
         '''

aws_cdk/aws_applicationautoscaling/__init__.py

@@ -2145,7 +2145,7 @@ class CfnScalingPolicy(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''ARN is a read only property for the resource.
+        '''Returns the ARN of a scaling policy.
 
         :cloudformationAttribute: Arn
         '''
@@ -2889,11 +2889,17 @@ class CfnScalingPolicy(
 
             Also defines whether this call is returning data for one metric only, or whether it is performing a math expression on the values of returned metric statistics to create a new time series. A time series is a series of data points, each of which is associated with a timestamp.
 
-            :param expression: The math expression to perform on the returned data, if this object is performing a math expression.
-            :param id: A short name that identifies the object's results in the response.
+            You can call for a single metric or perform math expressions on multiple metrics. Any expressions used in a metric specification must eventually return a single time series.
+
+            For more information and examples, see `Create a target tracking scaling policy for Application Auto Scaling using metric math <https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking-metric-math.html>`_ in the *Application Auto Scaling User Guide* .
+
+            ``TargetTrackingMetricDataQuery`` is a property of the `AWS::ApplicationAutoScaling::ScalingPolicy CustomizedMetricSpecification <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-customizedmetricspecification.html>`_ property type.
+
+            :param expression: The math expression to perform on the returned data, if this object is performing a math expression. This expression can use the ``Id`` of the other metrics to refer to those metrics, and can also use the ``Id`` of other expressions to use the result of those expressions. Conditional: Within each ``TargetTrackingMetricDataQuery`` object, you must specify either ``Expression`` or ``MetricStat`` , but not both.
+            :param id: A short name that identifies the object's results in the response. This name must be unique among all ``MetricDataQuery`` objects specified for a single scaling policy. If you are performing math expressions on this set of data, this name represents that data and can serve as a variable in the mathematical expression. The valid characters are letters, numbers, and underscores. The first character must be a lowercase letter.
             :param label: A human-readable label for this metric or expression. This is especially useful if this is a math expression, so that you know what the value represents.
-            :param metric_stat: This structure defines the CloudWatch metric to return, along with the statistic, period, and unit.
-            :param return_data: Indicates whether to return the timestamps and raw data values of this metric.
+            :param metric_stat: Information about the metric data to return. Conditional: Within each ``MetricDataQuery`` object, you must specify either ``Expression`` or ``MetricStat`` , but not both.
+            :param return_data: Indicates whether to return the timestamps and raw data values of this metric. If you use any math expressions, specify ``true`` for this value for only the final math expression that the metric specification is based on. You must specify ``false`` for ``ReturnData`` for all the other metrics and expressions used in the metric specification. If you are only retrieving metrics and not performing any math expressions, do not specify anything for ``ReturnData`` . This sets it to its default ( ``true`` ).
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html
             :exampleMetadata: fixture=_generated
@@ -2946,6 +2952,10 @@ class CfnScalingPolicy(
         def expression(self) -> typing.Optional[builtins.str]:
             '''The math expression to perform on the returned data, if this object is performing a math expression.
 
+            This expression can use the ``Id`` of the other metrics to refer to those metrics, and can also use the ``Id`` of other expressions to use the result of those expressions.
+
+            Conditional: Within each ``TargetTrackingMetricDataQuery`` object, you must specify either ``Expression`` or ``MetricStat`` , but not both.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery-expression
             '''
             result = self._values.get("expression")
@@ -2955,6 +2965,8 @@ class CfnScalingPolicy(
         def id(self) -> typing.Optional[builtins.str]:
             '''A short name that identifies the object's results in the response.
 
+            This name must be unique among all ``MetricDataQuery`` objects specified for a single scaling policy. If you are performing math expressions on this set of data, this name represents that data and can serve as a variable in the mathematical expression. The valid characters are letters, numbers, and underscores. The first character must be a lowercase letter.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery-id
             '''
             result = self._values.get("id")
@@ -2975,7 +2987,9 @@ class CfnScalingPolicy(
         def metric_stat(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnScalingPolicy.TargetTrackingMetricStatProperty"]]:
-            '''This structure defines the CloudWatch metric to return, along with the statistic, period, and unit.
+            '''Information about the metric data to return.
+
+            Conditional: Within each ``MetricDataQuery`` object, you must specify either ``Expression`` or ``MetricStat`` , but not both.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery-metricstat
             '''
@@ -2988,6 +3002,10 @@ class CfnScalingPolicy(
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
             '''Indicates whether to return the timestamps and raw data values of this metric.
 
+            If you use any math expressions, specify ``true`` for this value for only the final math expression that the metric specification is based on. You must specify ``false`` for ``ReturnData`` for all the other metrics and expressions used in the metric specification.
+
+            If you are only retrieving metrics and not performing any math expressions, do not specify anything for ``ReturnData`` . This sets it to its default ( ``true`` ).
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery-returndata
             '''
             result = self._values.get("return_data")
@@ -3016,7 +3034,7 @@ class CfnScalingPolicy(
             name: typing.Optional[builtins.str] = None,
             value: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Describes the dimension of a metric.
+            '''``TargetTrackingMetricDimension`` specifies a name/value pair that is part of the identity of a CloudWatch metric for the ``Dimensions`` property of the `AWS::ApplicationAutoScaling::ScalingPolicy TargetTrackingMetric <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetric.html>`_ property type. Duplicate dimensions are not allowed.
 
             :param name: The name of the dimension.
             :param value: The value of the dimension.
@@ -3091,11 +3109,13 @@ class CfnScalingPolicy(
             metric_name: typing.Optional[builtins.str] = None,
             namespace: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Represents a specific metric.
+            '''Represents a specific metric for a target tracking scaling policy for Application Auto Scaling.
+
+            Metric is a property of the `AWS::ApplicationAutoScaling::ScalingPolicy TargetTrackingMetricStat <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricstat.html>`_ property type.
 
-            :param dimensions: The dimensions for the metric.
+            :param dimensions: The dimensions for the metric. For the list of available dimensions, see the AWS documentation available from the table in `AWS services that publish CloudWatch metrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html>`_ in the *Amazon CloudWatch User Guide* . Conditional: If you published your metric with dimensions, you must specify the same dimensions in your scaling policy.
             :param metric_name: The name of the metric.
-            :param namespace: The namespace of the metric.
+            :param namespace: The namespace of the metric. For more information, see the table in `AWS services that publish CloudWatch metrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html>`_ in the *Amazon CloudWatch User Guide* .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetric.html
             :exampleMetadata: fixture=_generated
@@ -3134,6 +3154,10 @@ class CfnScalingPolicy(
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnScalingPolicy.TargetTrackingMetricDimensionProperty"]]]]:
             '''The dimensions for the metric.
 
+            For the list of available dimensions, see the AWS documentation available from the table in `AWS services that publish CloudWatch metrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html>`_ in the *Amazon CloudWatch User Guide* .
+
+            Conditional: If you published your metric with dimensions, you must specify the same dimensions in your scaling policy.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetric.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetric-dimensions
             '''
             result = self._values.get("dimensions")
@@ -3152,6 +3176,8 @@ class CfnScalingPolicy(
         def namespace(self) -> typing.Optional[builtins.str]:
             '''The namespace of the metric.
 
+            For more information, see the table in `AWS services that publish CloudWatch metrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html>`_ in the *Amazon CloudWatch User Guide* .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetric.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetric-namespace
             '''
             result = self._values.get("namespace")
@@ -3183,9 +3209,13 @@ class CfnScalingPolicy(
         ) -> None:
             '''This structure defines the CloudWatch metric to return, along with the statistic, period, and unit.
 
-            :param metric: Represents a specific metric.
-            :param stat: The statistic to return. It can include any CloudWatch statistic or extended statistic.
-            :param unit: The unit to use for the returned data points.
+            ``TargetTrackingMetricStat`` is a property of the `AWS::ApplicationAutoScaling::ScalingPolicy TargetTrackingMetricDataQuery <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricdataquery.html>`_ property type.
+
+            For more information about the CloudWatch terminology below, see `Amazon CloudWatch concepts <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html>`_ in the *Amazon CloudWatch User Guide* .
+
+            :param metric: The CloudWatch metric to return, including the metric name, namespace, and dimensions. To get the exact metric name, namespace, and dimensions, inspect the `Metric <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Metric.html>`_ object that is returned by a call to `ListMetrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html>`_ .
+            :param stat: The statistic to return. It can include any CloudWatch statistic or extended statistic. For a list of valid values, see the table in `Statistics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic>`_ in the *Amazon CloudWatch User Guide* . The most commonly used metric for scaling is ``Average`` .
+            :param unit: The unit to use for the returned data points. For a complete list of the units that CloudWatch supports, see the `MetricDatum <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html>`_ data type in the *Amazon CloudWatch API Reference* .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricstat.html
             :exampleMetadata: fixture=_generated
@@ -3226,7 +3256,9 @@ class CfnScalingPolicy(
         def metric(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnScalingPolicy.TargetTrackingMetricProperty"]]:
-            '''Represents a specific metric.
+            '''The CloudWatch metric to return, including the metric name, namespace, and dimensions.
+
+            To get the exact metric name, namespace, and dimensions, inspect the `Metric <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Metric.html>`_ object that is returned by a call to `ListMetrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricstat.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricstat-metric
             '''
@@ -3237,7 +3269,9 @@ class CfnScalingPolicy(
         def stat(self) -> typing.Optional[builtins.str]:
             '''The statistic to return.
 
-            It can include any CloudWatch statistic or extended statistic.
+            It can include any CloudWatch statistic or extended statistic. For a list of valid values, see the table in `Statistics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic>`_ in the *Amazon CloudWatch User Guide* .
+
+            The most commonly used metric for scaling is ``Average`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricstat.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricstat-stat
             '''
@@ -3248,6 +3282,8 @@ class CfnScalingPolicy(
         def unit(self) -> typing.Optional[builtins.str]:
             '''The unit to use for the returned data points.
 
+            For a complete list of the units that CloudWatch supports, see the `MetricDatum <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html>`_ data type in the *Amazon CloudWatch API Reference* .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-applicationautoscaling-scalingpolicy-targettrackingmetricstat.html#cfn-applicationautoscaling-scalingpolicy-targettrackingmetricstat-unit
             '''
             result = self._values.get("unit")

aws_cdk/aws_appsync/__init__.py

@@ -3068,7 +3068,8 @@ class CfnDataSource(
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
-        '''
+        '''The ID value.
+
         :cloudformationAttribute: Id
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrId"))
@@ -6085,6 +6086,14 @@ class CfnGraphQLApi(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrGraphQlDns"))
 
+    @builtins.property
+    @jsii.member(jsii_name="attrGraphQlEndpointArn")
+    def attr_graph_ql_endpoint_arn(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: GraphQLEndpointArn
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrGraphQlEndpointArn"))
+
     @builtins.property
     @jsii.member(jsii_name="attrGraphQlUrl")
     def attr_graph_ql_url(self) -> builtins.str:
@@ -6097,7 +6106,8 @@ class CfnGraphQLApi(
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
-        '''
+        '''The ID value.
+
         :cloudformationAttribute: Id
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrId"))
@@ -7394,7 +7404,8 @@ class CfnGraphQLSchema(
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
-        '''
+        '''The ID value.
+
         :cloudformationAttribute: Id
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrId"))

aws_cdk/aws_autoscaling/__init__.py

@@ -14914,6 +14914,12 @@ class OnDemandAllocationStrategy(enum.Enum):
     the Auto Scaling group launches the remaining capacity using the second priority instance type, and
     so on.
     '''
+    LOWEST_PRICE = "LOWEST_PRICE"
+    '''This strategy uses the lowest-price instance types in each Availability Zone based on the current On-Demand instance price.
+
+    To meet your desired capacity, you might receive On-Demand Instances of more than one instance type
+    in each Availability Zone. This depends on how much capacity you request.
+    '''
 
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_autoscaling.PoolState")