feat(client-ec2): Adds the new EC2 DescribeInstanceTopology API, whic…

…h you can use to retrieve the network topology of your running instances on select platform types to determine their relative proximity to each other.
aws · Nov 13, 2023 · ce5a2b0 · ce5a2b0
1 parent 0f12860
commit ce5a2b0
Show file tree

Hide file tree

Showing 39 changed files with 1,391 additions and 556 deletions.
diff --git a/clients/client-ec2/README.md b/clients/client-ec2/README.md
@@ -2380,6 +2380,14 @@ DescribeInstanceStatus
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/classes/describeinstancestatuscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/interfaces/describeinstancestatuscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/interfaces/describeinstancestatuscommandoutput.html)
 
+</details>
+<details>
+<summary>
+DescribeInstanceTopology
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/classes/describeinstancetopologycommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/interfaces/describeinstancetopologycommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-ec2/interfaces/describeinstancetopologycommandoutput.html)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-ec2/src/EC2.ts b/clients/client-ec2/src/EC2.ts
@@ -1303,6 +1303,11 @@ import {
   DescribeInstanceStatusCommandInput,
   DescribeInstanceStatusCommandOutput,
 } from "./commands/DescribeInstanceStatusCommand";
+import {
+  DescribeInstanceTopologyCommand,
+  DescribeInstanceTopologyCommandInput,
+  DescribeInstanceTopologyCommandOutput,
+} from "./commands/DescribeInstanceTopologyCommand";
 import {
   DescribeInstanceTypeOfferingsCommand,
   DescribeInstanceTypeOfferingsCommandInput,
@@ -3231,6 +3236,7 @@ const commands = {
   DescribeInstanceEventWindowsCommand,
   DescribeInstancesCommand,
   DescribeInstanceStatusCommand,
+  DescribeInstanceTopologyCommand,
   DescribeInstanceTypeOfferingsCommand,
   DescribeInstanceTypesCommand,
   DescribeInternetGatewaysCommand,
@@ -7945,6 +7951,23 @@ export interface EC2 {
     cb: (err: any, data?: DescribeInstanceStatusCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DescribeInstanceTopologyCommand}
+   */
+  describeInstanceTopology(
+    args: DescribeInstanceTopologyCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DescribeInstanceTopologyCommandOutput>;
+  describeInstanceTopology(
+    args: DescribeInstanceTopologyCommandInput,
+    cb: (err: any, data?: DescribeInstanceTopologyCommandOutput) => void
+  ): void;
+  describeInstanceTopology(
+    args: DescribeInstanceTopologyCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DescribeInstanceTopologyCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DescribeInstanceTypeOfferingsCommand}
    */

diff --git a/clients/client-ec2/src/EC2Client.ts b/clients/client-ec2/src/EC2Client.ts
@@ -919,6 +919,10 @@ import {
   DescribeInstanceStatusCommandInput,
   DescribeInstanceStatusCommandOutput,
 } from "./commands/DescribeInstanceStatusCommand";
+import {
+  DescribeInstanceTopologyCommandInput,
+  DescribeInstanceTopologyCommandOutput,
+} from "./commands/DescribeInstanceTopologyCommand";
 import {
   DescribeInstanceTypeOfferingsCommandInput,
   DescribeInstanceTypeOfferingsCommandOutput,
@@ -2381,6 +2385,7 @@ export type ServiceInputTypes =
   | DescribeInstanceEventNotificationAttributesCommandInput
   | DescribeInstanceEventWindowsCommandInput
   | DescribeInstanceStatusCommandInput
+  | DescribeInstanceTopologyCommandInput
   | DescribeInstanceTypeOfferingsCommandInput
   | DescribeInstanceTypesCommandInput
   | DescribeInstancesCommandInput
@@ -2991,6 +2996,7 @@ export type ServiceOutputTypes =
   | DescribeInstanceEventNotificationAttributesCommandOutput
   | DescribeInstanceEventWindowsCommandOutput
   | DescribeInstanceStatusCommandOutput
+  | DescribeInstanceTopologyCommandOutput
   | DescribeInstanceTypeOfferingsCommandOutput
   | DescribeInstanceTypesCommandOutput
   | DescribeInstancesCommandOutput

diff --git a/clients/client-ec2/src/commands/CreateFleetCommand.ts b/clients/client-ec2/src/commands/CreateFleetCommand.ts
@@ -154,10 +154,10 @@ export interface CreateFleetCommandOutput extends CreateFleetResult, __MetadataB
  *               Max: Number("int"),
  *             },
  *             AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- *               "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ *               "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  *             ],
  *             AcceleratorNames: [ // AcceleratorNameSet
- *               "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ *               "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  *             ],
  *             AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiBRequest
  *               Min: Number("int"),
@@ -274,10 +274,10 @@ export interface CreateFleetCommandOutput extends CreateFleetResult, __MetadataB
  * //               Max: Number("int"),
  * //             },
  * //             AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- * //               "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //               "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //             ],
  * //             AcceleratorNames: [ // AcceleratorNameSet
- * //               "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //               "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //             ],
  * //             AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiB
  * //               Min: Number("int"),
@@ -368,10 +368,10 @@ export interface CreateFleetCommandOutput extends CreateFleetResult, __MetadataB
  * //               Max: Number("int"),
  * //             },
  * //             AcceleratorManufacturers: [
- * //               "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //               "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //             ],
  * //             AcceleratorNames: [
- * //               "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //               "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //             ],
  * //             AcceleratorTotalMemoryMiB: {
  * //               Min: Number("int"),

diff --git a/clients/client-ec2/src/commands/CreateLaunchTemplateCommand.ts b/clients/client-ec2/src/commands/CreateLaunchTemplateCommand.ts
@@ -278,10 +278,10 @@ export interface CreateLaunchTemplateCommandOutput extends CreateLaunchTemplateR
  *         Max: Number("int"),
  *       },
  *       AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- *         "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ *         "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  *       ],
  *       AcceleratorNames: [ // AcceleratorNameSet
- *         "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ *         "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  *       ],
  *       AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiBRequest
  *         Min: Number("int"),

diff --git a/clients/client-ec2/src/commands/CreateLaunchTemplateVersionCommand.ts b/clients/client-ec2/src/commands/CreateLaunchTemplateVersionCommand.ts
@@ -280,10 +280,10 @@ export interface CreateLaunchTemplateVersionCommandOutput extends CreateLaunchTe
  *         Max: Number("int"),
  *       },
  *       AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- *         "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ *         "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  *       ],
  *       AcceleratorNames: [ // AcceleratorNameSet
- *         "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ *         "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  *       ],
  *       AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiBRequest
  *         Min: Number("int"),
