@aws-sdk/client-ec2 3.425.0 → 3.428.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +16 -0
  2. package/dist-cjs/EC2.js +4 -0
  3. package/dist-cjs/commands/DisableImageCommand.js +51 -0
  4. package/dist-cjs/commands/EnableImageCommand.js +51 -0
  5. package/dist-cjs/commands/index.js +2 -0
  6. package/dist-cjs/models/models_0.js +1 -0
  7. package/dist-cjs/models/models_3.js +1 -0
  8. package/dist-cjs/protocols/Aws_ec2.js +133 -17
  9. package/dist-es/EC2.js +4 -0
  10. package/dist-es/commands/DisableImageCommand.js +47 -0
  11. package/dist-es/commands/EnableImageCommand.js +47 -0
  12. package/dist-es/commands/index.js +2 -0
  13. package/dist-es/models/models_0.js +1 -0
  14. package/dist-es/models/models_3.js +1 -0
  15. package/dist-es/protocols/Aws_ec2.js +112 -0
  16. package/dist-types/EC2.d.ts +14 -0
  17. package/dist-types/EC2Client.d.ts +4 -2
  18. package/dist-types/commands/AssociateNatGatewayAddressCommand.d.ts +4 -0
  19. package/dist-types/commands/CreateCapacityReservationCommand.d.ts +2 -2
  20. package/dist-types/commands/CreateCapacityReservationFleetCommand.d.ts +2 -2
  21. package/dist-types/commands/CreateNatGatewayCommand.d.ts +4 -0
  22. package/dist-types/commands/DeleteVpcCommand.d.ts +1 -1
  23. package/dist-types/commands/DescribeCapacityReservationFleetsCommand.d.ts +1 -1
  24. package/dist-types/commands/DescribeCapacityReservationsCommand.d.ts +1 -1
  25. package/dist-types/commands/DescribeImagesCommand.d.ts +3 -1
  26. package/dist-types/commands/DescribeNetworkInterfacesCommand.d.ts +4 -0
  27. package/dist-types/commands/DisableImageCommand.d.ts +84 -0
  28. package/dist-types/commands/EnableImageCommand.d.ts +81 -0
  29. package/dist-types/commands/GetTransitGatewayRouteTablePropagationsCommand.d.ts +2 -1
  30. package/dist-types/commands/GetVerifiedAccessEndpointPolicyCommand.d.ts +1 -1
  31. package/dist-types/commands/index.d.ts +2 -0
  32. package/dist-types/models/models_0.d.ts +3 -3
  33. package/dist-types/models/models_1.d.ts +48 -7
  34. package/dist-types/models/models_3.d.ts +147 -28
  35. package/dist-types/models/models_4.d.ts +56 -35
  36. package/dist-types/models/models_5.d.ts +54 -78
  37. package/dist-types/models/models_6.d.ts +86 -105
  38. package/dist-types/models/models_7.d.ts +102 -2
  39. package/dist-types/protocols/Aws_ec2.d.ts +18 -0
  40. package/dist-types/ts3.4/EC2.d.ts +34 -0
  41. package/dist-types/ts3.4/EC2Client.d.ts +12 -0
  42. package/dist-types/ts3.4/commands/DisableImageCommand.d.ts +35 -0
  43. package/dist-types/ts3.4/commands/EnableImageCommand.d.ts +35 -0
  44. package/dist-types/ts3.4/commands/GetTransitGatewayRouteTablePropagationsCommand.d.ts +2 -4
  45. package/dist-types/ts3.4/commands/GetVerifiedAccessEndpointPolicyCommand.d.ts +1 -1
  46. package/dist-types/ts3.4/commands/index.d.ts +2 -0
  47. package/dist-types/ts3.4/models/models_0.d.ts +1 -0
  48. package/dist-types/ts3.4/models/models_3.d.ts +3 -0
  49. package/dist-types/ts3.4/models/models_5.d.ts +14 -19
  50. package/dist-types/ts3.4/models/models_6.d.ts +21 -18
  51. package/dist-types/ts3.4/models/models_7.d.ts +20 -3
  52. package/dist-types/ts3.4/protocols/Aws_ec2.d.ts +24 -0
  53. package/package.json +33 -33
