@propulsionworks/cloudformation 0.1.35 → 0.1.37

package/out/exports/resources.generated/aws-ec2-volume.d.ts

@@ -1,17 +1,14 @@
 import type { ResourceDefinitionWithAttributes, Tag } from "../main.ts";
 /**
- * Specifies an Amazon Elastic Block Store (Amazon EBS) volume.
+ * Specifies an Amazon Elastic Block Store (Amazon EBS) volume. You can create an empty volume, a volume from a snapshot, or a volume copy from an existing source volume.
  *
- * When you use AWS CloudFormation to update an Amazon EBS volume that modifies `Iops` , `Size` , or `VolumeType` , there is a cooldown period before another operation can occur. This can cause your stack to report being in `UPDATE_IN_PROGRESS` or `UPDATE_ROLLBACK_IN_PROGRESS` for long periods of time.
- *
- * Amazon EBS does not support sizing down an Amazon EBS volume. AWS CloudFormation does not attempt to modify an Amazon EBS volume to a smaller size on rollback.
- *
- * Some common scenarios when you might encounter a cooldown period for Amazon EBS include:
- *
- * - You successfully update an Amazon EBS volume and the update succeeds. When you attempt another update within the cooldown window, that update will be subject to a cooldown period.
- * - You successfully update an Amazon EBS volume and the update succeeds but another change in your `update-stack` call fails. The rollback will be subject to a cooldown period.
- *
- * For more information, see [Requirements for EBS volume modifications](https://docs.aws.amazon.com/ebs/latest/userguide/modify-volume-requirements.html) .
+ * > - When you use AWS CloudFormation to update an Amazon EBS volume that modifies `Iops` , `Size` , or `VolumeType` , there is a cooldown period before another operation can occur. This can cause your stack to report being in `UPDATE_IN_PROGRESS` or `UPDATE_ROLLBACK_IN_PROGRESS` for long periods of time. Some common scenarios when you might encounter a cooldown period for Amazon EBS include:
+ * >
+ * > - You successfully update an Amazon EBS volume and the update succeeds. When you attempt another update within the cooldown window, that update will be subject to a cooldown period.
+ * > - You successfully update an Amazon EBS volume and the update succeeds but another change in your `update-stack` call fails. The rollback will be subject to a cooldown period.
+ * >
+ * > For more information, see [Requirements for EBS volume modifications](https://docs.aws.amazon.com/ebs/latest/userguide/modify-volume-requirements.html) .
+ * > - Amazon EBS does not support sizing down an Amazon EBS volume. AWS CloudFormation does not attempt to modify an Amazon EBS volume to a smaller size on rollback.
  *
  * *DeletionPolicy attribute*
  *
@@ -22,18 +19,15 @@ import type { ResourceDefinitionWithAttributes, Tag } from "../main.ts";
  */
 export type EC2Volume = ResourceDefinitionWithAttributes<"AWS::EC2::Volume", EC2VolumeProps, EC2VolumeAttribs>;
 /**
- * Specifies an Amazon Elastic Block Store (Amazon EBS) volume.
- *
- * When you use AWS CloudFormation to update an Amazon EBS volume that modifies `Iops` , `Size` , or `VolumeType` , there is a cooldown period before another operation can occur. This can cause your stack to report being in `UPDATE_IN_PROGRESS` or `UPDATE_ROLLBACK_IN_PROGRESS` for long periods of time.
- *
- * Amazon EBS does not support sizing down an Amazon EBS volume. AWS CloudFormation does not attempt to modify an Amazon EBS volume to a smaller size on rollback.
+ * Specifies an Amazon Elastic Block Store (Amazon EBS) volume. You can create an empty volume, a volume from a snapshot, or a volume copy from an existing source volume.
  *
- * Some common scenarios when you might encounter a cooldown period for Amazon EBS include:
- *
- * - You successfully update an Amazon EBS volume and the update succeeds. When you attempt another update within the cooldown window, that update will be subject to a cooldown period.
- * - You successfully update an Amazon EBS volume and the update succeeds but another change in your `update-stack` call fails. The rollback will be subject to a cooldown period.
- *
- * For more information, see [Requirements for EBS volume modifications](https://docs.aws.amazon.com/ebs/latest/userguide/modify-volume-requirements.html) .
+ * > - When you use AWS CloudFormation to update an Amazon EBS volume that modifies `Iops` , `Size` , or `VolumeType` , there is a cooldown period before another operation can occur. This can cause your stack to report being in `UPDATE_IN_PROGRESS` or `UPDATE_ROLLBACK_IN_PROGRESS` for long periods of time. Some common scenarios when you might encounter a cooldown period for Amazon EBS include:
+ * >
+ * > - You successfully update an Amazon EBS volume and the update succeeds. When you attempt another update within the cooldown window, that update will be subject to a cooldown period.
+ * > - You successfully update an Amazon EBS volume and the update succeeds but another change in your `update-stack` call fails. The rollback will be subject to a cooldown period.
+ * >
+ * > For more information, see [Requirements for EBS volume modifications](https://docs.aws.amazon.com/ebs/latest/userguide/modify-volume-requirements.html) .
+ * > - Amazon EBS does not support sizing down an Amazon EBS volume. AWS CloudFormation does not attempt to modify an Amazon EBS volume to a smaller size on rollback.
  *
  * *DeletionPolicy attribute*
  *
@@ -52,18 +46,24 @@ export type EC2VolumeProps = {
      * The ID of the Availability Zone in which to create the volume. For example, `us-east-1a` .
      *
      * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzone}
      */
     AvailabilityZone: string;
     /**
-     * The ID of the Availability Zone for the volume.
+     * The ID of the Availability Zone in which to create the volume. For example, `use1-az1` .
+     *
+     * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzoneid}
      */
     AvailabilityZoneId?: string | undefined;
     /**
-     * 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* .
+     * Indicates whether the volume should be encrypted. The effect of setting the encryption state to `true` depends on the volume origin (new, from a snapshot, or from an existing volume), 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) .
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-encrypted}
      */
     Encrypted?: boolean | undefined;
