feat(client-ec2): Adding support for the new fullSnapshotSizeInBytes field in the response of the EC2 EBS DescribeSnapshots API. This field represents the size of all the blocks that were written to the source volume at the time the snapshot was created.

awstools · awstools · commit 2962b1bca17e · 2025-02-11T19:54:42.000Z
diff --git a/clients/client-ec2/src/commands/AssignIpv6AddressesCommand.ts b/clients/client-ec2/src/commands/AssignIpv6AddressesCommand.ts
@@ -28,11 +28,11 @@ export interface AssignIpv6AddressesCommandInput extends AssignIpv6AddressesRequ
 export interface AssignIpv6AddressesCommandOutput extends AssignIpv6AddressesResult, __MetadataBearer {}
 
 /**
- * <p>Assigns one or more IPv6 addresses to the specified network interface. You can
- *             specify one or more specific IPv6 addresses, or you can specify the number of IPv6
- *             addresses to be automatically assigned from within the subnet's IPv6 CIDR block range.
+ * <p>Assigns the specified IPv6 addresses to the specified network interface. You can
+ *             specify specific IPv6 addresses, or you can specify the number of IPv6
+ *             addresses to be automatically assigned from the subnet's IPv6 CIDR block range.
  *             You can assign as many IPv6 addresses to a network interface as you can assign private
- *             IPv4 addresses, and the limit varies per instance type.</p>
+ *             IPv4 addresses, and the limit varies by instance type.</p>
  *          <p>You must specify either the IPv6 addresses or the IPv6 address count in the request. </p>
  *          <p>You can optionally use Prefix Delegation on the network interface. You must specify
  *             either the IPV6 Prefix Delegation prefixes, or the IPv6 Prefix Delegation count. For
diff --git a/clients/client-ec2/src/commands/AssignPrivateIpAddressesCommand.ts b/clients/client-ec2/src/commands/AssignPrivateIpAddressesCommand.ts
@@ -28,9 +28,9 @@ export interface AssignPrivateIpAddressesCommandInput extends AssignPrivateIpAdd
 export interface AssignPrivateIpAddressesCommandOutput extends AssignPrivateIpAddressesResult, __MetadataBearer {}
 
 /**
- * <p>Assigns one or more secondary private IP addresses to the specified network interface.</p>
- *          <p>You can specify one or more specific secondary IP addresses, or you can specify the number
- *             of secondary IP addresses to be automatically assigned within the subnet's CIDR block range.
+ * <p>Assigns the specified secondary private IP addresses to the specified network interface.</p>
+ *          <p>You can specify specific secondary IP addresses, or you can specify the number
+ *             of secondary IP addresses to be automatically assigned from the subnet's CIDR block range.
  *             The number of secondary IP addresses that you can assign to an instance varies by instance type.
  *             For more information about Elastic IP addresses, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html">Elastic IP Addresses</a> in the <i>Amazon EC2 User Guide</i>.</p>
  *          <p>When you move a secondary private IP address to another network interface, any Elastic IP address
diff --git a/clients/client-ec2/src/commands/CopySnapshotCommand.ts b/clients/client-ec2/src/commands/CopySnapshotCommand.ts
@@ -40,11 +40,10 @@ export interface CopySnapshotCommandOutput extends CopySnapshotResult, __Metadat
  *     	however, you can specify a different KMS key. To copy an encrypted
  *     	snapshot that has been shared from another account, you must have permissions for the KMS key
  *     	used to encrypt the snapshot.</p>
- *          <p>Snapshots copied to an Outpost are encrypted by default using the default
- *   		encryption key for the Region, or a different key that you specify in the request using
- *   		<b>KmsKeyId</b>. Outposts do not support unencrypted
- *   	  snapshots. For more information, <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#ami">
- *   			Amazon EBS local snapshots on Outposts</a> in the <i>Amazon EBS User Guide</i>.</p>
+ *          <p>Snapshots copied to an Outpost are encrypted by default using the default encryption key
+ *       for the Region, or a different key that you specify in the request using <b>KmsKeyId</b>. Outposts do not support unencrypted snapshots. For more information,
+ *       see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#ami">Amazon EBS
+ *         local snapshots on Outposts</a> in the <i>Amazon EBS User Guide</i>.</p>
  *          <p>Snapshots created by copying another snapshot have an arbitrary volume ID that should not
  *       be used for any purpose.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-copy-snapshot.html">Copy an Amazon EBS snapshot</a> in the
diff --git a/clients/client-ec2/src/commands/CreateManagedPrefixListCommand.ts b/clients/client-ec2/src/commands/CreateManagedPrefixListCommand.ts
@@ -28,7 +28,7 @@ export interface CreateManagedPrefixListCommandInput extends CreateManagedPrefix
 export interface CreateManagedPrefixListCommandOutput extends CreateManagedPrefixListResult, __MetadataBearer {}
 
 /**
- * <p>Creates a managed prefix list. You can specify one or more entries for the prefix list.
+ * <p>Creates a managed prefix list. You can specify entries for the prefix list.
  *             Each entry consists of a CIDR block and an optional description.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-ec2/src/commands/CreateSnapshotCommand.ts b/clients/client-ec2/src/commands/CreateSnapshotCommand.ts
@@ -38,8 +38,8 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer
  *           Region as the volume.</p>
  *             </li>
  *             <li>
- *                <p>If the source volume is in a Local Zone, you can create the snapshot in the same
- *           Local Zone or in parent Amazon Web Services Region.</p>
+ *                <p>If the source volume is in a Local Zone, you can create the snapshot in the same Local
+ *           Zone or in its parent Amazon Web Services Region.</p>
  *             </li>
  *             <li>
  *                <p>If the source volume is on an Outpost, you can create the snapshot on the same
@@ -60,8 +60,7 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer
  *       that you stop the instance before taking the snapshot.</p>
  *          <p>Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that
  *       are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes
- *       and any associated snapshots always remain protected. For more information,
- *       <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html">Amazon EBS encryption</a>
+ *       and any associated snapshots always remain protected. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html">Amazon EBS encryption</a>
  *       in the <i>Amazon EBS User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -105,6 +104,7 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer
  * //   TransferType: "time-based" || "standard",
  * //   CompletionDurationMinutes: Number("int"),
  * //   CompletionTime: new Date("TIMESTAMP"),
+ * //   FullSnapshotSizeInBytes: Number("long"),
  * //   SnapshotId: "STRING_VALUE",
  * //   VolumeId: "STRING_VALUE",
  * //   State: "pending" || "completed" || "error" || "recoverable" || "recovering",
diff --git a/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts b/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts
@@ -41,7 +41,7 @@ export interface CreateSnapshotsCommandOutput extends CreateSnapshotsResult, __M
  *             </li>
  *             <li>
  *                <p>If the source instance is in a Local Zone, you can create the snapshots in the same
- *           Local Zone or in parent Amazon Web Services Region.</p>
+ *           Local Zone or in its parent Amazon Web Services Region.</p>
  *             </li>
  *             <li>
  *                <p>If the source instance is on an Outpost, you can create the snapshots on the same
diff --git a/clients/client-ec2/src/commands/DeleteSnapshotCommand.ts b/clients/client-ec2/src/commands/DeleteSnapshotCommand.ts
@@ -35,7 +35,7 @@ export interface DeleteSnapshotCommandOutput extends __MetadataBearer {}
  *       regardless of which prior snapshots have been deleted, all active snapshots will have access
  *       to all the information needed to restore the volume.</p>
  *          <p>You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI.
- *       You must first de-register the AMI before you can delete the snapshot.</p>
+ *       You must first deregister the AMI before you can delete the snapshot.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-deleting-snapshot.html">Delete an Amazon EBS snapshot</a> in the
  *         <i>Amazon EBS User Guide</i>.</p>
  * @example
diff --git a/clients/client-ec2/src/commands/DescribeInstanceAttributeCommand.ts b/clients/client-ec2/src/commands/DescribeInstanceAttributeCommand.ts
@@ -29,13 +29,8 @@ export interface DescribeInstanceAttributeCommandOutput extends InstanceAttribut
 
 /**
  * <p>Describes the specified attribute of the specified instance. You can specify only one
- *             attribute at a time. Valid attribute values are: <code>instanceType</code> |
- *                 <code>kernel</code> | <code>ramdisk</code> | <code>userData</code> |
- *                 <code>disableApiTermination</code> | <code>instanceInitiatedShutdownBehavior</code>
- *             | <code>rootDeviceName</code> | <code>blockDeviceMapping</code> |
- *                 <code>productCodes</code> | <code>sourceDestCheck</code> | <code>groupSet</code> |
- *                 <code>ebsOptimized</code> | <code>sriovNetSupport</code>
- *          </p>
+ *             attribute at a time.
+ *         </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/DescribeNetworkInterfacesCommand.ts b/clients/client-ec2/src/commands/DescribeNetworkInterfacesCommand.ts
@@ -28,7 +28,7 @@ export interface DescribeNetworkInterfacesCommandInput extends DescribeNetworkIn
 export interface DescribeNetworkInterfacesCommandOutput extends DescribeNetworkInterfacesResult, __MetadataBearer {}
 
 /**
- * <p>Describes one or more of your network interfaces.</p>
+ * <p>Describes the specified network interfaces or all your network interfaces.</p>
  *          <p>If you have a large number of network interfaces, the operation fails unless
  *            you use pagination or one of the following filters: <code>group-id</code>,
  *            <code>mac-address</code>, <code>private-dns-name</code>, <code>private-ip-address</code>,
diff --git a/clients/client-ec2/src/commands/DescribeSnapshotsCommand.ts b/clients/client-ec2/src/commands/DescribeSnapshotsCommand.ts
@@ -124,6 +124,7 @@ export interface DescribeSnapshotsCommandOutput extends DescribeSnapshotsResult,
  * //       TransferType: "time-based" || "standard",
  * //       CompletionDurationMinutes: Number("int"),
  * //       CompletionTime: new Date("TIMESTAMP"),
+ * //       FullSnapshotSizeInBytes: Number("long"),
  * //       SnapshotId: "STRING_VALUE",
  * //       VolumeId: "STRING_VALUE",
  * //       State: "pending" || "completed" || "error" || "recoverable" || "recovering",
diff --git a/clients/client-ec2/src/commands/UnassignIpv6AddressesCommand.ts b/clients/client-ec2/src/commands/UnassignIpv6AddressesCommand.ts
@@ -28,7 +28,7 @@ export interface UnassignIpv6AddressesCommandInput extends UnassignIpv6Addresses
 export interface UnassignIpv6AddressesCommandOutput extends UnassignIpv6AddressesResult, __MetadataBearer {}
 
 /**
- * <p>Unassigns one or more IPv6 addresses IPv4 Prefix Delegation prefixes from a network interface.</p>
+ * <p>Unassigns the specified IPv6 addresses or Prefix Delegation prefixes from a network interface.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/UnassignPrivateIpAddressesCommand.ts b/clients/client-ec2/src/commands/UnassignPrivateIpAddressesCommand.ts
@@ -28,7 +28,7 @@ export interface UnassignPrivateIpAddressesCommandInput extends UnassignPrivateI
 export interface UnassignPrivateIpAddressesCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Unassigns one or more secondary private IP addresses, or IPv4 Prefix Delegation prefixes from a
+ * <p>Unassigns the specified secondary private IP addresses or IPv4 Prefix Delegation prefixes from a
  *         	network interface.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-ec2/src/models/models_0.ts b/clients/client-ec2/src/models/models_0.ts
@@ -3903,7 +3903,7 @@ export interface AssignIpv6AddressesRequest {
   Ipv6PrefixCount?: number | undefined;
 
   /**
-   * <p>One or more IPv6 prefixes assigned to the network interface. You cannot use this option if you use the <code>Ipv6PrefixCount</code> option.</p>
+   * <p>One or more IPv6 prefixes assigned to the network interface. You can't use this option if you use the <code>Ipv6PrefixCount</code> option.</p>
    * @public
    */
   Ipv6Prefixes?: string[] | undefined;