@@ -0,0 +1,84 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
5
+ import { DisableImageRequest, DisableImageResult } from "../models/models_5";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link DisableImageCommand}.
14
+ */
15
+ export interface DisableImageCommandInput extends DisableImageRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link DisableImageCommand}.
21
+ */
22
+ export interface DisableImageCommandOutput extends DisableImageResult, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Sets the AMI state to <code>disabled</code> and removes all launch permissions from the
27
+ * AMI. A disabled AMI can't be used for instance launches.</p>
28
+ * <p>A disabled AMI can't be shared. If a public or shared AMI was previously shared, it is
29
+ * made private. If an AMI was shared with an Amazon Web Services account, organization, or Organizational
30
+ * Unit, they lose access to the disabled AMI. </p>
31
+ * <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
32
+ * default.</p>
33
+ * <p>Only the AMI owner can disable an AMI.</p>
34
+ * <p>You can re-enable a disabled AMI using <a href="http://amazonaws.com/AWSEC2/latest/APIReference/API_EnableImage.html">EnableImage</a>.</p>
35
+ * <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
36
+ * <i>Amazon EC2 User Guide</i>.</p>
37
+ * @example
38
+ * Use a bare-bones client and the command you need to make an API call.
39
+ * ```javascript
40
+ * import { EC2Client, DisableImageCommand } from "@aws-sdk/client-ec2"; // ES Modules import
41
+ * // const { EC2Client, DisableImageCommand } = require("@aws-sdk/client-ec2"); // CommonJS import
42
+ * const client = new EC2Client(config);
43
+ * const input = { // DisableImageRequest
44
+ * ImageId: "STRING_VALUE", // required
45
+ * DryRun: true || false,
46
+ * };
47
+ * const command = new DisableImageCommand(input);
48
+ * const response = await client.send(command);
49
+ * // { // DisableImageResult
50
+ * // Return: true || false,
51
+ * // };
52
+ *
53
+ * ```
54
+ *
55
+ * @param DisableImageCommandInput - {@link DisableImageCommandInput}
56
+ * @returns {@link DisableImageCommandOutput}
57
+ * @see {@link DisableImageCommandInput} for command's `input` shape.
58
+ * @see {@link DisableImageCommandOutput} for command's `response` shape.
59
+ * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
60
+ *
61
+ * @throws {@link EC2ServiceException}
62
+ * <p>Base exception class for all service exceptions from EC2 service.</p>
63
+ *
64
+ */
65
+ export declare class DisableImageCommand extends $Command<DisableImageCommandInput, DisableImageCommandOutput, EC2ClientResolvedConfig> {
66
+ readonly input: DisableImageCommandInput;
67
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
68
+ /**
69
+ * @public
70
+ */
71
+ constructor(input: DisableImageCommandInput);
72
+ /**
73
+ * @internal
74
+ */
75
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: EC2ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DisableImageCommandInput, DisableImageCommandOutput>;
76
+ /**
77
+ * @internal
78
+ */
79
+ private serialize;
80
+ /**
81
+ * @internal
82
+ */
83
+ private deserialize;
84
+ }
@@ -0,0 +1,81 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
5
+ import { EnableImageRequest, EnableImageResult } from "../models/models_5";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link EnableImageCommand}.
14
+ */
15
+ export interface EnableImageCommandInput extends EnableImageRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link EnableImageCommand}.
21
+ */
22
+ export interface EnableImageCommandOutput extends EnableImageResult, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Re-enables a disabled AMI. The re-enabled AMI is marked as <code>available</code> and can
27
+ * be used for instance launches, appears in describe operations, and can be shared. Amazon Web Services
28
+ * accounts, organizations, and Organizational Units that lost access to the AMI when it was
29
+ * disabled do not regain access automatically. Once the AMI is available, it can be shared with
30
+ * them again.</p>
31
+ * <p>Only the AMI owner can re-enable a disabled AMI.</p>
32
+ * <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
33
+ * <i>Amazon EC2 User Guide</i>.</p>
34
+ * @example
35
+ * Use a bare-bones client and the command you need to make an API call.
36
+ * ```javascript
37
+ * import { EC2Client, EnableImageCommand } from "@aws-sdk/client-ec2"; // ES Modules import
38
+ * // const { EC2Client, EnableImageCommand } = require("@aws-sdk/client-ec2"); // CommonJS import
39
+ * const client = new EC2Client(config);
40
+ * const input = { // EnableImageRequest
41
+ * ImageId: "STRING_VALUE", // required
42
+ * DryRun: true || false,
43
+ * };
44
+ * const command = new EnableImageCommand(input);
45
+ * const response = await client.send(command);
46
+ * // { // EnableImageResult
47
+ * // Return: true || false,
48
+ * // };
49
+ *
50
+ * ```
51
+ *
52
+ * @param EnableImageCommandInput - {@link EnableImageCommandInput}
53
+ * @returns {@link EnableImageCommandOutput}
54
+ * @see {@link EnableImageCommandInput} for command's `input` shape.
55
+ * @see {@link EnableImageCommandOutput} for command's `response` shape.
56
+ * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
57
+ *
58
+ * @throws {@link EC2ServiceException}
59
+ * <p>Base exception class for all service exceptions from EC2 service.</p>
60
+ *
61
+ */
62
+ export declare class EnableImageCommand extends $Command<EnableImageCommandInput, EnableImageCommandOutput, EC2ClientResolvedConfig> {
63
+ readonly input: EnableImageCommandInput;
64
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
65
+ /**
66
+ * @public
67
+ */
68
+ constructor(input: EnableImageCommandInput);
69
+ /**
70
+ * @internal
71
+ */
72
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: EC2ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<EnableImageCommandInput, EnableImageCommandOutput>;
73
+ /**
74
+ * @internal
75
+ */
76
+ private serialize;
77
+ /**
78
+ * @internal
79
+ */
80
+ private deserialize;
81
+ }
@@ -2,7 +2,8 @@ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
2
  import { Command as $Command } from "@smithy/smithy-client";