@@ -91,6 +91,8 @@ export type EC2VolumeProps = {
      * - 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.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-kmskeyid}
      */
     KmsKeyId?: string | undefined;
@@ -102,14 +104,19 @@ export type EC2VolumeProps = {
      */
     MultiAttachEnabled?: boolean | undefined;
     /**
-     * The Amazon Resource Name (ARN) of the Outpost.
+     * The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
+     *
+     * If you intend to use a volume with an instance running on an outpost, then you must create the volume on the same outpost as the instance. You can't use a volume created in an AWS Region with an instance on an AWS outpost, or the other way around.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-outpostarn}
      */
     OutpostArn?: string | undefined;
     /**
-     * The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size, and you can specify a volume size that is equal to or larger than the snapshot size.
+     * The size of the volume, in GiBs.
+     *
+     * - Required for new empty volumes.
+     * - Optional for volumes created from snapshots and volume copies. In this case, the size defaults to the size of the snapshot or source volume. You can optionally specify a size that is equal to or larger than the size of the source snapshot or volume.
      *
-     * Valid sizes:
+     * Supported volume sizes:
      *
      * - gp2: `1 - 16,384` GiB
      * - gp3: `1 - 65,536` GiB
@@ -121,12 +128,12 @@ export type EC2VolumeProps = {
      */
     Size: number;
     /**
-     * The snapshot from which to create the volume. You must specify either a snapshot ID or a volume size.
+     * The snapshot from which to create the volume. Only specify to create a volume from a snapshot. To create a new empty volume, omit this parameter and specify a value for `Size` instead. To create a volume copy, omit this parameter and specify `SourceVolumeId` instead.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-snapshotid}
      */
     SnapshotId?: string | undefined;
     /**
-     * The ID of the source volume from which the volume copy was created. Only for volume copies.
+     * The ID of the source EBS volume to copy. When specified, the volume is created as an exact copy of the specified volume. Only specify to create a volume copy. To create a new empty volume or to create a volume from a snapshot, omit this parameter,
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-sourcevolumeid}
      */
     SourceVolumeId?: string | undefined;
@@ -169,7 +176,9 @@ export type EC2VolumeProps = {
      * - Cold HDD: `sc1`
      * - Magnetic: `standard`
      *
-     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) .
+     * > Throughput Optimized HDD ( `st1` ) and Cold HDD ( `sc1` ) volumes can't be used as boot volumes.
+     *
+     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide* .
      *
      * Default: `gp2`
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-volumetype}
@@ -185,18 +194,24 @@ export type EC2VolumeProps = {
      * The ID of the Availability Zone in which to create the volume. For example, `us-east-1a` .
      *
      * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzone}
      */
     AvailabilityZone: string;
     /**
-     * The ID of the Availability Zone for the volume.
+     * The ID of the Availability Zone in which to create the volume. For example, `use1-az1` .
+     *
+     * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzoneid}
      */
     AvailabilityZoneId?: string | undefined;
     /**
-     * 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* .
+     * Indicates whether the volume should be encrypted. The effect of setting the encryption state to `true` depends on the volume origin (new, from a snapshot, or from an existing volume), 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) .
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-encrypted}
      */
     Encrypted?: boolean | undefined;
