@aws-sdk/client-ec2 3.614.0 → 3.620.0

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

@@ -2077,7 +2077,12 @@ export interface FleetLaunchTemplateOverridesRequest {
      */
     AvailabilityZone?: string;
     /**
-     * <p>The number of units provided by the specified instance type.</p>
+     * <p>The number of units provided by the specified instance type. These are the same units
+     *          that you chose to set the target capacity in terms of instances, or a performance
+     *          characteristic such as vCPUs, memory, or I/O.</p>
+     *          <p>If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the
+     *          number of instances to the next whole number. If this value is not specified, the default
+     *          is 1.</p>
      *          <note>
      *             <p>When specifying weights, the price used in the <code>lowest-price</code> and
      *                <code>price-capacity-optimized</code> allocation strategies is per
@@ -2121,9 +2126,67 @@ export interface FleetLaunchTemplateOverridesRequest {
      */
     InstanceRequirements?: InstanceRequirementsRequest;
     /**
-     * <p>The ID of the AMI. An AMI is required to launch an instance. This parameter is only
-     *          available for fleets of type <code>instant</code>. For fleets of type <code>maintain</code>
-     *          and <code>request</code>, you must specify the AMI ID in the launch template.</p>
+     * <p>The ID of the AMI in the format <code>ami-17characters00000</code>.</p>
+     *          <p>Alternatively, you can specify a Systems Manager parameter, using one of the following
+     *          formats. The Systems Manager parameter will resolve to an AMI ID on launch.</p>
+     *          <p>To reference a public parameter:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>public-parameter</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>To reference a parameter stored in the same account:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name:version-number</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name:label</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>To reference a parameter shared from another Amazon Web Services account:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:version-number</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:label</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-launch-template.html#use-an-ssm-parameter-instead-of-an-ami-id">Use a Systems Manager parameter instead of an AMI ID</a> in the
+     *          <i>Amazon EC2 User Guide</i>.</p>
+     *          <note>
+     *             <p>This parameter is only available for fleets of type <code>instant</code>. For fleets
+     *             of type <code>maintain</code> and <code>request</code>, you must specify the AMI ID in
+     *             the launch template.</p>
+     *          </note>
      * @public
      */
     ImageId?: string;
@@ -3295,7 +3358,12 @@ export interface FleetLaunchTemplateOverrides {
      */
     AvailabilityZone?: string;
     /**
-     * <p>The number of units provided by the specified instance type.</p>
+     * <p>The number of units provided by the specified instance type. These are the same units
+     *          that you chose to set the target capacity in terms of instances, or a performance
+     *          characteristic such as vCPUs, memory, or I/O.</p>
+     *          <p>If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the
+     *          number of instances to the next whole number. If this value is not specified, the default
+     *          is 1.</p>
      *          <note>
      *             <p>When specifying weights, the price used in the <code>lowest-price</code> and
      *             <code>price-capacity-optimized</code> allocation strategies is per
@@ -3339,9 +3407,67 @@ export interface FleetLaunchTemplateOverrides {
      */
     InstanceRequirements?: InstanceRequirements;
     /**
-     * <p>The ID of the AMI. An AMI is required to launch an instance. This parameter is only
-     *          available for fleets of type <code>instant</code>. For fleets of type <code>maintain</code>
-     *          and <code>request</code>, you must specify the AMI ID in the launch template.</p>
+     * <p>The ID of the AMI in the format <code>ami-17characters00000</code>.</p>
+     *          <p>Alternatively, you can specify a Systems Manager parameter, using one of the following
+     *          formats. The Systems Manager parameter will resolve to an AMI ID on launch.</p>
+     *          <p>To reference a public parameter:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>public-parameter</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>To reference a parameter stored in the same account:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name:version-number</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-name:label</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>To reference a parameter shared from another Amazon Web Services account:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:version-number</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:label</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *          </ul>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-launch-template.html#use-an-ssm-parameter-instead-of-an-ami-id">Use a Systems Manager parameter instead of an AMI ID</a> in the
+     *             <i>Amazon EC2 User Guide</i>.</p>
+     *          <note>
+     *             <p>This parameter is only available for fleets of type <code>instant</code>. For fleets
+     *             of type <code>maintain</code> and <code>request</code>, you must specify the AMI ID in
+     *             the launch template.</p>
+     *          </note>
      * @public
      */
     ImageId?: string;
@@ -4784,6 +4910,133 @@ export interface CreateIpamResult {
      */
     Ipam?: Ipam;
 }
+/**
+ * @public
+ */
+export interface CreateIpamExternalResourceVerificationTokenRequest {
+    /**
+     * <p>A check for whether you have the required permissions for the action without actually making the request
+     *    and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>.
+     *    Otherwise, it is <code>UnauthorizedOperation</code>.</p>
+     * @public
+     */
+    DryRun?: boolean;
+    /**
+     * <p>The ID of the IPAM that will create the token.</p>
+     * @public
+     */
+    IpamId: string | undefined;
+    /**
+     * <p>Token tags.</p>
+     * @public
+     */
+    TagSpecifications?: TagSpecification[];
+    /**
+     * <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html">Ensuring idempotency</a>.</p>
+     * @public
+     */
+    ClientToken?: string;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const IpamExternalResourceVerificationTokenState: {
+    readonly CREATE_COMPLETE: "create-complete";
+    readonly CREATE_FAILED: "create-failed";
+    readonly CREATE_IN_PROGRESS: "create-in-progress";
+    readonly DELETE_COMPLETE: "delete-complete";
+    readonly DELETE_FAILED: "delete-failed";
+    readonly DELETE_IN_PROGRESS: "delete-in-progress";
+};
+/**
+ * @public
+ */
+export type IpamExternalResourceVerificationTokenState = (typeof IpamExternalResourceVerificationTokenState)[keyof typeof IpamExternalResourceVerificationTokenState];
+/**
+ * @public
+ * @enum
+ */
+export declare const TokenState: {
+    readonly expired: "expired";
+    readonly valid: "valid";
+};
+/**
+ * @public
+ */
+export type TokenState = (typeof TokenState)[keyof typeof TokenState];
+/**
+ * <p>A verification token is an Amazon Web Services-generated random value that you can use to prove ownership of an external resource. For example, you can use a verification token to validate that you control a public IP address range when you bring an IP address range to Amazon Web Services (BYOIP).
+ * </p>
+ * @public
+ */
+export interface IpamExternalResourceVerificationToken {
+    /**
+     * <p>The ID of the token.</p>
+     * @public
+     */
+    IpamExternalResourceVerificationTokenId?: string;
+    /**
+     * <p>Token ARN.</p>
+     * @public
+     */
+    IpamExternalResourceVerificationTokenArn?: string;
+    /**
+     * <p>The ID of the IPAM that created the token.</p>
+     * @public
+     */
+    IpamId?: string;
+    /**
+     * <p>ARN of the IPAM that created the token.</p>
+     * @public
+     */
+    IpamArn?: string;
+    /**
+     * <p>Region of the IPAM that created the token.</p>
+     * @public
+     */
+    IpamRegion?: string;
+    /**
+     * <p>Token value.</p>
+     * @public
+     */
+    TokenValue?: string;
+    /**
+     * <p>Token name.</p>
+     * @public
+     */
+    TokenName?: string;
+    /**
+     * <p>Token expiration.</p>
+     * @public
+     */
+    NotAfter?: Date;
+    /**
+     * <p>Token status.</p>
+     * @public
+     */
+    Status?: TokenState;
+    /**
+     * <p>Token tags.</p>
+     * @public
+     */
+    Tags?: Tag[];
+    /**
+     * <p>Token state.</p>
+     * @public
+     */
+    State?: IpamExternalResourceVerificationTokenState;
+}
+/**
+ * @public
+ */
+export interface CreateIpamExternalResourceVerificationTokenResult {
+    /**
+     * <p>The verification token.</p>
+     * @public
+     */
+    IpamExternalResourceVerificationToken?: IpamExternalResourceVerificationToken;
+}
 /**
  * <p>A tag on an IPAM resource.</p>
  * @public
@@ -4877,8 +5130,17 @@ export interface CreateIpamPoolRequest {
      */
     IpamScopeId: string | undefined;
     /**
-     * <p>In IPAM, the locale is the Amazon Web Services Region or, for IPAM IPv4 pools in the public scope, the network border group for an Amazon Web Services Local Zone where you want to make an IPAM pool available for allocations (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#byoip-zone-avail">supported Local Zones</a>). If you do not choose a locale, resources in Regions others than the IPAM's home region cannot use CIDRs from this pool.</p>
-     *          <p>Possible values: Any Amazon Web Services Region, such as us-east-1.</p>
+     * <p>The locale for the pool should be one of the following:</p>
+     *          <ul>
+     *             <li>
+     *                <p>An Amazon Web Services Region where you want this IPAM pool to be available for allocations.</p>
+     *             </li>
+     *             <li>
+     *                <p>The network border group for an Amazon Web Services Local Zone where you want this IPAM pool to be available for allocations (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#byoip-zone-avail">supported Local Zones</a>). This option is only available for IPAM IPv4 pools in the public scope.</p>
+     *             </li>
+     *          </ul>
+     *          <p>If you do not choose a locale, resources in Regions others than the IPAM's home region cannot use CIDRs from this pool.</p>
+     *          <p>Possible values: Any Amazon Web Services Region or supported Amazon Web Services Local Zone.</p>
      * @public
      */
     Locale?: string;
@@ -5088,7 +5350,17 @@ export interface IpamPool {
      */
     IpamRegion?: string;
     /**
-     * <p>The locale of the IPAM pool. In IPAM, the locale is the Amazon Web Services Region or, for IPAM IPv4 pools in the public scope, the network border group for an Amazon Web Services Local Zone where you want to make an IPAM pool available for allocations (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#byoip-zone-avail">supported Local Zones</a>). If you choose an Amazon Web Services Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error.</p>
+     * <p>The locale of the IPAM pool.</p>
+     *          <p>The locale for the pool should be one of the following:</p>
+     *          <ul>
+     *             <li>
+     *                <p>An Amazon Web Services Region where you want this IPAM pool to be available for allocations.</p>
+     *             </li>
+     *             <li>
+     *                <p>The network border group for an Amazon Web Services Local Zone where you want this IPAM pool to be available for allocations (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#byoip-zone-avail">supported Local Zones</a>). This option is only available for IPAM IPv4 pools in the public scope.</p>
+     *             </li>
+     *          </ul>
+     *          <p>If you choose an Amazon Web Services Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error.</p>
      * @public
      */
     Locale?: string;
@@ -6587,41 +6859,75 @@ export interface RequestLaunchTemplateData {
      */
     NetworkInterfaces?: LaunchTemplateInstanceNetworkInterfaceSpecificationRequest[];
     /**
-     * <p>The ID of the AMI. Alternatively, you can specify a Systems Manager parameter, which
-     *             will resolve to an AMI ID on launch.</p>
-     *          <p>Valid formats:</p>
+     * <p>The ID of the AMI in the format <code>ami-17characters00000</code>.</p>
+     *          <p>Alternatively, you can specify a Systems Manager parameter, using one of the following
+     *             formats. The Systems Manager parameter will resolve to an AMI ID on launch.</p>
+     *          <p>To reference a public parameter:</p>
      *          <ul>
      *             <li>
      *                <p>
-     *                   <code>ami-17characters00000</code>
+     *                   <code>resolve:ssm:<i>public-parameter</i>
+     *                   </code>
      *                </p>
      *             </li>
+     *          </ul>
+     *          <p>To reference a parameter stored in the same account:</p>
+     *          <ul>
      *             <li>
      *                <p>
-     *                   <code>resolve:ssm:parameter-name</code>
+     *                   <code>resolve:ssm:<i>parameter-name</i>
+     *                   </code>
      *                </p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>resolve:ssm:parameter-name:version-number</code>
+     *                   <code>resolve:ssm:<i>parameter-name:version-number</i>
+     *                   </code>
      *                </p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>resolve:ssm:parameter-name:label</code>
+     *                   <code>resolve:ssm:<i>parameter-name:label</i>
+     *                   </code>
      *                </p>
      *             </li>
+     *          </ul>
+     *          <p>To reference a parameter shared from another Amazon Web Services account:</p>
+     *          <ul>
      *             <li>
      *                <p>
-     *                   <code>resolve:ssm:public-parameter</code>
+     *                   <code>resolve:ssm:<i>parameter-ARN</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:version-number</i>
+     *                   </code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>resolve:ssm:<i>parameter-ARN:label</i>
+     *                   </code>
      *                </p>
      *             </li>
      *          </ul>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-launch-template.html#use-an-ssm-parameter-instead-of-an-ami-id">Use a Systems Manager parameter instead of an AMI ID</a> in the <i>Amazon EC2 User Guide</i>.</p>
      *          <note>
-     *             <p>Currently, EC2 Fleet and Spot Fleet do not support specifying a Systems Manager parameter.
-     *                 If the launch template will be used by an EC2 Fleet or Spot Fleet, you must specify the AMI ID.</p>
+     *             <p>If the launch template will be used for an EC2 Fleet or Spot Fleet, note the
+     *                 following:</p>
+     *             <ul>
+     *                <li>
+     *                   <p>Only EC2 Fleets of type <code>instant</code> support specifying a Systems
+     *                         Manager parameter.</p>
+     *                </li>
+     *                <li>
+     *                   <p>For EC2 Fleets of type <code>maintain</code> or <code>request</code>, or
+     *                         for Spot Fleets, you must specify the AMI ID.</p>
+     *                </li>
+     *             </ul>
      *          </note>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-launch-template.html#use-an-ssm-parameter-instead-of-an-ami-id">Use a Systems Manager parameter instead of an AMI ID</a> in the <i>Amazon EC2 User Guide</i>.</p>
      * @public
      */
     ImageId?: string;
@@ -9744,151 +10050,6 @@ export interface AttachmentEnaSrdUdpSpecification {
      */
     EnaSrdUdpEnabled?: boolean;
 }
-/**
- * <p>ENA Express uses Amazon Web Services Scalable Reliable Datagram (SRD) technology to increase the
- * 			maximum bandwidth used per stream and minimize tail latency of network traffic between EC2 instances.
- * 			With ENA Express, you can communicate between two EC2 instances in the same subnet within the same
- * 			account, or in different accounts. Both sending and receiving instances must have ENA Express enabled.</p>
- *          <p>To improve the reliability of network packet delivery, ENA Express reorders network packets on the
- * 			receiving end by default. However, some UDP-based applications are designed to handle network packets
- * 			that are out of order to reduce the overhead for packet delivery at the network layer. When ENA Express
- * 			is enabled, you can specify whether UDP network traffic uses it.</p>
- * @public
- */
-export interface AttachmentEnaSrdSpecification {
-    /**
-     * <p>Indicates whether ENA Express is enabled for the network interface.</p>
-     * @public
-     */
-    EnaSrdEnabled?: boolean;
-    /**
-     * <p>Configures ENA Express for UDP network traffic.</p>
-     * @public
-     */
-    EnaSrdUdpSpecification?: AttachmentEnaSrdUdpSpecification;
-}
-/**
- * <p>Describes a network interface attachment.</p>
- * @public
- */
-export interface NetworkInterfaceAttachment {
-    /**
-     * <p>The timestamp indicating when the attachment initiated.</p>
-     * @public
-     */
-    AttachTime?: Date;
-    /**
-     * <p>The ID of the network interface attachment.</p>
-     * @public
-     */
-    AttachmentId?: string;
-    /**
-     * <p>Indicates whether the network interface is deleted when the instance is terminated.</p>
-     * @public
-     */
-    DeleteOnTermination?: boolean;
-    /**
-     * <p>The device index of the network interface attachment on the instance.</p>
-     * @public
-     */
-    DeviceIndex?: number;
-    /**
-     * <p>The index of the network card.</p>
-     * @public
-     */
-    NetworkCardIndex?: number;
-    /**
-     * <p>The ID of the instance.</p>
-     * @public
-     */
-    InstanceId?: string;
-    /**
-     * <p>The Amazon Web Services account ID of the owner of the instance.</p>
-     * @public
-     */
-    InstanceOwnerId?: string;
-    /**
-     * <p>The attachment state.</p>
-     * @public
-     */
-    Status?: AttachmentStatus;
-    /**
-     * <p>Configures ENA Express for the network interface that this action attaches to the instance.</p>
-     * @public
-     */
-    EnaSrdSpecification?: AttachmentEnaSrdSpecification;
-}
-/**
- * <p>A security group connection tracking configuration that enables you to set the idle timeout for connection tracking on an Elastic network interface. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-connection-tracking.html#connection-tracking-timeouts">Connection tracking timeouts</a> in the <i>Amazon EC2 User Guide</i>.</p>
- * @public
- */
-export interface ConnectionTrackingConfiguration {
-    /**
-     * <p>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.</p>
-     * @public
-     */
-    TcpEstablishedTimeout?: number;
-    /**
-     * <p>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.</p>
-     * @public
-     */
-    UdpStreamTimeout?: number;
-    /**
-     * <p>Timeout (in seconds) for idle UDP flows that
-     * 						have seen traffic only in a single direction or a single request-response
-     * 						transaction. Min: 30 seconds. Max: 60 seconds. Default: 30 seconds.</p>
-     * @public
-     */
-    UdpTimeout?: number;
-}
-/**
- * <p>Describes a security group.</p>
- * @public
- */
-export interface GroupIdentifier {
-    /**
-     * <p>The name of the security group.</p>
-     * @public
-     */
-    GroupName?: string;
-    /**
-     * <p>The ID of the security group.</p>
-     * @public
-     */
-    GroupId?: string;
-}
-/**
- * @public
- * @enum
- */
-export declare const NetworkInterfaceType: {
-    readonly api_gateway_managed: "api_gateway_managed";
-    readonly aws_codestar_connections_managed: "aws_codestar_connections_managed";
-    readonly branch: "branch";
-    readonly efa: "efa";
-    readonly gateway_load_balancer: "gateway_load_balancer";
-    readonly gateway_load_balancer_endpoint: "gateway_load_balancer_endpoint";
-    readonly global_accelerator_managed: "global_accelerator_managed";
-    readonly interface: "interface";
-    readonly iot_rules_managed: "iot_rules_managed";
-    readonly lambda: "lambda";
-    readonly load_balancer: "load_balancer";
-    readonly natGateway: "natGateway";
-    readonly network_load_balancer: "network_load_balancer";
-    readonly quicksight: "quicksight";
-    readonly transit_gateway: "transit_gateway";
-    readonly trunk: "trunk";
-    readonly vpc_endpoint: "vpc_endpoint";
-};
-/**
- * @public
- */
-export type NetworkInterfaceType = (typeof NetworkInterfaceType)[keyof typeof NetworkInterfaceType];
 /**
  * @internal
  */