Skip to content

Commit f624638

Browse files
author
awstools
committed
feat(client-ec2): This release includes a new API to describe some details of the Amazon Machine Images (AMIs) that were used to launch EC2 instances, even if those AMIs are no longer available for use.
1 parent eba29d1 commit f624638

20 files changed

+1340
-425
lines changed

clients/client-ec2/README.md

+8
Original file line numberDiff line numberDiff line change
@@ -2405,6 +2405,14 @@ DescribeInstanceEventWindows
24052405

24062406
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/command/DescribeInstanceEventWindowsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ec2/Interface/DescribeInstanceEventWindowsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ec2/Interface/DescribeInstanceEventWindowsCommandOutput/)
24072407

2408+
</details>
2409+
<details>
2410+
<summary>
2411+
DescribeInstanceImageMetadata
2412+
</summary>
2413+
2414+
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/command/DescribeInstanceImageMetadataCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ec2/Interface/DescribeInstanceImageMetadataCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ec2/Interface/DescribeInstanceImageMetadataCommandOutput/)
2415+
24082416
</details>
24092417
<details>
24102418
<summary>

clients/client-ec2/src/EC2.ts

+24
Original file line numberDiff line numberDiff line change
@@ -1333,6 +1333,11 @@ import {
13331333
DescribeInstanceEventWindowsCommandInput,
13341334
DescribeInstanceEventWindowsCommandOutput,
13351335
} from "./commands/DescribeInstanceEventWindowsCommand";
1336+
import {
1337+
DescribeInstanceImageMetadataCommand,
1338+
DescribeInstanceImageMetadataCommandInput,
1339+
DescribeInstanceImageMetadataCommandOutput,
1340+
} from "./commands/DescribeInstanceImageMetadataCommand";
13361341
import {
13371342
DescribeInstancesCommand,
13381343
DescribeInstancesCommandInput,
@@ -3377,6 +3382,7 @@ const commands = {
33773382
DescribeInstanceCreditSpecificationsCommand,
33783383
DescribeInstanceEventNotificationAttributesCommand,
33793384
DescribeInstanceEventWindowsCommand,
3385+
DescribeInstanceImageMetadataCommand,
33803386
DescribeInstancesCommand,
33813387
DescribeInstanceStatusCommand,
33823388
DescribeInstanceTopologyCommand,
@@ -8277,6 +8283,24 @@ export interface EC2 {
82778283
cb: (err: any, data?: DescribeInstanceEventWindowsCommandOutput) => void
82788284
): void;
82798285

8286+
/**
8287+
* @see {@link DescribeInstanceImageMetadataCommand}
8288+
*/
8289+
describeInstanceImageMetadata(): Promise<DescribeInstanceImageMetadataCommandOutput>;
8290+
describeInstanceImageMetadata(
8291+
args: DescribeInstanceImageMetadataCommandInput,
8292+
options?: __HttpHandlerOptions
8293+
): Promise<DescribeInstanceImageMetadataCommandOutput>;
8294+
describeInstanceImageMetadata(
8295+
args: DescribeInstanceImageMetadataCommandInput,
8296+
cb: (err: any, data?: DescribeInstanceImageMetadataCommandOutput) => void
8297+
): void;
8298+
describeInstanceImageMetadata(
8299+
args: DescribeInstanceImageMetadataCommandInput,
8300+
options: __HttpHandlerOptions,
8301+
cb: (err: any, data?: DescribeInstanceImageMetadataCommandOutput) => void
8302+
): void;
8303+
82808304
/**
82818305
* @see {@link DescribeInstancesCommand}
82828306
*/

clients/client-ec2/src/EC2Client.ts

+6
Original file line numberDiff line numberDiff line change
@@ -949,6 +949,10 @@ import {
949949
DescribeInstanceEventWindowsCommandInput,
950950
DescribeInstanceEventWindowsCommandOutput,
951951
} from "./commands/DescribeInstanceEventWindowsCommand";
952+
import {
953+
DescribeInstanceImageMetadataCommandInput,
954+
DescribeInstanceImageMetadataCommandOutput,
955+
} from "./commands/DescribeInstanceImageMetadataCommand";
952956
import { DescribeInstancesCommandInput, DescribeInstancesCommandOutput } from "./commands/DescribeInstancesCommand";
953957
import {
954958
DescribeInstanceStatusCommandInput,
@@ -2491,6 +2495,7 @@ export type ServiceInputTypes =
24912495
| DescribeInstanceCreditSpecificationsCommandInput
24922496
| DescribeInstanceEventNotificationAttributesCommandInput
24932497
| DescribeInstanceEventWindowsCommandInput
2498+
| DescribeInstanceImageMetadataCommandInput
24942499
| DescribeInstanceStatusCommandInput
24952500
| DescribeInstanceTopologyCommandInput
24962501
| DescribeInstanceTypeOfferingsCommandInput
@@ -3129,6 +3134,7 @@ export type ServiceOutputTypes =
31293134
| DescribeInstanceCreditSpecificationsCommandOutput
31303135
| DescribeInstanceEventNotificationAttributesCommandOutput
31313136
| DescribeInstanceEventWindowsCommandOutput
3137+
| DescribeInstanceImageMetadataCommandOutput
31323138
| DescribeInstanceStatusCommandOutput
31333139
| DescribeInstanceTopologyCommandOutput
31343140
| DescribeInstanceTypeOfferingsCommandOutput

clients/client-ec2/src/commands/DescribeInstanceImageMetadataCommand.ts

+155
Large diffs are not rendered by default.

clients/client-ec2/src/commands/DescribeSpotFleetRequestHistoryCommand.ts

+2-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { DescribeSpotFleetRequestHistoryRequest, DescribeSpotFleetRequestHistoryResponse } from "../models/models_4";
9+
import { DescribeSpotFleetRequestHistoryRequest } from "../models/models_4";
10+
import { DescribeSpotFleetRequestHistoryResponse } from "../models/models_5";
1011
import {
1112
de_DescribeSpotFleetRequestHistoryCommand,
1213
se_DescribeSpotFleetRequestHistoryCommand,

clients/client-ec2/src/commands/DescribeSpotFleetRequestsCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { DescribeSpotFleetRequestsRequest } from "../models/models_4";
109
import {
10+
DescribeSpotFleetRequestsRequest,
1111
DescribeSpotFleetRequestsResponse,
1212
DescribeSpotFleetRequestsResponseFilterSensitiveLog,
1313
} from "../models/models_5";

clients/client-ec2/src/commands/GetEbsDefaultKmsKeyIdCommand.ts

+2-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { GetEbsDefaultKmsKeyIdRequest, GetEbsDefaultKmsKeyIdResult } from "../models/models_5";
9+
import { GetEbsDefaultKmsKeyIdRequest } from "../models/models_5";
10+
import { GetEbsDefaultKmsKeyIdResult } from "../models/models_6";
1011
import { de_GetEbsDefaultKmsKeyIdCommand, se_GetEbsDefaultKmsKeyIdCommand } from "../protocols/Aws_ec2";
1112

1213
/**

clients/client-ec2/src/commands/GetEbsEncryptionByDefaultCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { GetEbsEncryptionByDefaultRequest, GetEbsEncryptionByDefaultResult } from "../models/models_5";
9+
import { GetEbsEncryptionByDefaultRequest, GetEbsEncryptionByDefaultResult } from "../models/models_6";
1010
import { de_GetEbsEncryptionByDefaultCommand, se_GetEbsEncryptionByDefaultCommand } from "../protocols/Aws_ec2";
1111

1212
/**

clients/client-ec2/src/commands/ModifyVpcEndpointConnectionNotificationCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import { commonParams } from "../endpoint/EndpointParameters";
99
import {
1010
ModifyVpcEndpointConnectionNotificationRequest,
1111
ModifyVpcEndpointConnectionNotificationResult,
12-
} from "../models/models_6";
12+
} from "../models/models_7";
1313
import {
1414
de_ModifyVpcEndpointConnectionNotificationCommand,
1515
se_ModifyVpcEndpointConnectionNotificationCommand,

clients/client-ec2/src/commands/ModifyVpcEndpointServiceConfigurationCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import { commonParams } from "../endpoint/EndpointParameters";
99
import {
1010
ModifyVpcEndpointServiceConfigurationRequest,
1111
ModifyVpcEndpointServiceConfigurationResult,
12-
} from "../models/models_6";
12+
} from "../models/models_7";
1313
import {
1414
de_ModifyVpcEndpointServiceConfigurationCommand,
1515
se_ModifyVpcEndpointServiceConfigurationCommand,

clients/client-ec2/src/commands/index.ts

+1
Original file line numberDiff line numberDiff line change
@@ -274,6 +274,7 @@ export * from "./DescribeInstanceConnectEndpointsCommand";
274274
export * from "./DescribeInstanceCreditSpecificationsCommand";
275275
export * from "./DescribeInstanceEventNotificationAttributesCommand";
276276
export * from "./DescribeInstanceEventWindowsCommand";
277+
export * from "./DescribeInstanceImageMetadataCommand";
277278
export * from "./DescribeInstanceStatusCommand";
278279
export * from "./DescribeInstanceTopologyCommand";
279280
export * from "./DescribeInstanceTypeOfferingsCommand";

clients/client-ec2/src/models/models_1.ts

+51-15
Original file line numberDiff line numberDiff line change
@@ -6999,7 +6999,6 @@ export interface CreateIpamPoolRequest {
69996999
* <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>
70007000
* </li>
70017001
* </ul>
7002-
* <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>
70037002
* <p>Possible values: Any Amazon Web Services Region or supported Amazon Web Services Local Zone. Default is <code>none</code> and means any locale.</p>
70047003
* @public
70057004
*/
@@ -7037,7 +7036,7 @@ export interface CreateIpamPoolRequest {
70377036
AutoImport?: boolean;
70387037

70397038
/**
7040-
* <p>Determines if the pool is publicly advertisable. This option is not available for pools with AddressFamily set to <code>ipv4</code>.</p>
7039+
* <p>Determines if the pool is publicly advertisable. The request can only contain <code>PubliclyAdvertisable</code> if <code>AddressFamily</code> is <code>ipv6</code> and <code>PublicIpSource</code> is <code>byoip</code>.</p>
70417040
* @public
70427041
*/
70437042
PubliclyAdvertisable?: boolean;
@@ -7862,7 +7861,8 @@ export interface LaunchTemplateEbsBlockDeviceRequest {
78627861
Iops?: number;
78637862

78647863
/**
7865-
* <p>The ARN of the symmetric Key Management Service (KMS) CMK used for encryption.</p>
7864+
* <p>Identifier (key ID, key alias, key ARN, or alias ARN) of the customer managed KMS key
7865+
* to use for EBS encryption.</p>
78667866
* @public
78677867
*/
78687868
KmsKeyId?: string;
@@ -8099,7 +8099,7 @@ export interface ElasticGpuSpecification {
80998099
* <note>
81008100
* <p>Amazon Elastic Inference is no longer available.</p>
81018101
* </note>
8102-
* <p> Describes an elastic inference accelerator.</p>
8102+
* <p> Describes an elastic inference accelerator. </p>
81038103
* @public
81048104
*/
81058105
export interface LaunchTemplateElasticInferenceAccelerator {
@@ -9099,17 +9099,31 @@ export interface RequestLaunchTemplateData {
90999099
/**
91009100
* <p>Deprecated.</p>
91019101
* <note>
9102-
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024.</p>
9102+
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024. For
9103+
* workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4ad,
9104+
* G4dn, or G5 instances.</p>
91039105
* </note>
91049106
* @public
91059107
*/
91069108
ElasticGpuSpecifications?: ElasticGpuSpecification[];
91079109

91089110
/**
9109-
* <p>Deprecated.</p>
9110-
* <note>
9111+
* <note>
91119112
* <p>Amazon Elastic Inference is no longer available.</p>
91129113
* </note>
9114+
* <p>An elastic inference accelerator to associate with the instance. Elastic inference
9115+
* accelerators are a resource you can attach to your Amazon EC2 instances to accelerate
9116+
* your Deep Learning (DL) inference workloads.</p>
9117+
* <p>You cannot specify accelerators from different generations in the same request.</p>
9118+
* <note>
9119+
* <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon
9120+
* Elastic Inference (EI), and will help current customers migrate their workloads to
9121+
* options that offer better price and performance. After April 15, 2023, new customers
9122+
* will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker,
9123+
* Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during
9124+
* the past 30-day period are considered current customers and will be able to continue
9125+
* using the service.</p>
9126+
* </note>
91139127
* @public
91149128
*/
91159129
ElasticInferenceAccelerators?: LaunchTemplateElasticInferenceAccelerator[];
@@ -9499,7 +9513,8 @@ export interface LaunchTemplateEbsBlockDevice {
94999513
Iops?: number;
95009514

95019515
/**
9502-
* <p>The ARN of the Key Management Service (KMS) CMK used for encryption.</p>
9516+
* <p>Identifier (key ID, key alias, key ARN, or alias ARN) of the customer managed KMS key
9517+
* to use for EBS encryption.</p>
95039518
* @public
95049519
*/
95059520
KmsKeyId?: string;
@@ -9650,15 +9665,22 @@ export interface CreditSpecification {
96509665
}
96519666

96529667
/**
9653-
* <note>
9654-
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024.</p>
9668+
* <p>Deprecated.</p>
9669+
* <note>
9670+
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024. For
9671+
* workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4ad,
9672+
* G4dn, or G5 instances.</p>
96559673
* </note>
9656-
* <p>Describes an elastic GPU.</p>
96579674
* @public
96589675
*/
96599676
export interface ElasticGpuSpecificationResponse {
96609677
/**
9661-
* <p>The elastic GPU type.</p>
9678+
* <p>Deprecated.</p>
9679+
* <note>
9680+
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024. For
9681+
* workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4ad,
9682+
* G4dn, or G5 instances.</p>
9683+
* </note>
96629684
* @public
96639685
*/
96649686
Type?: string;
@@ -10425,17 +10447,31 @@ export interface ResponseLaunchTemplateData {
1042510447
/**
1042610448
* <p>Deprecated.</p>
1042710449
* <note>
10428-
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024.</p>
10450+
* <p>Amazon Elastic Graphics reached end of life on January 8, 2024. For
10451+
* workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4ad,
10452+
* G4dn, or G5 instances.</p>
1042910453
* </note>
1043010454
* @public
1043110455
*/
1043210456
ElasticGpuSpecifications?: ElasticGpuSpecificationResponse[];
1043310457

1043410458
/**
10435-
* <p>Deprecated.</p>
10436-
* <note>
10459+
* <note>
1043710460
* <p>Amazon Elastic Inference is no longer available.</p>
1043810461
* </note>
10462+
* <p>An elastic inference accelerator to associate with the instance. Elastic inference
10463+
* accelerators are a resource you can attach to your Amazon EC2 instances to accelerate
10464+
* your Deep Learning (DL) inference workloads.</p>
10465+
* <p>You cannot specify accelerators from different generations in the same request.</p>
10466+
* <note>
10467+
* <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon
10468+
* Elastic Inference (EI), and will help current customers migrate their workloads to
10469+
* options that offer better price and performance. After April 15, 2023, new customers
10470+
* will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker,
10471+
* Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during
10472+
* the past 30-day period are considered current customers and will be able to continue
10473+
* using the service.</p>
10474+
* </note>
1043910475
* @public
1044010476
*/
1044110477
ElasticInferenceAccelerators?: LaunchTemplateElasticInferenceAcceleratorResponse[];

0 commit comments

Comments
 (0)