@@ -224,6 +239,8 @@ export type EC2VolumeProps = {
      * - 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.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-kmskeyid}
      */
     KmsKeyId?: string | undefined;
@@ -235,14 +252,19 @@ export type EC2VolumeProps = {
      */
     MultiAttachEnabled?: boolean | undefined;
     /**
-     * The Amazon Resource Name (ARN) of the Outpost.
+     * The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
+     *
+     * If you intend to use a volume with an instance running on an outpost, then you must create the volume on the same outpost as the instance. You can't use a volume created in an AWS Region with an instance on an AWS outpost, or the other way around.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-outpostarn}
      */
     OutpostArn?: string | undefined;
     /**
-     * The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size, and you can specify a volume size that is equal to or larger than the snapshot size.
+     * The size of the volume, in GiBs.
+     *
+     * - Required for new empty volumes.
+     * - Optional for volumes created from snapshots and volume copies. In this case, the size defaults to the size of the snapshot or source volume. You can optionally specify a size that is equal to or larger than the size of the source snapshot or volume.
      *
-     * Valid sizes:
+     * Supported volume sizes:
      *
      * - gp2: `1 - 16,384` GiB
      * - gp3: `1 - 65,536` GiB
@@ -254,12 +276,12 @@ export type EC2VolumeProps = {
      */
     Size?: number | undefined;
     /**
-     * The snapshot from which to create the volume. You must specify either a snapshot ID or a volume size.
+     * The snapshot from which to create the volume. Only specify to create a volume from a snapshot. To create a new empty volume, omit this parameter and specify a value for `Size` instead. To create a volume copy, omit this parameter and specify `SourceVolumeId` instead.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-snapshotid}
      */
     SnapshotId: string;
     /**
-     * The ID of the source volume from which the volume copy was created. Only for volume copies.
+     * The ID of the source EBS volume to copy. When specified, the volume is created as an exact copy of the specified volume. Only specify to create a volume copy. To create a new empty volume or to create a volume from a snapshot, omit this parameter,
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-sourcevolumeid}
      */
     SourceVolumeId?: string | undefined;
@@ -302,7 +324,9 @@ export type EC2VolumeProps = {
      * - Cold HDD: `sc1`
      * - Magnetic: `standard`
      *
-     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) .
+     * > Throughput Optimized HDD ( `st1` ) and Cold HDD ( `sc1` ) volumes can't be used as boot volumes.
+     *
+     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide* .
      *
      * Default: `gp2`
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-volumetype}
@@ -318,18 +342,24 @@ export type EC2VolumeProps = {
      * The ID of the Availability Zone in which to create the volume. For example, `us-east-1a` .
      *
      * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzone}
      */
     AvailabilityZone?: string | undefined;
     /**
-     * The ID of the Availability Zone for the volume.
+     * The ID of the Availability Zone in which to create the volume. For example, `use1-az1` .
+     *
+     * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzoneid}
      */
     AvailabilityZoneId: string;
     /**
-     * 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* .
+     * Indicates whether the volume should be encrypted. The effect of setting the encryption state to `true` depends on the volume origin (new, from a snapshot, or from an existing volume), 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) .
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-encrypted}
      */
     Encrypted?: boolean | undefined;
@@ -357,6 +387,8 @@ export type EC2VolumeProps = {
      * - 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.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-kmskeyid}
      */
     KmsKeyId?: string | undefined;