@@ -538,10 +538,10 @@ export interface CreateLaunchTemplateVersionCommandOutput extends CreateLaunchTe
  * //           Max: Number("int"),
  * //         },
  * //         AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- * //           "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //           "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //         ],
  * //         AcceleratorNames: [ // AcceleratorNameSet
- * //           "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //           "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //         ],
  * //         AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiB
  * //           Min: Number("int"),

diff --git a/clients/client-ec2/src/commands/DeleteVpcPeeringConnectionCommand.ts b/clients/client-ec2/src/commands/DeleteVpcPeeringConnectionCommand.ts
@@ -41,7 +41,7 @@ export interface DeleteVpcPeeringConnectionCommandOutput extends DeleteVpcPeerin
  *             of the accepter VPC can delete the VPC peering connection if it's in the
  *                 <code>active</code> state. The owner of the requester VPC can delete a VPC peering
  *             connection in the <code>pending-acceptance</code> state. You cannot delete a VPC peering
- *             connection that's in the <code>failed</code> state.</p>
+ *           connection that's in the <code>failed</code> or <code>rejected</code> state.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

diff --git a/clients/client-ec2/src/commands/DescribeFastLaunchImagesCommand.ts b/clients/client-ec2/src/commands/DescribeFastLaunchImagesCommand.ts
@@ -37,7 +37,7 @@ export interface DescribeFastLaunchImagesCommandOutput extends DescribeFastLaunc
 
 /**
  * @public
- * <p>Describe details for Windows AMIs that are configured for faster launching.</p>
+ * <p>Describe details for Windows AMIs that are configured for Windows fast launch.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

diff --git a/clients/client-ec2/src/commands/DescribeFleetsCommand.ts b/clients/client-ec2/src/commands/DescribeFleetsCommand.ts
@@ -144,10 +144,10 @@ export interface DescribeFleetsCommandOutput extends DescribeFleetsResult, __Met
  * //                   Max: Number("int"),
  * //                 },
  * //                 AcceleratorManufacturers: [ // AcceleratorManufacturerSet
- * //                   "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //                   "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //                 ],
  * //                 AcceleratorNames: [ // AcceleratorNameSet
- * //                   "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //                   "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //                 ],
  * //                 AcceleratorTotalMemoryMiB: { // AcceleratorTotalMemoryMiB
  * //                   Min: Number("int"),
@@ -278,10 +278,10 @@ export interface DescribeFleetsCommandOutput extends DescribeFleetsResult, __Met
  * //                   Max: Number("int"),
  * //                 },
  * //                 AcceleratorManufacturers: [
- * //                   "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //                   "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //                 ],
  * //                 AcceleratorNames: [
- * //                   "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //                   "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //                 ],
  * //                 AcceleratorTotalMemoryMiB: {
  * //                   Min: Number("int"),
@@ -372,10 +372,10 @@ export interface DescribeFleetsCommandOutput extends DescribeFleetsResult, __Met
  * //                   Max: Number("int"),
  * //                 },
  * //                 AcceleratorManufacturers: [
- * //                   "nvidia" || "amd" || "amazon-web-services" || "xilinx",
+ * //                   "amazon-web-services" || "amd" || "nvidia" || "xilinx",
  * //                 ],
  * //                 AcceleratorNames: [
- * //                   "a100" || "v100" || "k80" || "t4" || "m60" || "radeon-pro-v520" || "vu9p" || "inferentia" || "k520",
+ * //                   "a100" || "inferentia" || "k520" || "k80" || "m60" || "radeon-pro-v520" || "t4" || "vu9p" || "v100",
  * //                 ],
  * //                 AcceleratorTotalMemoryMiB: {
  * //                   Min: Number("int"),