@aws-sdk/client-ec2 3.525.1 → 3.529.1
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.
- package/dist-cjs/index.js +584 -596
- package/dist-es/protocols/Aws_ec2.js +22 -34
- package/dist-types/commands/BundleInstanceCommand.d.ts +4 -2
- package/dist-types/commands/CancelImageLaunchPermissionCommand.d.ts +3 -4
- package/dist-types/commands/CopyImageCommand.d.ts +24 -16
- package/dist-types/commands/CreateImageCommand.d.ts +6 -5
- package/dist-types/commands/CreateRestoreImageTaskCommand.d.ts +3 -3
- package/dist-types/commands/CreateStoreImageTaskCommand.d.ts +1 -1
- package/dist-types/commands/DeregisterImageCommand.d.ts +11 -11
- package/dist-types/commands/DescribeBundleTasksCommand.d.ts +8 -1
- package/dist-types/commands/DescribeImageAttributeCommand.d.ts +6 -1
- package/dist-types/commands/DescribeImagesCommand.d.ts +9 -3
- package/dist-types/commands/DescribeStoreImageTasksCommand.d.ts +1 -1
- package/dist-types/commands/DisableFastLaunchCommand.d.ts +6 -4
- package/dist-types/commands/DisableImageBlockPublicAccessCommand.d.ts +2 -2
- package/dist-types/commands/EnableFastLaunchCommand.d.ts +8 -7
- package/dist-types/commands/EnableImageDeprecationCommand.d.ts +2 -1
- package/dist-types/commands/ListImagesInRecycleBinCommand.d.ts +2 -2
- package/dist-types/commands/ModifyImageAttributeCommand.d.ts +7 -5
- package/dist-types/commands/RegisterImageCommand.d.ts +24 -13
- package/dist-types/commands/RestoreImageFromRecycleBinCommand.d.ts +2 -1
- package/dist-types/models/models_0.d.ts +42 -22
- package/dist-types/models/models_1.d.ts +13 -11
- package/dist-types/models/models_2.d.ts +5 -4
- package/dist-types/models/models_3.d.ts +86 -76
- package/dist-types/models/models_4.d.ts +2 -1
- package/dist-types/models/models_5.d.ts +40 -33
- package/dist-types/models/models_6.d.ts +66 -42
- package/dist-types/models/models_7.d.ts +2 -1
- package/dist-types/ts3.4/models/models_0.d.ts +1 -0
- package/dist-types/ts3.4/models/models_6.d.ts +1 -0
- package/package.json +4 -5
|
@@ -1,6 +1,6 @@
|
|
|
1
|
+
import { parseXmlBody as parseBody, parseXmlErrorBody as parseErrorBody } from "@aws-sdk/core";
|
|
1
2
|
import { HttpRequest as __HttpRequest } from "@smithy/protocol-http";
|
|
2
|
-
import { collectBody, expectNonNull as __expectNonNull, expectString as __expectString, extendedEncodeURIComponent as __extendedEncodeURIComponent, getArrayIfSingleItem as __getArrayIfSingleItem,
|
|
3
|
-
import { XMLParser } from "fast-xml-parser";
|
|
3
|
+
import { collectBody, expectNonNull as __expectNonNull, expectString as __expectString, extendedEncodeURIComponent as __extendedEncodeURIComponent, getArrayIfSingleItem as __getArrayIfSingleItem, parseBoolean as __parseBoolean, parseRfc3339DateTimeWithOffset as __parseRfc3339DateTimeWithOffset, serializeFloat as __serializeFloat, strictParseFloat as __strictParseFloat, strictParseInt32 as __strictParseInt32, strictParseLong as __strictParseLong, withBaseException, } from "@smithy/smithy-client";
|
|
4
4
|
import { v4 as generateIdempotencyToken } from "uuid";
|
|
5
5
|
import { EC2ServiceException as __BaseException } from "../models/EC2ServiceException";
|
|
6
6
|
export const se_AcceptAddressTransferCommand = async (input, context) => {
|
|
@@ -15864,6 +15864,16 @@ const se_CopyImageRequest = (input, context) => {
|
|
|
15864
15864
|
if (input[_CITo] != null) {
|
|
15865
15865
|
entries[_CITo] = input[_CITo];
|
|
15866
15866
|
}
|
|
15867
|
+
if (input[_TS] != null) {
|
|
15868
|
+
const memberEntries = se_TagSpecificationList(input[_TS], context);
|
|
15869
|
+
if (input[_TS]?.length === 0) {
|
|
15870
|
+
entries.TagSpecification = [];
|
|
15871
|
+
}
|
|
15872
|
+
Object.entries(memberEntries).forEach(([key, value]) => {
|
|
15873
|
+
const loc = `TagSpecification.${key.substring(key.indexOf(".") + 1)}`;
|
|
15874
|
+
entries[loc] = value;
|
|
15875
|
+
});
|
|
15876
|
+
}
|
|
15867
15877
|
return entries;
|
|
15868
15878
|
};
|
|
15869
15879
|
const se_CopySnapshotRequest = (input, context) => {
|
|
@@ -33005,6 +33015,16 @@ const se_RegisterImageRequest = (input, context) => {
|
|
|
33005
33015
|
if (input[_ISm] != null) {
|
|
33006
33016
|
entries[_ISm] = input[_ISm];
|
|
33007
33017
|
}
|
|
33018
|
+
if (input[_TS] != null) {
|
|
33019
|
+
const memberEntries = se_TagSpecificationList(input[_TS], context);
|
|
33020
|
+
if (input[_TS]?.length === 0) {
|
|
33021
|
+
entries.TagSpecification = [];
|
|
33022
|
+
}
|
|
33023
|
+
Object.entries(memberEntries).forEach(([key, value]) => {
|
|
33024
|
+
const loc = `TagSpecification.${key.substring(key.indexOf(".") + 1)}`;
|
|
33025
|
+
entries[loc] = value;
|
|
33026
|
+
});
|
|
33027
|
+
}
|
|
33008
33028
|
return entries;
|
|
33009
33029
|
};
|
|
33010
33030
|
const se_RegisterInstanceEventNotificationAttributesRequest = (input, context) => {
|
|
@@ -62249,38 +62269,6 @@ const _zI = "zoneId";
|
|
|
62249
62269
|
const _zN = "zoneName";
|
|
62250
62270
|
const _zS = "zoneState";
|
|
62251
62271
|
const _zT = "zoneType";
|
|
62252
|
-
const parseBody = (streamBody, context) => collectBodyString(streamBody, context).then((encoded) => {
|
|
62253
|
-
if (encoded.length) {
|
|
62254
|
-
const parser = new XMLParser({
|
|
62255
|
-
attributeNamePrefix: "",
|
|
62256
|
-
htmlEntities: true,
|
|
62257
|
-
ignoreAttributes: false,
|
|
62258
|
-
ignoreDeclaration: true,
|
|
62259
|
-
parseTagValue: false,
|
|
62260
|
-
trimValues: false,
|
|
62261
|
-
tagValueProcessor: (_, val) => (val.trim() === "" && val.includes("\n") ? "" : undefined),
|
|
62262
|
-
});
|
|
62263
|
-
parser.addEntity("#xD", "\r");
|
|
62264
|
-
parser.addEntity("#10", "\n");
|
|
62265
|
-
const parsedObj = parser.parse(encoded);
|
|
62266
|
-
const textNodeName = "#text";
|
|
62267
|
-
const key = Object.keys(parsedObj)[0];
|
|
62268
|
-
const parsedObjToReturn = parsedObj[key];
|
|
62269
|
-
if (parsedObjToReturn[textNodeName]) {
|
|
62270
|
-
parsedObjToReturn[key] = parsedObjToReturn[textNodeName];
|
|
62271
|
-
delete parsedObjToReturn[textNodeName];
|
|
62272
|
-
}
|
|
62273
|
-
return __getValueFromTextNode(parsedObjToReturn);
|
|
62274
|
-
}
|
|
62275
|
-
return {};
|
|
62276
|
-
});
|
|
62277
|
-
const parseErrorBody = async (errorBody, context) => {
|
|
62278
|
-
const value = await parseBody(errorBody, context);
|
|
62279
|
-
if (value.Error) {
|
|
62280
|
-
value.Error.message = value.Error.message ?? value.Error.Message;
|
|
62281
|
-
}
|
|
62282
|
-
return value;
|
|
62283
|
-
};
|
|
62284
62272
|
const buildFormUrlencodedString = (formEntries) => Object.entries(formEntries)
|
|
62285
62273
|
.map(([key, value]) => __extendedEncodeURIComponent(key) + "=" + __extendedEncodeURIComponent(value))
|
|
62286
62274
|
.join("&");
|
|
@@ -27,9 +27,11 @@ declare const BundleInstanceCommand_base: {
|
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Bundles an Amazon instance store-backed Windows instance.</p>
|
|
30
|
-
* <p>During bundling, only the root device volume (C:\) is bundled. Data on other instance
|
|
30
|
+
* <p>During bundling, only the root device volume (C:\) is bundled. Data on other instance
|
|
31
|
+
* store volumes is not preserved.</p>
|
|
31
32
|
* <note>
|
|
32
|
-
* <p>This action is not applicable for Linux/Unix instances or Windows instances that are
|
|
33
|
+
* <p>This action is not applicable for Linux/Unix instances or Windows instances that are
|
|
34
|
+
* backed by Amazon EBS.</p>
|
|
33
35
|
* </note>
|
|
34
36
|
* @example
|
|
35
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -26,10 +26,9 @@ declare const CancelImageLaunchPermissionCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Removes your Amazon Web Services account from the launch permissions for the specified AMI.
|
|
30
|
-
* information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-sharing-an-AMI.html">
|
|
31
|
-
*
|
|
32
|
-
* <i>Amazon EC2 User Guide</i>.</p>
|
|
29
|
+
* <p>Removes your Amazon Web Services account from the launch permissions for the specified AMI.
|
|
30
|
+
* For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-sharing-an-AMI.html"> Cancel having an AMI shared with
|
|
31
|
+
* your Amazon Web Services account</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
33
32
|
* @example
|
|
34
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
34
|
* ```javascript
|
|
@@ -27,22 +27,19 @@ declare const CopyImageCommand_base: {
|
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Initiates the copy of an AMI. You can copy an AMI from one Region to another, or from a
|
|
30
|
-
* Region to an Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost
|
|
31
|
-
*
|
|
32
|
-
* <p>To copy an AMI from one Region to another, specify the source Region using the
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
* <b>KmsKeyId</b>. Outposts do not support unencrypted
|
|
44
|
-
* snapshots. For more information, <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshots-outposts.html#ami">
|
|
45
|
-
* Amazon EBS local snapshots on Outposts</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
30
|
+
* Region to an Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost to
|
|
31
|
+
* another, or within the same Outpost. To copy an AMI to another partition, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a>.</p>
|
|
32
|
+
* <p>To copy an AMI from one Region to another, specify the source Region using the <b>SourceRegion</b> parameter, and specify the destination Region using its
|
|
33
|
+
* endpoint. Copies of encrypted backing snapshots for the AMI are encrypted. Copies of
|
|
34
|
+
* unencrypted backing snapshots remain unencrypted, unless you set <code>Encrypted</code> during
|
|
35
|
+
* the copy operation. You cannot create an unencrypted copy of an encrypted backing
|
|
36
|
+
* snapshot.</p>
|
|
37
|
+
* <p>To copy an AMI from a Region to an Outpost, specify the source Region using the <b>SourceRegion</b> parameter, and specify the ARN of the destination
|
|
38
|
+
* Outpost using <b>DestinationOutpostArn</b>. Backing snapshots copied
|
|
39
|
+
* to an Outpost are encrypted by default using the default encryption key for the Region, or a
|
|
40
|
+
* different key that you specify in the request using <b>KmsKeyId</b>.
|
|
41
|
+
* Outposts do not support unencrypted snapshots. For more information, <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshots-outposts.html#ami"> Amazon EBS local
|
|
42
|
+
* snapshots on Outposts</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
46
43
|
* <p>For more information about the prerequisites and limits when copying an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html">Copy an AMI</a> in the
|
|
47
44
|
* <i>Amazon EC2 User Guide</i>.</p>
|
|
48
45
|
* @example
|
|
@@ -62,6 +59,17 @@ declare const CopyImageCommand_base: {
|
|
|
62
59
|
* DestinationOutpostArn: "STRING_VALUE",
|
|
63
60
|
* DryRun: true || false,
|
|
64
61
|
* CopyImageTags: true || false,
|
|
62
|
+
* TagSpecifications: [ // TagSpecificationList
|
|
63
|
+
* { // TagSpecification
|
|
64
|
+
* 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",
|
|
65
|
+
* Tags: [ // TagList
|
|
66
|
+
* { // Tag
|
|
67
|
+
* Key: "STRING_VALUE",
|
|
68
|
+
* Value: "STRING_VALUE",
|
|
69
|
+
* },
|
|
70
|
+
* ],
|
|
71
|
+
* },
|
|
72
|
+
* ],
|
|
65
73
|
* };
|
|
66
74
|
* const command = new CopyImageCommand(input);
|
|
67
75
|
* const response = await client.send(command);
|
|
@@ -26,11 +26,12 @@ declare const CreateImageCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance
|
|
30
|
-
*
|
|
31
|
-
* <p>If you customized your instance with instance store volumes or Amazon EBS volumes in addition
|
|
32
|
-
*
|
|
33
|
-
*
|
|
29
|
+
* <p>Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or
|
|
30
|
+
* stopped.</p>
|
|
31
|
+
* <p>If you customized your instance with instance store volumes or Amazon EBS volumes in addition
|
|
32
|
+
* to the root device volume, the new AMI contains block device mapping information for those
|
|
33
|
+
* volumes. When you launch an instance from this new AMI, the instance automatically launches
|
|
34
|
+
* with those additional volumes.</p>
|
|
34
35
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html">Create an Amazon EBS-backed Linux
|
|
35
36
|
* AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
|
|
36
37
|
* @example
|
|
@@ -26,12 +26,12 @@ declare const CreateRestoreImageTaskCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Starts a task that restores an AMI from an Amazon S3 object that was previously created by
|
|
30
|
-
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a>.</p>
|
|
29
|
+
* <p>Starts a task that restores an AMI from an Amazon S3 object that was previously created by
|
|
30
|
+
* using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a>.</p>
|
|
31
31
|
* <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
|
|
32
32
|
* <i>Amazon EC2 User Guide</i>.</p>
|
|
33
33
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
|
|
34
|
-
*
|
|
34
|
+
* Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
35
35
|
* @example
|
|
36
36
|
* Use a bare-bones client and the command you need to make an API call.
|
|
37
37
|
* ```javascript
|
|
@@ -30,7 +30,7 @@ declare const CreateStoreImageTaskCommand_base: {
|
|
|
30
30
|
* <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
|
|
31
31
|
* <i>Amazon EC2 User Guide</i>.</p>
|
|
32
32
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
|
|
33
|
-
*
|
|
33
|
+
* Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
34
34
|
* @example
|
|
35
35
|
* Use a bare-bones client and the command you need to make an API call.
|
|
36
36
|
* ```javascript
|
|
@@ -26,18 +26,18 @@ declare const DeregisterImageCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Deregisters the specified AMI. After you deregister an AMI, it can't be used to
|
|
30
|
-
*
|
|
31
|
-
* <p>If you deregister an AMI that matches a Recycle Bin retention rule, the AMI is retained
|
|
32
|
-
*
|
|
29
|
+
* <p>Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new
|
|
30
|
+
* instances.</p>
|
|
31
|
+
* <p>If you deregister an AMI that matches a Recycle Bin retention rule, the AMI is retained in
|
|
32
|
+
* the Recycle Bin for the specified retention period. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recycle Bin</a> in
|
|
33
33
|
* the <i>Amazon EC2 User Guide</i>.</p>
|
|
34
|
-
* <p>When you deregister an AMI, it doesn't affect any instances that you've already
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
* <p>When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
34
|
+
* <p>When you deregister an AMI, it doesn't affect any instances that you've already launched
|
|
35
|
+
* from the AMI. You'll continue to incur usage costs for those instances until you terminate
|
|
36
|
+
* them.</p>
|
|
37
|
+
* <p>When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was created
|
|
38
|
+
* for the root volume of the instance during the AMI creation process. When you deregister an
|
|
39
|
+
* instance store-backed AMI, it doesn't affect the files that you uploaded to Amazon S3 when you
|
|
40
|
+
* created the AMI.</p>
|
|
41
41
|
* @example
|
|
42
42
|
* Use a bare-bones client and the command you need to make an API call.
|
|
43
43
|
* ```javascript
|
|
@@ -28,7 +28,14 @@ declare const DescribeBundleTasksCommand_base: {
|
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Describes the specified bundle tasks or all of your bundle tasks.</p>
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>Completed bundle tasks are listed for only a limited time. If your bundle task is no
|
|
31
|
+
* <p>Completed bundle tasks are listed for only a limited time. If your bundle task is no
|
|
32
|
+
* longer in the list, you can still register an AMI from it. Just use
|
|
33
|
+
* <code>RegisterImage</code> with the Amazon S3 bucket name and image manifest name you provided
|
|
34
|
+
* to the bundle task.</p>
|
|
35
|
+
* </note>
|
|
36
|
+
* <note>
|
|
37
|
+
* <p>The order of the elements in the response, including those within nested structures,
|
|
38
|
+
* might vary. Applications should not assume the elements appear in a particular order.</p>
|
|
32
39
|
* </note>
|
|
33
40
|
* @example
|
|
34
41
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -26,7 +26,12 @@ declare const DescribeImageAttributeCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Describes the specified attribute of the specified AMI. You can specify only one attribute
|
|
29
|
+
* <p>Describes the specified attribute of the specified AMI. You can specify only one attribute
|
|
30
|
+
* at a time.</p>
|
|
31
|
+
* <note>
|
|
32
|
+
* <p>The order of the elements in the response, including those within nested structures,
|
|
33
|
+
* might vary. Applications should not assume the elements appear in a particular order.</p>
|
|
34
|
+
* </note>
|
|
30
35
|
* @example
|
|
31
36
|
* Use a bare-bones client and the command you need to make an API call.
|
|
32
37
|
* ```javascript
|
|
@@ -26,13 +26,19 @@ declare const DescribeImagesCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Describes the specified images (AMIs, AKIs, and ARIs) available to you or all of the
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* <p>Describes the specified images (AMIs, AKIs, and ARIs) available to you or all of the
|
|
30
|
+
* images available to you.</p>
|
|
31
|
+
* <p>The images available to you include public images, private images that you own, and
|
|
32
|
+
* private images owned by other Amazon Web Services accounts for which you have explicit launch
|
|
33
|
+
* permissions.</p>
|
|
32
34
|
* <p>Recently deregistered images appear in the returned results for a short interval and then
|
|
33
35
|
* return empty results. After all instances that reference a deregistered AMI are terminated,
|
|
34
36
|
* specifying the ID of the image will eventually return an error indicating that the AMI ID
|
|
35
37
|
* cannot be found.</p>
|
|
38
|
+
* <note>
|
|
39
|
+
* <p>The order of the elements in the response, including those within nested structures,
|
|
40
|
+
* might vary. Applications should not assume the elements appear in a particular order.</p>
|
|
41
|
+
* </note>
|
|
36
42
|
* @example
|
|
37
43
|
* Use a bare-bones client and the command you need to make an API call.
|
|
38
44
|
* ```javascript
|
|
@@ -37,7 +37,7 @@ declare const DescribeStoreImageTasksCommand_base: {
|
|
|
37
37
|
* <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using Amazon S3</a> in the
|
|
38
38
|
* <i>Amazon EC2 User Guide</i>.</p>
|
|
39
39
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using
|
|
40
|
-
*
|
|
40
|
+
* Amazon S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
41
41
|
* @example
|
|
42
42
|
* Use a bare-bones client and the command you need to make an API call.
|
|
43
43
|
* ```javascript
|
|
@@ -26,11 +26,13 @@ declare const DisableFastLaunchCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Discontinue Windows fast launch for a Windows AMI, and clean up existing pre-provisioned
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* <p>Discontinue Windows fast launch for a Windows AMI, and clean up existing pre-provisioned
|
|
30
|
+
* snapshots. After you disable Windows fast launch, the AMI uses the standard launch process for
|
|
31
|
+
* each new instance. Amazon EC2 must remove all pre-provisioned snapshots before you can enable
|
|
32
|
+
* Windows fast launch again.</p>
|
|
32
33
|
* <note>
|
|
33
|
-
* <p>You can only change these settings for Windows AMIs that you own or that have been
|
|
34
|
+
* <p>You can only change these settings for Windows AMIs that you own or that have been
|
|
35
|
+
* shared with you.</p>
|
|
34
36
|
* </note>
|
|
35
37
|
* @example
|
|
36
38
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -34,8 +34,8 @@ declare const DisableImageBlockPublicAccessCommand_base: {
|
|
|
34
34
|
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetImageBlockPublicAccessState.html">GetImageBlockPublicAccessState</a>, the response will be
|
|
35
35
|
* <code>block-new-sharing</code>. When the API has completed the configuration, the response
|
|
36
36
|
* will be <code>unblocked</code>.</p>
|
|
37
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis">Block
|
|
38
|
-
*
|
|
37
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/sharingamis-intro.html#block-public-access-to-amis">Block
|
|
38
|
+
* public access to your AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
39
39
|
* @example
|
|
40
40
|
* Use a bare-bones client and the command you need to make an API call.
|
|
41
41
|
* ```javascript
|
|
@@ -26,14 +26,15 @@ declare const EnableFastLaunchCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>When you enable Windows fast launch for a Windows AMI, images are pre-provisioned,
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
29
|
+
* <p>When you enable Windows fast launch for a Windows AMI, images are pre-provisioned, using
|
|
30
|
+
* snapshots to launch instances up to 65% faster. To create the optimized Windows image, Amazon EC2
|
|
31
|
+
* launches an instance and runs through Sysprep steps, rebooting as required. Then it creates a
|
|
32
|
+
* set of reserved snapshots that are used for subsequent launches. The reserved snapshots are
|
|
33
|
+
* automatically replenished as they are used, depending on your settings for launch
|
|
34
|
+
* frequency.</p>
|
|
35
35
|
* <note>
|
|
36
|
-
* <p>You can only change these settings for Windows AMIs that you own or that have been
|
|
36
|
+
* <p>You can only change these settings for Windows AMIs that you own or that have been
|
|
37
|
+
* shared with you.</p>
|
|
37
38
|
* </note>
|
|
38
39
|
* @example
|
|
39
40
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -27,7 +27,8 @@ declare const EnableImageDeprecationCommand_base: {
|
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Enables deprecation of the specified AMI at the specified date and time.</p>
|
|
30
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html">Deprecate an AMI</a> in the
|
|
30
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deprecate.html">Deprecate an AMI</a> in the
|
|
31
|
+
* <i>Amazon EC2 User Guide</i>.</p>
|
|
31
32
|
* @example
|
|
32
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
33
34
|
* ```javascript
|
|
@@ -26,8 +26,8 @@ declare const ListImagesInRecycleBinCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Lists one or more AMIs that are currently in the Recycle Bin. For more information,
|
|
30
|
-
*
|
|
29
|
+
* <p>Lists one or more AMIs that are currently in the Recycle Bin. For more information, see
|
|
30
|
+
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recycle
|
|
31
31
|
* Bin</a> in the <i>Amazon EC2 User Guide</i>.</p>
|
|
32
32
|
* @example
|
|
33
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -26,12 +26,14 @@ declare const ModifyImageAttributeCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Modifies the specified attribute of the specified AMI. You can specify only one attribute
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* <p>Modifies the specified attribute of the specified AMI. You can specify only one attribute
|
|
30
|
+
* at a time.</p>
|
|
31
|
+
* <p>To specify the attribute, you can use the <code>Attribute</code> parameter, or one of the
|
|
32
|
+
* following parameters: <code>Description</code>, <code>ImdsSupport</code>, or
|
|
33
|
+
* <code>LaunchPermission</code>.</p>
|
|
32
34
|
* <p>Images with an Amazon Web Services Marketplace product code cannot be made public.</p>
|
|
33
|
-
* <p>To enable the SriovNetSupport enhanced networking attribute of an image, enable
|
|
34
|
-
*
|
|
35
|
+
* <p>To enable the SriovNetSupport enhanced networking attribute of an image, enable
|
|
36
|
+
* SriovNetSupport on an instance and create an AMI from the instance.</p>
|
|
35
37
|
* @example
|
|
36
38
|
* Use a bare-bones client and the command you need to make an API call.
|
|
37
39
|
* ```javascript
|
|
@@ -26,8 +26,8 @@ declare const RegisterImageCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Registers an AMI. When you're creating an AMI,
|
|
30
|
-
*
|
|
29
|
+
* <p>Registers an AMI. When you're creating an instance-store backed AMI, registering the AMI
|
|
30
|
+
* is the final step in the creation process. For more information about creating AMIs, see
|
|
31
31
|
* <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami.html">Create your
|
|
32
32
|
* own AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
|
|
33
33
|
* <note>
|
|
@@ -36,23 +36,23 @@ declare const RegisterImageCommand_base: {
|
|
|
36
36
|
* always use <a>CreateImage</a> unless you have a specific reason to use
|
|
37
37
|
* RegisterImage.</p>
|
|
38
38
|
* </note>
|
|
39
|
-
* <p>If needed, you can deregister an AMI at any time. Any modifications you make to an AMI
|
|
40
|
-
*
|
|
39
|
+
* <p>If needed, you can deregister an AMI at any time. Any modifications you make to an AMI
|
|
40
|
+
* backed by an instance store volume invalidates its registration. If you make changes to an
|
|
41
|
+
* image, deregister the previous image and register the new image.</p>
|
|
41
42
|
* <p>
|
|
42
43
|
* <b>Register a snapshot of a root device volume</b>
|
|
43
44
|
* </p>
|
|
44
|
-
* <p>You can use <code>RegisterImage</code> to create an Amazon EBS-backed Linux AMI from
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#creating-launching-ami-from-snapshot">Create a Linux AMI from a snapshot</a> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with Amazon EBS-backed
|
|
50
|
-
*
|
|
45
|
+
* <p>You can use <code>RegisterImage</code> to create an Amazon EBS-backed Linux AMI from a snapshot
|
|
46
|
+
* of a root device volume. You specify the snapshot using a block device mapping. You can't set
|
|
47
|
+
* the encryption state of the volume using the block device mapping. If the snapshot is
|
|
48
|
+
* encrypted, or encryption by default is enabled, the root volume of an instance launched from
|
|
49
|
+
* the AMI is encrypted.</p>
|
|
50
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#creating-launching-ami-from-snapshot">Create a Linux AMI from a snapshot</a> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with Amazon EBS-backed
|
|
51
|
+
* AMIs</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
|
|
51
52
|
* <p>
|
|
52
53
|
* <b>Amazon Web Services Marketplace product codes</b>
|
|
53
54
|
* </p>
|
|
54
|
-
* <p>If any snapshots have Amazon Web Services Marketplace product codes, they are copied to the new
|
|
55
|
-
* AMI.</p>
|
|
55
|
+
* <p>If any snapshots have Amazon Web Services Marketplace product codes, they are copied to the new AMI.</p>
|
|
56
56
|
* <p>Windows and some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE
|
|
57
57
|
* Linux Enterprise Server (SLES), use the Amazon EC2 billing product code associated with an AMI to
|
|
58
58
|
* verify the subscription status for package updates. To create a new AMI for operating systems
|
|
@@ -118,6 +118,17 @@ declare const RegisterImageCommand_base: {
|
|
|
118
118
|
* TpmSupport: "v2.0",
|
|
119
119
|
* UefiData: "STRING_VALUE",
|
|
120
120
|
* ImdsSupport: "v2.0",
|
|
121
|
+
* TagSpecifications: [ // TagSpecificationList
|
|
122
|
+
* { // TagSpecification
|
|
123
|
+
* 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",
|
|
124
|
+
* Tags: [ // TagList
|
|
125
|
+
* { // Tag
|
|
126
|
+
* Key: "STRING_VALUE",
|
|
127
|
+
* Value: "STRING_VALUE",
|
|
128
|
+
* },
|
|
129
|
+
* ],
|
|
130
|
+
* },
|
|
131
|
+
* ],
|
|
121
132
|
* };
|
|
122
133
|
* const command = new RegisterImageCommand(input);
|
|
123
134
|
* const response = await client.send(command);
|
|
@@ -26,7 +26,8 @@ declare const RestoreImageFromRecycleBinCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Restores an AMI from the Recycle Bin. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recycle Bin</a> in
|
|
29
|
+
* <p>Restores an AMI from the Recycle Bin. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin.html">Recycle Bin</a> in
|
|
30
|
+
* the <i>Amazon EC2 User Guide</i>.</p>
|
|
30
31
|
* @example
|
|
31
32
|
* Use a bare-bones client and the command you need to make an API call.
|
|
32
33
|
* ```javascript
|