@@ -368,14 +400,19 @@ export type EC2VolumeProps = {
      */
     MultiAttachEnabled?: boolean | undefined;
     /**
-     * The Amazon Resource Name (ARN) of the Outpost.
+     * The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
+     *
+     * If you intend to use a volume with an instance running on an outpost, then you must create the volume on the same outpost as the instance. You can't use a volume created in an AWS Region with an instance on an AWS outpost, or the other way around.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-outpostarn}
      */
     OutpostArn?: string | undefined;
     /**
-     * The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size, and you can specify a volume size that is equal to or larger than the snapshot size.
+     * The size of the volume, in GiBs.
      *
-     * Valid sizes:
+     * - Required for new empty volumes.
+     * - Optional for volumes created from snapshots and volume copies. In this case, the size defaults to the size of the snapshot or source volume. You can optionally specify a size that is equal to or larger than the size of the source snapshot or volume.
+     *
+     * Supported volume sizes:
      *
      * - gp2: `1 - 16,384` GiB
      * - gp3: `1 - 65,536` GiB
@@ -387,12 +424,12 @@ export type EC2VolumeProps = {
      */
     Size: number;
     /**
-     * The snapshot from which to create the volume. You must specify either a snapshot ID or a volume size.
+     * The snapshot from which to create the volume. Only specify to create a volume from a snapshot. To create a new empty volume, omit this parameter and specify a value for `Size` instead. To create a volume copy, omit this parameter and specify `SourceVolumeId` instead.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-snapshotid}
      */
     SnapshotId?: string | undefined;
     /**
-     * The ID of the source volume from which the volume copy was created. Only for volume copies.
+     * The ID of the source EBS volume to copy. When specified, the volume is created as an exact copy of the specified volume. Only specify to create a volume copy. To create a new empty volume or to create a volume from a snapshot, omit this parameter,
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-sourcevolumeid}
      */
     SourceVolumeId?: string | undefined;
@@ -435,7 +472,9 @@ export type EC2VolumeProps = {
      * - Cold HDD: `sc1`
      * - Magnetic: `standard`
      *
-     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) .
+     * > Throughput Optimized HDD ( `st1` ) and Cold HDD ( `sc1` ) volumes can't be used as boot volumes.
+     *
+     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide* .
      *
      * Default: `gp2`
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-volumetype}
@@ -451,18 +490,24 @@ export type EC2VolumeProps = {
      * The ID of the Availability Zone in which to create the volume. For example, `us-east-1a` .
      *
      * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzone}
      */
     AvailabilityZone?: string | undefined;
     /**
-     * The ID of the Availability Zone for the volume.
+     * The ID of the Availability Zone in which to create the volume. For example, `use1-az1` .
+     *
+     * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzoneid}
      */
     AvailabilityZoneId: string;
     /**
-     * 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* .
+     * Indicates whether the volume should be encrypted. The effect of setting the encryption state to `true` depends on the volume origin (new, from a snapshot, or from an existing volume), 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) .
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-encrypted}
      */
     Encrypted?: boolean | undefined;
@@ -490,6 +535,8 @@ export type EC2VolumeProps = {
      * - 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.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-kmskeyid}
      */
     KmsKeyId?: string | undefined;