3
3
  import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
4
  import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
5
- import { GetTransitGatewayRouteTablePropagationsRequest, GetTransitGatewayRouteTablePropagationsResult } from "../models/models_5";
5
+ import { GetTransitGatewayRouteTablePropagationsRequest } from "../models/models_5";
6
+ import { GetTransitGatewayRouteTablePropagationsResult } from "../models/models_6";
6
7
  /**
7
8
  * @public
8
9
  */
@@ -2,7 +2,7 @@ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
2
  import { Command as $Command } from "@smithy/smithy-client";
3
3
  import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
4
  import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
5
- import { GetVerifiedAccessEndpointPolicyRequest, GetVerifiedAccessEndpointPolicyResult } from "../models/models_5";
5
+ import { GetVerifiedAccessEndpointPolicyRequest, GetVerifiedAccessEndpointPolicyResult } from "../models/models_6";
6
6
  /**
7
7
  * @public
8
8
  */
@@ -372,6 +372,7 @@ export * from "./DisableEbsEncryptionByDefaultCommand";
372
372
  export * from "./DisableFastLaunchCommand";
373
373
  export * from "./DisableFastSnapshotRestoresCommand";
374
374
  export * from "./DisableImageBlockPublicAccessCommand";
375
+ export * from "./DisableImageCommand";
375
376
  export * from "./DisableImageDeprecationCommand";
376
377
  export * from "./DisableIpamOrganizationAdminAccountCommand";
377
378
  export * from "./DisableSerialConsoleAccessCommand";
@@ -399,6 +400,7 @@ export * from "./EnableEbsEncryptionByDefaultCommand";
399
400
  export * from "./EnableFastLaunchCommand";
400
401
  export * from "./EnableFastSnapshotRestoresCommand";
401
402
  export * from "./EnableImageBlockPublicAccessCommand";
