@aws-sdk/client-ec2 3.172.0 → 3.175.0

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

@@ -1,6 +1,134 @@
-import { _InstanceType, ActiveInstance, AllocationState, AllowsMultipleInstanceTypes, AssociationStatus, AttachmentStatus, AttributeValue, AutoPlacement, BundleTask, ByoipCidr, CapacityReservation, CapacityReservationFleetState, CarrierGateway, ClientVpnAuthenticationType, ClientVpnAuthorizationRuleStatus, ClientVpnEndpointStatus, ClientVpnRouteStatus, CoipPool, CurrencyCodeValues, CustomerGateway, FleetCapacityReservation, FleetCapacityReservationTenancy, FleetInstanceMatchCriteria, HostnameType, HostRecovery, IamInstanceProfile, IamInstanceProfileAssociation, InstanceEventWindow, Tag, TransportProtocol } from "./models_0";
-import { BlockDeviceMapping, CapacityReservationPreference, CapacityReservationTargetResponse, DefaultTargetCapacityType, DestinationFileFormat, DhcpOptions, DiskImageFormat, EgressOnlyInternetGateway, ExportTask, FleetCapacityReservationUsageStrategy, FleetExcessCapacityTerminationPolicy, FleetLaunchTemplateOverrides, FleetLaunchTemplateSpecification, FleetOnDemandAllocationStrategy, FleetReplacementStrategy, FleetType, GroupIdentifier, InstanceIpv6Address, InstanceLifecycle, InternetGateway, Ipam, IpamPool, IpamScope, KeyType, LaunchTemplate, LaunchTemplateAndOverridesResponse, LaunchTemplateVersion, LocalGatewayRouteTable, LocalGatewayRouteTableVirtualInterfaceGroupAssociation, LocalGatewayRouteTableVpcAssociation, LogDestinationType, NetworkInterfaceStatus, Placement, PlatformValues, SpotAllocationStrategy, SpotInstanceInterruptionBehavior, StateReason, TargetCapacityUnitType, TrafficType } from "./models_1";
-import { Filter, FleetStateCode, InstanceTagNotificationAttribute } from "./models_2";
+import { _InstanceType, ActiveInstance, Address, AddressAttribute, AddressAttributeName, AllocationState, AllowsMultipleInstanceTypes, AssociationStatus, AttachmentStatus, AutoPlacement, BundleTask, ByoipCidr, CapacityReservation, CapacityReservationFleetState, CarrierGateway, ClientVpnAuthenticationType, ClientVpnAuthorizationRuleStatus, ClientVpnEndpointStatus, ClientVpnRouteStatus, CoipPool, CurrencyCodeValues, CustomerGateway, FleetCapacityReservation, FleetCapacityReservationTenancy, FleetInstanceMatchCriteria, HostnameType, HostRecovery, IamInstanceProfile, IamInstanceProfileAssociation, InstanceEventWindow, Tag, TransportProtocol } from "./models_0";
+import { AttributeValue, BlockDeviceMapping, CapacityReservationPreference, CapacityReservationTargetResponse, DefaultTargetCapacityType, DestinationFileFormat, DhcpOptions, DiskImageFormat, EgressOnlyInternetGateway, ExportTask, FleetCapacityReservationUsageStrategy, FleetExcessCapacityTerminationPolicy, FleetLaunchTemplateOverrides, FleetLaunchTemplateSpecification, FleetOnDemandAllocationStrategy, FleetReplacementStrategy, FleetType, GroupIdentifier, InstanceIpv6Address, InstanceLifecycle, InternetGateway, Ipam, IpamPool, IpamScope, KeyType, LaunchTemplate, LaunchTemplateAndOverridesResponse, LaunchTemplateVersion, LocalGatewayRouteTable, LocalGatewayRouteTableVirtualInterfaceGroupAssociation, LocalGatewayRouteTableVpcAssociation, LogDestinationType, NetworkInterfaceStatus, Placement, PlatformValues, SpotAllocationStrategy, SpotInstanceInterruptionBehavior, StateReason, TargetCapacityUnitType, TrafficType } from "./models_1";
+import { FleetStateCode, InstanceTagNotificationAttribute } from "./models_2";
+/**
+ * <p>A filter name and value pair that is used to return a more specific list of results from a describe operation.
+ *          Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.</p>
+ *          <p>If you specify multiple filters, the filters are joined with an <code>AND</code>, and the request returns only
+ *            results that match all of the specified filters.</p>
+ */
+export interface Filter {
+    /**
+     * <p>The name of the filter. Filter names are case-sensitive.</p>
+     */
+    Name?: string;
+    /**
+     * <p>The filter values. Filter values are case-sensitive. If you specify multiple values for a
+     *          filter, the values are joined with an <code>OR</code>, and the request returns all results
+     *          that match any of the specified values.</p>
+     */
+    Values?: string[];
+}
+export interface DescribeAddressesRequest {
+    /**
+     * <p>One or more filters. Filter names and values are case-sensitive.</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>allocation-id</code> - [EC2-VPC] The allocation ID for the address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>association-id</code> - [EC2-VPC] The association ID for the address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>domain</code> - Indicates whether the address is for use in EC2-Classic (<code>standard</code>)
+     *               or in a VPC (<code>vpc</code>).</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>instance-id</code> - The ID of the instance the address is associated with, if any.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-border-group</code> -  A unique set of Availability Zones, Local Zones,
+     *            or Wavelength Zones from where Amazon Web Services advertises IP addresses. </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface-id</code> - [EC2-VPC] The ID of the network interface that the address is associated with, if any.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>network-interface-owner-id</code> - The Amazon Web Services account ID of the owner.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>private-ip-address</code> - [EC2-VPC] The private IP address associated with the Elastic IP address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>public-ip</code> - The Elastic IP address, or the carrier IP address.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>tag</code>:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value.
+     *     For example, to find all resources that have a tag with the key <code>Owner</code> and the value <code>TeamA</code>, specify <code>tag:Owner</code> for the filter name and <code>TeamA</code> for the filter value.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>tag-key</code> - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.</p>
+     *             </li>
+     *          </ul>
+     */
+    Filters?: Filter[];
+    /**
+     * <p>One or more Elastic IP addresses.</p>
+     *          <p>Default: Describes all your Elastic IP addresses.</p>
+     */
+    PublicIps?: string[];
+    /**
+     * <p>[EC2-VPC] Information about the allocation IDs.</p>
+     */
+    AllocationIds?: string[];
+    /**
+     * <p>Checks 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>
+     */
+    DryRun?: boolean;
+}
+export interface DescribeAddressesResult {
+    /**
+     * <p>Information about the Elastic IP addresses.</p>
+     */
+    Addresses?: Address[];
+}
+export interface DescribeAddressesAttributeRequest {
+    /**
+     * <p>[EC2-VPC] The allocation IDs.</p>
+     */
+    AllocationIds?: string[];
+    /**
+     * <p>The attribute of the IP address.</p>
+     */
+    Attribute?: AddressAttributeName | string;
+    /**
+     * <p>The token for the next page of results.</p>
+     */
+    NextToken?: string;
+    /**
+     * <p>The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned <code>nextToken</code> value.</p>
+     */
+    MaxResults?: number;
+    /**
+     * <p>Checks 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>
+     */
+    DryRun?: boolean;
+}
+export interface DescribeAddressesAttributeResult {
+    /**
+     * <p>Information about the IP addresses.</p>
+     */
+    Addresses?: AddressAttribute[];
+    /**
+     * <p>The token to use to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>
+     */
+    NextToken?: string;
+}
 export interface DescribeAggregateIdFormatRequest {
     /**
      * <p>Checks whether you have the required permissions for the action, without actually making the request,
@@ -2835,10 +2963,15 @@ export interface FleetSpotMaintenanceStrategies {
 export interface SpotOptions {
     /**
      * <p>The strategy that determines how to allocate the target Spot Instance capacity across the Spot Instance
-     *          pools specified by the EC2 Fleet.</p>
+     *          pools specified by the EC2 Fleet launch configuration. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-allocation-strategy.html">Allocation strategies for Spot Instances</a> in the
+     *          <i>Amazon EC2 User Guide</i>.</p>
      *          <p>
-     *             <code>lowest-price</code> - EC2 Fleet launches instances from the Spot Instance pools with the lowest
-     *          price.</p>
+     *             <code>lowest-price</code> - EC2 Fleet launches instances from the lowest-price Spot Instance pool that
+     *          has available capacity. If the cheapest pool doesn't have available capacity, the Spot Instances
+     *          come from the next cheapest pool that has available capacity. If a pool runs out of
+     *          capacity before fulfilling your desired capacity, EC2 Fleet will continue to fulfill your
+     *          request by drawing from the next cheapest pool. To ensure that your desired capacity is
+     *          met, you might receive Spot Instances from several pools.</p>
      *          <p>
      *             <code>diversified</code> - EC2 Fleet launches instances from all of the Spot Instance pools that you
      *          specify.</p>
@@ -5902,13 +6035,14 @@ export interface InstanceMetadataOptionsResponse {
     /**
      * <p>The state of token usage for your instance metadata requests.</p>
      *         <p>If the state is <code>optional</code>, you can choose to retrieve instance metadata
-     *             with or without a signed token header on your request. If you retrieve the IAM role credentials without a token, the version 1.0 role credentials are
-     *             returned. If you retrieve the IAM role credentials using a valid signed
-     *             token, the version 2.0 role credentials are returned.</p>
-     *         <p>If the state is <code>required</code>, you must send a signed token header with any
-     *             instance metadata retrieval requests. In this state, retrieving the IAM
-     *             role credential always returns the version 2.0 credentials; the version 1.0 credentials
-     *             are not available.</p>
+     *             with or without a session token on your request. If you retrieve the IAM
+     *             role credentials without a token, the version 1.0 role credentials are returned. If you
+     *             retrieve the IAM role credentials using a valid session token, the
+     *             version 2.0 role credentials are returned.</p>
+     *         <p>If the state is <code>required</code>, you must send a session token with any instance
+     *             metadata retrieval requests. In this state, retrieving the IAM role
+     *             credentials always returns the version 2.0 credentials; the version 1.0 credentials are
+     *             not available.</p>
      *         <p>Default: <code>optional</code>
      *          </p>
      */
@@ -6472,10 +6606,6 @@ export interface Instance {
  * <p>Describes a launch request for one or more instances, and includes owner, requester,
  *             and security group information that applies to all instances in the launch
  *             request.</p>
- *
- *         <note>
- *             <p>We are retiring EC2-Classic on August 15, 2022. We recommend that you migrate from EC2-Classic to a VPC. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-migrate.html">Migrate from EC2-Classic to a VPC</a> in the <i>Amazon EC2 User Guide</i>.</p>
- *         </note>
  */
 export interface Reservation {
     /**
@@ -8378,118 +8508,25 @@ export interface DescribeLocalGatewaysRequest {
     DryRun?: boolean;
 }
 /**
- * <p>Describes a local gateway.</p>
+ * @internal
  */
-export interface LocalGateway {
-    /**
-     * <p>The ID of the local gateway.</p>
-     */
-    LocalGatewayId?: string;
-    /**
-     * <p>The Amazon Resource Name (ARN) of the Outpost.</p>
-     */
-    OutpostArn?: string;
-    /**
-     * <p>The ID of the Amazon Web Services account that owns the local gateway.</p>
-     */
-    OwnerId?: string;
-    /**
-     * <p>The state of the local gateway.</p>
-     */
-    State?: string;
-    /**
-     * <p>The tags assigned to the local gateway.</p>
-     */
-    Tags?: Tag[];
-}
-export interface DescribeLocalGatewaysResult {
-    /**
-     * <p>Information about the local gateways.</p>
-     */
-    LocalGateways?: LocalGateway[];
-    /**
-     * <p>The token to use to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>
-     */
-    NextToken?: string;
-}
-export interface DescribeLocalGatewayVirtualInterfaceGroupsRequest {
-    /**
-     * <p>The IDs of the virtual interface groups.</p>
-     */
-    LocalGatewayVirtualInterfaceGroupIds?: string[];
-    /**
-     * <p>One or more filters.</p>
-     *          <ul>
-     *             <li>
-     *                <p>
-     *                   <code>local-gateway-id</code> - The ID of a local gateway.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>local-gateway-virtual-interface-group-id</code> - The ID of the virtual interface group.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>local-gateway-virtual-interface-id</code> - The ID of the virtual interface.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>owner-id</code> - The ID of the Amazon Web Services account that owns the local gateway virtual interface group.</p>
-     *             </li>
-     *          </ul>
-     */
-    Filters?: Filter[];
-    /**
-     * <p>The maximum number of results to return with a single call.
-     * 	To retrieve the remaining results, make another call with the returned <code>nextToken</code> value.</p>
-     */
-    MaxResults?: number;
-    /**
-     * <p>The token for the next page of results.</p>
-     */
-    NextToken?: string;
-    /**
-     * <p>Checks 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>
-     */
-    DryRun?: boolean;
-}
+export declare const FilterFilterSensitiveLog: (obj: Filter) => any;
 /**
- * <p>Describes a local gateway virtual interface group.</p>
+ * @internal
  */
-export interface LocalGatewayVirtualInterfaceGroup {
-    /**
-     * <p>The ID of the virtual interface group.</p>
-     */
-    LocalGatewayVirtualInterfaceGroupId?: string;
-    /**
-     * <p>The IDs of the virtual interfaces.</p>
-     */
-    LocalGatewayVirtualInterfaceIds?: string[];
-    /**
-     * <p>The ID of the local gateway.</p>
-     */
-    LocalGatewayId?: string;
-    /**
-     * <p>The ID of the Amazon Web Services account that owns the local gateway virtual interface group.</p>
-     */
-    OwnerId?: string;
-    /**
-     * <p>The tags assigned to the virtual interface group.</p>
-     */
-    Tags?: Tag[];
-}
-export interface DescribeLocalGatewayVirtualInterfaceGroupsResult {
-    /**
-     * <p>The virtual interface groups.</p>
-     */
-    LocalGatewayVirtualInterfaceGroups?: LocalGatewayVirtualInterfaceGroup[];
-    /**
-     * <p>The token to use to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>
-     */
-    NextToken?: string;
-}
+export declare const DescribeAddressesRequestFilterSensitiveLog: (obj: DescribeAddressesRequest) => any;
+/**
+ * @internal
+ */
+export declare const DescribeAddressesResultFilterSensitiveLog: (obj: DescribeAddressesResult) => any;
+/**
+ * @internal
+ */
+export declare const DescribeAddressesAttributeRequestFilterSensitiveLog: (obj: DescribeAddressesAttributeRequest) => any;
+/**
+ * @internal
+ */
+export declare const DescribeAddressesAttributeResultFilterSensitiveLog: (obj: DescribeAddressesAttributeResult) => any;
 /**
  * @internal
  */
@@ -9442,23 +9479,3 @@ export declare const DescribeLocalGatewayRouteTableVpcAssociationsResultFilterSe
  * @internal
  */
 export declare const DescribeLocalGatewaysRequestFilterSensitiveLog: (obj: DescribeLocalGatewaysRequest) => any;
-/**
- * @internal
- */
-export declare const LocalGatewayFilterSensitiveLog: (obj: LocalGateway) => any;
-/**
- * @internal
- */
-export declare const DescribeLocalGatewaysResultFilterSensitiveLog: (obj: DescribeLocalGatewaysResult) => any;
-/**
- * @internal
- */
-export declare const DescribeLocalGatewayVirtualInterfaceGroupsRequestFilterSensitiveLog: (obj: DescribeLocalGatewayVirtualInterfaceGroupsRequest) => any;
-/**
- * @internal
- */
-export declare const LocalGatewayVirtualInterfaceGroupFilterSensitiveLog: (obj: LocalGatewayVirtualInterfaceGroup) => any;
-/**
- * @internal
- */
-export declare const DescribeLocalGatewayVirtualInterfaceGroupsResultFilterSensitiveLog: (obj: DescribeLocalGatewayVirtualInterfaceGroupsResult) => any;