@@ -501,14 +548,19 @@ export type EC2VolumeProps = {
      */
     MultiAttachEnabled?: boolean | undefined;
     /**
-     * The Amazon Resource Name (ARN) of the Outpost.
+     * The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
+     *
+     * If you intend to use a volume with an instance running on an outpost, then you must create the volume on the same outpost as the instance. You can't use a volume created in an AWS Region with an instance on an AWS outpost, or the other way around.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-outpostarn}
      */
     OutpostArn?: string | undefined;
     /**
-     * The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size, and you can specify a volume size that is equal to or larger than the snapshot size.
+     * The size of the volume, in GiBs.
+     *
+     * - Required for new empty volumes.
+     * - Optional for volumes created from snapshots and volume copies. In this case, the size defaults to the size of the snapshot or source volume. You can optionally specify a size that is equal to or larger than the size of the source snapshot or volume.
      *
-     * Valid sizes:
+     * Supported volume sizes:
      *
      * - gp2: `1 - 16,384` GiB
      * - gp3: `1 - 65,536` GiB
@@ -520,12 +572,12 @@ export type EC2VolumeProps = {
      */
     Size?: number | undefined;
     /**
-     * The snapshot from which to create the volume. You must specify either a snapshot ID or a volume size.
+     * The snapshot from which to create the volume. Only specify to create a volume from a snapshot. To create a new empty volume, omit this parameter and specify a value for `Size` instead. To create a volume copy, omit this parameter and specify `SourceVolumeId` instead.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-snapshotid}
      */
     SnapshotId: string;
     /**
-     * The ID of the source volume from which the volume copy was created. Only for volume copies.
+     * The ID of the source EBS volume to copy. When specified, the volume is created as an exact copy of the specified volume. Only specify to create a volume copy. To create a new empty volume or to create a volume from a snapshot, omit this parameter,
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-sourcevolumeid}
      */
     SourceVolumeId?: string | undefined;
@@ -568,7 +620,9 @@ export type EC2VolumeProps = {
      * - Cold HDD: `sc1`
      * - Magnetic: `standard`
      *
-     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) .
+     * > Throughput Optimized HDD ( `st1` ) and Cold HDD ( `sc1` ) volumes can't be used as boot volumes.
+     *
+     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide* .
      *
      * Default: `gp2`
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-volumetype}
@@ -584,18 +638,24 @@ export type EC2VolumeProps = {
      * The ID of the Availability Zone in which to create the volume. For example, `us-east-1a` .
      *
      * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzone}
      */
     AvailabilityZone?: string | undefined;
     /**
-     * The ID of the Availability Zone for the volume.
+     * The ID of the Availability Zone in which to create the volume. For example, `use1-az1` .
+     *
+     * Either `AvailabilityZone` or `AvailabilityZoneId` must be specified, but not both.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume copy is created in the same Availability Zone as the source volume.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-availabilityzoneid}
      */
     AvailabilityZoneId?: string | undefined;
     /**
-     * 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* .
+     * Indicates whether the volume should be encrypted. The effect of setting the encryption state to `true` depends on the volume origin (new, from a snapshot, or from an existing volume), 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) .
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-encrypted}
      */
     Encrypted?: boolean | undefined;
@@ -623,6 +683,8 @@ export type EC2VolumeProps = {
      * - 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.
+     *
+     * If you are creating a volume copy, omit this parameter. The volume is automatically encrypted with the same KMS key as the source volume. You can't copy unencrypted volumes.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-kmskeyid}
      */
     KmsKeyId?: string | undefined;
@@ -634,14 +696,19 @@ export type EC2VolumeProps = {
      */
     MultiAttachEnabled?: boolean | undefined;
     /**
-     * The Amazon Resource Name (ARN) of the Outpost.
+     * The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
+     *
+     * If you intend to use a volume with an instance running on an outpost, then you must create the volume on the same outpost as the instance. You can't use a volume created in an AWS Region with an instance on an AWS outpost, or the other way around.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-outpostarn}
      */
     OutpostArn?: string | undefined;
     /**
-     * The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size, and you can specify a volume size that is equal to or larger than the snapshot size.
+     * The size of the volume, in GiBs.
+     *
+     * - Required for new empty volumes.
+     * - Optional for volumes created from snapshots and volume copies. In this case, the size defaults to the size of the snapshot or source volume. You can optionally specify a size that is equal to or larger than the size of the source snapshot or volume.
      *
-     * Valid sizes:
+     * Supported volume sizes:
      *
      * - gp2: `1 - 16,384` GiB
      * - gp3: `1 - 65,536` GiB
@@ -653,12 +720,12 @@ export type EC2VolumeProps = {
      */
     Size?: number | undefined;
     /**
-     * The snapshot from which to create the volume. You must specify either a snapshot ID or a volume size.
+     * The snapshot from which to create the volume. Only specify to create a volume from a snapshot. To create a new empty volume, omit this parameter and specify a value for `Size` instead. To create a volume copy, omit this parameter and specify `SourceVolumeId` instead.
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-snapshotid}
      */
     SnapshotId?: string | undefined;
     /**
-     * The ID of the source volume from which the volume copy was created. Only for volume copies.
+     * The ID of the source EBS volume to copy. When specified, the volume is created as an exact copy of the specified volume. Only specify to create a volume copy. To create a new empty volume or to create a volume from a snapshot, omit this parameter,
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-sourcevolumeid}
      */
     SourceVolumeId: string;
@@ -701,7 +768,9 @@ export type EC2VolumeProps = {
      * - Cold HDD: `sc1`
      * - Magnetic: `standard`
      *
-     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) .
+     * > Throughput Optimized HDD ( `st1` ) and Cold HDD ( `sc1` ) volumes can't be used as boot volumes.
+     *
+     * For more information, see [Amazon EBS volume types](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) in the *Amazon EBS User Guide* .
      *
      * Default: `gp2`
      * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html#cfn-ec2-volume-volumetype}