Skip to content

Commit

Permalink
feat(client-ec2): Amazon EC2 now allows you to create network interfa…
Browse files Browse the repository at this point in the history
…ces with just the EFA driver and no ENA driver by specifying the network interface type as efa-only.
  • Loading branch information
awstools committed Oct 21, 2024
1 parent f3c2a2c commit 67509d4
Show file tree
Hide file tree
Showing 19 changed files with 90 additions and 57 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ export interface AssignPrivateNatGatewayAddressCommandOutput

/**
* <p>Assigns private IPv4 addresses to a private NAT gateway. For more information, see
* <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html#nat-gateway-working-with">Work with NAT gateways</a> in the <i>Amazon VPC User Guide</i>.</p>
* <a href="https://docs.aws.amazon.com/vpc/latest/userguide/nat-gateway-working-with.html">Work with NAT gateways</a> in the <i>Amazon VPC User Guide</i>.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,15 @@ export interface AssociateNatGatewayAddressCommandOutput extends AssociateNatGat

/**
* <p>Associates Elastic IP addresses (EIPs) and private IPv4 addresses with a public NAT gateway. For more information,
* see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html#nat-gateway-working-with">Work with NAT gateways</a> in the <i>Amazon VPC User Guide</i>.</p>
* see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/nat-gateway-working-with.html">Work with NAT gateways</a> in the <i>Amazon VPC User Guide</i>.</p>
* <p>By default, you can associate up to 2 Elastic IP addresses per public NAT gateway. You can increase the limit by requesting a quota adjustment.
* For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html#vpc-limits-eips">Elastic IP address quotas</a> in the <i>Amazon VPC User Guide</i>.</p>
* <important>
* <p>When you associate an EIP or secondary EIPs with a public NAT gateway, the network border group of the EIPs must match the network border group of the Availability Zone (AZ) that the public NAT gateway is in. If it's not the same, the EIP will fail to associate. You can see the network border group for the subnet's AZ by viewing the details of the subnet. Similarly, you can view the network border group of an EIP by viewing the details of the EIP address. For more information about network border groups and EIPs, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-eips.html#allocate-eip">Allocate an Elastic IP address</a> in the <i>Amazon VPC User Guide</i>.
* <p>When you associate an EIP or secondary EIPs with a public NAT gateway, the network border group of the EIPs
* must match the network border group of the Availability Zone (AZ) that the public NAT gateway is in. If it's not the same,
* the EIP will fail to associate. You can see the network border group for the subnet's AZ by viewing the details of the subnet.
* Similarly, you can view the network border group of an EIP by viewing the details of the EIP address. For more information
* about network border groups and EIPs, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithEIPs.html">Allocate an Elastic IP address</a> in the <i>Amazon VPC User Guide</i>.
* </p>
* </important>
* @example
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ export interface CreateDefaultSubnetCommandOutput extends CreateDefaultSubnetRes
/**
* <p>Creates a default subnet with a size <code>/20</code> IPv4 CIDR block in the
* specified Availability Zone in your default VPC. You can have only one default subnet
* per Availability Zone. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html#create-default-subnet">Create a default
* per Availability Zone. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/work-with-default-vpc.html#create-default-subnet">Create a default
* subnet</a> in the <i>Amazon VPC User Guide</i>.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
Expand Down
2 changes: 1 addition & 1 deletion clients/client-ec2/src/commands/CreateFlowLogsCommand.ts
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ export interface CreateFlowLogsCommandOutput extends CreateFlowLogsResult, __Met
* subnet, or VPC. </p>
* <p>Flow log data for a monitored network interface is recorded as flow log records, which are log events
* consisting of fields that describe the traffic flow. For more information, see
* <a href="https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html#flow-log-records">Flow log records</a>
* <a href="https://docs.aws.amazon.com/vpc/latest/userguide/flow-log-records.html">Flow log records</a>
* in the <i>Amazon VPC User Guide</i>.</p>
* <p>When publishing to CloudWatch Logs, flow log records are published to a log group, and each network
* interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all
Expand Down
8 changes: 7 additions & 1 deletion clients/client-ec2/src/commands/CreateNatGatewayCommand.ts
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,13 @@ export interface CreateNatGatewayCommandOutput extends CreateNatGatewayResult, _
* private IPv4 addresses, and communicating between overlapping networks.</p>
* <p>For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html">NAT gateways</a> in the <i>Amazon VPC User Guide</i>.</p>
* <important>
* <p>When you create a public NAT gateway and assign it an EIP or secondary EIPs, the network border group of the EIPs must match the network border group of the Availability Zone (AZ) that the public NAT gateway is in. If it's not the same, the NAT gateway will fail to launch. You can see the network border group for the subnet's AZ by viewing the details of the subnet. Similarly, you can view the network border group of an EIP by viewing the details of the EIP address. For more information about network border groups and EIPs, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-eips.html#allocate-eip">Allocate an Elastic IP address</a> in the <i>Amazon VPC User Guide</i>.
* <p>When you create a public NAT gateway and assign it an EIP or secondary EIPs,
* the network border group of the EIPs must match the network border group of the Availability Zone (AZ)
* that the public NAT gateway is in. If it's not the same, the NAT gateway will fail to launch.
* You can see the network border group for the subnet's AZ by viewing the details of the subnet.
* Similarly, you can view the network border group of an EIP by viewing the details of the EIP address.
* For more information about network border groups and EIPs, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithEIPs.html">Allocate an Elastic IP address</a>
* in the <i>Amazon VPC User Guide</i>.
* </p>
* </important>
* @example
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ export interface CreateNetworkInterfaceCommandOutput extends CreateNetworkInterf
* },
* ],
* Ipv6PrefixCount: Number("int"),
* InterfaceType: "efa" || "branch" || "trunk",
* InterfaceType: "efa" || "efa-only" || "branch" || "trunk",
* TagSpecifications: [ // TagSpecificationList
* { // TagSpecification
* ResourceType: "capacity-reservation" || "client-vpn-endpoint" || "customer-gateway" || "carrier-gateway" || "coip-pool" || "dedicated-host" || "dhcp-options" || "egress-only-internet-gateway" || "elastic-ip" || "elastic-gpu" || "export-image-task" || "export-instance-task" || "fleet" || "fpga-image" || "host-reservation" || "image" || "import-image-task" || "import-snapshot-task" || "instance" || "instance-event-window" || "internet-gateway" || "ipam" || "ipam-pool" || "ipam-scope" || "ipv4pool-ec2" || "ipv6pool-ec2" || "key-pair" || "launch-template" || "local-gateway" || "local-gateway-route-table" || "local-gateway-virtual-interface" || "local-gateway-virtual-interface-group" || "local-gateway-route-table-vpc-association" || "local-gateway-route-table-virtual-interface-group-association" || "natgateway" || "network-acl" || "network-interface" || "network-insights-analysis" || "network-insights-path" || "network-insights-access-scope" || "network-insights-access-scope-analysis" || "placement-group" || "prefix-list" || "replace-root-volume-task" || "reserved-instances" || "route-table" || "security-group" || "security-group-rule" || "snapshot" || "spot-fleet-request" || "spot-instances-request" || "subnet" || "subnet-cidr-reservation" || "traffic-mirror-filter" || "traffic-mirror-session" || "traffic-mirror-target" || "transit-gateway" || "transit-gateway-attachment" || "transit-gateway-connect-peer" || "transit-gateway-multicast-domain" || "transit-gateway-policy-table" || "transit-gateway-route-table" || "transit-gateway-route-table-announcement" || "volume" || "vpc" || "vpc-endpoint" || "vpc-endpoint-connection" || "vpc-endpoint-service" || "vpc-endpoint-service-permission" || "vpc-peering-connection" || "vpn-connection" || "vpn-gateway" || "vpc-flow-log" || "capacity-reservation-fleet" || "traffic-mirror-filter-rule" || "vpc-endpoint-connection-device-type" || "verified-access-instance" || "verified-access-group" || "verified-access-endpoint" || "verified-access-policy" || "verified-access-trust-provider" || "vpn-connection-device-type" || "vpc-block-public-access-exclusion" || "ipam-resource-discovery" || "ipam-resource-discovery-association" || "instance-connect-endpoint" || "ipam-external-resource-verification-token",
Expand Down Expand Up @@ -135,7 +135,7 @@ export interface CreateNetworkInterfaceCommandOutput extends CreateNetworkInterf
* // GroupName: "STRING_VALUE",
* // },
* // ],
* // InterfaceType: "interface" || "natGateway" || "efa" || "trunk" || "load_balancer" || "network_load_balancer" || "vpc_endpoint" || "branch" || "transit_gateway" || "lambda" || "quicksight" || "global_accelerator_managed" || "api_gateway_managed" || "gateway_load_balancer" || "gateway_load_balancer_endpoint" || "iot_rules_managed" || "aws_codestar_connections_managed",
* // InterfaceType: "interface" || "natGateway" || "efa" || "efa-only" || "trunk" || "load_balancer" || "network_load_balancer" || "vpc_endpoint" || "branch" || "transit_gateway" || "lambda" || "quicksight" || "global_accelerator_managed" || "api_gateway_managed" || "gateway_load_balancer" || "gateway_load_balancer_endpoint" || "iot_rules_managed" || "aws_codestar_connections_managed",
* // Ipv6Addresses: [ // NetworkInterfaceIpv6AddressesList
* // { // NetworkInterfaceIpv6Address
* // Ipv6Address: "STRING_VALUE",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@ export interface CreateSubnetCidrReservationCommandOutput extends CreateSubnetCi

/**
* <p>Creates a subnet CIDR reservation. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html">Subnet CIDR reservations</a>
* in the <i>Amazon VPC User Guide</i> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html">Assign prefixes
* to network interfaces</a> in the <i>Amazon EC2 User Guide</i>.</p>
* in the <i>Amazon VPC User Guide</i> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-prefixes.html">Manage prefixes
* for your network interfaces</a> in the <i>Amazon EC2 User Guide</i>.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
Expand Down
2 changes: 1 addition & 1 deletion clients/client-ec2/src/commands/CreateVpcCommand.ts
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ export interface CreateVpcCommandOutput extends CreateVpcResult, __MetadataBeare
* <p>You can optionally request an IPv6 CIDR block for the VPC. You can request an
* Amazon-provided IPv6 CIDR block from Amazon's pool of IPv6 addresses or an IPv6 CIDR
* block from an IPv6 address pool that you provisioned through bring your own IP addresses
* (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html">BYOIP</a>).</p>
* (<a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html">BYOIP</a>).</p>
* <p>By default, each instance that you launch in the VPC has the default DHCP options, which
* include only a default DNS server that we provide (AmazonProvidedDNS). For more
* information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html">DHCP option sets</a> in the <i>Amazon VPC User Guide</i>.</p>
Expand Down
8 changes: 7 additions & 1 deletion clients/client-ec2/src/commands/DeleteVpcCommand.ts
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,13 @@ export interface DeleteVpcCommandInput extends DeleteVpcRequest {}
export interface DeleteVpcCommandOutput extends __MetadataBearer {}

/**
* <p>Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on. When you delete the VPC, it deletes the VPC's default security group, network ACL, and route table.</p>
* <p>Deletes the specified VPC. You must detach or delete all gateways and resources that are associated
* with the VPC before you can delete it. For example, you must terminate all instances running in the VPC,
* delete all security groups associated with the VPC (except the default one), delete all route tables
* associated with the VPC (except the default one), and so on. When you delete the VPC, it deletes the
* default security group, network ACL, and route table for the VPC.</p>
* <p>If you created a flow log for the VPC that you are deleting, note that flow logs for deleted
* VPCs are eventually automatically removed.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ export interface DescribeNetworkInterfacesCommandOutput extends DescribeNetworkI
* // GroupName: "STRING_VALUE",
* // },
* // ],
* // InterfaceType: "interface" || "natGateway" || "efa" || "trunk" || "load_balancer" || "network_load_balancer" || "vpc_endpoint" || "branch" || "transit_gateway" || "lambda" || "quicksight" || "global_accelerator_managed" || "api_gateway_managed" || "gateway_load_balancer" || "gateway_load_balancer_endpoint" || "iot_rules_managed" || "aws_codestar_connections_managed",
* // InterfaceType: "interface" || "natGateway" || "efa" || "efa-only" || "trunk" || "load_balancer" || "network_load_balancer" || "vpc_endpoint" || "branch" || "transit_gateway" || "lambda" || "quicksight" || "global_accelerator_managed" || "api_gateway_managed" || "gateway_load_balancer" || "gateway_load_balancer_endpoint" || "iot_rules_managed" || "aws_codestar_connections_managed",
* // Ipv6Addresses: [ // NetworkInterfaceIpv6AddressesList
* // { // NetworkInterfaceIpv6Address
* // Ipv6Address: "STRING_VALUE",
Expand Down
2 changes: 1 addition & 1 deletion clients/client-ec2/src/commands/DisableImageCommand.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ export interface DisableImageCommandOutput extends DisableImageResult, __Metadat
* <p>A disabled AMI does not appear in <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a> API calls by
* default.</p>
* <p>Only the AMI owner can disable an AMI.</p>
* <p>You can re-enable a disabled AMI using <a href="http://amazonaws.com/AWSEC2/latest/APIReference/API_EnableImage.html">EnableImage</a>.</p>
* <p>You can re-enable a disabled AMI using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_EnableImage.html">EnableImage</a>.</p>
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/disable-an-ami.html">Disable an AMI</a> in the
* <i>Amazon EC2 User Guide</i>.</p>
* @example
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ export interface DisassociateNatGatewayAddressCommandOutput

/**
* <p>Disassociates secondary Elastic IP addresses (EIPs) from a public NAT gateway.
* You cannot disassociate your primary EIP. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html#nat-gateway-edit-secondary">Edit secondary IP address associations</a> in the <i>Amazon VPC User Guide</i>.</p>
* You cannot disassociate your primary EIP. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/nat-gateway-working-with.html#nat-gateway-edit-secondary">Edit secondary IP address associations</a> in the <i>Amazon VPC User Guide</i>.</p>
* <p>While disassociating is in progress, you cannot associate/disassociate additional EIPs while the connections are being drained. You are, however, allowed to delete the NAT gateway.</p>
* <p>An EIP is released only at the end of MaxDrainDurationSeconds. It stays
* associated and supports the existing connections but does not support any new connections
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,9 @@ export interface GetInstanceTypesFromInstanceRequirementsCommandOutput
* <p>When you specify multiple parameters, you get instance types that satisfy all of the
* specified parameters. If you specify multiple values for a parameter, you get instance
* types that satisfy any of the specified values.</p>
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-attribute-based-instance-type-selection.html#spotfleet-get-instance-types-from-instance-requirements">Preview instance types with specified attributes</a>, <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html">Attribute-based instance type selection for EC2 Fleet</a>, <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-attribute-based-instance-type-selection.html">Attribute-based instance type selection for Spot Fleet</a>, and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html">Spot
* placement score</a> in the <i>Amazon EC2 User Guide</i>, and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html">Creating an
* Auto Scaling group using attribute-based instance type selection</a> in the
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html#ec2fleet-get-instance-types-from-instance-requirements">Preview instance types with specified attributes</a>, <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html">Specify attributes for instance type selection for EC2 Fleet or Spot Fleet</a>, and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html">Spot
* placement score</a> in the <i>Amazon EC2 User Guide</i>, and <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html">Creating
* mixed instance groups using attribute-based instance type selection</a> in the
* <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
Expand Down
Loading

0 comments on commit 67509d4

Please sign in to comment.