@aws-sdk/client-ec2 3.425.0 → 3.428.0

package/dist-types/models/models_3.d.ts

@@ -5176,6 +5176,14 @@ export interface OnDemandOptions {
     /**
      * @public
      * <p>The maximum amount per hour for On-Demand Instances that you're willing to pay.</p>
+     *          <note>
+     *             <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
+     *             and if their average CPU usage exceeds the baseline utilization, you will incur a charge
+     *             for surplus credits. The <code>maxTotalPrice</code> does not account for surplus
+     *             credits, and, if you use surplus credits, your final cost might be higher than what you
+     *             specified for <code>maxTotalPrice</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits">Surplus credits can incur charges</a> in the <i>EC2 User
+     *                   Guide</i>.</p>
+     *          </note>
      */
     MaxTotalPrice?: string;
 }
@@ -5338,6 +5346,14 @@ export interface SpotOptions {
      *          <important>
      *             <p>If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter.</p>
      *          </important>
+     *          <note>
+     *             <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
+     *             and if their average CPU usage exceeds the baseline utilization, you will incur a charge
+     *             for surplus credits. The <code>maxTotalPrice</code> does not account for surplus
+     *             credits, and, if you use surplus credits, your final cost might be higher than what you
+     *             specified for <code>maxTotalPrice</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits">Surplus credits can incur charges</a> in the <i>EC2 User
+     *                   Guide</i>.</p>
+     *          </note>
      */
     MaxTotalPrice?: string;
 }