403
+ export * from "./EnableImageCommand";
402
404
  export * from "./EnableImageDeprecationCommand";
403
405
  export * from "./EnableIpamOrganizationAdminAccountCommand";
404
406
  export * from "./EnableReachabilityAnalyzerOrganizationSharingCommand";
@@ -2660,8 +2660,6 @@ export interface AllocateAddressRequest {
2660
2660
  * advertises IP addresses. Use this parameter to limit the IP address to this location. IP
2661
2661
  * addresses cannot move between network border groups.</p>
2662
2662
  * <p>Use <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html">DescribeAvailabilityZones</a> to view the network border groups.</p>
2663
- * <p>You cannot use a network border group with EC2 Classic. If you attempt this operation on EC2 Classic,
2664
- * you receive an <code>InvalidParameterCombination</code> error.</p>
2665
2663
  */
2666
2664
  NetworkBorderGroup?: string;
2667
2665
  /**
@@ -6167,7 +6165,8 @@ export interface CancelConversionRequest {
6167
6165
  export interface CancelExportTaskRequest {
6168
6166
  /**
6169
6167
  * @public
6170
- * <p>The ID of the export task. This is the ID returned by <code>CreateInstanceExportTask</code>.</p>
6168
+ * <p>The ID of the export task. This is the ID returned by the
6169
+ * <code>CreateInstanceExportTask</code> and <code>ExportImage</code> operations.</p>
6171
6170
  */
6172
6171
  ExportTaskId: string | undefined;
6173
6172
  }
