aws-cdk-lib 2.146.0__py3-none-any.whl → 2.147.1__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.
- aws_cdk/__init__.py +11 -12
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.146.0.jsii.tgz → aws-cdk-lib@2.147.1.jsii.tgz} +0 -0
- aws_cdk/aws_apigateway/__init__.py +32 -12
- aws_cdk/aws_apigatewayv2/__init__.py +48 -2
- aws_cdk/aws_apigatewayv2_integrations/__init__.py +142 -4
- aws_cdk/aws_appconfig/__init__.py +8 -4
- aws_cdk/aws_applicationsignals/__init__.py +1766 -0
- aws_cdk/aws_auditmanager/__init__.py +5 -1
- aws_cdk/aws_autoscaling/__init__.py +65 -20
- aws_cdk/aws_batch/__init__.py +215 -0
- aws_cdk/aws_bedrock/__init__.py +272 -103
- aws_cdk/aws_cloudformation/__init__.py +5 -11
- aws_cdk/aws_cloudfront/__init__.py +10 -3
- aws_cdk/aws_cloudtrail/__init__.py +56 -2
- aws_cdk/aws_codebuild/__init__.py +62 -29
- aws_cdk/aws_codepipeline/__init__.py +10 -5
- aws_cdk/aws_datazone/__init__.py +80 -68
- aws_cdk/aws_deadline/__init__.py +603 -17
- aws_cdk/aws_ec2/__init__.py +237 -112
- aws_cdk/aws_ecs/__init__.py +20 -18
- aws_cdk/aws_eks/__init__.py +15 -9
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +11 -5
- aws_cdk/aws_emrserverless/__init__.py +5 -5
- aws_cdk/aws_events/__init__.py +36 -16
- aws_cdk/aws_fsx/__init__.py +126 -21
- aws_cdk/aws_globalaccelerator/__init__.py +2 -1
- aws_cdk/aws_globalaccelerator_endpoints/__init__.py +35 -4
- aws_cdk/aws_glue/__init__.py +26 -0
- aws_cdk/aws_grafana/__init__.py +4 -4
- aws_cdk/aws_groundstation/__init__.py +55 -35
- aws_cdk/aws_guardduty/__init__.py +826 -0
- aws_cdk/aws_iot/__init__.py +3 -3
- aws_cdk/aws_lambda/__init__.py +7 -5
- aws_cdk/aws_lightsail/__init__.py +1 -1
- aws_cdk/aws_location/__init__.py +10 -11
- aws_cdk/aws_mediapackagev2/__init__.py +38 -20
- aws_cdk/aws_mediatailor/__init__.py +2 -2
- aws_cdk/aws_msk/__init__.py +4 -4
- aws_cdk/aws_mwaa/__init__.py +16 -8
- aws_cdk/aws_nimblestudio/__init__.py +9 -9
- aws_cdk/aws_opensearchservice/__init__.py +5 -4
- aws_cdk/aws_opsworks/__init__.py +3 -3
- aws_cdk/aws_osis/__init__.py +33 -4
- aws_cdk/aws_pipes/__init__.py +97 -45
- aws_cdk/aws_quicksight/__init__.py +23 -21
- aws_cdk/aws_rds/__init__.py +43 -11
- aws_cdk/aws_refactorspaces/__init__.py +3 -3
- aws_cdk/aws_rolesanywhere/__init__.py +21 -14
- aws_cdk/aws_route53/__init__.py +3 -3
- aws_cdk/aws_sagemaker/__init__.py +5 -2
- aws_cdk/aws_securityhub/__init__.py +163 -78
- aws_cdk/aws_securitylake/__init__.py +7 -5
- aws_cdk/aws_ses/__init__.py +117 -0
- aws_cdk/aws_simspaceweaver/__init__.py +2 -2
- aws_cdk/aws_sns/__init__.py +6 -4
- aws_cdk/aws_sqs/__init__.py +3 -3
- aws_cdk/aws_stepfunctions/__init__.py +51 -28
- aws_cdk/aws_stepfunctions_tasks/__init__.py +56 -2
- aws_cdk/aws_transfer/__init__.py +8 -2
- aws_cdk/aws_wafv2/__init__.py +10 -10
- aws_cdk/aws_workspacesweb/__init__.py +8 -8
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/RECORD +68 -67
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/top_level.txt +0 -0
aws_cdk/aws_ec2/__init__.py
CHANGED
|
@@ -2039,6 +2039,56 @@ ec2.Instance(self, "Instance",
|
|
|
2039
2039
|
)
|
|
2040
2040
|
```
|
|
2041
2041
|
|
|
2042
|
+
### Enabling Nitro Enclaves
|
|
2043
|
+
|
|
2044
|
+
You can enable [AWS Nitro Enclaves](https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html) for
|
|
2045
|
+
your EC2 instances by setting the `enclaveEnabled` property to `true`. Nitro Enclaves is a feature of
|
|
2046
|
+
AWS Nitro System that enables creating isolated and highly constrained CPU environments known as enclaves.
|
|
2047
|
+
|
|
2048
|
+
```python
|
|
2049
|
+
# vpc: ec2.Vpc
|
|
2050
|
+
|
|
2051
|
+
|
|
2052
|
+
instance = ec2.Instance(self, "Instance",
|
|
2053
|
+
instance_type=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.XLARGE),
|
|
2054
|
+
machine_image=ec2.AmazonLinuxImage(),
|
|
2055
|
+
vpc=vpc,
|
|
2056
|
+
enclave_enabled=True
|
|
2057
|
+
)
|
|
2058
|
+
```
|
|
2059
|
+
|
|
2060
|
+
> NOTE: You must use an instance type and operating system that support Nitro Enclaves.
|
|
2061
|
+
> For more information, see [Requirements](https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html#nitro-enclave-reqs).
|
|
2062
|
+
|
|
2063
|
+
### Enabling Instance Hibernation
|
|
2064
|
+
|
|
2065
|
+
You can enable [Instance Hibernation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) for
|
|
2066
|
+
your EC2 instances by setting the `hibernationEnabled` property to `true`. Instance Hibernation saves the
|
|
2067
|
+
instance's in-memory (RAM) state when an instance is stopped, and restores that state when the instance is started.
|
|
2068
|
+
|
|
2069
|
+
```python
|
|
2070
|
+
# vpc: ec2.Vpc
|
|
2071
|
+
|
|
2072
|
+
|
|
2073
|
+
instance = ec2.Instance(self, "Instance",
|
|
2074
|
+
instance_type=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.XLARGE),
|
|
2075
|
+
machine_image=ec2.AmazonLinuxImage(),
|
|
2076
|
+
vpc=vpc,
|
|
2077
|
+
hibernation_enabled=True,
|
|
2078
|
+
block_devices=[ec2.BlockDevice(
|
|
2079
|
+
device_name="/dev/xvda",
|
|
2080
|
+
volume=ec2.BlockDeviceVolume.ebs(30,
|
|
2081
|
+
volume_type=ec2.EbsDeviceVolumeType.GP3,
|
|
2082
|
+
encrypted=True,
|
|
2083
|
+
delete_on_termination=True
|
|
2084
|
+
)
|
|
2085
|
+
)]
|
|
2086
|
+
)
|
|
2087
|
+
```
|
|
2088
|
+
|
|
2089
|
+
> NOTE: You must use an instance and a volume that meet the requirements for hibernation.
|
|
2090
|
+
> For more information, see [Prerequisites for Amazon EC2 instance hibernation](https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html#nitro-enclave-reqs).
|
|
2091
|
+
|
|
2042
2092
|
## VPC Flow Logs
|
|
2043
2093
|
|
|
2044
2094
|
VPC Flow Logs is a feature that enables you to capture information about the IP traffic going to and from network interfaces in your VPC. Flow log data can be published to Amazon CloudWatch Logs and Amazon S3. After you've created a flow log, you can retrieve and view its data in the chosen destination. ([https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html)).
|
|
@@ -5286,11 +5336,17 @@ class BlockDeviceVolume(
|
|
|
5286
5336
|
vpc=vpc,
|
|
5287
5337
|
instance_type=instance_type,
|
|
5288
5338
|
machine_image=machine_image,
|
|
5289
|
-
|
|
5339
|
+
|
|
5340
|
+
# ...
|
|
5341
|
+
|
|
5290
5342
|
block_devices=[ec2.BlockDevice(
|
|
5291
|
-
device_name="/dev/
|
|
5292
|
-
volume=ec2.BlockDeviceVolume.ebs(
|
|
5293
|
-
)
|
|
5343
|
+
device_name="/dev/sda1",
|
|
5344
|
+
volume=ec2.BlockDeviceVolume.ebs(50)
|
|
5345
|
+
), ec2.BlockDevice(
|
|
5346
|
+
device_name="/dev/sdm",
|
|
5347
|
+
volume=ec2.BlockDeviceVolume.ebs(100)
|
|
5348
|
+
)
|
|
5349
|
+
]
|
|
5294
5350
|
)
|
|
5295
5351
|
'''
|
|
5296
5352
|
|
|
@@ -5936,7 +5992,7 @@ class CfnCapacityReservationFleet(
|
|
|
5936
5992
|
'''
|
|
5937
5993
|
:param scope: Scope in which this resource is defined.
|
|
5938
5994
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
5939
|
-
:param allocation_strategy: The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the Amazon EC2 User Guide. Valid values: ``prioritized``
|
|
5995
|
+
:param allocation_strategy: The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the *Amazon EC2 User Guide* . Valid values: ``prioritized``
|
|
5940
5996
|
:param end_date: The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to ``expired`` and all of the Capacity Reservations in the Fleet expire. The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify ``5/31/2019`` , ``13:30:55`` , the Capacity Reservation Fleet is guaranteed to expire between ``13:30:55`` and ``14:30:55`` on ``5/31/2019`` .
|
|
5941
5997
|
:param instance_match_criteria: Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria. Currently, Capacity Reservation Fleets support ``open`` instance matching criteria only. This means that instances that have matching attributes (instance type, platform, and Availability Zone) run in the Capacity Reservations automatically. Instances do not need to explicitly target a Capacity Reservation Fleet to use its reserved capacity.
|
|
5942
5998
|
:param instance_type_specifications: Information about the instance types for which to reserve the capacity.
|
|
@@ -5944,7 +6000,7 @@ class CfnCapacityReservationFleet(
|
|
|
5944
6000
|
:param remove_end_date: Used to remove an end date from a Capacity Reservation Fleet that is configured to end automatically at a specific date and time. To remove the end date from a Capacity Reservation Fleet, specify ``true`` for this paramater and omit the *EndDate* parameter.
|
|
5945
6001
|
:param tag_specifications: The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.
|
|
5946
6002
|
:param tenancy: Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings: - ``default`` - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts . - ``dedicated`` - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .
|
|
5947
|
-
:param total_target_capacity: The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the Amazon EC2 User Guide.
|
|
6003
|
+
:param total_target_capacity: The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the *Amazon EC2 User Guide* .
|
|
5948
6004
|
'''
|
|
5949
6005
|
if __debug__:
|
|
5950
6006
|
type_hints = typing.get_type_hints(_typecheckingstub__f6fb1af1f639a354aff6bb978bcac42ab042448e257770c8bed7a46897429542)
|
|
@@ -6179,7 +6235,7 @@ class CfnCapacityReservationFleet(
|
|
|
6179
6235
|
:param ebs_optimized: Indicates whether the Capacity Reservation Fleet supports EBS-optimized instances types. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using EBS-optimized instance types.
|
|
6180
6236
|
:param instance_platform: The type of operating system for which the Capacity Reservation Fleet reserves capacity.
|
|
6181
6237
|
:param instance_type: The instance type for which the Capacity Reservation Fleet reserves capacity.
|
|
6182
|
-
:param priority: The priority to assign to the instance type. This value is used to determine which of the instance types specified for the Fleet should be prioritized for use. A lower value indicates a high priority. For more information, see `Instance type priority <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority>`_ in the Amazon EC2 User Guide.
|
|
6238
|
+
:param priority: The priority to assign to the instance type. This value is used to determine which of the instance types specified for the Fleet should be prioritized for use. A lower value indicates a high priority. For more information, see `Instance type priority <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority>`_ in the *Amazon EC2 User Guide* .
|
|
6183
6239
|
:param weight: The number of capacity units provided by the specified instance type. This value, together with the total target capacity that you specify for the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the Amazon EC2 User Guide. Valid Range: Minimum value of ``0.001`` . Maximum value of ``99.999`` .
|
|
6184
6240
|
|
|
6185
6241
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-capacityreservationfleet-instancetypespecification.html
|
|
@@ -6283,7 +6339,7 @@ class CfnCapacityReservationFleet(
|
|
|
6283
6339
|
def priority(self) -> typing.Optional[jsii.Number]:
|
|
6284
6340
|
'''The priority to assign to the instance type.
|
|
6285
6341
|
|
|
6286
|
-
This value is used to determine which of the instance types specified for the Fleet should be prioritized for use. A lower value indicates a high priority. For more information, see `Instance type priority <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority>`_ in the Amazon EC2 User Guide.
|
|
6342
|
+
This value is used to determine which of the instance types specified for the Fleet should be prioritized for use. A lower value indicates a high priority. For more information, see `Instance type priority <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority>`_ in the *Amazon EC2 User Guide* .
|
|
6287
6343
|
|
|
6288
6344
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-capacityreservationfleet-instancetypespecification.html#cfn-ec2-capacityreservationfleet-instancetypespecification-priority
|
|
6289
6345
|
'''
|
|
@@ -6426,7 +6482,7 @@ class CfnCapacityReservationFleetProps:
|
|
|
6426
6482
|
) -> None:
|
|
6427
6483
|
'''Properties for defining a ``CfnCapacityReservationFleet``.
|
|
6428
6484
|
|
|
6429
|
-
:param allocation_strategy: The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the Amazon EC2 User Guide. Valid values: ``prioritized``
|
|
6485
|
+
:param allocation_strategy: The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the *Amazon EC2 User Guide* . Valid values: ``prioritized``
|
|
6430
6486
|
:param end_date: The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to ``expired`` and all of the Capacity Reservations in the Fleet expire. The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify ``5/31/2019`` , ``13:30:55`` , the Capacity Reservation Fleet is guaranteed to expire between ``13:30:55`` and ``14:30:55`` on ``5/31/2019`` .
|
|
6431
6487
|
:param instance_match_criteria: Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria. Currently, Capacity Reservation Fleets support ``open`` instance matching criteria only. This means that instances that have matching attributes (instance type, platform, and Availability Zone) run in the Capacity Reservations automatically. Instances do not need to explicitly target a Capacity Reservation Fleet to use its reserved capacity.
|
|
6432
6488
|
:param instance_type_specifications: Information about the instance types for which to reserve the capacity.
|
|
@@ -6434,7 +6490,7 @@ class CfnCapacityReservationFleetProps:
|
|
|
6434
6490
|
:param remove_end_date: Used to remove an end date from a Capacity Reservation Fleet that is configured to end automatically at a specific date and time. To remove the end date from a Capacity Reservation Fleet, specify ``true`` for this paramater and omit the *EndDate* parameter.
|
|
6435
6491
|
:param tag_specifications: The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.
|
|
6436
6492
|
:param tenancy: Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings: - ``default`` - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts . - ``dedicated`` - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .
|
|
6437
|
-
:param total_target_capacity: The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the Amazon EC2 User Guide.
|
|
6493
|
+
:param total_target_capacity: The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the *Amazon EC2 User Guide* .
|
|
6438
6494
|
|
|
6439
6495
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-capacityreservationfleet.html
|
|
6440
6496
|
:exampleMetadata: fixture=_generated
|
|
@@ -6506,7 +6562,7 @@ class CfnCapacityReservationFleetProps:
|
|
|
6506
6562
|
def allocation_strategy(self) -> typing.Optional[builtins.str]:
|
|
6507
6563
|
'''The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use.
|
|
6508
6564
|
|
|
6509
|
-
Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the Amazon EC2 User Guide.
|
|
6565
|
+
Currently, only the ``prioritized`` allocation strategy is supported. For more information, see `Allocation strategy <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy>`_ in the *Amazon EC2 User Guide* .
|
|
6510
6566
|
|
|
6511
6567
|
Valid values: ``prioritized``
|
|
6512
6568
|
|
|
@@ -6609,7 +6665,7 @@ class CfnCapacityReservationFleetProps:
|
|
|
6609
6665
|
def total_target_capacity(self) -> typing.Optional[jsii.Number]:
|
|
6610
6666
|
'''The total number of capacity units to be reserved by the Capacity Reservation Fleet.
|
|
6611
6667
|
|
|
6612
|
-
This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the Amazon EC2 User Guide.
|
|
6668
|
+
This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see `Total target capacity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity>`_ in the *Amazon EC2 User Guide* .
|
|
6613
6669
|
|
|
6614
6670
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-capacityreservationfleet.html#cfn-ec2-capacityreservationfleet-totaltargetcapacity
|
|
6615
6671
|
'''
|
|
@@ -8464,14 +8520,9 @@ class CfnClientVpnEndpoint(
|
|
|
8464
8520
|
resource_type: builtins.str,
|
|
8465
8521
|
tags: typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]],
|
|
8466
8522
|
) -> None:
|
|
8467
|
-
'''
|
|
8523
|
+
'''Specifies the tags to apply to the Client VPN endpoint.
|
|
8468
8524
|
|
|
8469
|
-
|
|
8470
|
-
.. epigraph::
|
|
8471
|
-
|
|
8472
|
-
The ``Valid Values`` lists all the resource types that can be tagged. However, the action you're using might not support tagging all of these resource types. If you try to tag a resource type that is unsupported for the action you're using, you'll get an error.
|
|
8473
|
-
|
|
8474
|
-
:param resource_type: The type of resource to tag.
|
|
8525
|
+
:param resource_type: The type of resource to tag. To tag a Client VPN endpoint, ``ResourceType`` must be ``client-vpn-endpoint`` .
|
|
8475
8526
|
:param tags: The tags to apply to the resource.
|
|
8476
8527
|
|
|
8477
8528
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-clientvpnendpoint-tagspecification.html
|
|
@@ -8504,6 +8555,8 @@ class CfnClientVpnEndpoint(
|
|
|
8504
8555
|
def resource_type(self) -> builtins.str:
|
|
8505
8556
|
'''The type of resource to tag.
|
|
8506
8557
|
|
|
8558
|
+
To tag a Client VPN endpoint, ``ResourceType`` must be ``client-vpn-endpoint`` .
|
|
8559
|
+
|
|
8507
8560
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-clientvpnendpoint-tagspecification.html#cfn-ec2-clientvpnendpoint-tagspecification-resourcetype
|
|
8508
8561
|
'''
|
|
8509
8562
|
result = self._values.get("resource_type")
|
|
@@ -9441,10 +9494,10 @@ class CfnCustomerGateway(
|
|
|
9441
9494
|
'''
|
|
9442
9495
|
:param scope: Scope in which this resource is defined.
|
|
9443
9496
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
9444
|
-
:param ip_address: IPv4 address for the customer gateway device's outside interface. The address must be static.
|
|
9497
|
+
:param ip_address: IPv4 address for the customer gateway device's outside interface. The address must be static. If ``OutsideIpAddressType`` in your VPN connection options is set to ``PrivateIpv4`` , you can use an RFC6598 or RFC1918 private IPv4 address. If ``OutsideIpAddressType`` is set to ``PublicIpv4`` , you can use a public IPv4 address.
|
|
9445
9498
|
:param type: The type of VPN connection that this customer gateway supports ( ``ipsec.1`` ).
|
|
9446
|
-
:param bgp_asn: For devices that support BGP, the customer gateway
|
|
9447
|
-
:param bgp_asn_extended:
|
|
9499
|
+
:param bgp_asn: For customer gateway devices that support BGP, specify the device's ASN. You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` . Default: 65000 Valid values: ``1`` to ``2,147,483,647`` Default: - 65000
|
|
9500
|
+
:param bgp_asn_extended: For customer gateway devices that support BGP, specify the device's ASN. You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` . Valid values: ``2,147,483,648`` to ``4,294,967,295``
|
|
9448
9501
|
:param certificate_arn: The Amazon Resource Name (ARN) for the customer gateway certificate.
|
|
9449
9502
|
:param device_name: The name of customer gateway device.
|
|
9450
9503
|
:param tags: One or more tags for the customer gateway.
|
|
@@ -9544,7 +9597,7 @@ class CfnCustomerGateway(
|
|
|
9544
9597
|
@builtins.property
|
|
9545
9598
|
@jsii.member(jsii_name="bgpAsn")
|
|
9546
9599
|
def bgp_asn(self) -> typing.Optional[jsii.Number]:
|
|
9547
|
-
'''For devices that support BGP, the
|
|
9600
|
+
'''For customer gateway devices that support BGP, specify the device's ASN.'''
|
|
9548
9601
|
return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "bgpAsn"))
|
|
9549
9602
|
|
|
9550
9603
|
@bgp_asn.setter
|
|
@@ -9557,6 +9610,7 @@ class CfnCustomerGateway(
|
|
|
9557
9610
|
@builtins.property
|
|
9558
9611
|
@jsii.member(jsii_name="bgpAsnExtended")
|
|
9559
9612
|
def bgp_asn_extended(self) -> typing.Optional[jsii.Number]:
|
|
9613
|
+
'''For customer gateway devices that support BGP, specify the device's ASN.'''
|
|
9560
9614
|
return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "bgpAsnExtended"))
|
|
9561
9615
|
|
|
9562
9616
|
@bgp_asn_extended.setter
|
|
@@ -9633,10 +9687,10 @@ class CfnCustomerGatewayProps:
|
|
|
9633
9687
|
) -> None:
|
|
9634
9688
|
'''Properties for defining a ``CfnCustomerGateway``.
|
|
9635
9689
|
|
|
9636
|
-
:param ip_address: IPv4 address for the customer gateway device's outside interface. The address must be static.
|
|
9690
|
+
:param ip_address: IPv4 address for the customer gateway device's outside interface. The address must be static. If ``OutsideIpAddressType`` in your VPN connection options is set to ``PrivateIpv4`` , you can use an RFC6598 or RFC1918 private IPv4 address. If ``OutsideIpAddressType`` is set to ``PublicIpv4`` , you can use a public IPv4 address.
|
|
9637
9691
|
:param type: The type of VPN connection that this customer gateway supports ( ``ipsec.1`` ).
|
|
9638
|
-
:param bgp_asn: For devices that support BGP, the customer gateway
|
|
9639
|
-
:param bgp_asn_extended:
|
|
9692
|
+
:param bgp_asn: For customer gateway devices that support BGP, specify the device's ASN. You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` . Default: 65000 Valid values: ``1`` to ``2,147,483,647`` Default: - 65000
|
|
9693
|
+
:param bgp_asn_extended: For customer gateway devices that support BGP, specify the device's ASN. You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` . Valid values: ``2,147,483,648`` to ``4,294,967,295``
|
|
9640
9694
|
:param certificate_arn: The Amazon Resource Name (ARN) for the customer gateway certificate.
|
|
9641
9695
|
:param device_name: The name of customer gateway device.
|
|
9642
9696
|
:param tags: One or more tags for the customer gateway.
|
|
@@ -9693,7 +9747,7 @@ class CfnCustomerGatewayProps:
|
|
|
9693
9747
|
def ip_address(self) -> builtins.str:
|
|
9694
9748
|
'''IPv4 address for the customer gateway device's outside interface.
|
|
9695
9749
|
|
|
9696
|
-
The address must be static.
|
|
9750
|
+
The address must be static. If ``OutsideIpAddressType`` in your VPN connection options is set to ``PrivateIpv4`` , you can use an RFC6598 or RFC1918 private IPv4 address. If ``OutsideIpAddressType`` is set to ``PublicIpv4`` , you can use a public IPv4 address.
|
|
9697
9751
|
|
|
9698
9752
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customergateway.html#cfn-ec2-customergateway-ipaddress
|
|
9699
9753
|
'''
|
|
@@ -9713,10 +9767,14 @@ class CfnCustomerGatewayProps:
|
|
|
9713
9767
|
|
|
9714
9768
|
@builtins.property
|
|
9715
9769
|
def bgp_asn(self) -> typing.Optional[jsii.Number]:
|
|
9716
|
-
'''For devices that support BGP, the
|
|
9770
|
+
'''For customer gateway devices that support BGP, specify the device's ASN.
|
|
9771
|
+
|
|
9772
|
+
You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` .
|
|
9717
9773
|
|
|
9718
9774
|
Default: 65000
|
|
9719
9775
|
|
|
9776
|
+
Valid values: ``1`` to ``2,147,483,647``
|
|
9777
|
+
|
|
9720
9778
|
:default: - 65000
|
|
9721
9779
|
|
|
9722
9780
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customergateway.html#cfn-ec2-customergateway-bgpasn
|
|
@@ -9726,7 +9784,12 @@ class CfnCustomerGatewayProps:
|
|
|
9726
9784
|
|
|
9727
9785
|
@builtins.property
|
|
9728
9786
|
def bgp_asn_extended(self) -> typing.Optional[jsii.Number]:
|
|
9729
|
-
'''
|
|
9787
|
+
'''For customer gateway devices that support BGP, specify the device's ASN.
|
|
9788
|
+
|
|
9789
|
+
You must specify either ``BgpAsn`` or ``BgpAsnExtended`` when creating the customer gateway. If the ASN is larger than ``2,147,483,647`` , you must use ``BgpAsnExtended`` .
|
|
9790
|
+
|
|
9791
|
+
Valid values: ``2,147,483,648`` to ``4,294,967,295``
|
|
9792
|
+
|
|
9730
9793
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customergateway.html#cfn-ec2-customergateway-bgpasnextended
|
|
9731
9794
|
'''
|
|
9732
9795
|
result = self._values.get("bgp_asn_extended")
|
|
@@ -12564,8 +12627,8 @@ class CfnEC2Fleet(
|
|
|
12564
12627
|
|
|
12565
12628
|
:param allocation_strategy: The strategy that determines the order of the launch template overrides to use in fulfilling On-Demand capacity. ``lowest-price`` - EC2 Fleet uses price to determine the order, launching the lowest price first. ``prioritized`` - EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first. Default: ``lowest-price``
|
|
12566
12629
|
:param capacity_reservation_options: The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity. Supported only for fleets of type ``instant`` .
|
|
12567
|
-
:param max_total_price: The maximum amount per hour for On-Demand Instances that you're willing to pay. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
12568
|
-
:param min_target_capacity: The minimum target capacity for On-Demand Instances in the fleet. If
|
|
12630
|
+
:param max_total_price: The maximum amount per hour for On-Demand Instances that you're willing to pay. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
12631
|
+
:param min_target_capacity: The minimum target capacity for On-Demand Instances in the fleet. If this minimum capacity isn't reached, no instances are launched. Constraints: Maximum value of ``1000`` . Supported only for fleets of type ``instant`` . At least one of the following must be specified: ``SingleAvailabilityZone`` | ``SingleInstanceType``
|
|
12569
12632
|
:param single_availability_zone: Indicates that the fleet launches all On-Demand Instances into a single Availability Zone. Supported only for fleets of type ``instant`` .
|
|
12570
12633
|
:param single_instance_type: Indicates that the fleet uses a single instance type to launch all On-Demand Instances in the fleet. Supported only for fleets of type ``instant`` .
|
|
12571
12634
|
|
|
@@ -12645,7 +12708,7 @@ class CfnEC2Fleet(
|
|
|
12645
12708
|
|
|
12646
12709
|
.. epigraph::
|
|
12647
12710
|
|
|
12648
|
-
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
12711
|
+
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
12649
12712
|
|
|
12650
12713
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-ondemandoptionsrequest.html#cfn-ec2-ec2fleet-ondemandoptionsrequest-maxtotalprice
|
|
12651
12714
|
'''
|
|
@@ -12656,9 +12719,9 @@ class CfnEC2Fleet(
|
|
|
12656
12719
|
def min_target_capacity(self) -> typing.Optional[jsii.Number]:
|
|
12657
12720
|
'''The minimum target capacity for On-Demand Instances in the fleet.
|
|
12658
12721
|
|
|
12659
|
-
If
|
|
12722
|
+
If this minimum capacity isn't reached, no instances are launched.
|
|
12660
12723
|
|
|
12661
|
-
Supported only for fleets of type ``instant`` .
|
|
12724
|
+
Constraints: Maximum value of ``1000`` . Supported only for fleets of type ``instant`` .
|
|
12662
12725
|
|
|
12663
12726
|
At least one of the following must be specified: ``SingleAvailabilityZone`` | ``SingleInstanceType``
|
|
12664
12727
|
|
|
@@ -12928,8 +12991,8 @@ class CfnEC2Fleet(
|
|
|
12928
12991
|
:param instance_interruption_behavior: The behavior when a Spot Instance is interrupted. Default: ``terminate``
|
|
12929
12992
|
:param instance_pools_to_use_count: The number of Spot pools across which to allocate your target Spot capacity. Supported only when Spot ``AllocationStrategy`` is set to ``lowest-price`` . EC2 Fleet selects the cheapest Spot pools and evenly allocates your target Spot capacity across the number of Spot pools that you specify. Note that EC2 Fleet attempts to draw Spot Instances from the number of pools that you specify on a best effort basis. If a pool runs out of Spot capacity before fulfilling your target capacity, EC2 Fleet will continue to fulfill your request by drawing from the next cheapest pool. To ensure that your target capacity is met, you might receive Spot Instances from more than the number of pools that you specified. Similarly, if most of the pools have no Spot capacity, you might receive your full target capacity from fewer than the number of pools that you specified.
|
|
12930
12993
|
:param maintenance_strategies: The strategies for managing your Spot Instances that are at an elevated risk of being interrupted.
|
|
12931
|
-
:param max_total_price: The maximum amount per hour for Spot Instances that you're willing to pay. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. .. epigraph:: If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter. > If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
12932
|
-
:param min_target_capacity: The minimum target capacity for Spot Instances in the fleet. If
|
|
12994
|
+
:param max_total_price: The maximum amount per hour for Spot Instances that you're willing to pay. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. .. epigraph:: If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter. > If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
12995
|
+
:param min_target_capacity: The minimum target capacity for Spot Instances in the fleet. If this minimum capacity isn't reached, no instances are launched. Constraints: Maximum value of ``1000`` . Supported only for fleets of type ``instant`` . At least one of the following must be specified: ``SingleAvailabilityZone`` | ``SingleInstanceType``
|
|
12933
12996
|
:param single_availability_zone: Indicates that the fleet launches all Spot Instances into a single Availability Zone. Supported only for fleets of type ``instant`` .
|
|
12934
12997
|
:param single_instance_type: Indicates that the fleet uses a single instance type to launch all Spot Instances in the fleet. Supported only for fleets of type ``instant`` .
|
|
12935
12998
|
|
|
@@ -13045,7 +13108,7 @@ class CfnEC2Fleet(
|
|
|
13045
13108
|
We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.
|
|
13046
13109
|
.. epigraph::
|
|
13047
13110
|
|
|
13048
|
-
If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter. > If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
13111
|
+
If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter. > If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``MaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``MaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
13049
13112
|
|
|
13050
13113
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-spotoptionsrequest.html#cfn-ec2-ec2fleet-spotoptionsrequest-maxtotalprice
|
|
13051
13114
|
'''
|
|
@@ -13056,9 +13119,9 @@ class CfnEC2Fleet(
|
|
|
13056
13119
|
def min_target_capacity(self) -> typing.Optional[jsii.Number]:
|
|
13057
13120
|
'''The minimum target capacity for Spot Instances in the fleet.
|
|
13058
13121
|
|
|
13059
|
-
If
|
|
13122
|
+
If this minimum capacity isn't reached, no instances are launched.
|
|
13060
13123
|
|
|
13061
|
-
Supported only for fleets of type ``instant`` .
|
|
13124
|
+
Constraints: Maximum value of ``1000`` . Supported only for fleets of type ``instant`` .
|
|
13062
13125
|
|
|
13063
13126
|
At least one of the following must be specified: ``SingleAvailabilityZone`` | ``SingleInstanceType``
|
|
13064
13127
|
|
|
@@ -14976,7 +15039,7 @@ class CfnFlowLog(
|
|
|
14976
15039
|
:param log_destination_type: The type of destination for the flow log data. Default: ``cloud-watch-logs``
|
|
14977
15040
|
:param log_format: The fields to include in the flow log record, in the order in which they should appear. If you omit this parameter, the flow log is created using the default format. If you specify this parameter, you must include at least one field. For more information about the available fields, see `Flow log records <https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html#flow-log-records>`_ in the *Amazon VPC User Guide* or `Transit Gateway Flow Log records <https://docs.aws.amazon.com/vpc/latest/tgw/tgw-flow-logs.html#flow-log-records>`_ in the *AWS Transit Gateway Guide* . Specify the fields using the ``${field-id}`` format, separated by spaces.
|
|
14978
15041
|
:param log_group_name: The name of a new or existing CloudWatch Logs log group where Amazon EC2 publishes your flow logs. This parameter is valid only if the destination type is ``cloud-watch-logs`` .
|
|
14979
|
-
:param max_aggregation_interval: The maximum interval of time during which a flow of packets is captured and aggregated into a flow log record. The possible values are 60 seconds (1 minute) or 600 seconds (10 minutes). This parameter must be 60 seconds for transit gateway resource types. When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/
|
|
15042
|
+
:param max_aggregation_interval: The maximum interval of time during which a flow of packets is captured and aggregated into a flow log record. The possible values are 60 seconds (1 minute) or 600 seconds (10 minutes). This parameter must be 60 seconds for transit gateway resource types. When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ , the aggregation interval is always 60 seconds or less, regardless of the value that you specify. Default: 600
|
|
14980
15043
|
:param tags: The tags to apply to the flow logs.
|
|
14981
15044
|
:param traffic_type: The type of traffic to monitor (accepted traffic, rejected traffic, or all traffic). This parameter is not supported for transit gateway resource types. It is required for the other resource types.
|
|
14982
15045
|
'''
|
|
@@ -15359,7 +15422,7 @@ class CfnFlowLogProps:
|
|
|
15359
15422
|
:param log_destination_type: The type of destination for the flow log data. Default: ``cloud-watch-logs``
|
|
15360
15423
|
:param log_format: The fields to include in the flow log record, in the order in which they should appear. If you omit this parameter, the flow log is created using the default format. If you specify this parameter, you must include at least one field. For more information about the available fields, see `Flow log records <https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html#flow-log-records>`_ in the *Amazon VPC User Guide* or `Transit Gateway Flow Log records <https://docs.aws.amazon.com/vpc/latest/tgw/tgw-flow-logs.html#flow-log-records>`_ in the *AWS Transit Gateway Guide* . Specify the fields using the ``${field-id}`` format, separated by spaces.
|
|
15361
15424
|
:param log_group_name: The name of a new or existing CloudWatch Logs log group where Amazon EC2 publishes your flow logs. This parameter is valid only if the destination type is ``cloud-watch-logs`` .
|
|
15362
|
-
:param max_aggregation_interval: The maximum interval of time during which a flow of packets is captured and aggregated into a flow log record. The possible values are 60 seconds (1 minute) or 600 seconds (10 minutes). This parameter must be 60 seconds for transit gateway resource types. When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/
|
|
15425
|
+
:param max_aggregation_interval: The maximum interval of time during which a flow of packets is captured and aggregated into a flow log record. The possible values are 60 seconds (1 minute) or 600 seconds (10 minutes). This parameter must be 60 seconds for transit gateway resource types. When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ , the aggregation interval is always 60 seconds or less, regardless of the value that you specify. Default: 600
|
|
15363
15426
|
:param tags: The tags to apply to the flow logs.
|
|
15364
15427
|
:param traffic_type: The type of traffic to monitor (accepted traffic, rejected traffic, or all traffic). This parameter is not supported for transit gateway resource types. It is required for the other resource types.
|
|
15365
15428
|
|
|
@@ -15550,7 +15613,7 @@ class CfnFlowLogProps:
|
|
|
15550
15613
|
|
|
15551
15614
|
The possible values are 60 seconds (1 minute) or 600 seconds (10 minutes). This parameter must be 60 seconds for transit gateway resource types.
|
|
15552
15615
|
|
|
15553
|
-
When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/
|
|
15616
|
+
When a network interface is attached to a `Nitro-based instance <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ , the aggregation interval is always 60 seconds or less, regardless of the value that you specify.
|
|
15554
15617
|
|
|
15555
15618
|
Default: 600
|
|
15556
15619
|
|
|
@@ -15837,7 +15900,7 @@ class CfnHost(
|
|
|
15837
15900
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
15838
15901
|
:param availability_zone: The Availability Zone in which to allocate the Dedicated Host.
|
|
15839
15902
|
:param asset_id: The ID of the Outpost hardware asset on which the Dedicated Host is allocated.
|
|
15840
|
-
:param auto_placement: Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. For more information, see `Understanding auto-placement and affinity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding>`_ in the *Amazon EC2 User Guide* . Default: ``
|
|
15903
|
+
:param auto_placement: Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. For more information, see `Understanding auto-placement and affinity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding>`_ in the *Amazon EC2 User Guide* . Default: ``off``
|
|
15841
15904
|
:param host_maintenance: Indicates whether host maintenance is enabled or disabled for the Dedicated Host.
|
|
15842
15905
|
:param host_recovery: Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default. For more information, see `Host recovery <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-recovery.html>`_ in the *Amazon EC2 User Guide* . Default: ``off``
|
|
15843
15906
|
:param instance_family: The instance family supported by the Dedicated Host. For example, ``m5`` .
|
|
@@ -16041,7 +16104,7 @@ class CfnHostProps:
|
|
|
16041
16104
|
|
|
16042
16105
|
:param availability_zone: The Availability Zone in which to allocate the Dedicated Host.
|
|
16043
16106
|
:param asset_id: The ID of the Outpost hardware asset on which the Dedicated Host is allocated.
|
|
16044
|
-
:param auto_placement: Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. For more information, see `Understanding auto-placement and affinity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding>`_ in the *Amazon EC2 User Guide* . Default: ``
|
|
16107
|
+
:param auto_placement: Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. For more information, see `Understanding auto-placement and affinity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding>`_ in the *Amazon EC2 User Guide* . Default: ``off``
|
|
16045
16108
|
:param host_maintenance: Indicates whether host maintenance is enabled or disabled for the Dedicated Host.
|
|
16046
16109
|
:param host_recovery: Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default. For more information, see `Host recovery <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-recovery.html>`_ in the *Amazon EC2 User Guide* . Default: ``off``
|
|
16047
16110
|
:param instance_family: The instance family supported by the Dedicated Host. For example, ``m5`` .
|
|
@@ -16123,7 +16186,7 @@ class CfnHostProps:
|
|
|
16123
16186
|
|
|
16124
16187
|
For more information, see `Understanding auto-placement and affinity <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding>`_ in the *Amazon EC2 User Guide* .
|
|
16125
16188
|
|
|
16126
|
-
Default: ``
|
|
16189
|
+
Default: ``off``
|
|
16127
16190
|
|
|
16128
16191
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-host.html#cfn-ec2-host-autoplacement
|
|
16129
16192
|
'''
|
|
@@ -19311,7 +19374,7 @@ class CfnInstance(
|
|
|
19311
19374
|
:param elastic_gpu_specifications: An elastic GPU to associate with the instance. .. epigraph:: Amazon Elastic Graphics reached end of life on January 8, 2024.
|
|
19312
19375
|
:param elastic_inference_accelerators: An elastic inference accelerator to associate with the instance. .. epigraph:: Amazon Elastic Inference (EI) is no longer available to new customers. For more information, see `Amazon Elastic Inference FAQs <https://docs.aws.amazon.com/machine-learning/elastic-inference/faqs/>`_ .
|
|
19313
19376
|
:param enclave_options: Indicates whether the instance is enabled for AWS Nitro Enclaves.
|
|
19314
|
-
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* . You can't enable hibernation and AWS Nitro Enclaves on the same instance.
|
|
19377
|
+
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your Amazon EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* . You can't enable hibernation and AWS Nitro Enclaves on the same instance.
|
|
19315
19378
|
:param host_id: If you specify host for the ``Affinity`` property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account. This type of launch is called an untargeted launch. Note that for untargeted launches, you must have a compatible, dedicated host available to successfully launch instances.
|
|
19316
19379
|
:param host_resource_group_arn: The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the *Tenancy* parameter or set it to ``host`` .
|
|
19317
19380
|
:param iam_instance_profile: The name of an IAM instance profile. To create a new IAM instance profile, use the `AWS::IAM::InstanceProfile <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html>`_ resource.
|
|
@@ -20745,7 +20808,7 @@ class CfnInstance(
|
|
|
20745
20808
|
|
|
20746
20809
|
``ElasticGpuSpecification`` is a property of the `AWS::EC2::Instance <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html>`_ resource.
|
|
20747
20810
|
|
|
20748
|
-
:param type: The type of Elastic Graphics accelerator.
|
|
20811
|
+
:param type: The type of Elastic Graphics accelerator.
|
|
20749
20812
|
|
|
20750
20813
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-elasticgpuspecification.html
|
|
20751
20814
|
:exampleMetadata: fixture=_generated
|
|
@@ -20771,8 +20834,6 @@ class CfnInstance(
|
|
|
20771
20834
|
def type(self) -> builtins.str:
|
|
20772
20835
|
'''The type of Elastic Graphics accelerator.
|
|
20773
20836
|
|
|
20774
|
-
For more information about the values to specify for ``Type`` , see `Elastic Graphics Basics <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/elastic-graphics.html#elastic-graphics-basics>`_ , specifically the Elastic Graphics accelerator column, in the *Amazon Elastic Compute Cloud User Guide for Windows Instances* .
|
|
20775
|
-
|
|
20776
20837
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-elasticgpuspecification.html#cfn-ec2-instance-elasticgpuspecification-type
|
|
20777
20838
|
'''
|
|
20778
20839
|
result = self._values.get("type")
|
|
@@ -22370,7 +22431,7 @@ class CfnInstanceProps:
|
|
|
22370
22431
|
:param elastic_gpu_specifications: An elastic GPU to associate with the instance. .. epigraph:: Amazon Elastic Graphics reached end of life on January 8, 2024.
|
|
22371
22432
|
:param elastic_inference_accelerators: An elastic inference accelerator to associate with the instance. .. epigraph:: Amazon Elastic Inference (EI) is no longer available to new customers. For more information, see `Amazon Elastic Inference FAQs <https://docs.aws.amazon.com/machine-learning/elastic-inference/faqs/>`_ .
|
|
22372
22433
|
:param enclave_options: Indicates whether the instance is enabled for AWS Nitro Enclaves.
|
|
22373
|
-
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* . You can't enable hibernation and AWS Nitro Enclaves on the same instance.
|
|
22434
|
+
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your Amazon EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* . You can't enable hibernation and AWS Nitro Enclaves on the same instance.
|
|
22374
22435
|
:param host_id: If you specify host for the ``Affinity`` property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account. This type of launch is called an untargeted launch. Note that for untargeted launches, you must have a compatible, dedicated host available to successfully launch instances.
|
|
22375
22436
|
:param host_resource_group_arn: The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the *Tenancy* parameter or set it to ``host`` .
|
|
22376
22437
|
:param iam_instance_profile: The name of an IAM instance profile. To create a new IAM instance profile, use the `AWS::IAM::InstanceProfile <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html>`_ resource.
|
|
@@ -22814,7 +22875,7 @@ class CfnInstanceProps:
|
|
|
22814
22875
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnInstance.HibernationOptionsProperty]]:
|
|
22815
22876
|
'''Indicates whether an instance is enabled for hibernation.
|
|
22816
22877
|
|
|
22817
|
-
This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* .
|
|
22878
|
+
This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your Amazon EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* .
|
|
22818
22879
|
|
|
22819
22880
|
You can't enable hibernation and AWS Nitro Enclaves on the same instance.
|
|
22820
22881
|
|
|
@@ -24440,7 +24501,7 @@ class CfnLaunchTemplate(
|
|
|
24440
24501
|
) -> None:
|
|
24441
24502
|
'''A security group connection tracking specification that enables you to set the idle timeout for connection tracking on an Elastic network interface.
|
|
24442
24503
|
|
|
24443
|
-
For more information, see `Connection tracking timeouts <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-connection-tracking.html#connection-tracking-timeouts>`_ in the *Amazon
|
|
24504
|
+
For more information, see `Connection tracking timeouts <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-connection-tracking.html#connection-tracking-timeouts>`_ in the *Amazon EC2 User Guide* .
|
|
24444
24505
|
|
|
24445
24506
|
:param tcp_established_timeout: Timeout (in seconds) for idle TCP connections in an established state. Min: 60 seconds. Max: 432000 seconds (5 days). Default: 432000 seconds. Recommended: Less than 432000 seconds.
|
|
24446
24507
|
:param udp_stream_timeout: Timeout (in seconds) for idle UDP flows classified as streams which have seen more than one request-response transaction. Min: 60 seconds. Max: 180 seconds (3 minutes). Default: 180 seconds.
|
|
@@ -24892,7 +24953,7 @@ class CfnLaunchTemplate(
|
|
|
24892
24953
|
|
|
24893
24954
|
``ElasticGpuSpecification`` is a property of `AWS::EC2::LaunchTemplate LaunchTemplateData <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html>`_ .
|
|
24894
24955
|
|
|
24895
|
-
:param type: The type of Elastic Graphics accelerator.
|
|
24956
|
+
:param type: The type of Elastic Graphics accelerator.
|
|
24896
24957
|
|
|
24897
24958
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-elasticgpuspecification.html
|
|
24898
24959
|
:exampleMetadata: fixture=_generated
|
|
@@ -24918,8 +24979,6 @@ class CfnLaunchTemplate(
|
|
|
24918
24979
|
def type(self) -> typing.Optional[builtins.str]:
|
|
24919
24980
|
'''The type of Elastic Graphics accelerator.
|
|
24920
24981
|
|
|
24921
|
-
For more information about the values to specify for ``Type`` , see `Elastic Graphics Basics <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/elastic-graphics.html#elastic-graphics-basics>`_ , specifically the Elastic Graphics accelerator column, in the *Amazon Elastic Compute Cloud User Guide for Windows Instances* .
|
|
24922
|
-
|
|
24923
24982
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-elasticgpuspecification.html#cfn-ec2-launchtemplate-elasticgpuspecification-type
|
|
24924
24983
|
'''
|
|
24925
24984
|
result = self._values.get("type")
|
|
@@ -26023,7 +26082,7 @@ class CfnLaunchTemplate(
|
|
|
26023
26082
|
|
|
26024
26083
|
``Ipv4PrefixSpecification`` is a property of `AWS::EC2::LaunchTemplate NetworkInterface <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html>`_ .
|
|
26025
26084
|
|
|
26026
|
-
:param ipv4_prefix: The IPv4 prefix. For information, see `Assigning prefixes to
|
|
26085
|
+
:param ipv4_prefix: The IPv4 prefix. For information, see `Assigning prefixes to network interfaces <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html>`_ in the *Amazon EC2 User Guide* .
|
|
26027
26086
|
|
|
26028
26087
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-ipv4prefixspecification.html
|
|
26029
26088
|
:exampleMetadata: fixture=_generated
|
|
@@ -26049,7 +26108,7 @@ class CfnLaunchTemplate(
|
|
|
26049
26108
|
def ipv4_prefix(self) -> typing.Optional[builtins.str]:
|
|
26050
26109
|
'''The IPv4 prefix.
|
|
26051
26110
|
|
|
26052
|
-
For information, see `Assigning prefixes to
|
|
26111
|
+
For information, see `Assigning prefixes to network interfaces <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html>`_ in the *Amazon EC2 User Guide* .
|
|
26053
26112
|
|
|
26054
26113
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-ipv4prefixspecification.html#cfn-ec2-launchtemplate-ipv4prefixspecification-ipv4prefix
|
|
26055
26114
|
'''
|
|
@@ -26264,35 +26323,35 @@ class CfnLaunchTemplate(
|
|
|
26264
26323
|
|
|
26265
26324
|
:param block_device_mappings: The block device mapping.
|
|
26266
26325
|
:param capacity_reservation_specification: The Capacity Reservation targeting option. If you do not specify this parameter, the instance's Capacity Reservation preference defaults to ``open`` , which enables it to run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
|
|
26267
|
-
:param cpu_options: The CPU options for the instance. For more information, see `
|
|
26326
|
+
:param cpu_options: The CPU options for the instance. For more information, see `Optimize CPU options <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html>`_ in the *Amazon EC2 User Guide* .
|
|
26268
26327
|
:param credit_specification: The credit option for CPU usage of the instance. Valid only for T instances.
|
|
26269
|
-
:param disable_api_stop: Indicates whether to enable the instance for stop protection. For more information, see `
|
|
26328
|
+
:param disable_api_stop: Indicates whether to enable the instance for stop protection. For more information, see `Enable stop protection for your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-stop-protection.html>`_ in the *Amazon EC2 User Guide* .
|
|
26270
26329
|
:param disable_api_termination: If you set this parameter to ``true`` , you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. To change this attribute after launch, use `ModifyInstanceAttribute <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html>`_ . Alternatively, if you set ``InstanceInitiatedShutdownBehavior`` to ``terminate`` , you can terminate the instance by running the shutdown command from the instance.
|
|
26271
26330
|
:param ebs_optimized: Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.
|
|
26272
26331
|
:param elastic_gpu_specifications: Deprecated. .. epigraph:: Amazon Elastic Graphics reached end of life on January 8, 2024. For workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4ad, G4dn, or G5 instances.
|
|
26273
26332
|
:param elastic_inference_accelerators: An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. You cannot specify accelerators from different generations in the same request. .. epigraph:: Starting April 15, 2023, AWS will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.
|
|
26274
26333
|
:param enclave_options: Indicates whether the instance is enabled for AWS Nitro Enclaves. For more information, see `What is AWS Nitro Enclaves? <https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html>`_ in the *AWS Nitro Enclaves User Guide* . You can't enable AWS Nitro Enclaves and hibernation on the same instance.
|
|
26275
|
-
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon
|
|
26334
|
+
:param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your Amazon EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* .
|
|
26276
26335
|
:param iam_instance_profile: The name or Amazon Resource Name (ARN) of an IAM instance profile.
|
|
26277
26336
|
:param image_id: The ID of the AMI. Alternatively, you can specify a Systems Manager parameter, which will resolve to an AMI ID on launch. Valid formats: - ``ami-17characters00000`` - ``resolve:ssm:parameter-name`` - ``resolve:ssm:parameter-name:version-number`` - ``resolve:ssm:parameter-name:label`` For more information, see `Use a Systems Manager parameter to find an AMI <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html#using-systems-manager-parameter-to-find-AMI>`_ in the *Amazon Elastic Compute Cloud User Guide* .
|
|
26278
26337
|
:param instance_initiated_shutdown_behavior: Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown). Default: ``stop``
|
|
26279
26338
|
:param instance_market_options: The market (purchasing) option for the instances.
|
|
26280
26339
|
:param instance_requirements: The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with these attributes. You must specify ``VCpuCount`` and ``MemoryMiB`` . All other attributes are optional. Any unspecified optional attribute is set to its default. When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values. To limit the list of instance types from which Amazon EC2 can identify matching instance types, you can use one of the following parameters, but not both in the same request: - ``AllowedInstanceTypes`` - The instance types to include in the list. All other instance types are ignored, even if they match your specified attributes. - ``ExcludedInstanceTypes`` - The instance types to exclude from the list, even if they match your specified attributes. .. epigraph:: If you specify ``InstanceRequirements`` , you can't specify ``InstanceType`` . Attribute-based instance type selection is only supported when using Auto Scaling groups, EC2 Fleet, and Spot Fleet to launch instances. If you plan to use the launch template in the `launch instance wizard <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html>`_ , or with the `RunInstances <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html>`_ API or `AWS::EC2::Instance <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html>`_ AWS CloudFormation resource, you can't specify ``InstanceRequirements`` . For more information, see `Attribute-based instance type selection for EC2 Fleet <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html>`_ , `Attribute-based instance type selection for Spot Fleet <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-attribute-based-instance-type-selection.html>`_ , and `Spot placement score <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html>`_ in the *Amazon EC2 User Guide* .
|
|
26281
|
-
:param instance_type: The instance type. For more information, see `
|
|
26340
|
+
:param instance_type: The instance type. For more information, see `Amazon EC2 instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* . If you specify ``InstanceType`` , you can't specify ``InstanceRequirements`` .
|
|
26282
26341
|
:param kernel_id: The ID of the kernel. We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `User Provided Kernels <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon EC2 User Guide* .
|
|
26283
26342
|
:param key_name: The name of the key pair. You can create a key pair using `CreateKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html>`_ or `ImportKeyPair <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html>`_ . .. epigraph:: If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured to allow users another way to log in.
|
|
26284
26343
|
:param license_specifications: The license configurations.
|
|
26285
26344
|
:param maintenance_options: The maintenance options of your instance.
|
|
26286
|
-
:param metadata_options: The metadata options for the instance. For more information, see `Instance metadata and user data <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html>`_ in the *Amazon
|
|
26345
|
+
:param metadata_options: The metadata options for the instance. For more information, see `Instance metadata and user data <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html>`_ in the *Amazon EC2 User Guide* .
|
|
26287
26346
|
:param monitoring: The monitoring for the instance.
|
|
26288
26347
|
:param network_interfaces: The network interfaces for the instance.
|
|
26289
26348
|
:param placement: The placement for the instance.
|
|
26290
26349
|
:param private_dns_name_options: The hostname type for EC2 instances launched into this subnet and how DNS A and AAAA record queries should be handled. For more information, see `Amazon EC2 instance hostname types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html>`_ in the *Amazon Elastic Compute Cloud User Guide* .
|
|
26291
|
-
:param ram_disk_id: The ID of the RAM disk. .. epigraph:: We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `User provided kernels <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon
|
|
26350
|
+
:param ram_disk_id: The ID of the RAM disk. .. epigraph:: We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `User provided kernels <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon EC2 User Guide* .
|
|
26292
26351
|
:param security_group_ids: The IDs of the security groups. You can specify the IDs of existing security groups and references to resources created by the stack template. If you specify a network interface, you must specify any security groups as part of the network interface instead.
|
|
26293
26352
|
:param security_groups: The names of the security groups. For a nondefault VPC, you must use security group IDs instead. If you specify a network interface, you must specify any security groups as part of the network interface instead of using this parameter.
|
|
26294
26353
|
:param tag_specifications: The tags to apply to the resources that are created during instance launch. To tag a resource after it has been created, see `CreateTags <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html>`_ . To tag the launch template itself, use `TagSpecifications <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html#cfn-ec2-launchtemplate-tagspecifications>`_ .
|
|
26295
|
-
:param user_data: The user data to make available to the instance. You must provide base64-encoded text. User data is limited to 16 KB. For more information, see `Run commands on your Linux instance at launch <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html>`_ (Linux) or `Work with instance user data <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/instancedata-add-user-data.html>`_ (Windows) in the *Amazon
|
|
26354
|
+
:param user_data: The user data to make available to the instance. You must provide base64-encoded text. User data is limited to 16 KB. For more information, see `Run commands on your Linux instance at launch <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html>`_ (Linux) or `Work with instance user data <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/instancedata-add-user-data.html>`_ (Windows) in the *Amazon EC2 User Guide* . If you are creating the launch template for use with AWS Batch , the user data must be provided in the `MIME multi-part archive format <https://docs.aws.amazon.com/https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive>`_ . For more information, see `Amazon EC2 user data in launch templates <https://docs.aws.amazon.com/batch/latest/userguide/launch-templates.html>`_ in the *AWS Batch User Guide* .
|
|
26296
26355
|
|
|
26297
26356
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html
|
|
26298
26357
|
:exampleMetadata: fixture=_generated
|
|
@@ -26636,7 +26695,7 @@ class CfnLaunchTemplate(
|
|
|
26636
26695
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnLaunchTemplate.CpuOptionsProperty"]]:
|
|
26637
26696
|
'''The CPU options for the instance.
|
|
26638
26697
|
|
|
26639
|
-
For more information, see `
|
|
26698
|
+
For more information, see `Optimize CPU options <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html>`_ in the *Amazon EC2 User Guide* .
|
|
26640
26699
|
|
|
26641
26700
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-cpuoptions
|
|
26642
26701
|
'''
|
|
@@ -26662,7 +26721,7 @@ class CfnLaunchTemplate(
|
|
|
26662
26721
|
) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
|
|
26663
26722
|
'''Indicates whether to enable the instance for stop protection.
|
|
26664
26723
|
|
|
26665
|
-
For more information, see `
|
|
26724
|
+
For more information, see `Enable stop protection for your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-stop-protection.html>`_ in the *Amazon EC2 User Guide* .
|
|
26666
26725
|
|
|
26667
26726
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-disableapistop
|
|
26668
26727
|
'''
|
|
@@ -26749,7 +26808,7 @@ class CfnLaunchTemplate(
|
|
|
26749
26808
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnLaunchTemplate.HibernationOptionsProperty"]]:
|
|
26750
26809
|
'''Indicates whether an instance is enabled for hibernation.
|
|
26751
26810
|
|
|
26752
|
-
This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon
|
|
26811
|
+
This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your Amazon EC2 instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon EC2 User Guide* .
|
|
26753
26812
|
|
|
26754
26813
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-hibernationoptions
|
|
26755
26814
|
'''
|
|
@@ -26841,7 +26900,7 @@ class CfnLaunchTemplate(
|
|
|
26841
26900
|
|
|
26842
26901
|
@builtins.property
|
|
26843
26902
|
def instance_type(self) -> typing.Optional[builtins.str]:
|
|
26844
|
-
'''The instance type. For more information, see `
|
|
26903
|
+
'''The instance type. For more information, see `Amazon EC2 instance types <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html>`_ in the *Amazon EC2 User Guide* .
|
|
26845
26904
|
|
|
26846
26905
|
If you specify ``InstanceType`` , you can't specify ``InstanceRequirements`` .
|
|
26847
26906
|
|
|
@@ -26902,7 +26961,7 @@ class CfnLaunchTemplate(
|
|
|
26902
26961
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnLaunchTemplate.MetadataOptionsProperty"]]:
|
|
26903
26962
|
'''The metadata options for the instance.
|
|
26904
26963
|
|
|
26905
|
-
For more information, see `Instance metadata and user data <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html>`_ in the *Amazon
|
|
26964
|
+
For more information, see `Instance metadata and user data <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html>`_ in the *Amazon EC2 User Guide* .
|
|
26906
26965
|
|
|
26907
26966
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-metadataoptions
|
|
26908
26967
|
'''
|
|
@@ -26961,7 +27020,7 @@ class CfnLaunchTemplate(
|
|
|
26961
27020
|
|
|
26962
27021
|
.. epigraph::
|
|
26963
27022
|
|
|
26964
|
-
We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `User provided kernels <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon
|
|
27023
|
+
We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see `User provided kernels <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html>`_ in the *Amazon EC2 User Guide* .
|
|
26965
27024
|
|
|
26966
27025
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-ramdiskid
|
|
26967
27026
|
'''
|
|
@@ -27011,7 +27070,7 @@ class CfnLaunchTemplate(
|
|
|
27011
27070
|
def user_data(self) -> typing.Optional[builtins.str]:
|
|
27012
27071
|
'''The user data to make available to the instance.
|
|
27013
27072
|
|
|
27014
|
-
You must provide base64-encoded text. User data is limited to 16 KB. For more information, see `Run commands on your Linux instance at launch <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html>`_ (Linux) or `Work with instance user data <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/instancedata-add-user-data.html>`_ (Windows) in the *Amazon
|
|
27073
|
+
You must provide base64-encoded text. User data is limited to 16 KB. For more information, see `Run commands on your Linux instance at launch <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html>`_ (Linux) or `Work with instance user data <https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/instancedata-add-user-data.html>`_ (Windows) in the *Amazon EC2 User Guide* .
|
|
27015
27074
|
|
|
27016
27075
|
If you are creating the launch template for use with AWS Batch , the user data must be provided in the `MIME multi-part archive format <https://docs.aws.amazon.com/https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive>`_ . For more information, see `Amazon EC2 user data in launch templates <https://docs.aws.amazon.com/batch/latest/userguide/launch-templates.html>`_ in the *AWS Batch User Guide* .
|
|
27017
27076
|
|
|
@@ -27873,7 +27932,7 @@ class CfnLaunchTemplate(
|
|
|
27873
27932
|
:param device_index: The device index for the network interface attachment. Each network interface requires a device index. If you create a launch template that includes secondary network interfaces but not a primary network interface, then you must add a primary network interface as a launch parameter when you launch an instance from the template.
|
|
27874
27933
|
:param ena_srd_specification: The ENA Express configuration for the network interface.
|
|
27875
27934
|
:param groups: The IDs of one or more security groups.
|
|
27876
|
-
:param interface_type: The type of network interface. To create an Elastic Fabric Adapter (EFA), specify ``efa`` . For more information, see `Elastic Fabric Adapter <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html>`_ in the *Amazon
|
|
27935
|
+
:param interface_type: The type of network interface. To create an Elastic Fabric Adapter (EFA), specify ``efa`` . For more information, see `Elastic Fabric Adapter <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html>`_ in the *Amazon EC2 User Guide* . If you are not creating an EFA, specify ``interface`` or omit this parameter. Valid values: ``interface`` | ``efa``
|
|
27877
27936
|
:param ipv4_prefix_count: The number of IPv4 prefixes to be automatically assigned to the network interface. You cannot use this option if you use the ``Ipv4Prefix`` option.
|
|
27878
27937
|
:param ipv4_prefixes: One or more IPv4 prefixes to be assigned to the network interface. You cannot use this option if you use the ``Ipv4PrefixCount`` option.
|
|
27879
27938
|
:param ipv6_address_count: The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses.
|
|
@@ -28102,7 +28161,7 @@ class CfnLaunchTemplate(
|
|
|
28102
28161
|
def interface_type(self) -> typing.Optional[builtins.str]:
|
|
28103
28162
|
'''The type of network interface.
|
|
28104
28163
|
|
|
28105
|
-
To create an Elastic Fabric Adapter (EFA), specify ``efa`` . For more information, see `Elastic Fabric Adapter <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html>`_ in the *Amazon
|
|
28164
|
+
To create an Elastic Fabric Adapter (EFA), specify ``efa`` . For more information, see `Elastic Fabric Adapter <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html>`_ in the *Amazon EC2 User Guide* .
|
|
28106
28165
|
|
|
28107
28166
|
If you are not creating an EFA, specify ``interface`` or omit this parameter.
|
|
28108
28167
|
|
|
@@ -37508,7 +37567,7 @@ class CfnNetworkInterface(
|
|
|
37508
37567
|
def __init__(self, *, ipv4_prefix: builtins.str) -> None:
|
|
37509
37568
|
'''Describes an IPv4 prefix.
|
|
37510
37569
|
|
|
37511
|
-
:param ipv4_prefix: The IPv4 prefix. For information, see `Assigning prefixes to
|
|
37570
|
+
:param ipv4_prefix: The IPv4 prefix. For information, see `Assigning prefixes to network interfaces <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html>`_ in the *Amazon EC2 User Guide* .
|
|
37512
37571
|
|
|
37513
37572
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkinterface-ipv4prefixspecification.html
|
|
37514
37573
|
:exampleMetadata: fixture=_generated
|
|
@@ -37534,7 +37593,7 @@ class CfnNetworkInterface(
|
|
|
37534
37593
|
def ipv4_prefix(self) -> builtins.str:
|
|
37535
37594
|
'''The IPv4 prefix.
|
|
37536
37595
|
|
|
37537
|
-
For information, see `Assigning prefixes to
|
|
37596
|
+
For information, see `Assigning prefixes to network interfaces <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html>`_ in the *Amazon EC2 User Guide* .
|
|
37538
37597
|
|
|
37539
37598
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkinterface-ipv4prefixspecification.html#cfn-ec2-networkinterface-ipv4prefixspecification-ipv4prefix
|
|
37540
37599
|
'''
|
|
@@ -45711,7 +45770,7 @@ class CfnSpotFleet(
|
|
|
45711
45770
|
) -> None:
|
|
45712
45771
|
'''The Spot Instance replacement strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted.
|
|
45713
45772
|
|
|
45714
|
-
For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide
|
|
45773
|
+
For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide* .
|
|
45715
45774
|
|
|
45716
45775
|
:param replacement_strategy: The replacement strategy to use. Only available for fleets of type ``maintain`` . ``launch`` - Spot Fleet launches a new replacement Spot Instance when a rebalance notification is emitted for an existing Spot Instance in the fleet. Spot Fleet does not terminate the instances that receive a rebalance notification. You can terminate the old instances, or you can leave them running. You are charged for all instances while they are running. ``launch-before-terminate`` - Spot Fleet launches a new replacement Spot Instance when a rebalance notification is emitted for an existing Spot Instance in the fleet, and then, after a delay that you specify (in ``TerminationDelay`` ), terminates the instances that received a rebalance notification.
|
|
45717
45776
|
:param termination_delay: The amount of time (in seconds) that Amazon EC2 waits before terminating the old Spot Instance after launching a new replacement Spot Instance. Required when ``ReplacementStrategy`` is set to ``launch-before-terminate`` . Not valid when ``ReplacementStrategy`` is set to ``launch`` . Valid values: Minimum value of ``120`` seconds. Maximum value of ``7200`` seconds.
|
|
@@ -46399,11 +46458,11 @@ class CfnSpotFleet(
|
|
|
46399
46458
|
:param launch_template_configs: The launch template and overrides. If you specify ``LaunchTemplateConfigs`` , you can't specify ``LaunchSpecifications`` .
|
|
46400
46459
|
:param load_balancers_config: One or more Classic Load Balancers and target groups to attach to the Spot Fleet request. Spot Fleet registers the running Spot Instances with the specified Classic Load Balancers and target groups. With Network Load Balancers, Spot Fleet cannot register instances that have the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, and T1.
|
|
46401
46460
|
:param on_demand_allocation_strategy: The order of the launch template overrides to use in fulfilling On-Demand capacity. If you specify ``lowestPrice`` , Spot Fleet uses price to determine the order, launching the lowest price first. If you specify ``prioritized`` , Spot Fleet uses the priority that you assign to each Spot Fleet launch template override, launching the highest priority first. If you do not specify a value, Spot Fleet defaults to ``lowestPrice`` .
|
|
46402
|
-
:param on_demand_max_total_price: The maximum amount per hour for On-Demand Instances that you're willing to pay. You can use the ``onDemandMaxTotalPrice`` parameter, the ``spotMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``onDemandMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``onDemandMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
46461
|
+
:param on_demand_max_total_price: The maximum amount per hour for On-Demand Instances that you're willing to pay. You can use the ``onDemandMaxTotalPrice`` parameter, the ``spotMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``onDemandMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``onDemandMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
46403
46462
|
:param on_demand_target_capacity: The number of On-Demand units to request. You can choose to set the target capacity in terms of instances or a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is ``maintain`` , you can specify a target capacity of 0 and add capacity later.
|
|
46404
46463
|
:param replace_unhealthy_instances: Indicates whether Spot Fleet should replace unhealthy instances.
|
|
46405
46464
|
:param spot_maintenance_strategies: The strategies for managing your Spot Instances that are at an elevated risk of being interrupted.
|
|
46406
|
-
:param spot_max_total_price: The maximum amount per hour for Spot Instances that you're willing to pay. You can use the ``spotMaxTotalPrice`` parameter, the ``onDemandMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``spotMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``spotMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
46465
|
+
:param spot_max_total_price: The maximum amount per hour for Spot Instances that you're willing to pay. You can use the ``spotMaxTotalPrice`` parameter, the ``onDemandMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity. .. epigraph:: If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``spotMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``spotMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
46407
46466
|
:param spot_price: The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. .. epigraph:: If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.
|
|
46408
46467
|
:param tag_specifications: The key-value pair for tagging the Spot Fleet request on creation. The value for ``ResourceType`` must be ``spot-fleet-request`` , otherwise the Spot Fleet request fails. To tag instances at launch, specify the tags in the `launch template <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#create-launch-template>`_ (valid only if you use ``LaunchTemplateConfigs`` ) or in the ``[SpotFleetTagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_SpotFleetTagSpecification.html)`` (valid only if you use ``LaunchSpecifications`` ). For information about tagging after launch, see `Tag your resources <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources>`_ .
|
|
46409
46468
|
:param target_capacity_unit_type: The unit for the target capacity. You can specify this parameter only when using attribute-based instance type selection. Default: ``units`` (the number of instances)
|
|
@@ -46881,7 +46940,7 @@ class CfnSpotFleet(
|
|
|
46881
46940
|
You can use the ``onDemandMaxTotalPrice`` parameter, the ``spotMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity.
|
|
46882
46941
|
.. epigraph::
|
|
46883
46942
|
|
|
46884
|
-
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``onDemandMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``onDemandMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
46943
|
+
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``onDemandMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``onDemandMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
46885
46944
|
|
|
46886
46945
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-ondemandmaxtotalprice
|
|
46887
46946
|
'''
|
|
@@ -46928,7 +46987,7 @@ class CfnSpotFleet(
|
|
|
46928
46987
|
You can use the ``spotMaxTotalPrice`` parameter, the ``onDemandMaxTotalPrice`` parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, Spot Fleet will launch instances until it reaches the maximum amount you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn’t met the target capacity.
|
|
46929
46988
|
.. epigraph::
|
|
46930
46989
|
|
|
46931
|
-
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``spotMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``spotMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *EC2 User Guide* .
|
|
46990
|
+
If your fleet includes T instances that are configured as ``unlimited`` , and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The ``spotMaxTotalPrice`` does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for ``spotMaxTotalPrice`` . For more information, see `Surplus credits can incur charges <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits>`_ in the *Amazon EC2 User Guide* .
|
|
46932
46991
|
|
|
46933
46992
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-spotmaxtotalprice
|
|
46934
46993
|
'''
|
|
@@ -47116,7 +47175,7 @@ class CfnSpotFleet(
|
|
|
47116
47175
|
) -> None:
|
|
47117
47176
|
'''The strategies for managing your Spot Instances that are at an elevated risk of being interrupted.
|
|
47118
47177
|
|
|
47119
|
-
:param capacity_rebalance: The Spot Instance replacement strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted. For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide
|
|
47178
|
+
:param capacity_rebalance: The Spot Instance replacement strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted. For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide* .
|
|
47120
47179
|
|
|
47121
47180
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotmaintenancestrategies.html
|
|
47122
47181
|
:exampleMetadata: fixture=_generated
|
|
@@ -47147,7 +47206,7 @@ class CfnSpotFleet(
|
|
|
47147
47206
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnSpotFleet.SpotCapacityRebalanceProperty"]]:
|
|
47148
47207
|
'''The Spot Instance replacement strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted.
|
|
47149
47208
|
|
|
47150
|
-
For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide
|
|
47209
|
+
For more information, see `Capacity rebalancing <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-capacity-rebalance.html>`_ in the *Amazon EC2 User Guide* .
|
|
47151
47210
|
|
|
47152
47211
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotmaintenancestrategies.html#cfn-ec2-spotfleet-spotmaintenancestrategies-capacityrebalance
|
|
47153
47212
|
'''
|
|
@@ -50319,7 +50378,7 @@ class CfnTrafficMirrorSession(
|
|
|
50319
50378
|
:param description: The description of the Traffic Mirror session.
|
|
50320
50379
|
:param packet_length: The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. If you do not want to mirror the entire packet, use the ``PacketLength`` parameter to specify the number of bytes in each packet to mirror. For sessions with Network Load Balancer (NLB) Traffic Mirror targets the default ``PacketLength`` will be set to 8500. Valid values are 1-8500. Setting a ``PacketLength`` greater than 8500 will result in an error response.
|
|
50321
50380
|
:param tags: The tags to assign to a Traffic Mirror session.
|
|
50322
|
-
:param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://
|
|
50381
|
+
:param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://datatracker.ietf.org/doc/html/rfc7348>`_ . If you do not specify a ``VirtualNetworkId`` , an account-wide unique ID is chosen at random.
|
|
50323
50382
|
'''
|
|
50324
50383
|
if __debug__:
|
|
50325
50384
|
type_hints = typing.get_type_hints(_typecheckingstub__9e0df29e9de2cc6eed997cd0738e89aa6fc9bdffd0c700ef4584f2c9e0a82bb8)
|
|
@@ -50528,7 +50587,7 @@ class CfnTrafficMirrorSessionProps:
|
|
|
50528
50587
|
:param description: The description of the Traffic Mirror session.
|
|
50529
50588
|
:param packet_length: The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. If you do not want to mirror the entire packet, use the ``PacketLength`` parameter to specify the number of bytes in each packet to mirror. For sessions with Network Load Balancer (NLB) Traffic Mirror targets the default ``PacketLength`` will be set to 8500. Valid values are 1-8500. Setting a ``PacketLength`` greater than 8500 will result in an error response.
|
|
50530
50589
|
:param tags: The tags to assign to a Traffic Mirror session.
|
|
50531
|
-
:param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://
|
|
50590
|
+
:param virtual_network_id: The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://datatracker.ietf.org/doc/html/rfc7348>`_ . If you do not specify a ``VirtualNetworkId`` , an account-wide unique ID is chosen at random.
|
|
50532
50591
|
|
|
50533
50592
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trafficmirrorsession.html
|
|
50534
50593
|
:exampleMetadata: fixture=_generated
|
|
@@ -50661,7 +50720,7 @@ class CfnTrafficMirrorSessionProps:
|
|
|
50661
50720
|
def virtual_network_id(self) -> typing.Optional[jsii.Number]:
|
|
50662
50721
|
'''The VXLAN ID for the Traffic Mirror session.
|
|
50663
50722
|
|
|
50664
|
-
For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://
|
|
50723
|
+
For more information about the VXLAN protocol, see `RFC 7348 <https://docs.aws.amazon.com/https://datatracker.ietf.org/doc/html/rfc7348>`_ . If you do not specify a ``VirtualNetworkId`` , an account-wide unique ID is chosen at random.
|
|
50665
50724
|
|
|
50666
50725
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trafficmirrorsession.html#cfn-ec2-trafficmirrorsession-virtualnetworkid
|
|
50667
50726
|
'''
|
|
@@ -54070,14 +54129,6 @@ class CfnTransitGatewayRoute(
|
|
|
54070
54129
|
'''The CloudFormation resource type name for this resource class.'''
|
|
54071
54130
|
return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
|
|
54072
54131
|
|
|
54073
|
-
@builtins.property
|
|
54074
|
-
@jsii.member(jsii_name="attrId")
|
|
54075
|
-
def attr_id(self) -> builtins.str:
|
|
54076
|
-
'''
|
|
54077
|
-
:cloudformationAttribute: Id
|
|
54078
|
-
'''
|
|
54079
|
-
return typing.cast(builtins.str, jsii.get(self, "attrId"))
|
|
54080
|
-
|
|
54081
54132
|
@builtins.property
|
|
54082
54133
|
@jsii.member(jsii_name="cfnProperties")
|
|
54083
54134
|
def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
|
|
@@ -62758,7 +62809,7 @@ class CfnVolume(
|
|
|
62758
62809
|
:param availability_zone: The ID of the Availability Zone in which to create the volume. For example, ``us-east-1a`` .
|
|
62759
62810
|
:param auto_enable_io: Indicates whether the volume is auto-enabled for I/O operations. By default, Amazon EBS disables I/O to the volume from attached EC2 instances when it determines that a volume's data is potentially inconsistent. If the consistency of the volume is not a concern, and you prefer that the volume be made available immediately if it's impaired, you can configure the volume to automatically enable I/O.
|
|
62760
62811
|
:param encrypted: Indicates whether the volume should be encrypted. The effect of setting the encryption state to ``true`` depends on the volume origin (new or from a snapshot), starting encryption state, ownership, and whether encryption by default is enabled. For more information, see `Encryption by default <https://docs.aws.amazon.com/ebs/latest/userguide/work-with-ebs-encr.html#encryption-by-default>`_ in the *Amazon EBS User Guide* . Encrypted Amazon EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see `Supported instance types <https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances>`_ .
|
|
62761
|
-
:param iops: The number of I/O operations per second (IOPS). For ``gp3`` , ``io1`` , and ``io2`` volumes, this represents the number of IOPS that are provisioned for the volume. For ``gp2`` volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: - ``gp3`` : 3,000 - 16,000 IOPS - ``io1`` : 100 - 64,000 IOPS - ``io2`` : 100 - 256,000 IOPS For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/
|
|
62812
|
+
:param iops: The number of I/O operations per second (IOPS). For ``gp3`` , ``io1`` , and ``io2`` volumes, this represents the number of IOPS that are provisioned for the volume. For ``gp2`` volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: - ``gp3`` : 3,000 - 16,000 IOPS - ``io1`` : 100 - 64,000 IOPS - ``io2`` : 100 - 256,000 IOPS For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ . On other instances, you can achieve performance up to 32,000 IOPS. This parameter is required for ``io1`` and ``io2`` volumes. The default for ``gp3`` volumes is 3,000 IOPS. This parameter is not supported for ``gp2`` , ``st1`` , ``sc1`` , or ``standard`` volumes.
|
|
62762
62813
|
:param kms_key_id: The identifier of the AWS KMS key to use for Amazon EBS encryption. If ``KmsKeyId`` is specified, the encrypted state must be ``true`` . If you omit this property and your account is enabled for encryption by default, or *Encrypted* is set to ``true`` , then the volume is encrypted using the default key specified for your account. If your account does not have a default key, then the volume is encrypted using the AWS managed key . Alternatively, if you want to specify a different key, you can specify one of the following: - Key ID. For example, 1234abcd-12ab-34cd-56ef-1234567890ab. - Key alias. Specify the alias for the key, prefixed with ``alias/`` . For example, for a key with the alias ``my_cmk`` , use ``alias/my_cmk`` . Or to specify the AWS managed key , use ``alias/aws/ebs`` . - Key ARN. For example, arn:aws:kms:us-east-1:012345678910:key/1234abcd-12ab-34cd-56ef-1234567890ab. - Alias ARN. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
|
|
62763
62814
|
:param multi_attach_enabled: Indicates whether Amazon EBS Multi-Attach is enabled. AWS CloudFormation does not currently support updating a single-attach volume to be multi-attach enabled, updating a multi-attach enabled volume to be single-attach, or updating the size or number of I/O operations per second (IOPS) of a multi-attach enabled volume.
|
|
62764
62815
|
:param outpost_arn: The Amazon Resource Name (ARN) of the Outpost.
|
|
@@ -63285,7 +63336,7 @@ class CfnVolumeProps:
|
|
|
63285
63336
|
:param availability_zone: The ID of the Availability Zone in which to create the volume. For example, ``us-east-1a`` .
|
|
63286
63337
|
:param auto_enable_io: Indicates whether the volume is auto-enabled for I/O operations. By default, Amazon EBS disables I/O to the volume from attached EC2 instances when it determines that a volume's data is potentially inconsistent. If the consistency of the volume is not a concern, and you prefer that the volume be made available immediately if it's impaired, you can configure the volume to automatically enable I/O.
|
|
63287
63338
|
:param encrypted: Indicates whether the volume should be encrypted. The effect of setting the encryption state to ``true`` depends on the volume origin (new or from a snapshot), starting encryption state, ownership, and whether encryption by default is enabled. For more information, see `Encryption by default <https://docs.aws.amazon.com/ebs/latest/userguide/work-with-ebs-encr.html#encryption-by-default>`_ in the *Amazon EBS User Guide* . Encrypted Amazon EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see `Supported instance types <https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances>`_ .
|
|
63288
|
-
:param iops: The number of I/O operations per second (IOPS). For ``gp3`` , ``io1`` , and ``io2`` volumes, this represents the number of IOPS that are provisioned for the volume. For ``gp2`` volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: - ``gp3`` : 3,000 - 16,000 IOPS - ``io1`` : 100 - 64,000 IOPS - ``io2`` : 100 - 256,000 IOPS For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/
|
|
63339
|
+
:param iops: The number of I/O operations per second (IOPS). For ``gp3`` , ``io1`` , and ``io2`` volumes, this represents the number of IOPS that are provisioned for the volume. For ``gp2`` volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. The following are the supported values for each volume type: - ``gp3`` : 3,000 - 16,000 IOPS - ``io1`` : 100 - 64,000 IOPS - ``io2`` : 100 - 256,000 IOPS For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ . On other instances, you can achieve performance up to 32,000 IOPS. This parameter is required for ``io1`` and ``io2`` volumes. The default for ``gp3`` volumes is 3,000 IOPS. This parameter is not supported for ``gp2`` , ``st1`` , ``sc1`` , or ``standard`` volumes.
|
|
63289
63340
|
:param kms_key_id: The identifier of the AWS KMS key to use for Amazon EBS encryption. If ``KmsKeyId`` is specified, the encrypted state must be ``true`` . If you omit this property and your account is enabled for encryption by default, or *Encrypted* is set to ``true`` , then the volume is encrypted using the default key specified for your account. If your account does not have a default key, then the volume is encrypted using the AWS managed key . Alternatively, if you want to specify a different key, you can specify one of the following: - Key ID. For example, 1234abcd-12ab-34cd-56ef-1234567890ab. - Key alias. Specify the alias for the key, prefixed with ``alias/`` . For example, for a key with the alias ``my_cmk`` , use ``alias/my_cmk`` . Or to specify the AWS managed key , use ``alias/aws/ebs`` . - Key ARN. For example, arn:aws:kms:us-east-1:012345678910:key/1234abcd-12ab-34cd-56ef-1234567890ab. - Alias ARN. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
|
|
63290
63341
|
:param multi_attach_enabled: Indicates whether Amazon EBS Multi-Attach is enabled. AWS CloudFormation does not currently support updating a single-attach volume to be multi-attach enabled, updating a multi-attach enabled volume to be single-attach, or updating the size or number of I/O operations per second (IOPS) of a multi-attach enabled volume.
|
|
63291
63342
|
:param outpost_arn: The Amazon Resource Name (ARN) of the Outpost.
|
|
@@ -63416,7 +63467,7 @@ class CfnVolumeProps:
|
|
|
63416
63467
|
- ``io1`` : 100 - 64,000 IOPS
|
|
63417
63468
|
- ``io2`` : 100 - 256,000 IOPS
|
|
63418
63469
|
|
|
63419
|
-
For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/
|
|
63470
|
+
For ``io2`` volumes, you can achieve up to 256,000 IOPS on `instances built on the Nitro System <https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html>`_ . On other instances, you can achieve performance up to 32,000 IOPS.
|
|
63420
63471
|
|
|
63421
63472
|
This parameter is required for ``io1`` and ``io2`` volumes. The default for ``gp3`` volumes is 3,000 IOPS. This parameter is not supported for ``gp2`` , ``st1`` , ``sc1`` , or ``standard`` volumes.
|
|
63422
63473
|
|
|
@@ -66132,16 +66183,22 @@ class EbsDeviceVolumeType(enum.Enum):
|
|
|
66132
66183
|
|
|
66133
66184
|
Example::
|
|
66134
66185
|
|
|
66135
|
-
|
|
66136
|
-
|
|
66137
|
-
|
|
66138
|
-
|
|
66139
|
-
|
|
66140
|
-
),
|
|
66141
|
-
|
|
66142
|
-
|
|
66143
|
-
|
|
66144
|
-
|
|
66186
|
+
# vpc: ec2.Vpc
|
|
66187
|
+
|
|
66188
|
+
|
|
66189
|
+
instance = ec2.Instance(self, "Instance",
|
|
66190
|
+
instance_type=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.XLARGE),
|
|
66191
|
+
machine_image=ec2.AmazonLinuxImage(),
|
|
66192
|
+
vpc=vpc,
|
|
66193
|
+
hibernation_enabled=True,
|
|
66194
|
+
block_devices=[ec2.BlockDevice(
|
|
66195
|
+
device_name="/dev/xvda",
|
|
66196
|
+
volume=ec2.BlockDeviceVolume.ebs(30,
|
|
66197
|
+
volume_type=ec2.EbsDeviceVolumeType.GP3,
|
|
66198
|
+
encrypted=True,
|
|
66199
|
+
delete_on_termination=True
|
|
66200
|
+
)
|
|
66201
|
+
)]
|
|
66145
66202
|
)
|
|
66146
66203
|
'''
|
|
66147
66204
|
|
|
@@ -72089,6 +72146,8 @@ class Instance(
|
|
|
72089
72146
|
credit_specification: typing.Optional[CpuCredits] = None,
|
|
72090
72147
|
detailed_monitoring: typing.Optional[builtins.bool] = None,
|
|
72091
72148
|
ebs_optimized: typing.Optional[builtins.bool] = None,
|
|
72149
|
+
enclave_enabled: typing.Optional[builtins.bool] = None,
|
|
72150
|
+
hibernation_enabled: typing.Optional[builtins.bool] = None,
|
|
72092
72151
|
init: typing.Optional[CloudFormationInit] = None,
|
|
72093
72152
|
init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
72094
72153
|
instance_initiated_shutdown_behavior: typing.Optional["InstanceInitiatedShutdownBehavior"] = None,
|
|
@@ -72122,6 +72181,8 @@ class Instance(
|
|
|
72122
72181
|
:param credit_specification: Specifying the CPU credit type for burstable EC2 instance types (T2, T3, T3a, etc). The unlimited CPU credit option is not supported for T3 instances with a dedicated host. Default: - T2 instances are standard, while T3, T4g, and T3a instances are unlimited.
|
|
72123
72182
|
:param detailed_monitoring: Whether "Detailed Monitoring" is enabled for this instance Keep in mind that Detailed Monitoring results in extra charges. Default: - false
|
|
72124
72183
|
:param ebs_optimized: Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance. Default: false
|
|
72184
|
+
:param enclave_enabled: Whether the instance is enabled for AWS Nitro Enclaves. Nitro Enclaves requires a Nitro-based virtualized parent instance with specific Intel/AMD with at least 4 vCPUs or Graviton with at least 2 vCPUs instance types and Linux/Windows host OS, while the enclave itself supports only Linux OS. You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance. Default: - false
|
|
72185
|
+
:param hibernation_enabled: Whether the instance is enabled for hibernation. You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance. Default: - false
|
|
72125
72186
|
:param init: Apply the given CloudFormation Init configuration to the instance at startup. Default: - no CloudFormation init
|
|
72126
72187
|
:param init_options: Use the given options for applying CloudFormation Init. Describes the configsets to use and the timeout to wait Default: - default options
|
|
72127
72188
|
:param instance_initiated_shutdown_behavior: Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown). Default: InstanceInitiatedShutdownBehavior.STOP
|
|
@@ -72157,6 +72218,8 @@ class Instance(
|
|
|
72157
72218
|
credit_specification=credit_specification,
|
|
72158
72219
|
detailed_monitoring=detailed_monitoring,
|
|
72159
72220
|
ebs_optimized=ebs_optimized,
|
|
72221
|
+
enclave_enabled=enclave_enabled,
|
|
72222
|
+
hibernation_enabled=hibernation_enabled,
|
|
72160
72223
|
init=init,
|
|
72161
72224
|
init_options=init_options,
|
|
72162
72225
|
instance_initiated_shutdown_behavior=instance_initiated_shutdown_behavior,
|
|
@@ -72904,6 +72967,8 @@ class InstanceInitiatedShutdownBehavior(enum.Enum):
|
|
|
72904
72967
|
"credit_specification": "creditSpecification",
|
|
72905
72968
|
"detailed_monitoring": "detailedMonitoring",
|
|
72906
72969
|
"ebs_optimized": "ebsOptimized",
|
|
72970
|
+
"enclave_enabled": "enclaveEnabled",
|
|
72971
|
+
"hibernation_enabled": "hibernationEnabled",
|
|
72907
72972
|
"init": "init",
|
|
72908
72973
|
"init_options": "initOptions",
|
|
72909
72974
|
"instance_initiated_shutdown_behavior": "instanceInitiatedShutdownBehavior",
|
|
@@ -72939,6 +73004,8 @@ class InstanceProps:
|
|
|
72939
73004
|
credit_specification: typing.Optional[CpuCredits] = None,
|
|
72940
73005
|
detailed_monitoring: typing.Optional[builtins.bool] = None,
|
|
72941
73006
|
ebs_optimized: typing.Optional[builtins.bool] = None,
|
|
73007
|
+
enclave_enabled: typing.Optional[builtins.bool] = None,
|
|
73008
|
+
hibernation_enabled: typing.Optional[builtins.bool] = None,
|
|
72942
73009
|
init: typing.Optional[CloudFormationInit] = None,
|
|
72943
73010
|
init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
72944
73011
|
instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
|
|
@@ -72971,6 +73038,8 @@ class InstanceProps:
|
|
|
72971
73038
|
:param credit_specification: Specifying the CPU credit type for burstable EC2 instance types (T2, T3, T3a, etc). The unlimited CPU credit option is not supported for T3 instances with a dedicated host. Default: - T2 instances are standard, while T3, T4g, and T3a instances are unlimited.
|
|
72972
73039
|
:param detailed_monitoring: Whether "Detailed Monitoring" is enabled for this instance Keep in mind that Detailed Monitoring results in extra charges. Default: - false
|
|
72973
73040
|
:param ebs_optimized: Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance. Default: false
|
|
73041
|
+
:param enclave_enabled: Whether the instance is enabled for AWS Nitro Enclaves. Nitro Enclaves requires a Nitro-based virtualized parent instance with specific Intel/AMD with at least 4 vCPUs or Graviton with at least 2 vCPUs instance types and Linux/Windows host OS, while the enclave itself supports only Linux OS. You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance. Default: - false
|
|
73042
|
+
:param hibernation_enabled: Whether the instance is enabled for hibernation. You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance. Default: - false
|
|
72974
73043
|
:param init: Apply the given CloudFormation Init configuration to the instance at startup. Default: - no CloudFormation init
|
|
72975
73044
|
:param init_options: Use the given options for applying CloudFormation Init. Describes the configsets to use and the timeout to wait Default: - default options
|
|
72976
73045
|
:param instance_initiated_shutdown_behavior: Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown). Default: InstanceInitiatedShutdownBehavior.STOP
|
|
@@ -73026,6 +73095,8 @@ class InstanceProps:
|
|
|
73026
73095
|
check_type(argname="argument credit_specification", value=credit_specification, expected_type=type_hints["credit_specification"])
|
|
73027
73096
|
check_type(argname="argument detailed_monitoring", value=detailed_monitoring, expected_type=type_hints["detailed_monitoring"])
|
|
73028
73097
|
check_type(argname="argument ebs_optimized", value=ebs_optimized, expected_type=type_hints["ebs_optimized"])
|
|
73098
|
+
check_type(argname="argument enclave_enabled", value=enclave_enabled, expected_type=type_hints["enclave_enabled"])
|
|
73099
|
+
check_type(argname="argument hibernation_enabled", value=hibernation_enabled, expected_type=type_hints["hibernation_enabled"])
|
|
73029
73100
|
check_type(argname="argument init", value=init, expected_type=type_hints["init"])
|
|
73030
73101
|
check_type(argname="argument init_options", value=init_options, expected_type=type_hints["init_options"])
|
|
73031
73102
|
check_type(argname="argument instance_initiated_shutdown_behavior", value=instance_initiated_shutdown_behavior, expected_type=type_hints["instance_initiated_shutdown_behavior"])
|
|
@@ -73065,6 +73136,10 @@ class InstanceProps:
|
|
|
73065
73136
|
self._values["detailed_monitoring"] = detailed_monitoring
|
|
73066
73137
|
if ebs_optimized is not None:
|
|
73067
73138
|
self._values["ebs_optimized"] = ebs_optimized
|
|
73139
|
+
if enclave_enabled is not None:
|
|
73140
|
+
self._values["enclave_enabled"] = enclave_enabled
|
|
73141
|
+
if hibernation_enabled is not None:
|
|
73142
|
+
self._values["hibernation_enabled"] = hibernation_enabled
|
|
73068
73143
|
if init is not None:
|
|
73069
73144
|
self._values["init"] = init
|
|
73070
73145
|
if init_options is not None:
|
|
@@ -73214,6 +73289,36 @@ class InstanceProps:
|
|
|
73214
73289
|
result = self._values.get("ebs_optimized")
|
|
73215
73290
|
return typing.cast(typing.Optional[builtins.bool], result)
|
|
73216
73291
|
|
|
73292
|
+
@builtins.property
|
|
73293
|
+
def enclave_enabled(self) -> typing.Optional[builtins.bool]:
|
|
73294
|
+
'''Whether the instance is enabled for AWS Nitro Enclaves.
|
|
73295
|
+
|
|
73296
|
+
Nitro Enclaves requires a Nitro-based virtualized parent instance with specific Intel/AMD with at least 4 vCPUs
|
|
73297
|
+
or Graviton with at least 2 vCPUs instance types and Linux/Windows host OS,
|
|
73298
|
+
while the enclave itself supports only Linux OS.
|
|
73299
|
+
|
|
73300
|
+
You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance.
|
|
73301
|
+
|
|
73302
|
+
:default: - false
|
|
73303
|
+
|
|
73304
|
+
:see: https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html#nitro-enclave-reqs
|
|
73305
|
+
'''
|
|
73306
|
+
result = self._values.get("enclave_enabled")
|
|
73307
|
+
return typing.cast(typing.Optional[builtins.bool], result)
|
|
73308
|
+
|
|
73309
|
+
@builtins.property
|
|
73310
|
+
def hibernation_enabled(self) -> typing.Optional[builtins.bool]:
|
|
73311
|
+
'''Whether the instance is enabled for hibernation.
|
|
73312
|
+
|
|
73313
|
+
You can't set both ``enclaveEnabled`` and ``hibernationEnabled`` to true on the same instance.
|
|
73314
|
+
|
|
73315
|
+
:default: - false
|
|
73316
|
+
|
|
73317
|
+
:see: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-hibernationoptions.html
|
|
73318
|
+
'''
|
|
73319
|
+
result = self._values.get("hibernation_enabled")
|
|
73320
|
+
return typing.cast(typing.Optional[builtins.bool], result)
|
|
73321
|
+
|
|
73217
73322
|
@builtins.property
|
|
73218
73323
|
def init(self) -> typing.Optional[CloudFormationInit]:
|
|
73219
73324
|
'''Apply the given CloudFormation Init configuration to the instance at startup.
|
|
@@ -89866,18 +89971,34 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
|
|
|
89866
89971
|
:param encrypted: Specifies whether the EBS volume is encrypted. Encrypted EBS volumes can only be attached to instances that support Amazon EBS encryption Default: false
|
|
89867
89972
|
:param kms_key: The ARN of the AWS Key Management Service (AWS KMS) CMK used for encryption. You have to ensure that the KMS CMK has the correct permissions to be used by the service launching the ec2 instances. Default: - If encrypted is true, the default aws/ebs KMS key will be used.
|
|
89868
89973
|
|
|
89869
|
-
:exampleMetadata:
|
|
89974
|
+
:exampleMetadata: infused
|
|
89870
89975
|
|
|
89871
89976
|
Example::
|
|
89872
89977
|
|
|
89873
|
-
|
|
89978
|
+
from aws_cdk.aws_kms import Key
|
|
89979
|
+
|
|
89980
|
+
# vpc: ec2.Vpc
|
|
89981
|
+
# instance_type: ec2.InstanceType
|
|
89982
|
+
# machine_image: ec2.IMachineImage
|
|
89983
|
+
|
|
89984
|
+
|
|
89985
|
+
kms_key = Key(self, "KmsKey")
|
|
89986
|
+
|
|
89987
|
+
ec2.Instance(self, "Instance",
|
|
89874
89988
|
vpc=vpc,
|
|
89989
|
+
instance_type=instance_type,
|
|
89990
|
+
machine_image=machine_image,
|
|
89991
|
+
|
|
89992
|
+
# ...
|
|
89993
|
+
|
|
89875
89994
|
block_devices=[ec2.BlockDevice(
|
|
89876
|
-
device_name="/dev/
|
|
89877
|
-
volume=ec2.BlockDeviceVolume.ebs(
|
|
89878
|
-
encrypted=True
|
|
89995
|
+
device_name="/dev/sda1",
|
|
89996
|
+
volume=ec2.BlockDeviceVolume.ebs(50,
|
|
89997
|
+
encrypted=True,
|
|
89998
|
+
kms_key=kms_key
|
|
89879
89999
|
)
|
|
89880
|
-
)
|
|
90000
|
+
)
|
|
90001
|
+
]
|
|
89881
90002
|
)
|
|
89882
90003
|
'''
|
|
89883
90004
|
if __debug__:
|
|
@@ -104151,6 +104272,8 @@ def _typecheckingstub__5fdf31f5ae2497c7efcb56df558011698f38dc19cff28ca7a78a08a6d
|
|
|
104151
104272
|
credit_specification: typing.Optional[CpuCredits] = None,
|
|
104152
104273
|
detailed_monitoring: typing.Optional[builtins.bool] = None,
|
|
104153
104274
|
ebs_optimized: typing.Optional[builtins.bool] = None,
|
|
104275
|
+
enclave_enabled: typing.Optional[builtins.bool] = None,
|
|
104276
|
+
hibernation_enabled: typing.Optional[builtins.bool] = None,
|
|
104154
104277
|
init: typing.Optional[CloudFormationInit] = None,
|
|
104155
104278
|
init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
104156
104279
|
instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
|
|
@@ -104204,6 +104327,8 @@ def _typecheckingstub__2d4dc63c6e6ee3ddc68d5dd204d8ac5ef1f1dec37a7b84d636225df1c
|
|
|
104204
104327
|
credit_specification: typing.Optional[CpuCredits] = None,
|
|
104205
104328
|
detailed_monitoring: typing.Optional[builtins.bool] = None,
|
|
104206
104329
|
ebs_optimized: typing.Optional[builtins.bool] = None,
|
|
104330
|
+
enclave_enabled: typing.Optional[builtins.bool] = None,
|
|
104331
|
+
hibernation_enabled: typing.Optional[builtins.bool] = None,
|
|
104207
104332
|
init: typing.Optional[CloudFormationInit] = None,
|
|
104208
104333
|
init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
104209
104334
|
instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
|