@@ -3961,13 +3961,13 @@ export interface AssignIpv6AddressesResult {
  */
 export interface AssignPrivateIpAddressesRequest {
   /**
-   * <p>One or more IPv4 prefixes assigned to the network interface. You cannot use this option if you use the <code>Ipv4PrefixCount</code> option.</p>
+   * <p>One or more IPv4 prefixes assigned to the network interface. You can't use this option if you use the <code>Ipv4PrefixCount</code> option.</p>
    * @public
    */
   Ipv4Prefixes?: string[] | undefined;
 
   /**
-   * <p>The number of IPv4 prefixes that Amazon Web Services automatically assigns to the network interface. You cannot use this option if you use the <code>Ipv4 Prefixes</code> option.</p>
+   * <p>The number of IPv4 prefixes that Amazon Web Services automatically assigns to the network interface. You can't use this option if you use the <code>Ipv4 Prefixes</code> option.</p>
    * @public
    */
   Ipv4PrefixCount?: number | undefined;
@@ -6739,6 +6739,14 @@ export interface IpRange {
   /**
    * <p>The IPv4 address range. You can either specify a CIDR block or a source security group,
    *             not both. To specify a single IPv4 address, use the /32 prefix length.</p>
+   *          <note>
+   *             <p>
+   *               Amazon Web Services <a href="https://en.wikipedia.org/wiki/Canonicalization">canonicalizes</a> IPv4 and IPv6 CIDRs. For example, if you specify 100.68.0.18/18 for the CIDR block,
+   *               Amazon Web Services canonicalizes the CIDR block to 100.68.0.0/18. Any subsequent DescribeSecurityGroups and DescribeSecurityGroupRules calls will
+   *               return the canonicalized form of the CIDR block. Additionally, if you attempt to add another rule with the
+   *               non-canonical form of the CIDR (such as 100.68.0.18/18) and there is already a rule for the canonicalized
+   *               form of the CIDR block (such as 100.68.0.0/18), the API throws an duplicate rule error.</p>
+   *          </note>
    * @public
    */
   CidrIp?: string | undefined;
@@ -6760,6 +6768,14 @@ export interface Ipv6Range {
   /**
    * <p>The IPv6 address range. You can either specify a CIDR block or a source security group,
    *         not both. To specify a single IPv6 address, use the /128 prefix length.</p>
+   *          <note>
+   *             <p>
+   *               Amazon Web Services <a href="https://en.wikipedia.org/wiki/Canonicalization">canonicalizes</a> IPv4 and IPv6 CIDRs. For example, if you specify 100.68.0.18/18 for the CIDR block,
+   *               Amazon Web Services canonicalizes the CIDR block to 100.68.0.0/18. Any subsequent DescribeSecurityGroups and DescribeSecurityGroupRules calls will
+   *               return the canonicalized form of the CIDR block. Additionally, if you attempt to add another rule with the
+   *               non-canonical form of the CIDR (such as 100.68.0.18/18) and there is already a rule for the canonicalized
+   *               form of the CIDR block (such as 100.68.0.0/18), the API throws an duplicate rule error.</p>
+   *          </note>
    * @public
    */
   CidrIpv6?: string | undefined;
@@ -7121,6 +7137,14 @@ export interface AuthorizeSecurityGroupEgressResult {
 export interface AuthorizeSecurityGroupIngressRequest {
   /**
    * <p>The IPv4 address range, in CIDR format.</p>
+   *          <note>
+   *             <p>
+   *                Amazon Web Services <a href="https://en.wikipedia.org/wiki/Canonicalization">canonicalizes</a> IPv4 and IPv6 CIDRs. For example, if you specify 100.68.0.18/18 for the CIDR block,
+   *               Amazon Web Services canonicalizes the CIDR block to 100.68.0.0/18. Any subsequent DescribeSecurityGroups and DescribeSecurityGroupRules calls will
+   *               return the canonicalized form of the CIDR block. Additionally, if you attempt to add another rule with the
+   *               non-canonical form of the CIDR (such as 100.68.0.18/18) and there is already a rule for the canonicalized
+   *               form of the CIDR block (such as 100.68.0.0/18), the API throws an duplicate rule error.</p>
+   *          </note>
    *          <p>To specify an IPv6 address range, use IP permissions instead.</p>
    *          <p>To specify multiple rules and descriptions for the rules, use IP permissions instead.</p>
    * @public
diff --git a/clients/client-ec2/src/models/models_1.ts b/clients/client-ec2/src/models/models_1.ts
@@ -161,7 +161,7 @@ export interface CreateCapacityReservationRequest {
    * <p>The number of instances for which to reserve capacity.</p>
    *          <note>
    *             <p>You can request future-dated Capacity Reservations for an instance count
-   * 				with a minimum of 100 VPUs. For example, if you request a future-dated Capacity
+   * 				with a minimum of 100 vCPUs. For example, if you request a future-dated Capacity
    * 				Reservation for <code>m5.xlarge</code> instances, you must request at least
    * 				25 instances (<i>25 * m5.xlarge = 100 vCPUs</i>).</p>
    *          </note>
@@ -9669,7 +9669,7 @@ export interface InstanceIpv6AddressRequest {
 }
 
 /**
- * <p>Describes the IPv4 prefix option for a network interface.</p>
+ * <p>Describes the IPv6 prefix option for a network interface.</p>
  * @public
  */
 export interface Ipv6PrefixSpecificationRequest {
@@ -10210,11 +10210,11 @@ export interface RequestLaunchTemplateData {
   RamDiskId?: string | undefined;
 
   /**
-   * <p>If you set this parameter to <code>true</code>, you can't terminate the instance using
-   *             the Amazon EC2 console, CLI, or API; otherwise, you can. To change this attribute after
-   *             launch, use <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html">ModifyInstanceAttribute</a>. Alternatively, if you set
-   *                 <code>InstanceInitiatedShutdownBehavior</code> to <code>terminate</code>, you can
-   *             terminate the instance by running the shutdown command from the instance.</p>
+   * <p>Indicates whether termination protection is enabled for the instance. The default
+   *             is <code>false</code>, which means that you can terminate the instance using
+   *             the Amazon EC2 console, command line tools, or API. You can enable termination protection
+   *             when you launch an instance, while the instance is running, or while the instance
+   *             is stopped.</p>
    * @public
    */
   DisableApiTermination?: boolean | undefined;
diff --git a/clients/client-ec2/src/models/models_2.ts b/clients/client-ec2/src/models/models_2.ts
@@ -1312,7 +1312,7 @@ export interface CreateNetworkInterfaceRequest {
   PrivateIpAddress?: string | undefined;
 
   /**
-   * <p>The IDs of one or more security groups.</p>
+   * <p>The IDs of the security groups.</p>
    * @public
    */
   Groups?: string[] | undefined;
@@ -3250,6 +3250,17 @@ export interface Snapshot {
    */
   CompletionTime?: Date | undefined;
 
+  /**
+   * <p>The full size of the snapshot, in bytes.</p>
+   *          <important>
+   *             <p>This is <b>not</b> the incremental size of the snapshot.
+   *         This is the full snapshot size and represents the size of all the blocks that were
+   *         written to the source volume at the time the snapshot was created.</p>
+   *          </important>
+   * @public
+   */
+  FullSnapshotSizeInBytes?: number | undefined;
+
   /**
    * <p>The ID of the snapshot. Each snapshot receives a unique identifier when it is
    *       created.</p>
diff --git a/clients/client-ec2/src/models/models_3.ts b/clients/client-ec2/src/models/models_3.ts
diff --git a/clients/client-ec2/src/models/models_4.ts b/clients/client-ec2/src/models/models_4.ts
diff --git a/clients/client-ec2/src/models/models_5.ts b/clients/client-ec2/src/models/models_5.ts
diff --git a/clients/client-ec2/src/models/models_6.ts b/clients/client-ec2/src/models/models_6.ts
diff --git a/clients/client-ec2/src/models/models_7.ts b/clients/client-ec2/src/models/models_7.ts
diff --git a/clients/client-ec2/src/protocols/Aws_ec2.ts b/clients/client-ec2/src/protocols/Aws_ec2.ts
diff --git a/codegen/sdk-codegen/aws-models/ec2.json b/codegen/sdk-codegen/aws-models/ec2.json