@@ -5511,13 +5527,13 @@ export interface FleetData {
     /**
      * @public
      * <p>Information about the instances that could not be launched by the fleet. Valid only when
-     *             <b>Type</b> is set to <code>instant</code>.</p>
+     *          <b>Type</b> is set to <code>instant</code>.</p>
      */
     Errors?: DescribeFleetError[];
     /**
      * @public
      * <p>Information about the instances that were launched by the fleet. Valid only when
-     *             <b>Type</b> is set to <code>instant</code>.</p>
+     *          <b>Type</b> is set to <code>instant</code>.</p>
      */
     Instances?: DescribeFleetsInstances[];
     /**
@@ -7156,6 +7172,12 @@ export interface DescribeImagesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>source-instance-id</code> - The ID of the instance that the AMI was created from
+     *           if the AMI was created using CreateImage. This filter is applicable only if the AMI was
+     *           created using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html">CreateImage</a>.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>state</code> - The state of the image (<code>available</code> | <code>pending</code>
      *           | <code>failed</code>).</p>
      *             </li>
@@ -7213,6 +7235,12 @@ export interface DescribeImagesRequest {
      *          </note>
      */
     IncludeDeprecated?: boolean;
+    /**
+     * @public
+     * <p>Specifies whether to include disabled AMIs.</p>
+     *          <p>Default: No disabled AMIs are included in the response.</p>
+     */
+    IncludeDisabled?: boolean;
     /**
      * @public
      * <p>Checks whether you have the required permissions for the action, without actually making the request,
@@ -7316,6 +7344,7 @@ export type DeviceType = (typeof DeviceType)[keyof typeof DeviceType];
 export declare const ImageState: {
     readonly available: "available";
     readonly deregistered: "deregistered";
+    readonly disabled: "disabled";
     readonly error: "error";
     readonly failed: "failed";
     readonly invalid: "invalid";
@@ -7451,7 +7480,8 @@ export interface Image {
     EnaSupport?: boolean;
     /**
      * @public
-     * <p>The hypervisor type of the image.</p>
+     * <p>The hypervisor type of the image. Only <code>xen</code> is supported. <code>ovm</code> is
+     *       not supported.</p>
      */
     Hypervisor?: HypervisorType | string;
     /**
@@ -7526,6 +7556,12 @@ export interface Image {
      *         the AMI</a> in the <i>Amazon EC2 User Guide</i>.</p>
      */
     ImdsSupport?: ImdsSupportValues | string;
+    /**
+     * @public
+     * <p>The ID of the instance that the AMI was created from if the AMI was created using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html">CreateImage</a>. This field only appears if the AMI was created using
+     *       CreateImage.</p>
+     */
+    SourceInstanceId?: string;
 }
 /**
  * @public
@@ -8629,10 +8665,6 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>license-pool</code> - </p>
-     *             </li>
-     *             <li>
-     *                <p>
      *                   <code>maintenance-options.auto-recovery</code> - The current automatic
      *                     recovery behavior of the instance (<code>disabled</code> | <code>default</code>).</p>
      *             </li>
@@ -8681,18 +8713,19 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.addresses.primary</code> - Specifies whether the IPv4
-     *                     address of the network interface is the primary private IPv4 address.</p>
+     *                   <code>network-interface.addresses.association.allocation-id</code> - The allocation ID.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.addresses.private-ip-address</code> - The private IPv4
-     *                     address associated with the network interface.</p>
+     *                   <code>network-interface.addresses.association.association-id</code> - The association ID.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.addresses.association.public-ip</code> - The ID of the
-     *                     association of an Elastic IP address (IPv4) with a network interface.</p>
+     *                   <code>network-interface.addresses.association.carrier-ip</code> - The carrier IP address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.addresses.association.customer-owned-ip</code> - The customer-owned IP address.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -8701,13 +8734,26 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.association.public-ip</code> - The address of the
-     *                     Elastic IP address (IPv4) bound to the network interface.</p>
+     *                   <code>network-interface.addresses.association.public-dns-name</code> - The public DNS name.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.association.ip-owner-id</code> - The owner of the
-     *                     Elastic IP address (IPv4) associated with the network interface.</p>
+     *                   <code>network-interface.addresses.association.public-ip</code> - The ID of the
+     *                     association of an Elastic IP address (IPv4) with a network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.addresses.primary</code> - Specifies whether the IPv4
+     *                     address of the network interface is the primary private IPv4 address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.addresses.private-dns-name</code> - The private DNS name.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.addresses.private-ip-address</code> - The private IPv4
+     *                     address associated with the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -8722,29 +8768,25 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.attachment.attachment-id</code> - The ID of the
-     *                     interface attachment.</p>
+     *                   <code>network-interface.association.carrier-ip</code> - The customer-owned IP address.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.attachment.instance-id</code> - The ID of the instance
-     *                     to which the network interface is attached.</p>
+     *                   <code>network-interface.association.customer-owned-ip</code> - The customer-owned IP address.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.attachment.instance-owner-id</code> - The owner ID of
-     *                     the instance to which the network interface is attached.</p>
+     *                   <code>network-interface.association.ip-owner-id</code> - The owner of the
+     *                     Elastic IP address (IPv4) associated with the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.attachment.device-index</code> - The device index to
-     *                     which the network interface is attached.</p>
+     *                   <code>network-interface.association.public-dns-name</code> - The public DNS name.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>network-interface.attachment.status</code> - The status of the
-     *                     attachment (<code>attaching</code> | <code>attached</code> |
-     *                         <code>detaching</code> | <code>detached</code>).</p>
+     *                   <code>network-interface.association.public-ip</code> - The address of the
+     *                     Elastic IP address (IPv4) bound to the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -8753,16 +8795,51 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.attachment.attachment-id</code> - The ID of the
+     *                     interface attachment.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.attachment.delete-on-termination</code> - Specifies
      *                     whether the attachment is deleted when an instance is terminated.</p>
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.attachment.device-index</code> - The device index to
+     *                     which the network interface is attached.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.attachment.instance-id</code> - The ID of the instance
+     *                     to which the network interface is attached.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.attachment.instance-owner-id</code> - The owner ID of
+     *                     the instance to which the network interface is attached.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.attachment.network-card-index</code> - The index of the network card.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.attachment.status</code> - The status of the
+     *                     attachment (<code>attaching</code> | <code>attached</code> |
+     *                     <code>detaching</code> | <code>detached</code>).</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.availability-zone</code> - The Availability Zone for
      *                     the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.deny-all-igw-traffic</code> - A Boolean that indicates whether
+     *                 a network interface with an IPv6 address is unreachable from the public internet.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.description</code> - The description of the network
      *                     interface.</p>
      *             </li>
@@ -8778,11 +8855,33 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.ipv4-prefixes.ipv4-prefix</code> - The IPv4 prefixes that are assigned to the network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.ipv6-address</code> - The IPv6 address associated with the network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.ipv6-addresses.ipv6-address</code> - The IPv6 address
      *                     associated with the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.ipv6-addresses.is-primary-ipv6</code> - A Boolean that indicates whether this
+     *                     is the primary IPv6 address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.ipv6-native</code> - A Boolean that indicates whether this is
+     *                     an IPv6 only network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.ipv6-prefixes.ipv6-prefix</code> - The IPv6 prefix assigned to the network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.mac-address</code> - The MAC address of the network
      *                     interface.</p>
      *             </li>
@@ -8793,6 +8892,10 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.outpost-arn</code> - The ARN of the Outpost.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.owner-id</code> - The ID of the owner of the network
      *                     interface.</p>
      *             </li>
@@ -8803,6 +8906,14 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.private-ip-address</code> - The private IPv4 address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.public-dns-name</code> - The public DNS name.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.requester-id</code> - The requester ID for the network
      *                     interface.</p>
      *             </li>
@@ -8831,6 +8942,14 @@ export interface DescribeInstancesRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>network-interface.tag-key</code> - The key of a tag assigned to the network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface.tag-value</code> - The value of a tag assigned to the network interface.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>network-interface.vpc-id</code> - The ID of the VPC for the network
      *                     interface.</p>
      *             </li>

package/dist-types/models/models_4.d.ts

@@ -4788,33 +4788,33 @@ export interface DescribeNetworkInterfacesRequest {
      *          <ul>
      *             <li>
      *                <p>
-     *                   <code>addresses.private-ip-address</code> - The private IPv4 addresses
-     *                     associated with the network interface.</p>
+     *                   <code>association.allocation-id</code> - The allocation ID returned when you
+     * 		                allocated the Elastic IP address (IPv4) for your network interface.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>addresses.primary</code> - Whether the private IPv4 address is the primary
-     *                     IP address associated with the network interface. </p>
+     *                   <code>association.association-id</code> - The association ID returned when the
+     * 		                network interface was associated with an IPv4 address.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>addresses.association.public-ip</code> - The association ID returned when
-     *                     the network interface was associated with the Elastic IP address
-     *                     (IPv4).</p>
+     *                   <code>addresses.association.owner-id</code> - The owner ID of the addresses associated with the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>addresses.association.owner-id</code> - The owner ID of the addresses associated with the network interface.</p>
+     *                   <code>addresses.association.public-ip</code> - The association ID returned when
+     * 		                the network interface was associated with the Elastic IP address
+     * 		                (IPv4).</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>association.association-id</code> - The association ID returned when the
-     *                     network interface was associated with an IPv4 address.</p>
+     *                   <code>addresses.primary</code> - Whether the private IPv4 address is the primary
+     *                     IP address associated with the network interface. </p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>association.allocation-id</code> - The allocation ID returned when you
-     *                     allocated the Elastic IP address (IPv4) for your network interface.</p>
+     *                   <code>addresses.private-ip-address</code> - The private IPv4 addresses
+     * 		                associated with the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -4833,11 +4833,11 @@ export interface DescribeNetworkInterfacesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>attachment.attachment-id</code> - The ID of the interface attachment.</p>
+     *                   <code>attachment.attach-time</code> - The time that the network interface was attached to an instance.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>attachment.attach-time</code> - The time that the network interface was attached to an instance.</p>
+     *                   <code>attachment.attachment-id</code> - The ID of the interface attachment.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -4873,21 +4873,22 @@ export interface DescribeNetworkInterfacesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>group-name</code> - The name of a security group associated with the network interface.</p>
-     *             </li>
-     *             <li>
-     *                <p>
      *                   <code>ipv6-addresses.ipv6-address</code> - An IPv6 address associated with
      *                     the network interface.</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <code>interface-type</code> - The type of network interface (<code>api_gateway_managed</code> |
-     * 		               <code>aws_codestar_connections_managed</code> | <code>branch</code> | <code>efa</code> |
-     * 		               <code>gateway_load_balancer</code> | <code>gateway_load_balancer_endpoint</code> | <code>global_accelerator_managed</code> |
-     * 		               <code>interface</code> | <code>iot_rules_managed</code> | <code>lambda</code> | <code>load_balancer</code> |
-     * 		               <code>nat_gateway</code> | <code>network_load_balancer</code> | <code>quicksight</code> |
-     * 		               <code>transit_gateway</code> | <code>trunk</code> | <code>vpc_endpoint</code>).</p>
+     * 		               <code>aws_codestar_connections_managed</code> | <code>branch</code> |
+     * 		               <code>ec2_instance_connect_endpoint</code> | <code>efa</code> | <code>efs</code> |
+     * 		               <code>gateway_load_balancer</code> | <code>gateway_load_balancer_endpoint</code> |
+     * 		               <code>global_accelerator_managed</code> |
+     * 		               <code>interface</code> | <code>iot_rules_managed</code> |
+     * 		               <code>lambda</code> | <code>load_balancer</code> |
+     * 		               <code>nat_gateway</code> | <code>network_load_balancer</code> |
+     * 		               <code>quicksight</code> |
+     * 		               <code>transit_gateway</code> | <code>trunk</code> |
+     * 		               <code>vpc_endpoint</code>).</p>
      *             </li>
      *             <li>
      *                <p>
@@ -4903,12 +4904,12 @@ export interface DescribeNetworkInterfacesRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>private-ip-address</code> - The private IPv4 address or addresses of the
-     *                     network interface.</p>
+     *                   <code>private-dns-name</code> - The private DNS name of the network interface (IPv4).</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>private-dns-name</code> - The private DNS name of the network interface (IPv4).</p>
+     *                   <code>private-ip-address</code> - The private IPv4 address or addresses of the
+     *                     network interface.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -8507,17 +8508,33 @@ export interface SpotFleetRequestConfigData {
      *             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.</p>
+     *          <note>
+     *             <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
+     *             and if their average CPU usage exceeds the baseline utilization, you will incur a charge
+     *             for surplus credits. The <code>onDemandMaxTotalPrice</code> does not account for surplus
+     *             credits, and, if you use surplus credits, your final cost might be higher than what you
+     *             specified for <code>onDemandMaxTotalPrice</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits">Surplus credits can incur charges</a> in the <i>EC2 User
+     *             Guide</i>.</p>
+     *          </note>
      */
     OnDemandMaxTotalPrice?: string;
     /**
      * @public
      * <p>The maximum amount per hour for Spot Instances that you're willing to pay. You can use
-     *             the <code>spotdMaxTotalPrice</code> parameter, the <code>onDemandMaxTotalPrice</code>
-     *             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.</p>
+     *          the <code>spotMaxTotalPrice</code> parameter, the <code>onDemandMaxTotalPrice</code>
+     *          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.</p>
+     *          <note>
+     *             <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
+     *             and if their average CPU usage exceeds the baseline utilization, you will incur a charge
+     *             for surplus credits. The <code>spotMaxTotalPrice</code> does not account for surplus
+     *             credits, and, if you use surplus credits, your final cost might be higher than what you
+     *             specified for <code>spotMaxTotalPrice</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode-concepts.html#unlimited-mode-surplus-credits">Surplus credits can incur charges</a> in the <i>EC2 User
+     *             Guide</i>.</p>
+     *          </note>
      */
     SpotMaxTotalPrice?: string;
     /**
@@ -8613,7 +8630,7 @@ export interface SpotFleetRequestConfigData {
      *                <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_SpotFleetTagSpecification.html">SpotFleetTagSpecification</a>
      *             </code> (valid only if you use
      *                 <code>LaunchSpecifications</code>). For information about tagging after launch, see
-     *                 <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources">Tagging Your Resources</a>.</p>
+     *                 <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources">Tag your resources</a>.</p>
      */
     TagSpecifications?: TagSpecification[];
 }
@@ -9479,6 +9496,10 @@ export interface DescribeStoreImageTasksRequest {
      *           bucket. For the filter value, specify the bucket name.</p>
      *             </li>
      *          </ul>
+     *          <note>
+     *             <p>When you specify the <code>ImageIds</code> parameter, any filters that you specify are
+     *         ignored. To use the filters, you must remove the <code>ImageIds</code> parameter.</p>
+     *          </note>
      */
     Filters?: Filter[];
     /**
@@ -9491,8 +9512,8 @@ export interface DescribeStoreImageTasksRequest {
      * <p>The maximum number of items to return for this request.
      *          To get the next page of items, make another request with the token returned in the output.
      * 	        For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination">Pagination</a>.</p>
-     *          <p>You cannot specify this parameter and the <code>ImageIDs</code> parameter
-     *       in the same call.</p>
+     *          <p>You cannot specify this parameter and the <code>ImageIds</code> parameter in the same
+     *       call.</p>
      */
     MaxResults?: number;
 }