@@ -6950,6 +6949,7 @@ export declare const CapacityReservationInstancePlatform: {
6950
6949
  readonly RHEL_WITH_SQL_SERVER_STANDARD: "RHEL with SQL Server Standard";
6951
6950
  readonly RHEL_WITH_SQL_SERVER_WEB: "RHEL with SQL Server Web";
6952
6951
  readonly SUSE_LINUX: "SUSE Linux";
6952
+ readonly UBUNTU_PRO_LINUX: "Ubuntu Pro";
6953
6953
  readonly WINDOWS: "Windows";
6954
6954
  readonly WINDOWS_WITH_SQL_SERVER: "Windows with SQL Server";
6955
6955
  readonly WINDOWS_WITH_SQL_SERVER_ENTERPRISE: "Windows with SQL Server Enterprise";
@@ -2056,6 +2056,14 @@ export interface OnDemandOptionsRequest {
2056
2056
  /**
2057
2057
  * @public
2058
2058
  * <p>The maximum amount per hour for On-Demand Instances that you're willing to pay.</p>
2059
+ * <note>
2060
+ * <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
2061
+ * and if their average CPU usage exceeds the baseline utilization, you will incur a charge
2062
+ * for surplus credits. The <code>MaxTotalPrice</code> does not account for surplus
2063
+ * credits, and, if you use surplus credits, your final cost might be higher than what you
2064
+ * 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
2065
+ * Guide</i>.</p>
2066
+ * </note>
2059
2067
  */
2060
2068
  MaxTotalPrice?: string;
2061
2069
  }
@@ -2258,6 +2266,14 @@ export interface SpotOptionsRequest {
2258
2266
  * <important>
2259
2267
  * <p>If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter.</p>
2260
2268
  * </important>
2269
+ * <note>
2270
+ * <p>If your fleet includes T instances that are configured as <code>unlimited</code>,
2271
+ * and if their average CPU usage exceeds the baseline utilization, you will incur a charge
2272
+ * for surplus credits. The <code>MaxTotalPrice</code> does not account for surplus
2273
+ * credits, and, if you use surplus credits, your final cost might be higher than what you
2274
+ * 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
2275
+ * Guide</i>.</p>
2276
+ * </note>
2261
2277
  */
2262
2278
  MaxTotalPrice?: string;
2263
2279
  }
@@ -2446,7 +2462,7 @@ export interface CreateFleetRequest {
2446
2462
  /**
2447
2463
  * @public
2448
2464
  * <p>The key-value pair for tagging the EC2 Fleet request on creation. For more information, see
2449
- * <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources">Tagging your resources</a>.</p>
2465
+ * <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources">Tag your resources</a>.</p>
2450
2466
  * <p>If the fleet type is <code>instant</code>, specify a resource type of <code>fleet</code>
2451
2467
  * to tag the fleet or <code>instance</code> to tag the instances at launch.</p>
2452
2468
  * <p>If the fleet type is <code>maintain</code> or <code>request</code>, specify a resource
@@ -6055,11 +6071,12 @@ export interface LaunchTemplateTagSpecificationRequest {
6055
6071
  /**
6056
6072
  * @public
6057
6073
  * <p>The type of resource to tag.</p>
6058
- * <p>The <code>Valid Values</code> are all the resource types that can be tagged. However,
6059
- * when creating a launch template, you can specify tags for the following resource types
6074
+ * <p>Valid Values lists all resource types for Amazon EC2 that can be tagged. When
6075
+ * you create a launch template, you can specify tags for the following resource types
6060
6076
  * only: <code>instance</code> | <code>volume</code> | <code>elastic-gpu</code> |
6061
- * <code>network-interface</code> | <code>spot-instances-request</code>
6062
- * </p>
6077
+ * <code>network-interface</code> | <code>spot-instances-request</code>.
6078
+ * If the instance does include the resource type that you specify, the instance
6079
+ * launch fails. For example, not all instance types include an Elastic GPU.</p>
6063
6080
  * <p>To tag a resource after it has been created, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html">CreateTags</a>.</p>
6064
6081
  */
6065
6082
  ResourceType?: ResourceType | string;
@@ -6250,7 +6267,19 @@ export interface RequestLaunchTemplateData {
6250
6267
  ElasticGpuSpecifications?: ElasticGpuSpecification[];
6251
6268
  /**
6252
6269
  * @public
6253
- * <p> The elastic inference accelerator for the instance. </p>
6270
+ * <p>An elastic inference accelerator to associate with the instance. Elastic inference
6271
+ * accelerators are a resource you can attach to your Amazon EC2 instances to accelerate
6272
+ * your Deep Learning (DL) inference workloads.</p>
6273
+ * <p>You cannot specify accelerators from different generations in the same request.</p>
6274
+ * <note>
6275
+ * <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon
6276
+ * Elastic Inference (EI), and will help current customers migrate their workloads to
6277
+ * options that offer better price and performance. After April 15, 2023, new customers
6278
+ * will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker,
6279
+ * Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during
6280
+ * the past 30-day period are considered current customers and will be able to continue
6281
+ * using the service.</p>
6282
+ * </note>
6254
6283
  */
6255
6284
  ElasticInferenceAccelerators?: LaunchTemplateElasticInferenceAccelerator[];
6256
6285
  /**
@@ -7326,7 +7355,19 @@ export interface ResponseLaunchTemplateData {
7326
7355
  ElasticGpuSpecifications?: ElasticGpuSpecificationResponse[];
7327
7356
  /**
7328
7357
  * @public
7329
- * <p> The elastic inference accelerator for the instance. </p>
7358
+ * <p>An elastic inference accelerator to associate with the instance. Elastic inference
7359
+ * accelerators are a resource you can attach to your Amazon EC2 instances to accelerate
7360
+ * your Deep Learning (DL) inference workloads.</p>
7361
+ * <p>You cannot specify accelerators from different generations in the same request.</p>
7362
+ * <note>
7363
+ * <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon
7364
+ * Elastic Inference (EI), and will help current customers migrate their workloads to
7365
+ * options that offer better price and performance. After April 15, 2023, new customers
7366
+ * will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker,
7367
+ * Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during
7368
+ * the past 30-day period are considered current customers and will be able to continue
7369
+ * using the service.</p>
7370
+ * </note>
7330
7371
  */
7331
7372
  ElasticInferenceAccelerators?: LaunchTemplateElasticInferenceAcceleratorResponse[];
7332
7373
  /**