From fa71f14130ba8705d77f2276e5edebe97f17b258 Mon Sep 17 00:00:00 2001 From: awstools Date: Tue, 20 Jun 2023 19:48:23 +0000 Subject: [PATCH] feat(client-ec2): Adds support for targeting Dedicated Host allocations by assetIds in AWS Outposts --- .../src/commands/AllocateAddressCommand.ts | 27 +- .../src/commands/AllocateHostsCommand.ts | 5 +- .../src/commands/AssociateAddressCommand.ts | 16 +- .../src/commands/CreateFleetCommand.ts | 7 +- .../commands/CreateVpnConnectionCommand.ts | 11 +- .../src/commands/DescribeAddressesCommand.ts | 63 - .../src/commands/DescribeHostsCommand.ts | 1 + .../DescribeInternetGatewaysCommand.ts | 2 +- .../DescribeMovingAddressesCommand.ts | 2 +- ...ibeScheduledInstanceAvailabilityCommand.ts | 49 - .../DescribeScheduledInstancesCommand.ts | 43 - .../DescribeSpotPriceHistoryCommand.ts | 4 +- .../commands/DescribeVpnConnectionsCommand.ts | 8 +- .../commands/DisassociateAddressCommand.ts | 15 +- .../commands/ModifyVpnConnectionCommand.ts | 8 +- .../ModifyVpnConnectionOptionsCommand.ts | 8 +- .../ModifyVpnTunnelCertificateCommand.ts | 8 +- .../commands/ModifyVpnTunnelOptionsCommand.ts | 11 +- .../PurchaseScheduledInstancesCommand.ts | 46 - .../src/commands/ReleaseAddressCommand.ts | 15 +- .../src/commands/RequestSpotFleetCommand.ts | 2 +- .../commands/RequestSpotInstancesCommand.ts | 2 +- .../RestoreAddressToClassicCommand.ts | 17 - .../commands/RunScheduledInstancesCommand.ts | 70 - clients/client-ec2/src/models/models_0.ts | 35 +- clients/client-ec2/src/models/models_1.ts | 8 +- clients/client-ec2/src/models/models_2.ts | 59 + clients/client-ec2/src/models/models_3.ts | 8 +- clients/client-ec2/src/models/models_4.ts | 16 +- clients/client-ec2/src/models/models_5.ts | 11 + clients/client-ec2/src/models/models_6.ts | 70 +- clients/client-ec2/src/protocols/Aws_ec2.ts | 29 + codegen/sdk-codegen/aws-models/ec2.json | 2227 +---------------- 33 files changed, 412 insertions(+), 2491 deletions(-) diff --git a/clients/client-ec2/src/commands/AllocateAddressCommand.ts b/clients/client-ec2/src/commands/AllocateAddressCommand.ts index 95d55e8720d5..b3314ff67459 100644 --- a/clients/client-ec2/src/commands/AllocateAddressCommand.ts +++ b/clients/client-ec2/src/commands/AllocateAddressCommand.ts @@ -97,39 +97,24 @@ export interface AllocateAddressCommandOutput extends AllocateAddressResult, __M * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To allocate an Elastic IP address for EC2-VPC + * @example To allocate an Elastic IP address * ```javascript - * // This example allocates an Elastic IP address to use with an instance in a VPC. - * const input = { - * "Domain": "vpc" - * }; + * // This example allocates an Elastic IP address. + * const input = undefined; * const command = new AllocateAddressCommand(input); * const response = await client.send(command); * /* response == * { * "AllocationId": "eipalloc-64d5890a", * "Domain": "vpc", - * "PublicIp": "203.0.113.0" + * "NetworkBorderGroup": "us-east-1", + * "PublicIp": "203.0.113.0", + * "PublicIpv4Pool": "amazon" * } * *\/ * // example id: ec2-allocate-address-1 * ``` * - * @example To allocate an Elastic IP address for EC2-Classic - * ```javascript - * // This example allocates an Elastic IP address to use with an instance in EC2-Classic. - * const input = undefined; - * const command = new AllocateAddressCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "Domain": "standard", - * "PublicIp": "198.51.100.0" - * } - * *\/ - * // example id: ec2-allocate-address-2 - * ``` - * */ export class AllocateAddressCommand extends $Command< AllocateAddressCommandInput, diff --git a/clients/client-ec2/src/commands/AllocateHostsCommand.ts b/clients/client-ec2/src/commands/AllocateHostsCommand.ts index a264149c2acb..f62f27c6458d 100644 --- a/clients/client-ec2/src/commands/AllocateHostsCommand.ts +++ b/clients/client-ec2/src/commands/AllocateHostsCommand.ts @@ -51,7 +51,7 @@ export interface AllocateHostsCommandOutput extends AllocateHostsResult, __Metad * ClientToken: "STRING_VALUE", * InstanceType: "STRING_VALUE", * InstanceFamily: "STRING_VALUE", - * Quantity: Number("int"), // required + * Quantity: Number("int"), * 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", @@ -66,6 +66,9 @@ export interface AllocateHostsCommandOutput extends AllocateHostsResult, __Metad * HostRecovery: "on" || "off", * OutpostArn: "STRING_VALUE", * HostMaintenance: "on" || "off", + * AssetIds: [ // AssetIdList + * "STRING_VALUE", + * ], * }; * const command = new AllocateHostsCommand(input); * const response = await client.send(command); diff --git a/clients/client-ec2/src/commands/AssociateAddressCommand.ts b/clients/client-ec2/src/commands/AssociateAddressCommand.ts index 3da248f6727c..9a1df74f0d8e 100644 --- a/clients/client-ec2/src/commands/AssociateAddressCommand.ts +++ b/clients/client-ec2/src/commands/AssociateAddressCommand.ts @@ -86,9 +86,9 @@ export interface AssociateAddressCommandOutput extends AssociateAddressResult, _ * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To associate an Elastic IP address in EC2-VPC + * @example To associate an Elastic IP address * ```javascript - * // This example associates the specified Elastic IP address with the specified instance in a VPC. + * // This example associates the specified Elastic IP address with the specified instance. * const input = { * "AllocationId": "eipalloc-64d5890a", * "InstanceId": "i-0b263919b6498b123" @@ -120,18 +120,6 @@ export interface AssociateAddressCommandOutput extends AssociateAddressResult, _ * // example id: ec2-associate-address-2 * ``` * - * @example To associate an Elastic IP address in EC2-Classic - * ```javascript - * // This example associates an Elastic IP address with an instance in EC2-Classic. - * const input = { - * "InstanceId": "i-07ffe74c7330ebf53", - * "PublicIp": "198.51.100.0" - * }; - * const command = new AssociateAddressCommand(input); - * await client.send(command); - * // example id: ec2-associate-address-3 - * ``` - * */ export class AssociateAddressCommand extends $Command< AssociateAddressCommandInput, diff --git a/clients/client-ec2/src/commands/CreateFleetCommand.ts b/clients/client-ec2/src/commands/CreateFleetCommand.ts index ba5435f2eb37..dea13e0d23e3 100644 --- a/clients/client-ec2/src/commands/CreateFleetCommand.ts +++ b/clients/client-ec2/src/commands/CreateFleetCommand.ts @@ -36,9 +36,10 @@ export interface CreateFleetCommandOutput extends CreateFleetResult, __MetadataB /** * @public - *

Launches an EC2 Fleet.

- *

You can create a single EC2 Fleet that includes multiple launch specifications that vary by - * instance type, AMI, Availability Zone, or subnet.

+ *

Creates an EC2 Fleet that contains the configuration information for On-Demand Instances and Spot Instances. + * Instances are launched immediately if there is available capacity.

+ *

A single EC2 Fleet can include multiple launch specifications that vary by instance type, + * AMI, Availability Zone, or subnet.

*

For more information, see EC2 Fleet in the Amazon EC2 User Guide.

* @example * Use a bare-bones client and the command you need to make an API call. diff --git a/clients/client-ec2/src/commands/CreateVpnConnectionCommand.ts b/clients/client-ec2/src/commands/CreateVpnConnectionCommand.ts index ca0b86e5b25b..157b9d067682 100644 --- a/clients/client-ec2/src/commands/CreateVpnConnectionCommand.ts +++ b/clients/client-ec2/src/commands/CreateVpnConnectionCommand.ts @@ -14,7 +14,12 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { CreateVpnConnectionRequest, CreateVpnConnectionResult } from "../models/models_2"; +import { + CreateVpnConnectionRequest, + CreateVpnConnectionRequestFilterSensitiveLog, + CreateVpnConnectionResult, + CreateVpnConnectionResultFilterSensitiveLog, +} from "../models/models_2"; import { de_CreateVpnConnectionCommand, se_CreateVpnConnectionCommand } from "../protocols/Aws_ec2"; /** @@ -317,8 +322,8 @@ export class CreateVpnConnectionCommand extends $Command< logger, clientName, commandName, - inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + inputFilterSensitiveLog: CreateVpnConnectionRequestFilterSensitiveLog, + outputFilterSensitiveLog: CreateVpnConnectionResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/DescribeAddressesCommand.ts b/clients/client-ec2/src/commands/DescribeAddressesCommand.ts index a0414759db9a..ce3bfedc8986 100644 --- a/clients/client-ec2/src/commands/DescribeAddressesCommand.ts +++ b/clients/client-ec2/src/commands/DescribeAddressesCommand.ts @@ -129,69 +129,6 @@ export interface DescribeAddressesCommandOutput extends DescribeAddressesResult, * // example id: ec2-describe-addresses-1 * ``` * - * @example To describe your Elastic IP addresses for EC2-VPC - * ```javascript - * // This example describes your Elastic IP addresses for use with instances in a VPC. - * const input = { - * "Filters": [ - * { - * "Name": "domain", - * "Values": [ - * "vpc" - * ] - * } - * ] - * }; - * const command = new DescribeAddressesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "Addresses": [ - * { - * "AllocationId": "eipalloc-12345678", - * "AssociationId": "eipassoc-12345678", - * "Domain": "vpc", - * "InstanceId": "i-1234567890abcdef0", - * "NetworkInterfaceId": "eni-12345678", - * "NetworkInterfaceOwnerId": "123456789012", - * "PrivateIpAddress": "10.0.1.241", - * "PublicIp": "203.0.113.0" - * } - * ] - * } - * *\/ - * // example id: ec2-describe-addresses-2 - * ``` - * - * @example To describe your Elastic IP addresses for EC2-Classic - * ```javascript - * // This example describes your Elastic IP addresses for use with instances in EC2-Classic. - * const input = { - * "Filters": [ - * { - * "Name": "domain", - * "Values": [ - * "standard" - * ] - * } - * ] - * }; - * const command = new DescribeAddressesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "Addresses": [ - * { - * "Domain": "standard", - * "InstanceId": "i-1234567890abcdef0", - * "PublicIp": "198.51.100.0" - * } - * ] - * } - * *\/ - * // example id: ec2-describe-addresses-3 - * ``` - * */ export class DescribeAddressesCommand extends $Command< DescribeAddressesCommandInput, diff --git a/clients/client-ec2/src/commands/DescribeHostsCommand.ts b/clients/client-ec2/src/commands/DescribeHostsCommand.ts index 7c0f97cdabf2..4c6d4ae4967b 100644 --- a/clients/client-ec2/src/commands/DescribeHostsCommand.ts +++ b/clients/client-ec2/src/commands/DescribeHostsCommand.ts @@ -111,6 +111,7 @@ export interface DescribeHostsCommandOutput extends DescribeHostsResult, __Metad * // MemberOfServiceLinkedResourceGroup: true || false, * // OutpostArn: "STRING_VALUE", * // HostMaintenance: "on" || "off", + * // AssetId: "STRING_VALUE", * // }, * // ], * // NextToken: "STRING_VALUE", diff --git a/clients/client-ec2/src/commands/DescribeInternetGatewaysCommand.ts b/clients/client-ec2/src/commands/DescribeInternetGatewaysCommand.ts index ecee8e274ac2..74c014eba1a3 100644 --- a/clients/client-ec2/src/commands/DescribeInternetGatewaysCommand.ts +++ b/clients/client-ec2/src/commands/DescribeInternetGatewaysCommand.ts @@ -115,7 +115,7 @@ export interface DescribeInternetGatewaysCommandOutput extends DescribeInternetG * { * "Attachments": [ * { - * "State": "available", + * "State": "attached", * "VpcId": "vpc-a01106c2" * } * ], diff --git a/clients/client-ec2/src/commands/DescribeMovingAddressesCommand.ts b/clients/client-ec2/src/commands/DescribeMovingAddressesCommand.ts index e3e4230c2a4b..59446dc0fa12 100644 --- a/clients/client-ec2/src/commands/DescribeMovingAddressesCommand.ts +++ b/clients/client-ec2/src/commands/DescribeMovingAddressesCommand.ts @@ -96,7 +96,7 @@ export interface DescribeMovingAddressesCommandOutput extends DescribeMovingAddr * { * "MovingAddressStatuses": [ * { - * "MoveStatus": "MovingToVpc", + * "MoveStatus": "movingToVpc", * "PublicIp": "198.51.100.0" * } * ] diff --git a/clients/client-ec2/src/commands/DescribeScheduledInstanceAvailabilityCommand.ts b/clients/client-ec2/src/commands/DescribeScheduledInstanceAvailabilityCommand.ts index f28c56b10283..88ed4980da7f 100644 --- a/clients/client-ec2/src/commands/DescribeScheduledInstanceAvailabilityCommand.ts +++ b/clients/client-ec2/src/commands/DescribeScheduledInstanceAvailabilityCommand.ts @@ -125,55 +125,6 @@ export interface DescribeScheduledInstanceAvailabilityCommandOutput * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To describe an available schedule - * ```javascript - * // This example describes a schedule that occurs every week on Sunday, starting on the specified date. Note that the output contains a single schedule as an example. - * const input = { - * "FirstSlotStartTimeRange": { - * "EarliestTime": "2016-01-31T00:00:00Z", - * "LatestTime": "2016-01-31T04:00:00Z" - * }, - * "Recurrence": { - * "Frequency": "Weekly", - * "Interval": 1, - * "OccurrenceDays": [ - * 1 - * ] - * } - * }; - * const command = new DescribeScheduledInstanceAvailabilityCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "ScheduledInstanceAvailabilitySet": [ - * { - * "AvailabilityZone": "us-west-2b", - * "AvailableInstanceCount": 20, - * "FirstSlotStartTime": "2016-01-31T00:00:00Z", - * "HourlyPrice": "0.095", - * "InstanceType": "c4.large", - * "MaxTermDurationInDays": 366, - * "MinTermDurationInDays": 366, - * "NetworkPlatform": "EC2-VPC", - * "Platform": "Linux/UNIX", - * "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...", - * "Recurrence": { - * "Frequency": "Weekly", - * "Interval": 1, - * "OccurrenceDaySet": [ - * 1 - * ], - * "OccurrenceRelativeToEnd": false - * }, - * "SlotDurationInHours": 23, - * "TotalScheduledInstanceHours": 1219 - * } - * ] - * } - * *\/ - * // example id: ec2-describe-scheduled-instance-availability-1 - * ``` - * */ export class DescribeScheduledInstanceAvailabilityCommand extends $Command< DescribeScheduledInstanceAvailabilityCommandInput, diff --git a/clients/client-ec2/src/commands/DescribeScheduledInstancesCommand.ts b/clients/client-ec2/src/commands/DescribeScheduledInstancesCommand.ts index 8d9fe3b01f58..00f49cfaef3d 100644 --- a/clients/client-ec2/src/commands/DescribeScheduledInstancesCommand.ts +++ b/clients/client-ec2/src/commands/DescribeScheduledInstancesCommand.ts @@ -107,49 +107,6 @@ export interface DescribeScheduledInstancesCommandOutput extends DescribeSchedul * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To describe your Scheduled Instances - * ```javascript - * // This example describes the specified Scheduled Instance. - * const input = { - * "ScheduledInstanceIds": [ - * "sci-1234-1234-1234-1234-123456789012" - * ] - * }; - * const command = new DescribeScheduledInstancesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "ScheduledInstanceSet": [ - * { - * "AvailabilityZone": "us-west-2b", - * "CreateDate": "2016-01-25T21:43:38.612Z", - * "HourlyPrice": "0.095", - * "InstanceCount": 1, - * "InstanceType": "c4.large", - * "NetworkPlatform": "EC2-VPC", - * "NextSlotStartTime": "2016-01-31T09:00:00Z", - * "Platform": "Linux/UNIX", - * "Recurrence": { - * "Frequency": "Weekly", - * "Interval": 1, - * "OccurrenceDaySet": [ - * 1 - * ], - * "OccurrenceRelativeToEnd": false, - * "OccurrenceUnit": "" - * }, - * "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - * "SlotDurationInHours": 32, - * "TermEndDate": "2017-01-31T09:00:00Z", - * "TermStartDate": "2016-01-31T09:00:00Z", - * "TotalScheduledInstanceHours": 1696 - * } - * ] - * } - * *\/ - * // example id: ec2-describe-scheduled-instances-1 - * ``` - * */ export class DescribeScheduledInstancesCommand extends $Command< DescribeScheduledInstancesCommandInput, diff --git a/clients/client-ec2/src/commands/DescribeSpotPriceHistoryCommand.ts b/clients/client-ec2/src/commands/DescribeSpotPriceHistoryCommand.ts index 86bd0e9ec6c9..4336e57b71a4 100644 --- a/clients/client-ec2/src/commands/DescribeSpotPriceHistoryCommand.ts +++ b/clients/client-ec2/src/commands/DescribeSpotPriceHistoryCommand.ts @@ -99,14 +99,14 @@ export interface DescribeSpotPriceHistoryCommandOutput extends DescribeSpotPrice * ```javascript * // This example returns the Spot Price history for m1.xlarge, Linux/UNIX (Amazon VPC) instances for a particular day in January. * const input = { - * "EndTime": "2014-01-06T08:09:10", + * "EndTime": "2014-01-06T08:09:10.05Z", * "InstanceTypes": [ * "m1.xlarge" * ], * "ProductDescriptions": [ * "Linux/UNIX (Amazon VPC)" * ], - * "StartTime": "2014-01-06T07:08:09" + * "StartTime": "2014-01-06T07:08:09.05Z" * }; * const command = new DescribeSpotPriceHistoryCommand(input); * const response = await client.send(command); diff --git a/clients/client-ec2/src/commands/DescribeVpnConnectionsCommand.ts b/clients/client-ec2/src/commands/DescribeVpnConnectionsCommand.ts index 8e90b66a4bf2..32c96befa90f 100644 --- a/clients/client-ec2/src/commands/DescribeVpnConnectionsCommand.ts +++ b/clients/client-ec2/src/commands/DescribeVpnConnectionsCommand.ts @@ -14,7 +14,11 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { DescribeVpnConnectionsRequest, DescribeVpnConnectionsResult } from "../models/models_5"; +import { + DescribeVpnConnectionsRequest, + DescribeVpnConnectionsResult, + DescribeVpnConnectionsResultFilterSensitiveLog, +} from "../models/models_5"; import { de_DescribeVpnConnectionsCommand, se_DescribeVpnConnectionsCommand } from "../protocols/Aws_ec2"; /** @@ -233,7 +237,7 @@ export class DescribeVpnConnectionsCommand extends $Command< clientName, commandName, inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + outputFilterSensitiveLog: DescribeVpnConnectionsResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/DisassociateAddressCommand.ts b/clients/client-ec2/src/commands/DisassociateAddressCommand.ts index 736863dbd09c..0d793700533d 100644 --- a/clients/client-ec2/src/commands/DisassociateAddressCommand.ts +++ b/clients/client-ec2/src/commands/DisassociateAddressCommand.ts @@ -64,9 +64,9 @@ export interface DisassociateAddressCommandOutput extends __MetadataBearer {} * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To disassociate an Elastic IP address in EC2-VPC + * @example To disassociate an Elastic IP address * ```javascript - * // This example disassociates an Elastic IP address from an instance in a VPC. + * // This example disassociates an Elastic IP address from an instance. * const input = { * "AssociationId": "eipassoc-2bebb745" * }; @@ -75,17 +75,6 @@ export interface DisassociateAddressCommandOutput extends __MetadataBearer {} * // example id: ec2-disassociate-address-1 * ``` * - * @example To disassociate an Elastic IP addresses in EC2-Classic - * ```javascript - * // This example disassociates an Elastic IP address from an instance in EC2-Classic. - * const input = { - * "PublicIp": "198.51.100.0" - * }; - * const command = new DisassociateAddressCommand(input); - * await client.send(command); - * // example id: ec2-disassociate-address-2 - * ``` - * */ export class DisassociateAddressCommand extends $Command< DisassociateAddressCommandInput, diff --git a/clients/client-ec2/src/commands/ModifyVpnConnectionCommand.ts b/clients/client-ec2/src/commands/ModifyVpnConnectionCommand.ts index 70e89149ccbe..a7f9c27102c7 100644 --- a/clients/client-ec2/src/commands/ModifyVpnConnectionCommand.ts +++ b/clients/client-ec2/src/commands/ModifyVpnConnectionCommand.ts @@ -14,7 +14,11 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { ModifyVpnConnectionRequest, ModifyVpnConnectionResult } from "../models/models_6"; +import { + ModifyVpnConnectionRequest, + ModifyVpnConnectionResult, + ModifyVpnConnectionResultFilterSensitiveLog, +} from "../models/models_6"; import { de_ModifyVpnConnectionCommand, se_ModifyVpnConnectionCommand } from "../protocols/Aws_ec2"; /** @@ -257,7 +261,7 @@ export class ModifyVpnConnectionCommand extends $Command< clientName, commandName, inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + outputFilterSensitiveLog: ModifyVpnConnectionResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/ModifyVpnConnectionOptionsCommand.ts b/clients/client-ec2/src/commands/ModifyVpnConnectionOptionsCommand.ts index 9fa6d2fcf606..82f16652c92d 100644 --- a/clients/client-ec2/src/commands/ModifyVpnConnectionOptionsCommand.ts +++ b/clients/client-ec2/src/commands/ModifyVpnConnectionOptionsCommand.ts @@ -14,7 +14,11 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { ModifyVpnConnectionOptionsRequest, ModifyVpnConnectionOptionsResult } from "../models/models_6"; +import { + ModifyVpnConnectionOptionsRequest, + ModifyVpnConnectionOptionsResult, + ModifyVpnConnectionOptionsResultFilterSensitiveLog, +} from "../models/models_6"; import { de_ModifyVpnConnectionOptionsCommand, se_ModifyVpnConnectionOptionsCommand } from "../protocols/Aws_ec2"; /** @@ -227,7 +231,7 @@ export class ModifyVpnConnectionOptionsCommand extends $Command< clientName, commandName, inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + outputFilterSensitiveLog: ModifyVpnConnectionOptionsResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/ModifyVpnTunnelCertificateCommand.ts b/clients/client-ec2/src/commands/ModifyVpnTunnelCertificateCommand.ts index 074ec20de242..a13d4ee907b0 100644 --- a/clients/client-ec2/src/commands/ModifyVpnTunnelCertificateCommand.ts +++ b/clients/client-ec2/src/commands/ModifyVpnTunnelCertificateCommand.ts @@ -14,7 +14,11 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { ModifyVpnTunnelCertificateRequest, ModifyVpnTunnelCertificateResult } from "../models/models_6"; +import { + ModifyVpnTunnelCertificateRequest, + ModifyVpnTunnelCertificateResult, + ModifyVpnTunnelCertificateResultFilterSensitiveLog, +} from "../models/models_6"; import { de_ModifyVpnTunnelCertificateCommand, se_ModifyVpnTunnelCertificateCommand } from "../protocols/Aws_ec2"; /** @@ -220,7 +224,7 @@ export class ModifyVpnTunnelCertificateCommand extends $Command< clientName, commandName, inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + outputFilterSensitiveLog: ModifyVpnTunnelCertificateResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/ModifyVpnTunnelOptionsCommand.ts b/clients/client-ec2/src/commands/ModifyVpnTunnelOptionsCommand.ts index e6b851fe8d70..802b6c8f309f 100644 --- a/clients/client-ec2/src/commands/ModifyVpnTunnelOptionsCommand.ts +++ b/clients/client-ec2/src/commands/ModifyVpnTunnelOptionsCommand.ts @@ -14,7 +14,12 @@ import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@s import { SerdeContext as __SerdeContext } from "@smithy/types"; import { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; -import { ModifyVpnTunnelOptionsRequest, ModifyVpnTunnelOptionsResult } from "../models/models_6"; +import { + ModifyVpnTunnelOptionsRequest, + ModifyVpnTunnelOptionsRequestFilterSensitiveLog, + ModifyVpnTunnelOptionsResult, + ModifyVpnTunnelOptionsResultFilterSensitiveLog, +} from "../models/models_6"; import { de_ModifyVpnTunnelOptionsCommand, se_ModifyVpnTunnelOptionsCommand } from "../protocols/Aws_ec2"; /** @@ -279,8 +284,8 @@ export class ModifyVpnTunnelOptionsCommand extends $Command< logger, clientName, commandName, - inputFilterSensitiveLog: (_: any) => _, - outputFilterSensitiveLog: (_: any) => _, + inputFilterSensitiveLog: ModifyVpnTunnelOptionsRequestFilterSensitiveLog, + outputFilterSensitiveLog: ModifyVpnTunnelOptionsResultFilterSensitiveLog, }; const { requestHandler } = configuration; return stack.resolve( diff --git a/clients/client-ec2/src/commands/PurchaseScheduledInstancesCommand.ts b/clients/client-ec2/src/commands/PurchaseScheduledInstancesCommand.ts index 4cc6821f3c8f..8ce28c7abfa5 100644 --- a/clients/client-ec2/src/commands/PurchaseScheduledInstancesCommand.ts +++ b/clients/client-ec2/src/commands/PurchaseScheduledInstancesCommand.ts @@ -104,52 +104,6 @@ export interface PurchaseScheduledInstancesCommandOutput extends PurchaseSchedul * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To purchase a Scheduled Instance - * ```javascript - * // This example purchases a Scheduled Instance. - * const input = { - * "PurchaseRequests": [ - * { - * "InstanceCount": 1, - * "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi..." - * } - * ] - * }; - * const command = new PurchaseScheduledInstancesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "ScheduledInstanceSet": [ - * { - * "AvailabilityZone": "us-west-2b", - * "CreateDate": "2016-01-25T21:43:38.612Z", - * "HourlyPrice": "0.095", - * "InstanceCount": 1, - * "InstanceType": "c4.large", - * "NetworkPlatform": "EC2-VPC", - * "NextSlotStartTime": "2016-01-31T09:00:00Z", - * "Platform": "Linux/UNIX", - * "Recurrence": { - * "Frequency": "Weekly", - * "Interval": 1, - * "OccurrenceDaySet": [ - * 1 - * ], - * "OccurrenceRelativeToEnd": false, - * "OccurrenceUnit": "" - * }, - * "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012", - * "SlotDurationInHours": 32, - * "TermEndDate": "2017-01-31T09:00:00Z", - * "TermStartDate": "2016-01-31T09:00:00Z", - * "TotalScheduledInstanceHours": 1696 - * } - * ] - * } - * *\/ - * // example id: ec2-purchase-scheduled-instances-1 - * ``` - * */ export class PurchaseScheduledInstancesCommand extends $Command< PurchaseScheduledInstancesCommandInput, diff --git a/clients/client-ec2/src/commands/ReleaseAddressCommand.ts b/clients/client-ec2/src/commands/ReleaseAddressCommand.ts index 389fd1a0bc80..c06f5dee9312 100644 --- a/clients/client-ec2/src/commands/ReleaseAddressCommand.ts +++ b/clients/client-ec2/src/commands/ReleaseAddressCommand.ts @@ -75,9 +75,9 @@ export interface ReleaseAddressCommandOutput extends __MetadataBearer {} * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To release an Elastic IP address for EC2-VPC + * @example To release an Elastic IP address * ```javascript - * // This example releases an Elastic IP address for use with instances in a VPC. + * // This example releases the specified Elastic IP address. * const input = { * "AllocationId": "eipalloc-64d5890a" * }; @@ -86,17 +86,6 @@ export interface ReleaseAddressCommandOutput extends __MetadataBearer {} * // example id: ec2-release-address-1 * ``` * - * @example To release an Elastic IP addresses for EC2-Classic - * ```javascript - * // This example releases an Elastic IP address for use with instances in EC2-Classic. - * const input = { - * "PublicIp": "198.51.100.0" - * }; - * const command = new ReleaseAddressCommand(input); - * await client.send(command); - * // example id: ec2-release-address-2 - * ``` - * */ export class ReleaseAddressCommand extends $Command< ReleaseAddressCommandInput, diff --git a/clients/client-ec2/src/commands/RequestSpotFleetCommand.ts b/clients/client-ec2/src/commands/RequestSpotFleetCommand.ts index def87d75e23e..5dc14d0bdbbe 100644 --- a/clients/client-ec2/src/commands/RequestSpotFleetCommand.ts +++ b/clients/client-ec2/src/commands/RequestSpotFleetCommand.ts @@ -446,7 +446,7 @@ export interface RequestSpotFleetCommandOutput extends RequestSpotFleetResponse, * * @example To request a Spot fleet in the Availability Zone with the lowest price * ```javascript - * // This example creates a Spot fleet request with two launch specifications that differ only by Availability Zone. The Spot fleet launches the instances in the specified Availability Zone with the lowest price. If your account supports EC2-VPC only, Amazon EC2 launches the Spot instances in the default subnet of the Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the Availability Zone. + * // This example creates a Spot fleet request with two launch specifications that differ only by Availability Zone. The Spot fleet launches the instances in the specified Availability Zone with the lowest price. If your account supports EC2-VPC only, Amazon EC2 launches the Spot instances in the default subnet of the Availability Zone. * const input = { * "SpotFleetRequestConfig": { * "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role", diff --git a/clients/client-ec2/src/commands/RequestSpotInstancesCommand.ts b/clients/client-ec2/src/commands/RequestSpotInstancesCommand.ts index 80a2db91a60f..e5f9208cce72 100644 --- a/clients/client-ec2/src/commands/RequestSpotInstancesCommand.ts +++ b/clients/client-ec2/src/commands/RequestSpotInstancesCommand.ts @@ -311,7 +311,7 @@ export interface RequestSpotInstancesCommandOutput extends RequestSpotInstancesR * * @example To create a one-time Spot Instance request * ```javascript - * // This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the specified Availability Zone. + * // This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone. * const input = { * "InstanceCount": 5, * "LaunchSpecification": { diff --git a/clients/client-ec2/src/commands/RestoreAddressToClassicCommand.ts b/clients/client-ec2/src/commands/RestoreAddressToClassicCommand.ts index 6b4bf6b5865e..2a9d2e1560f3 100644 --- a/clients/client-ec2/src/commands/RestoreAddressToClassicCommand.ts +++ b/clients/client-ec2/src/commands/RestoreAddressToClassicCommand.ts @@ -68,23 +68,6 @@ export interface RestoreAddressToClassicCommandOutput extends RestoreAddressToCl * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To restore an address to EC2-Classic - * ```javascript - * // This example restores the specified Elastic IP address to the EC2-Classic platform. - * const input = { - * "PublicIp": "198.51.100.0" - * }; - * const command = new RestoreAddressToClassicCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "PublicIp": "198.51.100.0", - * "Status": "MoveInProgress" - * } - * *\/ - * // example id: ec2-restore-address-to-classic-1 - * ``` - * */ export class RestoreAddressToClassicCommand extends $Command< RestoreAddressToClassicCommandInput, diff --git a/clients/client-ec2/src/commands/RunScheduledInstancesCommand.ts b/clients/client-ec2/src/commands/RunScheduledInstancesCommand.ts index 2314fd986e13..6230a436378c 100644 --- a/clients/client-ec2/src/commands/RunScheduledInstancesCommand.ts +++ b/clients/client-ec2/src/commands/RunScheduledInstancesCommand.ts @@ -143,76 +143,6 @@ export interface RunScheduledInstancesCommandOutput extends RunScheduledInstance * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* - * @example To launch a Scheduled Instance in a VPC - * ```javascript - * // This example launches the specified Scheduled Instance in a VPC. - * const input = { - * "InstanceCount": 1, - * "LaunchSpecification": { - * "IamInstanceProfile": { - * "Name": "my-iam-role" - * }, - * "ImageId": "ami-12345678", - * "InstanceType": "c4.large", - * "KeyName": "my-key-pair", - * "NetworkInterfaces": [ - * { - * "AssociatePublicIpAddress": true, - * "DeviceIndex": 0, - * "Groups": [ - * "sg-12345678" - * ], - * "SubnetId": "subnet-12345678" - * } - * ] - * }, - * "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - * }; - * const command = new RunScheduledInstancesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "InstanceIdSet": [ - * "i-1234567890abcdef0" - * ] - * } - * *\/ - * // example id: ec2-run-scheduled-instances-1 - * ``` - * - * @example To launch a Scheduled Instance in EC2-Classic - * ```javascript - * // This example launches the specified Scheduled Instance in EC2-Classic. - * const input = { - * "InstanceCount": 1, - * "LaunchSpecification": { - * "IamInstanceProfile": { - * "Name": "my-iam-role" - * }, - * "ImageId": "ami-12345678", - * "InstanceType": "c4.large", - * "KeyName": "my-key-pair", - * "Placement": { - * "AvailabilityZone": "us-west-2b" - * }, - * "SecurityGroupIds": [ - * "sg-12345678" - * ] - * }, - * "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012" - * }; - * const command = new RunScheduledInstancesCommand(input); - * const response = await client.send(command); - * /* response == - * { - * "InstanceIdSet": [ - * "i-1234567890abcdef0" - * ] - * } - * *\/ - * // example id: ec2-run-scheduled-instances-2 - * ``` - * */ export class RunScheduledInstancesCommand extends $Command< RunScheduledInstancesCommandInput, diff --git a/clients/client-ec2/src/models/models_0.ts b/clients/client-ec2/src/models/models_0.ts index b2b2aa76011b..0332025e59f8 100644 --- a/clients/client-ec2/src/models/models_0.ts +++ b/clients/client-ec2/src/models/models_0.ts @@ -2874,10 +2874,14 @@ export interface AllocateHostsRequest { InstanceFamily?: string; /** - *

The number of Dedicated Hosts to allocate to your account with these - * parameters.

+ *

The number of Dedicated Hosts to allocate to your account with these parameters. If you are + * allocating the Dedicated Hosts on an Outpost, and you specify AssetIds, + * you can omit this parameter. In this case, Amazon EC2 allocates a Dedicated Host on each + * specified hardware asset. If you specify both AssetIds and + * Quantity, then the value that you specify for + * Quantity must be equal to the number of asset IDs specified.

*/ - Quantity: number | undefined; + Quantity?: number; /** *

The tags to apply to the Dedicated Host during creation.

@@ -2895,7 +2899,9 @@ export interface AllocateHostsRequest { /** *

The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate - * the Dedicated Host.

+ * the Dedicated Host. If you specify OutpostArn, you can + * optionally specify AssetIds.

+ *

If you are allocating the Dedicated Host in a Region, omit this parameter.

*/ OutpostArn?: string; @@ -2905,6 +2911,27 @@ export interface AllocateHostsRequest { * maintenance in the Amazon EC2 User Guide.

*/ HostMaintenance?: HostMaintenance | string; + + /** + *

The IDs of the Outpost hardware assets on which to allocate the Dedicated Hosts. Targeting + * specific hardware assets on an Outpost can help to minimize latency between your workloads. + * This parameter is supported only if you specify OutpostArn. + * If you are allocating the Dedicated Hosts in a Region, omit this parameter.

+ * + */ + AssetIds?: string[]; } /** diff --git a/clients/client-ec2/src/models/models_1.ts b/clients/client-ec2/src/models/models_1.ts index 04d541628e1f..738e9771fb4d 100644 --- a/clients/client-ec2/src/models/models_1.ts +++ b/clients/client-ec2/src/models/models_1.ts @@ -1978,7 +1978,9 @@ export interface FleetLaunchTemplateOverridesRequest { InstanceRequirements?: InstanceRequirementsRequest; /** - *

The ID of the AMI. An AMI is required to launch an instance. The AMI ID must be specified here or in the launch template.

+ *

The ID of the AMI. An AMI is required to launch an instance. This parameter is only + * available for fleets of type instant. For fleets of type maintain + * and request, you must specify the AMI ID in the launch template.

*/ ImageId?: string; } @@ -3128,7 +3130,9 @@ export interface FleetLaunchTemplateOverrides { InstanceRequirements?: InstanceRequirements; /** - *

The ID of the AMI. An AMI is required to launch an instance. The AMI ID must be specified here or in the launch template.

+ *

The ID of the AMI. An AMI is required to launch an instance. This parameter is only + * available for fleets of type instant. For fleets of type maintain + * and request, you must specify the AMI ID in the launch template.

*/ ImageId?: string; } diff --git a/clients/client-ec2/src/models/models_2.ts b/clients/client-ec2/src/models/models_2.ts index c36edb783520..dfdd8cf31d42 100644 --- a/clients/client-ec2/src/models/models_2.ts +++ b/clients/client-ec2/src/models/models_2.ts @@ -7756,3 +7756,62 @@ export const CreateVerifiedAccessTrustProviderResultFilterSensitiveLog = ( VerifiedAccessTrustProvider: VerifiedAccessTrustProviderFilterSensitiveLog(obj.VerifiedAccessTrustProvider), }), }); + +/** + * @internal + */ +export const VpnTunnelOptionsSpecificationFilterSensitiveLog = (obj: VpnTunnelOptionsSpecification): any => ({ + ...obj, + ...(obj.PreSharedKey && { PreSharedKey: SENSITIVE_STRING }), +}); + +/** + * @internal + */ +export const VpnConnectionOptionsSpecificationFilterSensitiveLog = (obj: VpnConnectionOptionsSpecification): any => ({ + ...obj, + ...(obj.TunnelOptions && { + TunnelOptions: obj.TunnelOptions.map((item) => VpnTunnelOptionsSpecificationFilterSensitiveLog(item)), + }), +}); + +/** + * @internal + */ +export const CreateVpnConnectionRequestFilterSensitiveLog = (obj: CreateVpnConnectionRequest): any => ({ + ...obj, + ...(obj.Options && { Options: VpnConnectionOptionsSpecificationFilterSensitiveLog(obj.Options) }), +}); + +/** + * @internal + */ +export const TunnelOptionFilterSensitiveLog = (obj: TunnelOption): any => ({ + ...obj, + ...(obj.PreSharedKey && { PreSharedKey: SENSITIVE_STRING }), +}); + +/** + * @internal + */ +export const VpnConnectionOptionsFilterSensitiveLog = (obj: VpnConnectionOptions): any => ({ + ...obj, + ...(obj.TunnelOptions && { TunnelOptions: obj.TunnelOptions.map((item) => TunnelOptionFilterSensitiveLog(item)) }), +}); + +/** + * @internal + */ +export const VpnConnectionFilterSensitiveLog = (obj: VpnConnection): any => ({ + ...obj, + ...(obj.CustomerGatewayConfiguration && { CustomerGatewayConfiguration: SENSITIVE_STRING }), + ...(obj.Options && { Options: VpnConnectionOptionsFilterSensitiveLog(obj.Options) }), +}); + +/** + * @internal + */ +export const CreateVpnConnectionResultFilterSensitiveLog = (obj: CreateVpnConnectionResult): any => ({ + ...obj, + ...(obj.VpnConnection && { VpnConnection: VpnConnectionFilterSensitiveLog(obj.VpnConnection) }), +}); diff --git a/clients/client-ec2/src/models/models_3.ts b/clients/client-ec2/src/models/models_3.ts index 60ed3e925060..a9d2a50414e6 100644 --- a/clients/client-ec2/src/models/models_3.ts +++ b/clients/client-ec2/src/models/models_3.ts @@ -6770,6 +6770,11 @@ export interface Host { * Host.

*/ HostMaintenance?: HostMaintenance | string; + + /** + *

The ID of the Outpost hardware asset on which the Dedicated Host is allocated.

+ */ + AssetId?: string; } /** @@ -9055,7 +9060,8 @@ export interface CpuOptions { ThreadsPerCore?: number; /** - *

Indicates whether the instance is enabled for AMD SEV-SNP.

+ *

Indicates whether the instance is enabled for AMD SEV-SNP. For more information, see + * AMD SEV-SNP.

*/ AmdSevSnp?: AmdSevSnpSpecification | string; } diff --git a/clients/client-ec2/src/models/models_4.ts b/clients/client-ec2/src/models/models_4.ts index bdf598db0197..9d992c10da9b 100644 --- a/clients/client-ec2/src/models/models_4.ts +++ b/clients/client-ec2/src/models/models_4.ts @@ -1625,6 +1625,10 @@ export interface DescribeInstanceTypesRequest { * *
  • *

    + * processor-info.supported-features - The supported CPU features (amd-sev-snp).

    + *
    • + *
  • + *

    * supported-boot-mode - The boot mode (legacy-bios | * uefi).

    *
    • @@ -2237,7 +2241,9 @@ export interface ProcessorInfo { /** *

    Indicates whether the instance type supports AMD SEV-SNP. If the request returns - * amd-sev-snp, AMD SEV-SNP is supported. Otherwise, it is not supported.

    + * amd-sev-snp, AMD SEV-SNP is supported. Otherwise, it is not supported. + * For more information, see + * AMD SEV-SNP.

    */ SupportedFeatures?: (SupportedAdditionalProcessorFeature | string)[]; } @@ -2448,6 +2454,10 @@ export interface InstanceTypeInfo { export interface DescribeInstanceTypesResult { /** *

    The instance type. For more information, see Instance types in the Amazon EC2 User Guide.

    + *

    When you change your EBS-backed instance type, instance restart or replacement behavior depends on the + * instance type compatibility between the old and new types. An instance that's backed by an instance store volume + * is always replaced. For more information, see Change the instance type in the + * Amazon EC2 User Guide.

    */ InstanceTypes?: InstanceTypeInfo[]; @@ -8197,7 +8207,9 @@ export interface LaunchTemplateOverrides { */ export interface LaunchTemplateConfig { /** - *

    The launch template.

    + *

    The launch template to use. Make sure that the launch template does not contain the + * NetworkInterfaceId parameter because you can't specify a network interface + * ID in a Spot Fleet.

    */ LaunchTemplateSpecification?: FleetLaunchTemplateSpecification; diff --git a/clients/client-ec2/src/models/models_5.ts b/clients/client-ec2/src/models/models_5.ts index f1af8af0bfa5..87133b037d86 100644 --- a/clients/client-ec2/src/models/models_5.ts +++ b/clients/client-ec2/src/models/models_5.ts @@ -57,6 +57,7 @@ import { Volume, VpcEndpoint, VpnConnection, + VpnConnectionFilterSensitiveLog, VpnGateway, } from "./models_2"; import { @@ -7747,6 +7748,16 @@ export const DescribeVerifiedAccessTrustProvidersResultFilterSensitiveLog = ( }), }); +/** + * @internal + */ +export const DescribeVpnConnectionsResultFilterSensitiveLog = (obj: DescribeVpnConnectionsResult): any => ({ + ...obj, + ...(obj.VpnConnections && { + VpnConnections: obj.VpnConnections.map((item) => VpnConnectionFilterSensitiveLog(item)), + }), +}); + /** * @internal */ diff --git a/clients/client-ec2/src/models/models_6.ts b/clients/client-ec2/src/models/models_6.ts index 39df9d7a331a..6424c0fe5db9 100644 --- a/clients/client-ec2/src/models/models_6.ts +++ b/clients/client-ec2/src/models/models_6.ts @@ -102,6 +102,7 @@ import { VerifiedAccessEndpointProtocol, VerifiedAccessGroup, VpnConnection, + VpnConnectionFilterSensitiveLog, VpnEcmpSupportValue, VpnTunnelLogOptionsSpecification, } from "./models_2"; @@ -2282,10 +2283,11 @@ export interface ModifyInstancePlacementRequest { /** *

    The tenancy for the instance.

    * - *

    For T3 instances, you can't change the tenancy from dedicated to - * host, or from host to dedicated. - * Attempting to make one of these unsupported tenancy changes results in the - * InvalidTenancy error code.

    + *

    For T3 instances, you must launch the instance on a Dedicated Host to use a + * tenancy of host. You can't change the tenancy from + * host to dedicated or default. + * Attempting to make one of these unsupported tenancy changes results in an + * InvalidRequest error code.

    *     */ Tenancy?: HostTenancy | string; @@ -2297,7 +2299,8 @@ export interface ModifyInstancePlacementRequest { PartitionNumber?: number; /** - *

    The ARN of the host resource group in which to place the instance.

    + *

    The ARN of the host resource group in which to place the instance. The instance must + * have a tenancy of host to specify this parameter.

    */ HostResourceGroupArn?: string; @@ -7548,7 +7551,8 @@ export interface CpuOptionsRequest { /** *

    Indicates whether to enable the instance for AMD SEV-SNP. AMD SEV-SNP is supported - * with M6a, R6a, and C6a instance types only.

    + * with M6a, R6a, and C6a instance types only. For more information, see + * AMD SEV-SNP.

    */ AmdSevSnp?: AmdSevSnpSpecification | string; } @@ -7841,6 +7845,10 @@ export interface RunInstancesRequest { /** *

    The instance type. For more information, see Instance types in the * Amazon EC2 User Guide.

    + *

    When you change your EBS-backed instance type, instance restart or replacement behavior depends on the + * instance type compatibility between the old and new types. An instance that's backed by an instance store volume + * is always replaced. For more information, see Change the instance type in the + * Amazon EC2 User Guide.

    *

    Default: m1.small *

    */ @@ -8660,6 +8668,56 @@ export const ModifyVerifiedAccessTrustProviderResultFilterSensitiveLog = ( }), }); +/** + * @internal + */ +export const ModifyVpnConnectionResultFilterSensitiveLog = (obj: ModifyVpnConnectionResult): any => ({ + ...obj, + ...(obj.VpnConnection && { VpnConnection: VpnConnectionFilterSensitiveLog(obj.VpnConnection) }), +}); + +/** + * @internal + */ +export const ModifyVpnConnectionOptionsResultFilterSensitiveLog = (obj: ModifyVpnConnectionOptionsResult): any => ({ + ...obj, + ...(obj.VpnConnection && { VpnConnection: VpnConnectionFilterSensitiveLog(obj.VpnConnection) }), +}); + +/** + * @internal + */ +export const ModifyVpnTunnelCertificateResultFilterSensitiveLog = (obj: ModifyVpnTunnelCertificateResult): any => ({ + ...obj, + ...(obj.VpnConnection && { VpnConnection: VpnConnectionFilterSensitiveLog(obj.VpnConnection) }), +}); + +/** + * @internal + */ +export const ModifyVpnTunnelOptionsSpecificationFilterSensitiveLog = ( + obj: ModifyVpnTunnelOptionsSpecification +): any => ({ + ...obj, + ...(obj.PreSharedKey && { PreSharedKey: SENSITIVE_STRING }), +}); + +/** + * @internal + */ +export const ModifyVpnTunnelOptionsRequestFilterSensitiveLog = (obj: ModifyVpnTunnelOptionsRequest): any => ({ + ...obj, + ...(obj.TunnelOptions && { TunnelOptions: SENSITIVE_STRING }), +}); + +/** + * @internal + */ +export const ModifyVpnTunnelOptionsResultFilterSensitiveLog = (obj: ModifyVpnTunnelOptionsResult): any => ({ + ...obj, + ...(obj.VpnConnection && { VpnConnection: VpnConnectionFilterSensitiveLog(obj.VpnConnection) }), +}); + /** * @internal */ diff --git a/clients/client-ec2/src/protocols/Aws_ec2.ts b/clients/client-ec2/src/protocols/Aws_ec2.ts index 41638af682cc..9e4741edfaee 100644 --- a/clients/client-ec2/src/protocols/Aws_ec2.ts +++ b/clients/client-ec2/src/protocols/Aws_ec2.ts @@ -38081,6 +38081,16 @@ const se_AllocateHostsRequest = (input: AllocateHostsRequest, context: __SerdeCo if (input.HostMaintenance != null) { entries["HostMaintenance"] = input.HostMaintenance; } + if (input.AssetIds != null) { + const memberEntries = se_AssetIdList(input.AssetIds, context); + if (input.AssetIds?.length === 0) { + entries.AssetId = []; + } + Object.entries(memberEntries).forEach(([key, value]) => { + const loc = `AssetId.${key.substring(key.indexOf(".") + 1)}`; + entries[loc] = value; + }); + } return entries; }; @@ -38236,6 +38246,22 @@ const se_ArnList = (input: string[], context: __SerdeContext): any => { return entries; }; +/** + * serializeAws_ec2AssetIdList + */ +const se_AssetIdList = (input: string[], context: __SerdeContext): any => { + const entries: any = {}; + let counter = 1; + for (const entry of input) { + if (entry === null) { + continue; + } + entries[`Member.${counter}`] = entry; + counter++; + } + return entries; +}; + /** * serializeAws_ec2AssignIpv6AddressesRequest */ @@ -77801,6 +77827,9 @@ const de_Host = (output: any, context: __SerdeContext): Host => { if (output["hostMaintenance"] !== undefined) { contents.HostMaintenance = __expectString(output["hostMaintenance"]); } + if (output["assetId"] !== undefined) { + contents.AssetId = __expectString(output["assetId"]); + } return contents; }; diff --git a/codegen/sdk-codegen/aws-models/ec2.json b/codegen/sdk-codegen/aws-models/ec2.json index c5a332f18883..3a624a6ce031 100644 --- a/codegen/sdk-codegen/aws-models/ec2.json +++ b/codegen/sdk-codegen/aws-models/ec2.json @@ -1535,20 +1535,7 @@ "target": "com.amazonaws.ec2#AllocateAddressResult" }, "traits": { - "smithy.api#documentation": "

    Allocates an Elastic IP address to your Amazon Web Services account. After you allocate the Elastic IP address you can associate \n it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address \n pool and can be allocated to a different Amazon Web Services account.

    \n

    You can allocate an Elastic IP address from an address pool owned by Amazon Web Services or from an address pool created \n from a public IPv4 address range that you have brought to Amazon Web Services for use with your Amazon Web Services resources using bring your own \n IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

    \n

    If you release an Elastic IP address, you might be able to recover it. You cannot recover\n an Elastic IP address that you released after it is allocated to another Amazon Web Services account. To attempt to recover an Elastic IP address that you released, specify\n it in this operation.

    \n

    For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    \n

    You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, \n to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

    ", - "smithy.api#examples": [ - { - "title": "To allocate an Elastic IP address", - "documentation": "This example allocates an Elastic IP address.", - "output": { - "PublicIp": "203.0.113.0", - "AllocationId": "eipalloc-64d5890a", - "PublicIpv4Pool": "amazon", - "NetworkBorderGroup": "us-east-1", - "Domain": "vpc" - } - } - ] + "smithy.api#documentation": "

    Allocates an Elastic IP address to your Amazon Web Services account. After you allocate the Elastic IP address you can associate \n it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address \n pool and can be allocated to a different Amazon Web Services account.

    \n

    You can allocate an Elastic IP address from an address pool owned by Amazon Web Services or from an address pool created \n from a public IPv4 address range that you have brought to Amazon Web Services for use with your Amazon Web Services resources using bring your own \n IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

    \n

    If you release an Elastic IP address, you might be able to recover it. You cannot recover\n an Elastic IP address that you released after it is allocated to another Amazon Web Services account. To attempt to recover an Elastic IP address that you released, specify\n it in this operation.

    \n

    For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    \n

    You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, \n to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

    " } }, "com.amazonaws.ec2#AllocateAddressRequest": { @@ -1739,8 +1726,7 @@ "aws.protocols#ec2QueryName": "Quantity", "smithy.api#clientOptional": {}, "smithy.api#default": 0, - "smithy.api#documentation": "

    The number of Dedicated Hosts to allocate to your account with these\n parameters.

    ", - "smithy.api#required": {}, + "smithy.api#documentation": "

    The number of Dedicated Hosts to allocate to your account with these parameters. If you are \n allocating the Dedicated Hosts on an Outpost, and you specify AssetIds, \n you can omit this parameter. In this case, Amazon EC2 allocates a Dedicated Host on each \n specified hardware asset. If you specify both AssetIds and \n Quantity, then the value that you specify for \n Quantity must be equal to the number of asset IDs specified.

    ", "smithy.api#xmlName": "quantity" } }, @@ -1760,7 +1746,7 @@ "OutpostArn": { "target": "com.amazonaws.ec2#String", "traits": { - "smithy.api#documentation": "

    The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate\n the Dedicated Host.

    " + "smithy.api#documentation": "

    The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate\n the Dedicated Host. If you specify OutpostArn, you can \n optionally specify AssetIds.

    \n

    If you are allocating the Dedicated Host in a Region, omit this parameter.

    " } }, "HostMaintenance": { @@ -1768,6 +1754,13 @@ "traits": { "smithy.api#documentation": "

    Indicates whether to enable or disable host maintenance for the Dedicated Host. For\n more information, see Host\n maintenance in the Amazon EC2 User Guide.

    " } + }, + "AssetIds": { + "target": "com.amazonaws.ec2#AssetIdList", + "traits": { + "smithy.api#documentation": "

    The IDs of the Outpost hardware assets on which to allocate the Dedicated Hosts. Targeting \n specific hardware assets on an Outpost can help to minimize latency between your workloads. \n This parameter is supported only if you specify OutpostArn. \n If you are allocating the Dedicated Hosts in a Region, omit this parameter.

    \n ", + "smithy.api#xmlName": "AssetId" + } } }, "traits": { @@ -5673,6 +5666,15 @@ } } }, + "com.amazonaws.ec2#AssetId": { + "type": "string" + }, + "com.amazonaws.ec2#AssetIdList": { + "type": "list", + "member": { + "target": "com.amazonaws.ec2#AssetId" + } + }, "com.amazonaws.ec2#AssignIpv6Addresses": { "type": "operation", "input": { @@ -5983,20 +5985,7 @@ "target": "com.amazonaws.ec2#AssociateAddressResult" }, "traits": { - "smithy.api#documentation": "

    Associates an Elastic IP address, or carrier IP address (for instances that are in\n subnets in Wavelength Zones) with an instance or a network interface. Before you can use an\n Elastic IP address, you must allocate it to your account.

    \n

    If the Elastic IP address is already\n associated with a different instance, it is disassociated from that instance and associated\n with the specified instance. If you associate an Elastic IP address with an instance that has\n an existing Elastic IP address, the existing address is disassociated from the instance, but\n remains allocated to your account.

    \n

    [Subnets in Wavelength Zones] You can associate an IP address from the telecommunication\n carrier to the instance or network interface.

    \n

    You cannot associate an Elastic IP address with an interface in a different network border group.

    \n \n

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2\n doesn't return an error, and you may be charged for each time the Elastic IP address is\n remapped to the same instance. For more information, see the Elastic IP\n Addresses section of Amazon EC2\n Pricing.

    \n     ", - "smithy.api#examples": [ - { - "title": "To associate an Elastic IP address", - "documentation": "This example associates the specified Elastic IP address with the specified instance.", - "input": { - "AllocationId": "eipalloc-64d5890a", - "InstanceId": "i-0b263919b6498b123" - }, - "output": { - "AssociationId": "eipassoc-2bebb745" - } - } - ] + "smithy.api#documentation": "

    Associates an Elastic IP address, or carrier IP address (for instances that are in\n subnets in Wavelength Zones) with an instance or a network interface. Before you can use an\n Elastic IP address, you must allocate it to your account.

    \n

    If the Elastic IP address is already\n associated with a different instance, it is disassociated from that instance and associated\n with the specified instance. If you associate an Elastic IP address with an instance that has\n an existing Elastic IP address, the existing address is disassociated from the instance, but\n remains allocated to your account.

    \n

    [Subnets in Wavelength Zones] You can associate an IP address from the telecommunication\n carrier to the instance or network interface.

    \n

    You cannot associate an Elastic IP address with an interface in a different network border group.

    \n \n

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2\n doesn't return an error, and you may be charged for each time the Elastic IP address is\n remapped to the same instance. For more information, see the Elastic IP\n Addresses section of Amazon EC2\n Pricing.

    \n     " } }, "com.amazonaws.ec2#AssociateAddressRequest": { @@ -6161,17 +6150,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

    \n

    After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

    \n

    For more information, see DHCP options sets\n in the Amazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To associate a DHCP options set with a VPC", - "documentation": "This example associates the specified DHCP options set with the specified VPC.", - "input": { - "DhcpOptionsId": "dopt-d9070ebb", - "VpcId": "vpc-a01106c2" - } - } - ] + "smithy.api#documentation": "

    Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

    \n

    After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

    \n

    For more information, see DHCP options sets\n in the Amazon Virtual Private Cloud User Guide.

    " } }, "com.amazonaws.ec2#AssociateDhcpOptionsRequest": { @@ -6293,30 +6272,7 @@ "target": "com.amazonaws.ec2#AssociateIamInstanceProfileResult" }, "traits": { - "smithy.api#documentation": "

    Associates an IAM instance profile with a running or stopped instance. You cannot\n associate more than one IAM instance profile with an instance.

    ", - "smithy.api#examples": [ - { - "title": "To associate an IAM instance profile with an instance", - "documentation": "This example associates an IAM instance profile named admin-role with the specified instance.", - "input": { - "IamInstanceProfile": { - "Name": "admin-role" - }, - "InstanceId": "i-123456789abcde123" - }, - "output": { - "IamInstanceProfileAssociation": { - "InstanceId": "i-123456789abcde123", - "State": "associating", - "AssociationId": "iip-assoc-0e7736511a163c209", - "IamInstanceProfile": { - "Id": "AIPAJBLK7RKJKWDXVHIEC", - "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" - } - } - } - } - ] + "smithy.api#documentation": "

    Associates an IAM instance profile with a running or stopped instance. You cannot\n associate more than one IAM instance profile with an instance.

    " } }, "com.amazonaws.ec2#AssociateIamInstanceProfileRequest": { @@ -7636,25 +7592,7 @@ "target": "com.amazonaws.ec2#VolumeAttachment" }, "traits": { - "smithy.api#documentation": "

    Attaches an EBS volume to a running or stopped instance and exposes it to the instance\n with the specified device name.

    \n

    Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For\n more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.

    \n

    After you attach an EBS volume, you must make it available. For more information, see \n Make an EBS volume available for use.

    \n

    If a volume has an Amazon Web Services Marketplace product code:

    \n \n

    For more information, see Attach an Amazon EBS volume to an instance in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To attach a volume to an instance", - "documentation": "This example attaches a volume (``vol-1234567890abcdef0``) to an instance (``i-01474ef662b89480``) as ``/dev/sdf``.", - "input": { - "VolumeId": "vol-1234567890abcdef0", - "InstanceId": "i-01474ef662b89480", - "Device": "/dev/sdf" - }, - "output": { - "AttachTime": "2016-08-29T18:52:32.724Z", - "InstanceId": "i-01474ef662b89480", - "VolumeId": "vol-1234567890abcdef0", - "State": "attaching", - "Device": "/dev/sdf" - } - } - ] + "smithy.api#documentation": "

    Attaches an EBS volume to a running or stopped instance and exposes it to the instance\n with the specified device name.

    \n

    Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For\n more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.

    \n

    After you attach an EBS volume, you must make it available. For more information, see \n Make an EBS volume available for use.

    \n

    If a volume has an Amazon Web Services Marketplace product code:

    \n \n

    For more information, see Attach an Amazon EBS volume to an instance in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#AttachVolumeRequest": { @@ -8166,30 +8104,7 @@ "target": "com.amazonaws.ec2#AuthorizeSecurityGroupIngressResult" }, "traits": { - "smithy.api#documentation": "

    Adds the specified inbound (ingress) rules to a security group.

    \n

    An inbound rule permits instances to receive traffic from the specified IPv4 or IPv6 CIDR\n address range, or from the instances that are associated with the specified destination security \n groups. When specifying an inbound rule for your security group in a VPC, the\n IpPermissions must include a source for the traffic.

    \n

    You specify a protocol for each rule (for example, TCP). \n For TCP and UDP, you must also specify the destination port or port range. \n For ICMP/ICMPv6, you must also specify the ICMP/ICMPv6 type and code. \n You can use -1 to mean all types or all codes.

    \n

    Rule changes are propagated to instances within the security group as quickly as possible. \n However, a small delay might occur.

    \n

    For more information about VPC security group quotas, see Amazon VPC quotas.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     ", - "smithy.api#examples": [ - { - "title": "To add a rule that allows inbound SSH traffic from an IPv4 address range", - "documentation": "This example enables inbound traffic on TCP port 22 (SSH). The rule includes a description to help you identify it later.", - "input": { - "GroupId": "sg-903004f8", - "IpPermissions": [ - { - "IpProtocol": "tcp", - "FromPort": 22, - "ToPort": 22, - "IpRanges": [ - { - "CidrIp": "203.0.113.0/24", - "Description": "SSH access from the LA office" - } - ] - } - ] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Adds the specified inbound (ingress) rules to a security group.

    \n

    An inbound rule permits instances to receive traffic from the specified IPv4 or IPv6 CIDR\n address range, or from the instances that are associated with the specified destination security \n groups. When specifying an inbound rule for your security group in a VPC, the\n IpPermissions must include a source for the traffic.

    \n

    You specify a protocol for each rule (for example, TCP). \n For TCP and UDP, you must also specify the destination port or port range. \n For ICMP/ICMPv6, you must also specify the ICMP/ICMPv6 type and code. \n You can use -1 to mean all types or all codes.

    \n

    Rule changes are propagated to instances within the security group as quickly as possible. \n However, a small delay might occur.

    \n

    For more information about VPC security group quotas, see Amazon VPC quotas.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     " } }, "com.amazonaws.ec2#AuthorizeSecurityGroupIngressRequest": { @@ -12370,20 +12285,7 @@ "target": "com.amazonaws.ec2#ConfirmProductInstanceResult" }, "traits": { - "smithy.api#documentation": "

    Determines whether a product code is associated with an instance. This action can only\n be used by the owner of the product code. It is useful when a product code owner must\n verify whether another user's instance is eligible for support.

    ", - "smithy.api#examples": [ - { - "title": "To confirm the product instance", - "documentation": "This example determines whether the specified product code is associated with the specified instance.", - "input": { - "ProductCode": "774F4FF8", - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "OwnerId": "123456789012" - } - } - ] + "smithy.api#documentation": "

    Determines whether a product code is associated with an instance. This action can only\n be used by the owner of the product code. It is useful when a product code owner must\n verify whether another user's instance is eligible for support.

    " } }, "com.amazonaws.ec2#ConfirmProductInstanceRequest": { @@ -12835,22 +12737,7 @@ "target": "com.amazonaws.ec2#CopyImageResult" }, "traits": { - "smithy.api#documentation": "

    Initiates the copy of an AMI. You can copy an AMI from one Region to another, or from a\n Region to an Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost\n to another, or within the same Outpost. To copy an AMI to another partition, see CreateStoreImageTask.

    \n

    To copy an AMI from one Region to another, specify the source Region using the \n \t\tSourceRegion parameter, and specify the \n \t\tdestination Region using its endpoint. Copies of encrypted backing snapshots for\n \t\tthe AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, \n \t\tunless you set Encrypted during the copy operation. You cannot \n \t\tcreate an unencrypted copy of an encrypted backing snapshot.

    \n

    To copy an AMI from a Region to an Outpost, specify the source Region using the \n \t\tSourceRegion parameter, and specify the \n \t\tARN of the destination Outpost using DestinationOutpostArn. \n \t\tBacking snapshots copied to an Outpost are encrypted by default using the default\n \t\tencryption key for the Region, or a different key that you specify in the request using \n \t\tKmsKeyId. Outposts do not support unencrypted \n \t\tsnapshots. For more information, \n \t\t\tAmazon EBS local snapshots on Outposts in the Amazon EC2 User Guide.

    \n

    For more information about the prerequisites and limits when copying an AMI, see Copy an AMI in the\n Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To copy an AMI to another region", - "documentation": "This example copies the specified AMI from the us-east-1 region to the current region.", - "input": { - "Description": "", - "Name": "My server", - "SourceImageId": "ami-5731123e", - "SourceRegion": "us-east-1" - }, - "output": { - "ImageId": "ami-438bea42" - } - } - ] + "smithy.api#documentation": "

    Initiates the copy of an AMI. You can copy an AMI from one Region to another, or from a\n Region to an Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost\n to another, or within the same Outpost. To copy an AMI to another partition, see CreateStoreImageTask.

    \n

    To copy an AMI from one Region to another, specify the source Region using the \n \t\tSourceRegion parameter, and specify the \n \t\tdestination Region using its endpoint. Copies of encrypted backing snapshots for\n \t\tthe AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, \n \t\tunless you set Encrypted during the copy operation. You cannot \n \t\tcreate an unencrypted copy of an encrypted backing snapshot.

    \n

    To copy an AMI from a Region to an Outpost, specify the source Region using the \n \t\tSourceRegion parameter, and specify the \n \t\tARN of the destination Outpost using DestinationOutpostArn. \n \t\tBacking snapshots copied to an Outpost are encrypted by default using the default\n \t\tencryption key for the Region, or a different key that you specify in the request using \n \t\tKmsKeyId. Outposts do not support unencrypted \n \t\tsnapshots. For more information, \n \t\t\tAmazon EBS local snapshots on Outposts in the Amazon EC2 User Guide.

    \n

    For more information about the prerequisites and limits when copying an AMI, see Copy an AMI in the\n Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#CopyImageRequest": { @@ -12966,22 +12853,7 @@ "target": "com.amazonaws.ec2#CopySnapshotResult" }, "traits": { - "smithy.api#documentation": "

    Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy a\n snapshot within the same Region, from one Region to another, or from a Region to an Outpost. \n You can't copy a snapshot from an Outpost to a Region, from one Outpost to another, or within \n the same Outpost.

    \n

    You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).

    \n

    When copying snapshots to a Region, copies of encrypted EBS snapshots remain encrypted. \n \tCopies of unencrypted snapshots remain unencrypted, unless you enable encryption for the \n \tsnapshot copy operation. By default, encrypted snapshot copies use the default Key Management Service (KMS) \n \tKMS key; however, you can specify a different KMS key. To copy an encrypted \n \tsnapshot that has been shared from another account, you must have permissions for the KMS key \n \tused to encrypt the snapshot.

    \n

    Snapshots copied to an Outpost are encrypted by default using the default\n \t\tencryption key for the Region, or a different key that you specify in the request using \n \t\tKmsKeyId. Outposts do not support unencrypted \n \t\tsnapshots. For more information, \n \t\t\tAmazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.

    \n

    Snapshots created by copying another snapshot have an arbitrary volume ID that should not\n be used for any purpose.

    \n

    For more information, see Copy an Amazon EBS snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To copy a snapshot", - "documentation": "This example copies a snapshot with the snapshot ID of ``snap-066877671789bd71b`` from the ``us-west-2`` region to the ``us-east-1`` region and adds a short description to identify the snapshot.", - "input": { - "SourceRegion": "us-west-2", - "SourceSnapshotId": "snap-066877671789bd71b", - "Description": "This is my copied snapshot.", - "DestinationRegion": "us-east-1" - }, - "output": { - "SnapshotId": "snap-066877671789bd71b" - } - } - ] + "smithy.api#documentation": "

    Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy a\n snapshot within the same Region, from one Region to another, or from a Region to an Outpost. \n You can't copy a snapshot from an Outpost to a Region, from one Outpost to another, or within \n the same Outpost.

    \n

    You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).

    \n

    When copying snapshots to a Region, copies of encrypted EBS snapshots remain encrypted. \n \tCopies of unencrypted snapshots remain unencrypted, unless you enable encryption for the \n \tsnapshot copy operation. By default, encrypted snapshot copies use the default Key Management Service (KMS) \n \tKMS key; however, you can specify a different KMS key. To copy an encrypted \n \tsnapshot that has been shared from another account, you must have permissions for the KMS key \n \tused to encrypt the snapshot.

    \n

    Snapshots copied to an Outpost are encrypted by default using the default\n \t\tencryption key for the Region, or a different key that you specify in the request using \n \t\tKmsKeyId. Outposts do not support unencrypted \n \t\tsnapshots. For more information, \n \t\t\tAmazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.

    \n

    Snapshots created by copying another snapshot have an arbitrary volume ID that should not\n be used for any purpose.

    \n

    For more information, see Copy an Amazon EBS snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CopySnapshotRequest": { @@ -13186,7 +13058,7 @@ "target": "com.amazonaws.ec2#AmdSevSnpSpecification", "traits": { "aws.protocols#ec2QueryName": "AmdSevSnp", - "smithy.api#documentation": "

    Indicates whether the instance is enabled for AMD SEV-SNP.

    ", + "smithy.api#documentation": "

    Indicates whether the instance is enabled for AMD SEV-SNP. For more information, see \n AMD SEV-SNP.

    ", "smithy.api#xmlName": "amdSevSnp" } } @@ -13217,7 +13089,7 @@ "AmdSevSnp": { "target": "com.amazonaws.ec2#AmdSevSnpSpecification", "traits": { - "smithy.api#documentation": "

    Indicates whether to enable the instance for AMD SEV-SNP. AMD SEV-SNP is supported \n with M6a, R6a, and C6a instance types only.

    " + "smithy.api#documentation": "

    Indicates whether to enable the instance for AMD SEV-SNP. AMD SEV-SNP is supported \n with M6a, R6a, and C6a instance types only. For more information, see \n AMD SEV-SNP.

    " } } }, @@ -14009,27 +13881,7 @@ "target": "com.amazonaws.ec2#CreateCustomerGatewayResult" }, "traits": { - "smithy.api#documentation": "

    Provides information to Amazon Web Services about your customer gateway device. The\n customer gateway device is the appliance at your end of the VPN connection. You\n must provide the IP address of the customer gateway device’s external\n interface. The IP address must be static and can be behind a device performing network\n address translation (NAT).

    \n

    For devices that use Border Gateway Protocol (BGP), you can also provide the device's\n BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network.\n If you don't have an ASN already, you can use a private ASN. For more information, see \n Customer gateway \n options for your Site-to-Site VPN connection in the Amazon Web Services Site-to-Site VPN User Guide.

    \n

    To create more than one customer gateway with the same VPN type, IP address, and\n BGP ASN, specify a unique device name for each customer gateway. An identical request\n returns information about the existing customer gateway; it doesn't create a new customer\n gateway.

    ", - "smithy.api#examples": [ - { - "title": "To create a customer gateway", - "documentation": "This example creates a customer gateway with the specified IP address for its outside interface.", - "input": { - "Type": "ipsec.1", - "PublicIp": "12.1.2.3", - "BgpAsn": 65534 - }, - "output": { - "CustomerGateway": { - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1", - "BgpAsn": "65534" - } - } - } - ] + "smithy.api#documentation": "

    Provides information to Amazon Web Services about your customer gateway device. The\n customer gateway device is the appliance at your end of the VPN connection. You\n must provide the IP address of the customer gateway device’s external\n interface. The IP address must be static and can be behind a device performing network\n address translation (NAT).

    \n

    For devices that use Border Gateway Protocol (BGP), you can also provide the device's\n BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network.\n If you don't have an ASN already, you can use a private ASN. For more information, see \n Customer gateway \n options for your Site-to-Site VPN connection in the Amazon Web Services Site-to-Site VPN User Guide.

    \n

    To create more than one customer gateway with the same VPN type, IP address, and\n BGP ASN, specify a unique device name for each customer gateway. An identical request\n returns information about the existing customer gateway; it doesn't create a new customer\n gateway.

    " } }, "com.amazonaws.ec2#CreateCustomerGatewayRequest": { @@ -14228,39 +14080,7 @@ "target": "com.amazonaws.ec2#CreateDhcpOptionsResult" }, "traits": { - "smithy.api#documentation": "

    Creates a set of DHCP options for your VPC. After creating the set, you must\n\t\t\t\tassociate it with the VPC, causing all existing and new instances that you launch in\n\t\t\t\tthe VPC to use this set of DHCP options. The following are the individual DHCP\n\t\t\t\toptions you can specify. For more information about the options, see RFC 2132.

    \n \n

    Your VPC automatically starts out with a set of DHCP options that includes only a DNS\n\t\t\tserver that we provide (AmazonProvidedDNS). If you create a set of options, and if your\n\t\t\tVPC has an internet gateway, make sure to set the domain-name-servers\n\t\t\toption either to AmazonProvidedDNS or to a domain name server of your\n\t\t\tchoice. For more information, see DHCP options sets in the\n\t\t\tAmazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a DHCP options set", - "documentation": "This example creates a DHCP options set.", - "input": { - "DhcpConfigurations": [ - { - "Key": "domain-name-servers", - "Values": ["10.2.5.1", "10.2.5.2"] - } - ] - }, - "output": { - "DhcpOptions": { - "DhcpConfigurations": [ - { - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ], - "Key": "domain-name-servers" - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - } - } - ] + "smithy.api#documentation": "

    Creates a set of DHCP options for your VPC. After creating the set, you must\n\t\t\t\tassociate it with the VPC, causing all existing and new instances that you launch in\n\t\t\t\tthe VPC to use this set of DHCP options. The following are the individual DHCP\n\t\t\t\toptions you can specify. For more information about the options, see RFC 2132.

    \n \n

    Your VPC automatically starts out with a set of DHCP options that includes only a DNS\n\t\t\tserver that we provide (AmazonProvidedDNS). If you create a set of options, and if your\n\t\t\tVPC has an internet gateway, make sure to set the domain-name-servers\n\t\t\toption either to AmazonProvidedDNS or to a domain name server of your\n\t\t\tchoice. For more information, see DHCP options sets in the\n\t\t\tAmazon Virtual Private Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateDhcpOptionsRequest": { @@ -14396,7 +14216,7 @@ "target": "com.amazonaws.ec2#CreateFleetResult" }, "traits": { - "smithy.api#documentation": "

    Launches an EC2 Fleet.

    \n

    You can create a single EC2 Fleet that includes multiple launch specifications that vary by\n instance type, AMI, Availability Zone, or subnet.

    \n

    For more information, see EC2 Fleet in the Amazon EC2 User Guide.

    " + "smithy.api#documentation": "

    Creates an EC2 Fleet that contains the configuration information for On-Demand Instances and Spot Instances.\n Instances are launched immediately if there is available capacity.

    \n

    A single EC2 Fleet can include multiple launch specifications that vary by instance type,\n AMI, Availability Zone, or subnet.

    \n

    For more information, see EC2 Fleet in the Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#CreateFleetError": { @@ -15225,20 +15045,7 @@ "target": "com.amazonaws.ec2#CreateInternetGatewayResult" }, "traits": { - "smithy.api#documentation": "

    Creates an internet gateway for use with a VPC. After creating the internet gateway,\n\t\t\tyou attach it to a VPC using AttachInternetGateway.

    \n

    For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create an Internet gateway", - "documentation": "This example creates an Internet gateway.", - "output": { - "InternetGateway": { - "Tags": [], - "InternetGatewayId": "igw-c0a643a9", - "Attachments": [] - } - } - } - ] + "smithy.api#documentation": "

    Creates an internet gateway for use with a VPC. After creating the internet gateway,\n\t\t\tyou attach it to a VPC using AttachInternetGateway.

    \n

    For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateInternetGatewayRequest": { @@ -15656,16 +15463,7 @@ "target": "com.amazonaws.ec2#KeyPair" }, "traits": { - "smithy.api#documentation": "

    Creates an ED25519 or 2048-bit RSA key pair with the specified name and in the\n specified PEM or PPK format. Amazon EC2 stores the public key and displays the private\n key for you to save to a file. The private key is returned as an unencrypted PEM encoded\n PKCS#1 private key or an unencrypted PPK formatted private key for use with PuTTY. If a\n key with the specified name already exists, Amazon EC2 returns an error.

    \n

    The key pair returned to you is available only in the Amazon Web Services Region in which you create it.\n If you prefer, you can create your own key pair using a third-party tool and upload it\n to any Region using ImportKeyPair.

    \n

    You can have up to 5,000 key pairs per Amazon Web Services Region.

    \n

    For more information, see Amazon EC2 key pairs in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a key pair", - "documentation": "This example creates a key pair named my-key-pair.", - "input": { - "KeyName": "my-key-pair" - } - } - ] + "smithy.api#documentation": "

    Creates an ED25519 or 2048-bit RSA key pair with the specified name and in the\n specified PEM or PPK format. Amazon EC2 stores the public key and displays the private\n key for you to save to a file. The private key is returned as an unencrypted PEM encoded\n PKCS#1 private key or an unencrypted PPK formatted private key for use with PuTTY. If a\n key with the specified name already exists, Amazon EC2 returns an error.

    \n

    The key pair returned to you is available only in the Amazon Web Services Region in which you create it.\n If you prefer, you can create your own key pair using a third-party tool and upload it\n to any Region using ImportKeyPair.

    \n

    You can have up to 5,000 key pairs per Amazon Web Services Region.

    \n

    For more information, see Amazon EC2 key pairs in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateKeyPairRequest": { @@ -15722,50 +15520,7 @@ "target": "com.amazonaws.ec2#CreateLaunchTemplateResult" }, "traits": { - "smithy.api#documentation": "

    Creates a launch template.

    \n

    A launch template contains the parameters to launch an instance. When you launch an\n instance using RunInstances, you can specify a launch template instead\n of providing the launch parameters in the request. For more information, see Launch\n an instance from a launch template in the\n Amazon Elastic Compute Cloud User Guide.

    \n

    If you want to clone an existing launch template as the basis for creating a new\n launch template, you can use the Amazon EC2 console. The API, SDKs, and CLI do not support\n cloning a template. For more information, see Create a launch template from an existing launch template in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a launch template", - "documentation": "This example creates a launch template that specifies the subnet in which to launch the instance, assigns a public IP address and an IPv6 address to the instance, and creates a tag for the instance.", - "input": { - "LaunchTemplateName": "my-template", - "VersionDescription": "WebVersion1", - "LaunchTemplateData": { - "NetworkInterfaces": [ - { - "AssociatePublicIpAddress": true, - "DeviceIndex": 0, - "Ipv6AddressCount": 1, - "SubnetId": "subnet-7b16de0c" - } - ], - "ImageId": "ami-8c1be5f6", - "InstanceType": "t2.small", - "TagSpecifications": [ - { - "ResourceType": "instance", - "Tags": [ - { - "Key": "Name", - "Value": "webserver" - } - ] - } - ] - } - }, - "output": { - "LaunchTemplate": { - "LatestVersionNumber": 1, - "LaunchTemplateId": "lt-01238c059e3466abc", - "LaunchTemplateName": "my-template", - "DefaultVersionNumber": 1, - "CreatedBy": "arn:aws:iam::123456789012:root", - "CreateTime": "2017-11-27T09:13:24.000Z" - } - } - } - ] + "smithy.api#documentation": "

    Creates a launch template.

    \n

    A launch template contains the parameters to launch an instance. When you launch an\n instance using RunInstances, you can specify a launch template instead\n of providing the launch parameters in the request. For more information, see Launch\n an instance from a launch template in the\n Amazon Elastic Compute Cloud User Guide.

    \n

    If you want to clone an existing launch template as the basis for creating a new\n launch template, you can use the Amazon EC2 console. The API, SDKs, and CLI do not support\n cloning a template. For more information, see Create a launch template from an existing launch template in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateLaunchTemplateRequest": { @@ -15852,48 +15607,7 @@ "target": "com.amazonaws.ec2#CreateLaunchTemplateVersionResult" }, "traits": { - "smithy.api#documentation": "

    Creates a new version of a launch template. You can specify an existing version of\n launch template from which to base the new version.

    \n

    Launch template versions are numbered in the order in which they are created. You\n cannot specify, change, or replace the numbering of launch template versions.

    \n

    Launch templates are immutable; after you create a launch template, you can't modify\n it. Instead, you can create a new version of the launch template that includes any\n changes you require.

    \n

    For more information, see Modify a launch template (manage launch template versions) in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a launch template version", - "documentation": "This example creates a new launch template version based on version 1 of the specified launch template and specifies a different AMI ID.", - "input": { - "LaunchTemplateId": "lt-0abcd290751193123", - "SourceVersion": "1", - "VersionDescription": "WebVersion2", - "LaunchTemplateData": { - "ImageId": "ami-c998b6b2" - } - }, - "output": { - "LaunchTemplateVersion": { - "VersionDescription": "WebVersion2", - "LaunchTemplateId": "lt-0abcd290751193123", - "LaunchTemplateName": "my-template", - "VersionNumber": 2, - "CreatedBy": "arn:aws:iam::123456789012:root", - "LaunchTemplateData": { - "ImageId": "ami-c998b6b2", - "InstanceType": "t2.micro", - "NetworkInterfaces": [ - { - "Ipv6Addresses": [ - { - "Ipv6Address": "2001:db8:1234:1a00::123" - } - ], - "DeviceIndex": 0, - "SubnetId": "subnet-7b16de0c", - "AssociatePublicIpAddress": true - } - ] - }, - "DefaultVersion": false, - "CreateTime": "2017-12-01T13:35:46.000Z" - } - } - } - ] + "smithy.api#documentation": "

    Creates a new version of a launch template. You can specify an existing version of\n launch template from which to base the new version.

    \n

    Launch template versions are numbered in the order in which they are created. You\n cannot specify, change, or replace the numbering of launch template versions.

    \n

    Launch templates are immutable; after you create a launch template, you can't modify\n it. Instead, you can create a new version of the launch template that includes any\n changes you require.

    \n

    For more information, see Modify a launch template (manage launch template versions) in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateLaunchTemplateVersionRequest": { @@ -16356,31 +16070,7 @@ "target": "com.amazonaws.ec2#CreateNatGatewayResult" }, "traits": { - "smithy.api#documentation": "

    Creates a NAT gateway in the specified subnet. This action creates a network interface\n in the specified subnet with a private IP address from the IP address range of the\n subnet. You can create either a public NAT gateway or a private NAT gateway.

    \n

    With a public NAT gateway, internet-bound traffic from a private subnet can be routed\n to the NAT gateway, so that instances in a private subnet can connect to the internet.

    \n

    With a private NAT gateway, private communication is routed across VPCs and on-premises\n networks through a transit gateway or virtual private gateway. Common use cases include\n running large workloads behind a small pool of allowlisted IPv4 addresses, preserving\n private IPv4 addresses, and communicating between overlapping networks.

    \n

    For more information, see NAT gateways in the Amazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a NAT gateway", - "documentation": "This example creates a NAT gateway in subnet subnet-1a2b3c4d and associates an Elastic IP address with the allocation ID eipalloc-37fc1a52 with the NAT gateway.", - "input": { - "SubnetId": "subnet-1a2b3c4d", - "AllocationId": "eipalloc-37fc1a52" - }, - "output": { - "NatGateway": { - "NatGatewayAddresses": [ - { - "AllocationId": "eipalloc-37fc1a52" - } - ], - "VpcId": "vpc-1122aabb", - "State": "pending", - "NatGatewayId": "nat-08d48af2a8e83edfd", - "SubnetId": "subnet-1a2b3c4d", - "CreateTime": "2015-12-17T12:45:26.732Z" - } - } - } - ] + "smithy.api#documentation": "

    Creates a NAT gateway in the specified subnet. This action creates a network interface\n in the specified subnet with a private IP address from the IP address range of the\n subnet. You can create either a public NAT gateway or a private NAT gateway.

    \n

    With a public NAT gateway, internet-bound traffic from a private subnet can be routed\n to the NAT gateway, so that instances in a private subnet can connect to the internet.

    \n

    With a private NAT gateway, private communication is routed across VPCs and on-premises\n networks through a transit gateway or virtual private gateway. Common use cases include\n running large workloads behind a small pool of allowlisted IPv4 addresses, preserving\n private IPv4 addresses, and communicating between overlapping networks.

    \n

    For more information, see NAT gateways in the Amazon Virtual Private Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateNatGatewayRequest": { @@ -17113,18 +16803,7 @@ "target": "com.amazonaws.ec2#CreatePlacementGroupResult" }, "traits": { - "smithy.api#documentation": "

    Creates a placement group in which to launch instances. The strategy of the placement\n group determines how the instances are organized within the group.

    \n

    A cluster placement group is a logical grouping of instances within a\n single Availability Zone that benefit from low network latency, high network throughput.\n A spread placement group places instances on distinct hardware. A\n partition placement group places groups of instances in different\n partitions, where instances in one partition do not share the same hardware with\n instances in another partition.

    \n

    For more information, see Placement groups in the\n Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a placement group", - "documentation": "This example creates a placement group with the specified name.", - "input": { - "GroupName": "my-cluster", - "Strategy": "cluster" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Creates a placement group in which to launch instances. The strategy of the placement\n group determines how the instances are organized within the group.

    \n

    A cluster placement group is a logical grouping of instances within a\n single Availability Zone that benefit from low network latency, high network throughput.\n A spread placement group places instances on distinct hardware. A\n partition placement group places groups of instances in different\n partitions, where instances in one partition do not share the same hardware with\n instances in another partition.

    \n

    For more information, see Placement groups in the\n Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#CreatePlacementGroupRequest": { @@ -17717,21 +17396,7 @@ "target": "com.amazonaws.ec2#CreateSecurityGroupResult" }, "traits": { - "smithy.api#documentation": "

    Creates a security group.

    \n

    A security group acts as a virtual firewall for your instance to control inbound and outbound traffic.\n For more information, see\n\t\t\t\tAmazon EC2 security groups in \n\t\t\t\tthe Amazon Elastic Compute Cloud User Guide and \n\t\t\t\tSecurity groups for your VPC in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    \n

    When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

    \n

    You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

    \n

    You can add or remove rules from your security groups using \n\t\t\t\t\tAuthorizeSecurityGroupIngress,\n\t\t\t\t\tAuthorizeSecurityGroupEgress,\n\t\t\t\t\tRevokeSecurityGroupIngress, and\n\t\t\t\t\tRevokeSecurityGroupEgress.

    \n

    For more information about VPC security group limits, see Amazon VPC Limits.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     ", - "smithy.api#examples": [ - { - "title": "To create a security group for a VPC", - "documentation": "This example creates a security group for the specified VPC.", - "input": { - "Description": "My security group", - "GroupName": "my-security-group", - "VpcId": "vpc-1a2b3c4d" - }, - "output": { - "GroupId": "sg-903004f8" - } - } - ] + "smithy.api#documentation": "

    Creates a security group.

    \n

    A security group acts as a virtual firewall for your instance to control inbound and outbound traffic.\n For more information, see\n\t\t\t\tAmazon EC2 security groups in \n\t\t\t\tthe Amazon Elastic Compute Cloud User Guide and \n\t\t\t\tSecurity groups for your VPC in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    \n

    When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

    \n

    You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

    \n

    You can add or remove rules from your security groups using \n\t\t\t\t\tAuthorizeSecurityGroupIngress,\n\t\t\t\t\tAuthorizeSecurityGroupEgress,\n\t\t\t\t\tRevokeSecurityGroupIngress, and\n\t\t\t\t\tRevokeSecurityGroupEgress.

    \n

    For more information about VPC security group limits, see Amazon VPC Limits.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     " } }, "com.amazonaws.ec2#CreateSecurityGroupRequest": { @@ -17815,27 +17480,7 @@ "target": "com.amazonaws.ec2#Snapshot" }, "traits": { - "smithy.api#documentation": "

    Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for\n \tbackups, to make copies of EBS volumes, and to save data before shutting down an\n \tinstance.

    \n

    You can create snapshots of volumes in a Region and volumes on an Outpost. If you \n \tcreate a snapshot of a volume in a Region, the snapshot must be stored in the same \n \tRegion as the volume. If you create a snapshot of a volume on an Outpost, the snapshot \n \tcan be stored on the same Outpost as the volume, or in the Region for that Outpost.

    \n

    When a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the\n source volume are propagated to the snapshot.

    \n

    You can take a snapshot of an attached volume that is in use. However, snapshots only\n capture data that has been written to your Amazon EBS volume at the time the snapshot command is\n issued; this might exclude any data that has been cached by any applications or the operating\n system. If you can pause any file systems on the volume long enough to take a snapshot, your\n snapshot should be complete. However, if you cannot pause all file writes to the volume, you\n should unmount the volume from within the instance, issue the snapshot command, and then\n remount the volume to ensure a consistent and complete snapshot. You may remount and use your\n volume while the snapshot status is pending.

    \n

    When you create a snapshot for an EBS volume that serves as a root device, we recommend \n that you stop the instance before taking the snapshot.

    \n

    Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that\n are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes\n and any associated snapshots always remain protected.

    \n

    You can tag your snapshots during creation. For more information, see Tag your Amazon EC2\n resources in the Amazon Elastic Compute Cloud User Guide.

    \n

    For more information, see Amazon Elastic Block Store and Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a snapshot", - "documentation": "This example creates a snapshot of the volume with a volume ID of ``vol-1234567890abcdef0`` and a short description to identify the snapshot.", - "input": { - "VolumeId": "vol-1234567890abcdef0", - "Description": "This is my root volume snapshot." - }, - "output": { - "Description": "This is my root volume snapshot.", - "Tags": [], - "VolumeId": "vol-1234567890abcdef0", - "State": "pending", - "VolumeSize": 8, - "StartTime": "2014-02-28T21:06:01.000Z", - "OwnerId": "012345678910", - "SnapshotId": "snap-066877671789bd71b" - } - } - ] + "smithy.api#documentation": "

    Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for\n \tbackups, to make copies of EBS volumes, and to save data before shutting down an\n \tinstance.

    \n

    You can create snapshots of volumes in a Region and volumes on an Outpost. If you \n \tcreate a snapshot of a volume in a Region, the snapshot must be stored in the same \n \tRegion as the volume. If you create a snapshot of a volume on an Outpost, the snapshot \n \tcan be stored on the same Outpost as the volume, or in the Region for that Outpost.

    \n

    When a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the\n source volume are propagated to the snapshot.

    \n

    You can take a snapshot of an attached volume that is in use. However, snapshots only\n capture data that has been written to your Amazon EBS volume at the time the snapshot command is\n issued; this might exclude any data that has been cached by any applications or the operating\n system. If you can pause any file systems on the volume long enough to take a snapshot, your\n snapshot should be complete. However, if you cannot pause all file writes to the volume, you\n should unmount the volume from within the instance, issue the snapshot command, and then\n remount the volume to ensure a consistent and complete snapshot. You may remount and use your\n volume while the snapshot status is pending.

    \n

    When you create a snapshot for an EBS volume that serves as a root device, we recommend \n that you stop the instance before taking the snapshot.

    \n

    Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that\n are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes\n and any associated snapshots always remain protected.

    \n

    You can tag your snapshots during creation. For more information, see Tag your Amazon EC2\n resources in the Amazon Elastic Compute Cloud User Guide.

    \n

    For more information, see Amazon Elastic Block Store and Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateSnapshotRequest": { @@ -18102,27 +17747,7 @@ "target": "com.amazonaws.ec2#CreateSubnetResult" }, "traits": { - "smithy.api#documentation": "

    Creates a subnet in the specified VPC. For an IPv4 only subnet, specify an IPv4 CIDR block.\n If the VPC has an IPv6 CIDR block, you can create an IPv6 only subnet or a dual stack subnet instead.\n For an IPv6 only subnet, specify an IPv6 CIDR block. For a dual stack subnet, specify both\n an IPv4 CIDR block and an IPv6 CIDR block.

    \n

    A subnet CIDR block must not overlap the CIDR block of an existing subnet in the VPC.\n After you create a subnet, you can't change its CIDR block.

    \n

    The allowed size for an IPv4 subnet is between a /28 netmask (16 IP addresses) and \n a /16 netmask (65,536 IP addresses). Amazon Web Services reserves both the first four and \n the last IPv4 address in each subnet's CIDR block. They're not available for your use.

    \n

    If you've associated an IPv6 CIDR block with your VPC, you can associate an IPv6 CIDR block \n with a subnet when you create it. The allowed block size for an IPv6 subnet is a /64 netmask.

    \n

    If you add more than one subnet to a VPC, they're set up in a star topology with a\n logical router in the middle.

    \n

    When you stop an instance in a subnet, it retains its private IPv4 address. It's\n therefore possible to have a subnet with no running instances (they're all stopped), but\n no remaining IP addresses available.

    \n

    For more information, see Subnets in the Amazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a subnet", - "documentation": "This example creates a subnet in the specified VPC with the specified CIDR block. We recommend that you let us select an Availability Zone for you.", - "input": { - "VpcId": "vpc-a01106c2", - "CidrBlock": "10.0.1.0/24" - }, - "output": { - "Subnet": { - "VpcId": "vpc-a01106c2", - "CidrBlock": "10.0.1.0/24", - "State": "pending", - "AvailabilityZone": "us-west-2c", - "SubnetId": "subnet-9d4a7b6c", - "AvailableIpAddressCount": 251 - } - } - } - ] + "smithy.api#documentation": "

    Creates a subnet in the specified VPC. For an IPv4 only subnet, specify an IPv4 CIDR block.\n If the VPC has an IPv6 CIDR block, you can create an IPv6 only subnet or a dual stack subnet instead.\n For an IPv6 only subnet, specify an IPv6 CIDR block. For a dual stack subnet, specify both\n an IPv4 CIDR block and an IPv6 CIDR block.

    \n

    A subnet CIDR block must not overlap the CIDR block of an existing subnet in the VPC.\n After you create a subnet, you can't change its CIDR block.

    \n

    The allowed size for an IPv4 subnet is between a /28 netmask (16 IP addresses) and \n a /16 netmask (65,536 IP addresses). Amazon Web Services reserves both the first four and \n the last IPv4 address in each subnet's CIDR block. They're not available for your use.

    \n

    If you've associated an IPv6 CIDR block with your VPC, you can associate an IPv6 CIDR block \n with a subnet when you create it. The allowed block size for an IPv6 subnet is a /64 netmask.

    \n

    If you add more than one subnet to a VPC, they're set up in a star topology with a\n logical router in the middle.

    \n

    When you stop an instance in a subnet, it retains its private IPv4 address. It's\n therefore possible to have a subnet with no running instances (they're all stopped), but\n no remaining IP addresses available.

    \n

    For more information, see Subnets in the Amazon Virtual Private Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateSubnetCidrReservation": { @@ -20150,29 +19775,7 @@ "target": "com.amazonaws.ec2#Volume" }, "traits": { - "smithy.api#documentation": "

    Creates an EBS volume that can be attached to an instance in the same Availability Zone.

    \n

    You can create a new empty volume or restore a volume from an EBS snapshot.\n Any Amazon Web Services Marketplace product codes from the snapshot are propagated to the volume.

    \n

    You can create encrypted volumes. Encrypted volumes must be attached to instances that \n support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically \n encrypted. For more information, see Amazon EBS encryption\n in the Amazon Elastic Compute Cloud User Guide.

    \n

    You can tag your volumes during creation. For more information, see Tag your Amazon EC2\n resources in the Amazon Elastic Compute Cloud User Guide.

    \n

    For more information, see Create an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a new volume", - "documentation": "This example creates an 80 GiB General Purpose (SSD) volume in the Availability Zone ``us-east-1a``.", - "input": { - "AvailabilityZone": "us-east-1a", - "Size": 80, - "VolumeType": "gp2" - }, - "output": { - "AvailabilityZone": "us-east-1a", - "Encrypted": false, - "VolumeType": "gp2", - "VolumeId": "vol-6b60b7c7", - "State": "creating", - "Iops": 240, - "SnapshotId": "", - "CreateTime": "2016-08-29T18:52:32.724Z", - "Size": 80 - } - } - ] + "smithy.api#documentation": "

    Creates an EBS volume that can be attached to an instance in the same Availability Zone.

    \n

    You can create a new empty volume or restore a volume from an EBS snapshot.\n Any Amazon Web Services Marketplace product codes from the snapshot are propagated to the volume.

    \n

    You can create encrypted volumes. Encrypted volumes must be attached to instances that \n support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically \n encrypted. For more information, see Amazon EBS encryption\n in the Amazon Elastic Compute Cloud User Guide.

    \n

    You can tag your volumes during creation. For more information, see Tag your Amazon EC2\n resources in the Amazon Elastic Compute Cloud User Guide.

    \n

    For more information, see Create an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateVolumePermission": { @@ -20343,25 +19946,7 @@ "target": "com.amazonaws.ec2#CreateVpcResult" }, "traits": { - "smithy.api#documentation": "

    Creates a VPC with the specified CIDR blocks. For more information, see\n\t VPC CIDR blocks in the Amazon Virtual Private Cloud User Guide.

    \n

    You can optionally request an IPv6 CIDR block for the VPC. You can request an Amazon-provided \n IPv6 CIDR block from Amazon's pool of IPv6 addresses, or an IPv6 CIDR block from an IPv6 address \n pool that you provisioned through bring your own IP addresses (BYOIP).

    \n

    By default, each instance that you launch in the VPC has the default DHCP options, which\n\t\t\tinclude only a default DNS server that we provide (AmazonProvidedDNS). For more\n\t\t\tinformation, see DHCP option sets in the Amazon Virtual Private Cloud User Guide.

    \n

    You can specify the instance tenancy value for the VPC when you create it. You can't change\n this value for the VPC after you create it. For more information, see Dedicated Instances in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To create a VPC", - "documentation": "This example creates a VPC with the specified CIDR block.", - "input": { - "CidrBlock": "10.0.0.0/16" - }, - "output": { - "Vpc": { - "InstanceTenancy": "default", - "State": "pending", - "VpcId": "vpc-a01106c2", - "CidrBlock": "10.0.0.0/16", - "DhcpOptionsId": "dopt-7a8b9c2d" - } - } - } - ] + "smithy.api#documentation": "

    Creates a VPC with the specified CIDR blocks. For more information, see\n\t VPC CIDR blocks in the Amazon Virtual Private Cloud User Guide.

    \n

    You can optionally request an IPv6 CIDR block for the VPC. You can request an Amazon-provided \n IPv6 CIDR block from Amazon's pool of IPv6 addresses, or an IPv6 CIDR block from an IPv6 address \n pool that you provisioned through bring your own IP addresses (BYOIP).

    \n

    By default, each instance that you launch in the VPC has the default DHCP options, which\n\t\t\tinclude only a default DNS server that we provide (AmazonProvidedDNS). For more\n\t\t\tinformation, see DHCP option sets in the Amazon Virtual Private Cloud User Guide.

    \n

    You can specify the instance tenancy value for the VPC when you create it. You can't change\n this value for the VPC after you create it. For more information, see Dedicated Instances in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#CreateVpcEndpoint": { @@ -21744,16 +21329,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified customer gateway. You must delete the VPN connection before you\n can delete the customer gateway.

    ", - "smithy.api#examples": [ - { - "title": "To delete a customer gateway", - "documentation": "This example deletes the specified customer gateway.", - "input": { - "CustomerGatewayId": "cgw-0e11f167" - } - } - ] + "smithy.api#documentation": "

    Deletes the specified customer gateway. You must delete the VPN connection before you\n can delete the customer gateway.

    " } }, "com.amazonaws.ec2#DeleteCustomerGatewayRequest": { @@ -21792,16 +21368,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

    ", - "smithy.api#examples": [ - { - "title": "To delete a DHCP options set", - "documentation": "This example deletes the specified DHCP options set.", - "input": { - "DhcpOptionsId": "dopt-d9070ebb" - } - } - ] + "smithy.api#documentation": "

    Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

    " } }, "com.amazonaws.ec2#DeleteDhcpOptionsRequest": { @@ -22566,16 +22133,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified key pair, by removing the public key from Amazon EC2.

    ", - "smithy.api#examples": [ - { - "title": "To delete a key pair", - "documentation": "This example deletes the specified key pair.", - "input": { - "KeyName": "my-key-pair" - } - } - ] + "smithy.api#documentation": "

    Deletes the specified key pair, by removing the public key from Amazon EC2.

    " } }, "com.amazonaws.ec2#DeleteKeyPairRequest": { @@ -22617,26 +22175,7 @@ "target": "com.amazonaws.ec2#DeleteLaunchTemplateResult" }, "traits": { - "smithy.api#documentation": "

    Deletes a launch template. Deleting a launch template deletes all of its\n versions.

    ", - "smithy.api#examples": [ - { - "title": "To delete a launch template", - "documentation": "This example deletes the specified launch template.", - "input": { - "LaunchTemplateId": "lt-0abcd290751193123" - }, - "output": { - "LaunchTemplate": { - "LatestVersionNumber": 2, - "LaunchTemplateId": "lt-0abcd290751193123", - "LaunchTemplateName": "my-template", - "DefaultVersionNumber": 2, - "CreatedBy": "arn:aws:iam::123456789012:root", - "CreateTime": "2017-11-23T16:46:25.000Z" - } - } - } - ] + "smithy.api#documentation": "

    Deletes a launch template. Deleting a launch template deletes all of its\n versions.

    " } }, "com.amazonaws.ec2#DeleteLaunchTemplateRequest": { @@ -22692,27 +22231,7 @@ "target": "com.amazonaws.ec2#DeleteLaunchTemplateVersionsResult" }, "traits": { - "smithy.api#documentation": "

    Deletes one or more versions of a launch template. You cannot delete the default\n version of a launch template; you must first assign a different version as the default.\n If the default version is the only version for the launch template, you must delete the\n entire launch template using DeleteLaunchTemplate.

    ", - "smithy.api#examples": [ - { - "title": "To delete a launch template version", - "documentation": "This example deletes the specified launch template version.", - "input": { - "LaunchTemplateId": "lt-0abcd290751193123", - "Versions": ["1"] - }, - "output": { - "SuccessfullyDeletedLaunchTemplateVersions": [ - { - "LaunchTemplateName": "my-template", - "VersionNumber": 1, - "LaunchTemplateId": "lt-0abcd290751193123" - } - ], - "UnsuccessfullyDeletedLaunchTemplateVersions": [] - } - } - ] + "smithy.api#documentation": "

    Deletes one or more versions of a launch template. You cannot delete the default\n version of a launch template; you must first assign a different version as the default.\n If the default version is the only version for the launch template, you must delete the\n entire launch template using DeleteLaunchTemplate.

    " } }, "com.amazonaws.ec2#DeleteLaunchTemplateVersionsRequest": { @@ -23151,19 +22670,7 @@ "target": "com.amazonaws.ec2#DeleteNatGatewayResult" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified NAT gateway. Deleting a public NAT gateway disassociates its Elastic IP address, \n but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway \n routes in your route tables.

    ", - "smithy.api#examples": [ - { - "title": "To delete a NAT gateway", - "documentation": "This example deletes the specified NAT gateway.", - "input": { - "NatGatewayId": "nat-04ae55e711cec5680" - }, - "output": { - "NatGatewayId": "nat-04ae55e711cec5680" - } - } - ] + "smithy.api#documentation": "

    Deletes the specified NAT gateway. Deleting a public NAT gateway disassociates its Elastic IP address, \n but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway \n routes in your route tables.

    " } }, "com.amazonaws.ec2#DeleteNatGatewayRequest": { @@ -23950,17 +23457,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes a security group.

    \n

    If you attempt to delete a security group that is associated with an instance, or is\n\t\t\t referenced by another security group, the operation fails with\n\t\t\t\tInvalidGroup.InUse in EC2-Classic or\n\t\t\t\tDependencyViolation in EC2-VPC.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     ", - "smithy.api#examples": [ - { - "title": "To delete a security group", - "documentation": "This example deletes the specified security group.", - "input": { - "GroupId": "sg-903004f8" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Deletes a security group.

    \n

    If you attempt to delete a security group that is associated with an instance, or is\n\t\t\t referenced by another security group, the operation fails with\n\t\t\t\tInvalidGroup.InUse in EC2-Classic or\n\t\t\t\tDependencyViolation in EC2-VPC.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     " } }, "com.amazonaws.ec2#DeleteSecurityGroupRequest": { @@ -24002,17 +23499,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified snapshot.

    \n

    When you make periodic snapshots of a volume, the snapshots are incremental, and only the\n blocks on the device that have changed since your last snapshot are saved in the new snapshot.\n When you delete a snapshot, only the data not needed for any other snapshot is removed. So\n regardless of which prior snapshots have been deleted, all active snapshots will have access\n to all the information needed to restore the volume.

    \n

    You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI.\n You must first de-register the AMI before you can delete the snapshot.

    \n

    For more information, see Delete an Amazon EBS snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To delete a snapshot", - "documentation": "This example deletes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "input": { - "SnapshotId": "snap-1234567890abcdef0" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Deletes the specified snapshot.

    \n

    When you make periodic snapshots of a volume, the snapshots are incremental, and only the\n blocks on the device that have changed since your last snapshot are saved in the new snapshot.\n When you delete a snapshot, only the data not needed for any other snapshot is removed. So\n regardless of which prior snapshots have been deleted, all active snapshots will have access\n to all the information needed to restore the volume.

    \n

    You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI.\n You must first de-register the AMI before you can delete the snapshot.

    \n

    For more information, see Delete an Amazon EBS snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DeleteSnapshotRequest": { @@ -24050,13 +23537,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the data feed for Spot Instances.

    ", - "smithy.api#examples": [ - { - "title": "To cancel a Spot Instance data feed subscription", - "documentation": "This example deletes a Spot data feed subscription for the account." - } - ] + "smithy.api#documentation": "

    Deletes the data feed for Spot Instances.

    " } }, "com.amazonaws.ec2#DeleteSpotDatafeedSubscriptionRequest": { @@ -24087,16 +23568,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

    ", - "smithy.api#examples": [ - { - "title": "To delete a subnet", - "documentation": "This example deletes the specified subnet.", - "input": { - "SubnetId": "subnet-9d4a7b6c" - } - } - ] + "smithy.api#documentation": "

    Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

    " } }, "com.amazonaws.ec2#DeleteSubnetCidrReservation": { @@ -25266,17 +24738,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Deletes the specified EBS volume. The volume must be in the available state\n (not attached to an instance).

    \n

    The volume can remain in the deleting state for several minutes.

    \n

    For more information, see Delete an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To delete a volume", - "documentation": "This example deletes an available volume with the volume ID of ``vol-049df61146c4d7901``. If the command succeeds, no output is returned.", - "input": { - "VolumeId": "vol-049df61146c4d7901" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Deletes the specified EBS volume. The volume must be in the available state\n (not attached to an instance).

    \n

    The volume can remain in the deleting state for several minutes.

    \n

    For more information, see Delete an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DeleteVolumeRequest": { @@ -25314,16 +24776,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    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.

    ", - "smithy.api#examples": [ - { - "title": "To delete a VPC", - "documentation": "This example deletes the specified VPC.", - "input": { - "VpcId": "vpc-a01106c2" - } - } - ] + "smithy.api#documentation": "

    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.

    " } }, "com.amazonaws.ec2#DeleteVpcEndpointConnectionNotifications": { @@ -26118,31 +25571,7 @@ "target": "com.amazonaws.ec2#DescribeAccountAttributesResult" }, "traits": { - "smithy.api#documentation": "

    Describes attributes of your Amazon Web Services account. The following are the supported account attributes:

    \n ", - "smithy.api#examples": [ - { - "title": "To describe a single attribute for your AWS account", - "documentation": "This example describes the supported-platforms attribute for your AWS account.", - "input": { - "AttributeNames": ["supported-platforms"] - }, - "output": { - "AccountAttributes": [ - { - "AttributeName": "supported-platforms", - "AttributeValues": [ - { - "AttributeValue": "EC2" - }, - { - "AttributeValue": "VPC" - } - ] - } - ] - } - } - ] + "smithy.api#documentation": "

    Describes attributes of your Amazon Web Services account. The following are the supported account attributes:

    \n " } }, "com.amazonaws.ec2#DescribeAccountAttributesRequest": { @@ -26285,32 +25714,7 @@ "target": "com.amazonaws.ec2#DescribeAddressesResult" }, "traits": { - "smithy.api#documentation": "

    Describes the specified Elastic IP addresses or all of your Elastic IP addresses.

    ", - "smithy.api#examples": [ - { - "title": "To describe your Elastic IP addresses", - "documentation": "This example describes your Elastic IP addresses.", - "output": { - "Addresses": [ - { - "InstanceId": "i-1234567890abcdef0", - "PublicIp": "198.51.100.0", - "Domain": "standard" - }, - { - "Domain": "vpc", - "InstanceId": "i-1234567890abcdef0", - "NetworkInterfaceId": "eni-12345678", - "AssociationId": "eipassoc-12345678", - "NetworkInterfaceOwnerId": "123456789012", - "PublicIp": "203.0.113.0", - "AllocationId": "eipalloc-12345678", - "PrivateIpAddress": "10.0.1.241" - } - ] - } - } - ] + "smithy.api#documentation": "

    Describes the specified Elastic IP addresses or all of your Elastic IP addresses.

    " } }, "com.amazonaws.ec2#DescribeAddressesAttribute": { @@ -26516,41 +25920,7 @@ "target": "com.amazonaws.ec2#DescribeAvailabilityZonesResult" }, "traits": { - "smithy.api#documentation": "

    Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to\n you. If there is an event impacting a zone, you can use this request to view the state and any\n provided messages for that zone.

    \n

    For more information about Availability Zones, Local Zones, and Wavelength Zones, see\n Regions and zones \n in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe your Availability Zones", - "documentation": "This example describes the Availability Zones that are available to you. The response includes Availability Zones only for the current region.", - "output": { - "AvailabilityZones": [ - { - "State": "available", - "RegionName": "us-east-1", - "Messages": [], - "ZoneName": "us-east-1b" - }, - { - "State": "available", - "RegionName": "us-east-1", - "Messages": [], - "ZoneName": "us-east-1c" - }, - { - "State": "available", - "RegionName": "us-east-1", - "Messages": [], - "ZoneName": "us-east-1d" - }, - { - "State": "available", - "RegionName": "us-east-1", - "Messages": [], - "ZoneName": "us-east-1e" - } - ] - } - } - ] + "smithy.api#documentation": "

    Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to\n you. If there is an event impacting a zone, you can use this request to view the state and any\n provided messages for that zone.

    \n

    For more information about Availability Zones, Local Zones, and Wavelength Zones, see\n Regions and zones \n in the Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DescribeAvailabilityZonesRequest": { @@ -27961,26 +27331,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your VPN customer gateways.

    \n

    For more information, see Amazon Web Services Site-to-Site VPN in the Amazon Web Services Site-to-Site VPN\n User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a customer gateway", - "documentation": "This example describes the specified customer gateway.", - "input": { - "CustomerGatewayIds": ["cgw-0e11f167"] - }, - "output": { - "CustomerGateways": [ - { - "CustomerGatewayId": "cgw-0e11f167", - "IpAddress": "12.1.2.3", - "State": "available", - "Type": "ipsec.1", - "BgpAsn": "65534" - } - ] - } - } - ], "smithy.waiters#waitable": { "CustomerGatewayAvailable": { "acceptors": [ @@ -28080,35 +27430,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your DHCP options sets.

    \n

    For more information, see DHCP options sets in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a DHCP options set", - "documentation": "This example describes the specified DHCP options set.", - "input": { - "DhcpOptionsIds": ["dopt-d9070ebb"] - }, - "output": { - "DhcpOptions": [ - { - "DhcpConfigurations": [ - { - "Values": [ - { - "Value": "10.2.5.2" - }, - { - "Value": "10.2.5.1" - } - ], - "Key": "domain-name-servers" - } - ], - "DhcpOptionsId": "dopt-d9070ebb" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -29860,28 +29181,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes your IAM instance profile associations.

    ", - "smithy.api#examples": [ - { - "title": "To describe an IAM instance profile association", - "documentation": "This example describes the specified IAM instance profile association.", - "input": { - "AssociationIds": ["iip-assoc-0db249b1f25fa24b8"] - }, - "output": { - "IamInstanceProfileAssociations": [ - { - "InstanceId": "i-09eb09efa73ec1dee", - "State": "associated", - "AssociationId": "iip-assoc-0db249b1f25fa24b8", - "IamInstanceProfile": { - "Id": "AIPAJVQN4F5WVLGCJDRGM", - "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" - } - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -30065,25 +29364,7 @@ "target": "com.amazonaws.ec2#ImageAttribute" }, "traits": { - "smithy.api#documentation": "

    Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

    ", - "smithy.api#examples": [ - { - "title": "To describe the launch permissions for an AMI", - "documentation": "This example describes the launch permissions for the specified AMI.", - "input": { - "Attribute": "launchPermission", - "ImageId": "ami-5731123e" - }, - "output": { - "ImageId": "ami-5731123e", - "LaunchPermissions": [ - { - "UserId": "123456789012" - } - ] - } - } - ] + "smithy.api#documentation": "

    Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

    " } }, "com.amazonaws.ec2#DescribeImageAttributeRequest": { @@ -30131,46 +29412,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified images (AMIs, AKIs, and ARIs) available to you or all of the images available to you.

    \n

    The images available to you include public images, private images that you own, and private images owned by other \n Amazon Web Services accounts for which you have explicit launch permissions.

    \n

    Recently deregistered images appear in the returned results for a short interval and then\n return empty results. After all instances that reference a deregistered AMI are terminated,\n specifying the ID of the image will eventually return an error indicating that the AMI ID\n cannot be found.

    ", - "smithy.api#examples": [ - { - "title": "To describe an AMI", - "documentation": "This example describes the specified AMI.", - "input": { - "ImageIds": ["ami-5731123e"] - }, - "output": { - "Images": [ - { - "VirtualizationType": "paravirtual", - "Name": "My server", - "Hypervisor": "xen", - "ImageId": "ami-5731123e", - "RootDeviceType": "ebs", - "State": "available", - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "DeleteOnTermination": true, - "SnapshotId": "snap-1234567890abcdef0", - "VolumeSize": 8, - "VolumeType": "standard" - } - } - ], - "Architecture": "x86_64", - "ImageLocation": "123456789012/My server", - "KernelId": "aki-88aa75e1", - "OwnerId": "123456789012", - "RootDeviceName": "/dev/sda1", - "Public": false, - "ImageType": "machine", - "Description": "An AMI for my server" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -30892,45 +30133,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the status of the specified instances or all of your instances. By default,\n only running instances are described, unless you specifically indicate to return the\n status of all instances.

    \n

    Instance status includes the following components:

    \n ", - "smithy.api#examples": [ - { - "title": "To describe the status of an instance", - "documentation": "This example describes the current status of the specified instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef0"] - }, - "output": { - "InstanceStatuses": [ - { - "InstanceId": "i-1234567890abcdef0", - "InstanceState": { - "Code": 16, - "Name": "running" - }, - "AvailabilityZone": "us-east-1d", - "SystemStatus": { - "Status": "ok", - "Details": [ - { - "Status": "passed", - "Name": "reachability" - } - ] - }, - "InstanceStatus": { - "Status": "ok", - "Details": [ - { - "Status": "passed", - "Name": "reachability" - } - ] - } - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -31180,7 +30382,7 @@ "Filters": { "target": "com.amazonaws.ec2#FilterList", "traits": { - "smithy.api#documentation": "

    One or more filters. Filter names and values are case-sensitive.

    \n ", + "smithy.api#documentation": "

    One or more filters. Filter names and values are case-sensitive.

    \n ", "smithy.api#xmlName": "Filter" } }, @@ -31208,7 +30410,7 @@ "target": "com.amazonaws.ec2#InstanceTypeInfoList", "traits": { "aws.protocols#ec2QueryName": "InstanceTypeSet", - "smithy.api#documentation": "

    The instance type. For more information, see Instance types in the Amazon EC2 User Guide.

    ", + "smithy.api#documentation": "

    The instance type. For more information, see Instance types in the Amazon EC2 User Guide.

    \n

    When you change your EBS-backed instance type, instance restart or replacement behavior depends on the \n \t\tinstance type compatibility between the old and new types. An instance that's backed by an instance store volume \n \t\tis always replaced. For more information, see Change the instance type in the \n \t\tAmazon EC2 User Guide.

    ", "smithy.api#xmlName": "instanceTypeSet" } }, @@ -31235,16 +30437,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified instances or all instances.

    \n

    If you specify instance IDs, the output includes information for only the specified\n instances. If you specify filters, the output includes information for only those\n instances that meet the filter criteria. If you do not specify instance IDs or filters,\n the output includes information for all instances, which can affect performance. We\n recommend that you use pagination to ensure that the operation returns quickly and\n successfully.

    \n

    If you specify an instance ID that is not valid, an error is returned. If you specify\n an instance that you do not own, it is not included in the output.

    \n

    Recently terminated instances might appear in the returned results. This interval is\n usually less than one hour.

    \n

    If you describe instances in the rare case where an Availability Zone is experiencing\n a service disruption and you specify instance IDs that are in the affected zone, or do\n not specify any instance IDs at all, the call fails. If you describe instances and\n specify only instance IDs that are in an unaffected zone, the call works\n normally.

    ", - "smithy.api#examples": [ - { - "title": "To describe an Amazon EC2 instance", - "documentation": "This example describes the specified instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef0"] - }, - "output": {} - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -31482,34 +30674,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your internet gateways.

    ", - "smithy.api#examples": [ - { - "title": "To describe the Internet gateway for a VPC", - "documentation": "This example describes the Internet gateway for the specified VPC.", - "input": { - "Filters": [ - { - "Name": "attachment.vpc-id", - "Values": ["vpc-a01106c2"] - } - ] - }, - "output": { - "InternetGateways": [ - { - "Tags": [], - "InternetGatewayId": "igw-c0a643a9", - "Attachments": [ - { - "State": "attached", - "VpcId": "vpc-a01106c2" - } - ] - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -32149,23 +31313,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified key pairs or all of your key pairs.

    \n

    For more information about key pairs, see Amazon EC2 key pairs \n\t\t\t\tin the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To display a key pair", - "documentation": "This example displays the fingerprint for the specified key.", - "input": { - "KeyNames": ["my-key-pair"] - }, - "output": { - "KeyPairs": [ - { - "KeyName": "my-key-pair", - "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f" - } - ] - } - } - ], "smithy.api#suppress": ["WaitableTraitInvalidErrorType"], "smithy.waiters#waitable": { "KeyPairExists": { @@ -32265,62 +31412,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more versions of a specified launch template. You can describe all\n versions, individual versions, or a range of versions. You can also describe all the\n latest versions or all the default versions of all the launch templates in your\n account.

    ", - "smithy.api#examples": [ - { - "title": "To describe the versions for a launch template", - "documentation": "This example describes the versions for the specified launch template.", - "input": { - "LaunchTemplateId": "068f72b72934aff71" - }, - "output": { - "LaunchTemplateVersions": [ - { - "LaunchTemplateId": "lt-068f72b72934aff71", - "LaunchTemplateName": "Webservers", - "VersionNumber": 2, - "CreatedBy": "arn:aws:iam::123456789102:root", - "LaunchTemplateData": { - "KeyName": "kp-us-east", - "ImageId": "ami-6057e21a", - "InstanceType": "t2.medium", - "NetworkInterfaces": [ - { - "SubnetId": "subnet-1a2b3c4d", - "DeviceIndex": 0, - "Groups": ["sg-7c227019"] - } - ] - }, - "DefaultVersion": false, - "CreateTime": "2017-11-20T13:12:32.000Z" - }, - { - "LaunchTemplateId": "lt-068f72b72934aff71", - "LaunchTemplateName": "Webservers", - "VersionNumber": 1, - "CreatedBy": "arn:aws:iam::123456789102:root", - "LaunchTemplateData": { - "UserData": "", - "KeyName": "kp-us-east", - "ImageId": "ami-aabbcc11", - "InstanceType": "t2.medium", - "NetworkInterfaces": [ - { - "SubnetId": "subnet-7b16de0c", - "DeviceIndex": 0, - "DeleteOnTermination": false, - "Groups": ["sg-7c227019"], - "AssociatePublicIpAddress": true - } - ] - }, - "DefaultVersion": true, - "CreateTime": "2017-11-20T12:52:33.000Z" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -32439,27 +31530,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more launch templates.

    ", - "smithy.api#examples": [ - { - "title": "To describe a launch template", - "documentation": "This example describes the specified launch template.", - "input": { - "LaunchTemplateIds": ["lt-01238c059e3466abc"] - }, - "output": { - "LaunchTemplates": [ - { - "LatestVersionNumber": 1, - "LaunchTemplateName": "my-template", - "LaunchTemplateId": "lt-01238c059e3466abc", - "CreatedBy": "arn:aws:iam::123456789012:root", - "CreateTime": "2018-01-16T04:32:57.000Z", - "DefaultVersionNumber": 1 - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -33165,20 +32235,6 @@ }, "traits": { "smithy.api#documentation": "\n

    This action is deprecated.

    \n     \n

    Describes your Elastic IP addresses that are being moved from or being restored to the EC2-Classic platform. \n This request does not return information about any other Elastic IP addresses in your account.

    ", - "smithy.api#examples": [ - { - "title": "To describe your moving addresses", - "documentation": "This example describes all of your moving Elastic IP addresses.", - "output": { - "MovingAddressStatuses": [ - { - "PublicIp": "198.51.100.0", - "MoveStatus": "movingToVpc" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -33283,39 +32339,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your NAT gateways.

    ", - "smithy.api#examples": [ - { - "title": "To describe a NAT gateway", - "documentation": "This example describes the NAT gateway for the specified VPC.", - "input": { - "Filter": [ - { - "Name": "vpc-id", - "Values": ["vpc-1a2b3c4d"] - } - ] - }, - "output": { - "NatGateways": [ - { - "NatGatewayAddresses": [ - { - "PublicIp": "198.11.222.333", - "NetworkInterfaceId": "eni-9dec76cd", - "AllocationId": "eipalloc-89c620ec", - "PrivateIp": "10.0.0.149" - } - ], - "VpcId": "vpc-1a2b3c4d", - "State": "available", - "NatGatewayId": "nat-05dba92075d71c408", - "SubnetId": "subnet-847e4dc2", - "CreateTime": "2015-12-01T12:26:55.983Z" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -33486,48 +32509,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your network ACLs.

    \n

    For more information, see Network ACLs in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a network ACL", - "documentation": "This example describes the specified network ACL.", - "input": { - "NetworkAclIds": ["acl-5fb85d36"] - }, - "output": { - "NetworkAcls": [ - { - "Associations": [ - { - "SubnetId": "subnet-65ea5f08", - "NetworkAclId": "acl-9aeb5ef7", - "NetworkAclAssociationId": "aclassoc-66ea5f0b" - } - ], - "NetworkAclId": "acl-5fb85d36", - "VpcId": "vpc-a01106c2", - "Tags": [], - "Entries": [ - { - "CidrBlock": "0.0.0.0/0", - "RuleNumber": 32767, - "Protocol": "-1", - "Egress": true, - "RuleAction": "deny" - }, - { - "CidrBlock": "0.0.0.0/0", - "RuleNumber": 32767, - "Protocol": "-1", - "Egress": false, - "RuleAction": "deny" - } - ], - "IsDefault": false - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -34194,68 +33175,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your network interfaces.

    ", - "smithy.api#examples": [ - { - "title": "To describe a network interface", - "documentation": "", - "input": { - "NetworkInterfaceIds": ["eni-e5aa89a3"] - }, - "output": { - "NetworkInterfaces": [ - { - "Status": "in-use", - "MacAddress": "02:2f:8f:b0:cf:75", - "SourceDestCheck": true, - "VpcId": "vpc-a01106c2", - "Description": "my network interface", - "Association": { - "PublicIp": "203.0.113.12", - "AssociationId": "eipassoc-0fbb766a", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "IpOwnerId": "123456789012" - }, - "NetworkInterfaceId": "eni-e5aa89a3", - "PrivateIpAddresses": [ - { - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "Association": { - "PublicIp": "203.0.113.12", - "AssociationId": "eipassoc-0fbb766a", - "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com", - "IpOwnerId": "123456789012" - }, - "Primary": true, - "PrivateIpAddress": "10.0.1.17" - } - ], - "RequesterManaged": false, - "PrivateDnsName": "ip-10-0-1-17.ec2.internal", - "AvailabilityZone": "us-east-1d", - "Attachment": { - "Status": "attached", - "DeviceIndex": 1, - "AttachTime": "2013-11-30T23:36:42.000Z", - "InstanceId": "i-1234567890abcdef0", - "DeleteOnTermination": false, - "AttachmentId": "eni-attach-66c4350a", - "InstanceOwnerId": "123456789012" - }, - "Groups": [ - { - "GroupName": "default", - "GroupId": "sg-8637d3e3" - } - ], - "SubnetId": "subnet-b61f49f0", - "OwnerId": "123456789012", - "TagSet": [], - "PrivateIpAddress": "10.0.1.17" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -34700,61 +33619,7 @@ "target": "com.amazonaws.ec2#DescribeRegionsResult" }, "traits": { - "smithy.api#documentation": "

    Describes the Regions that are enabled for your account, or all Regions.

    \n

    For a list of the Regions supported by Amazon EC2, see \n Amazon Elastic Compute Cloud endpoints and quotas.

    \n

    For information about enabling and disabling Regions for your account, see Managing Amazon Web Services Regions in the Amazon Web Services General Reference.

    ", - "smithy.api#examples": [ - { - "title": "To describe your regions", - "documentation": "This example describes all the regions that are available to you.", - "output": { - "Regions": [ - { - "Endpoint": "ec2.ap-south-1.amazonaws.com", - "RegionName": "ap-south-1" - }, - { - "Endpoint": "ec2.eu-west-1.amazonaws.com", - "RegionName": "eu-west-1" - }, - { - "Endpoint": "ec2.ap-southeast-1.amazonaws.com", - "RegionName": "ap-southeast-1" - }, - { - "Endpoint": "ec2.ap-southeast-2.amazonaws.com", - "RegionName": "ap-southeast-2" - }, - { - "Endpoint": "ec2.eu-central-1.amazonaws.com", - "RegionName": "eu-central-1" - }, - { - "Endpoint": "ec2.ap-northeast-2.amazonaws.com", - "RegionName": "ap-northeast-2" - }, - { - "Endpoint": "ec2.ap-northeast-1.amazonaws.com", - "RegionName": "ap-northeast-1" - }, - { - "Endpoint": "ec2.us-east-1.amazonaws.com", - "RegionName": "us-east-1" - }, - { - "Endpoint": "ec2.sa-east-1.amazonaws.com", - "RegionName": "sa-east-1" - }, - { - "Endpoint": "ec2.us-west-1.amazonaws.com", - "RegionName": "us-west-1" - }, - { - "Endpoint": "ec2.us-west-2.amazonaws.com", - "RegionName": "us-west-2" - } - ] - } - } - ] + "smithy.api#documentation": "

    Describes the Regions that are enabled for your account, or all Regions.

    \n

    For a list of the Regions supported by Amazon EC2, see \n Amazon Elastic Compute Cloud endpoints and quotas.

    \n

    For information about enabling and disabling Regions for your account, see Managing Amazon Web Services Regions in the Amazon Web Services General Reference.

    " } }, "com.amazonaws.ec2#DescribeRegionsRequest": { @@ -35295,39 +34160,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your route tables.

    \n

    Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

    \n

    For more information, see Route tables in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a route table", - "documentation": "This example describes the specified route table.", - "input": { - "RouteTableIds": ["rtb-1f382e7d"] - }, - "output": { - "RouteTables": [ - { - "Associations": [ - { - "RouteTableAssociationId": "rtbassoc-d8ccddba", - "Main": true, - "RouteTableId": "rtb-1f382e7d" - } - ], - "RouteTableId": "rtb-1f382e7d", - "VpcId": "vpc-a01106c2", - "PropagatingVgws": [], - "Tags": [], - "Routes": [ - { - "GatewayId": "local", - "DestinationCidrBlock": "10.0.0.0/16", - "State": "active" - } - ] - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -35643,25 +34475,7 @@ "target": "com.amazonaws.ec2#DescribeSecurityGroupReferencesResult" }, "traits": { - "smithy.api#documentation": "

    [VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

    ", - "smithy.api#examples": [ - { - "title": "To describe security group references", - "documentation": "This example describes the security group references for the specified security group.", - "input": { - "GroupId": ["sg-903004f8"] - }, - "output": { - "SecurityGroupReferenceSet": [ - { - "ReferencingVpcId": "vpc-1a2b3c4d", - "GroupId": "sg-903004f8", - "VpcPeeringConnectionId": "pcx-b04deed9" - } - ] - } - } - ] + "smithy.api#documentation": "

    [VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

    " } }, "com.amazonaws.ec2#DescribeSecurityGroupReferencesRequest": { @@ -35810,16 +34624,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified security groups or all of your security groups.

    \n

    A security group is for use with instances either in the EC2-Classic platform \n\t\t\t\tor in a specific VPC. For more information, see\n\t\t\t\tAmazon EC2 security groups in \n\t\t\t\tthe Amazon Elastic Compute Cloud User Guide and \n\t\t\t\tSecurity groups for your VPC in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    \n \n

    We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

    \n     ", - "smithy.api#examples": [ - { - "title": "To describe a security group", - "documentation": "This example describes the specified security group.", - "input": { - "GroupIds": ["sg-903004f8"] - }, - "output": {} - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -35948,21 +34752,7 @@ "target": "com.amazonaws.ec2#DescribeSnapshotAttributeResult" }, "traits": { - "smithy.api#documentation": "

    Describes the specified attribute of the specified snapshot. You can specify only one\n attribute at a time.

    \n

    For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe snapshot attributes", - "documentation": "This example describes the ``createVolumePermission`` attribute on a snapshot with the snapshot ID of ``snap-066877671789bd71b``.", - "input": { - "SnapshotId": "snap-066877671789bd71b", - "Attribute": "createVolumePermission" - }, - "output": { - "SnapshotId": "snap-066877671789bd71b", - "CreateVolumePermissions": [] - } - } - ] + "smithy.api#documentation": "

    Describes the specified attribute of the specified snapshot. You can specify only one\n attribute at a time.

    \n

    For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DescribeSnapshotAttributeRequest": { @@ -36121,30 +34911,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified EBS snapshots available to you or all of the EBS snapshots\n available to you.

    \n

    The snapshots available to you include public snapshots, private snapshots that you own,\n and private snapshots owned by other Amazon Web Services accounts for which you have explicit create volume\n permissions.

    \n

    The create volume permissions fall into the following categories:

    \n \n

    The list of snapshots returned can be filtered by specifying snapshot IDs, snapshot\n owners, or Amazon Web Services accounts with create volume permissions. If no options are specified, \n Amazon EC2 returns all snapshots for which you have create volume permissions.

    \n

    If you specify one or more snapshot IDs, only snapshots that have the specified IDs are\n returned. If you specify an invalid snapshot ID, an error is returned. If you specify a\n snapshot ID for which you do not have access, it is not included in the returned\n results.

    \n

    If you specify one or more snapshot owners using the OwnerIds option, only\n snapshots from the specified owners and for which you have access are returned. The results\n can include the Amazon Web Services account IDs of the specified owners, amazon for snapshots\n owned by Amazon, or self for snapshots that you own.

    \n

    If you specify a list of restorable users, only snapshots with create snapshot permissions\n for those users are returned. You can specify Amazon Web Services account IDs (if you own the snapshots),\n self for snapshots for which you own or have explicit permissions, or\n all for public snapshots.

    \n

    If you are describing a long list of snapshots, we recommend that you paginate the output to make the\n list more manageable. For more information, see Pagination.

    \n

    To get the state of fast snapshot restores for a snapshot, use DescribeFastSnapshotRestores.

    \n

    For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a snapshot", - "documentation": "This example describes a snapshot with the snapshot ID of ``snap-1234567890abcdef0``.", - "input": { - "SnapshotIds": ["snap-1234567890abcdef0"] - }, - "output": { - "Snapshots": [ - { - "Description": "This is my snapshot.", - "VolumeId": "vol-049df61146c4d7901", - "State": "completed", - "VolumeSize": 8, - "Progress": "100%", - "StartTime": "2014-02-28T21:28:32.000Z", - "SnapshotId": "snap-1234567890abcdef0", - "OwnerId": "012345678910" - } - ], - "NextToken": "" - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -36273,21 +35039,7 @@ "target": "com.amazonaws.ec2#DescribeSpotDatafeedSubscriptionResult" }, "traits": { - "smithy.api#documentation": "

    Describes the data feed for Spot Instances. For more information, see Spot\n Instance data feed in the Amazon EC2 User Guide for Linux Instances.

    ", - "smithy.api#examples": [ - { - "title": "To describe the datafeed for your AWS account", - "documentation": "This example describes the Spot Instance datafeed subscription for your AWS account.", - "output": { - "SpotDatafeedSubscription": { - "OwnerId": "123456789012", - "Prefix": "spotdata", - "Bucket": "my-s3-bucket", - "State": "Active" - } - } - } - ] + "smithy.api#documentation": "

    Describes the data feed for Spot Instances. For more information, see Spot\n Instance data feed in the Amazon EC2 User Guide for Linux Instances.

    " } }, "com.amazonaws.ec2#DescribeSpotDatafeedSubscriptionRequest": { @@ -36574,58 +35326,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes your Spot Fleet requests.

    \n

    Spot Fleet requests are deleted 48 hours after they are canceled and their instances\n are terminated.

    ", - "smithy.api#examples": [ - { - "title": "To describe a Spot fleet request", - "documentation": "This example describes the specified Spot fleet request.", - "input": { - "SpotFleetRequestIds": ["sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"] - }, - "output": { - "SpotFleetRequestConfigs": [ - { - "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE", - "SpotFleetRequestConfig": { - "TargetCapacity": 20, - "LaunchSpecifications": [ - { - "EbsOptimized": false, - "NetworkInterfaces": [ - { - "SubnetId": "subnet-a61dafcf", - "DeviceIndex": 0, - "DeleteOnTermination": false, - "AssociatePublicIpAddress": true, - "SecondaryPrivateIpAddressCount": 0 - } - ], - "InstanceType": "cc2.8xlarge", - "ImageId": "ami-1a2b3c4d" - }, - { - "EbsOptimized": false, - "NetworkInterfaces": [ - { - "SubnetId": "subnet-a61dafcf", - "DeviceIndex": 0, - "DeleteOnTermination": false, - "AssociatePublicIpAddress": true, - "SecondaryPrivateIpAddressCount": 0 - } - ], - "InstanceType": "r3.8xlarge", - "ImageId": "ami-1a2b3c4d" - } - ], - "SpotPrice": "0.05", - "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role" - }, - "SpotFleetRequestState": "active" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -36714,56 +35414,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified Spot Instance requests.

    \n

    You can use DescribeSpotInstanceRequests to find a running Spot Instance by\n examining the response. If the status of the Spot Instance is fulfilled, the\n instance ID appears in the response and contains the identifier of the instance.\n Alternatively, you can use DescribeInstances\n with a filter to look for instances where the instance lifecycle is\n spot.

    \n

    We recommend that you set MaxResults to a value between 5 and 1000 to\n limit the number of items returned. This paginates the output, which makes the list\n more manageable and returns the items faster. If the list of items exceeds your\n MaxResults value, then that number of items is returned along with a\n NextToken value that can be passed to a subsequent\n DescribeSpotInstanceRequests request to retrieve the remaining\n items.

    \n

    Spot Instance requests are deleted four hours after they are canceled and their instances are\n terminated.

    ", - "smithy.api#examples": [ - { - "title": "To describe a Spot Instance request", - "documentation": "This example describes the specified Spot Instance request.", - "input": { - "SpotInstanceRequestIds": ["sir-08b93456"] - }, - "output": { - "SpotInstanceRequests": [ - { - "Status": { - "UpdateTime": "2014-04-30T18:16:21.000Z", - "Code": "fulfilled", - "Message": "Your Spot request is fulfilled." - }, - "ProductDescription": "Linux/UNIX", - "InstanceId": "i-1234567890abcdef0", - "SpotInstanceRequestId": "sir-08b93456", - "State": "active", - "LaunchedAvailabilityZone": "us-west-1b", - "LaunchSpecification": { - "ImageId": "ami-7aba833f", - "KeyName": "my-key-pair", - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sda1", - "Ebs": { - "DeleteOnTermination": true, - "VolumeType": "standard", - "VolumeSize": 8 - } - } - ], - "EbsOptimized": false, - "SecurityGroups": [ - { - "GroupName": "my-security-group", - "GroupId": "sg-e38f24a7" - } - ], - "InstanceType": "m1.small" - }, - "Type": "one-time", - "CreateTime": "2014-04-30T18:14:55.000Z", - "SpotPrice": "0.010000" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -36928,36 +35578,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the Spot price history. For more information, see Spot Instance pricing history in the\n Amazon EC2 User Guide for Linux Instances.

    \n

    When you specify a start and end time, the operation returns the prices of the\n instance types within that time range. It also returns the last price change before the\n start time, which is the effective price as of the start time.

    ", - "smithy.api#examples": [ - { - "title": "To describe Spot price history for Linux/UNIX (Amazon VPC)", - "documentation": "This example returns the Spot Price history for m1.xlarge, Linux/UNIX (Amazon VPC) instances for a particular day in January.", - "input": { - "StartTime": "2014-01-06T07:08:09.05Z", - "EndTime": "2014-01-06T08:09:10.05Z", - "InstanceTypes": ["m1.xlarge"], - "ProductDescriptions": ["Linux/UNIX (Amazon VPC)"] - }, - "output": { - "SpotPriceHistory": [ - { - "Timestamp": "2014-01-06T04:32:53.000Z", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "InstanceType": "m1.xlarge", - "SpotPrice": "0.080000", - "AvailabilityZone": "us-west-1a" - }, - { - "Timestamp": "2014-01-05T11:28:26.000Z", - "ProductDescription": "Linux/UNIX (Amazon VPC)", - "InstanceType": "m1.xlarge", - "SpotPrice": "0.080000", - "AvailabilityZone": "us-west-1c" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -37278,34 +35898,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your subnets.

    \n

    For more information, see Your VPC and subnets in the\n\t\t\t\tAmazon Virtual Private Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe the subnets for a VPC", - "documentation": "This example describes the subnets for the specified VPC.", - "input": { - "Filters": [ - { - "Name": "vpc-id", - "Values": ["vpc-a01106c2"] - } - ] - }, - "output": { - "Subnets": [ - { - "VpcId": "vpc-a01106c2", - "CidrBlock": "10.0.1.0/24", - "MapPublicIpOnLaunch": false, - "DefaultForAz": false, - "State": "available", - "AvailabilityZone": "us-east-1c", - "SubnetId": "subnet-9d4a7b6c", - "AvailableIpAddressCount": 251 - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -37421,36 +36013,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified tags for your EC2 resources.

    \n

    For more information about tags, see Tag your Amazon EC2 resources in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe the tags for a single resource", - "documentation": "This example describes the tags for the specified instance.", - "input": { - "Filters": [ - { - "Name": "resource-id", - "Values": ["i-1234567890abcdef8"] - } - ] - }, - "output": { - "Tags": [ - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef8", - "Value": "test", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef8", - "Value": "Beta Server", - "Key": "Name" - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -39237,23 +37799,7 @@ "target": "com.amazonaws.ec2#DescribeVolumeAttributeResult" }, "traits": { - "smithy.api#documentation": "

    Describes the specified attribute of the specified volume. You can specify only one\n attribute at a time.

    \n

    For more information about EBS volumes, see Amazon EBS volumes in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe a volume attribute", - "documentation": "This example describes the ``autoEnableIo`` attribute of the volume with the ID ``vol-049df61146c4d7901``.", - "input": { - "VolumeId": "vol-049df61146c4d7901", - "Attribute": "autoEnableIO" - }, - "output": { - "AutoEnableIO": { - "Value": false - }, - "VolumeId": "vol-049df61146c4d7901" - } - } - ] + "smithy.api#documentation": "

    Describes the specified attribute of the specified volume. You can specify only one\n attribute at a time.

    \n

    For more information about EBS volumes, see Amazon EBS volumes in the Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DescribeVolumeAttributeRequest": { @@ -39332,38 +37878,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the status of the specified volumes. Volume status provides the result of the\n checks performed on your volumes to determine events that can impair the performance of your\n volumes. The performance of a volume can be affected if an issue occurs on the volume's\n underlying host. If the volume's underlying host experiences a power outage or system issue,\n after the system is restored, there could be data inconsistencies on the volume. Volume events\n notify you if this occurs. Volume actions notify you if any action needs to be taken in\n response to the event.

    \n

    The DescribeVolumeStatus operation provides the following information about\n the specified volumes:

    \n

    \n Status: Reflects the current status of the volume. The possible\n values are ok, impaired , warning, or\n insufficient-data. If all checks pass, the overall status of the volume is\n ok. If the check fails, the overall status is impaired. If the\n status is insufficient-data, then the checks might still be taking place on your\n volume at the time. We recommend that you retry the request. For more information about volume\n status, see Monitor the status of your volumes in the\n Amazon Elastic Compute Cloud User Guide.

    \n

    \n Events: Reflect the cause of a volume status and might require you to\n take action. For example, if your volume returns an impaired status, then the\n volume event might be potential-data-inconsistency. This means that your volume\n has been affected by an issue with the underlying host, has all I/O operations disabled, and\n might have inconsistent data.

    \n

    \n Actions: Reflect the actions you might have to take in response to an\n event. For example, if the status of the volume is impaired and the volume event\n shows potential-data-inconsistency, then the action shows\n enable-volume-io. This means that you may want to enable the I/O operations for\n the volume by calling the EnableVolumeIO action and then check the volume\n for data consistency.

    \n

    Volume status is based on the volume status checks, and does not reflect the volume state.\n Therefore, volume status does not indicate volumes in the error state (for\n example, when a volume is incapable of accepting I/O.)

    ", - "smithy.api#examples": [ - { - "title": "To describe the status of a single volume", - "documentation": "This example describes the status for the volume ``vol-1234567890abcdef0``.", - "input": { - "VolumeIds": ["vol-1234567890abcdef0"] - }, - "output": { - "VolumeStatuses": [ - { - "VolumeStatus": { - "Status": "ok", - "Details": [ - { - "Status": "passed", - "Name": "io-enabled" - }, - { - "Status": "not-applicable", - "Name": "io-performance" - } - ] - }, - "AvailabilityZone": "us-east-1a", - "VolumeId": "vol-1234567890abcdef0", - "Actions": [], - "Events": [] - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -39452,36 +37966,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes the specified EBS volumes or all of your EBS volumes.

    \n

    If you are describing a long list of volumes, we recommend that you paginate the output to make the list\n more manageable. For more information, see Pagination.

    \n

    For more information about EBS volumes, see Amazon EBS volumes in the Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To describe all volumes", - "documentation": "This example describes all of your volumes in the default region.", - "output": { - "Volumes": [ - { - "AvailabilityZone": "us-east-1a", - "Attachments": [ - { - "AttachTime": "2013-12-18T22:35:00.000Z", - "InstanceId": "i-1234567890abcdef0", - "VolumeId": "vol-049df61146c4d7901", - "State": "attached", - "DeleteOnTermination": true, - "Device": "/dev/sda1" - } - ], - "VolumeType": "standard", - "VolumeId": "vol-049df61146c4d7901", - "State": "in-use", - "SnapshotId": "snap-1234567890abcdef0", - "CreateTime": "2013-12-18T22:35:00.084Z", - "Size": 8 - } - ], - "NextToken": "" - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -39733,23 +38217,7 @@ "target": "com.amazonaws.ec2#DescribeVpcAttributeResult" }, "traits": { - "smithy.api#documentation": "

    Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

    ", - "smithy.api#examples": [ - { - "title": "To describe the enableDnsSupport attribute", - "documentation": "This example describes the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.", - "input": { - "VpcId": "vpc-a01106c2", - "Attribute": "enableDnsSupport" - }, - "output": { - "VpcId": "vpc-a01106c2", - "EnableDnsSupport": { - "Value": true - } - } - } - ] + "smithy.api#documentation": "

    Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

    " } }, "com.amazonaws.ec2#DescribeVpcAttributeRequest": { @@ -40640,33 +39108,6 @@ }, "traits": { "smithy.api#documentation": "

    Describes one or more of your VPCs.

    ", - "smithy.api#examples": [ - { - "title": "To describe a VPC", - "documentation": "This example describes the specified VPC.", - "input": { - "VpcIds": ["vpc-a01106c2"] - }, - "output": { - "Vpcs": [ - { - "VpcId": "vpc-a01106c2", - "InstanceTenancy": "default", - "Tags": [ - { - "Value": "MyVPC", - "Key": "Name" - } - ], - "State": "available", - "DhcpOptionsId": "dopt-7a8b9c2d", - "CidrBlock": "10.0.0.0/16", - "IsDefault": false - } - ] - } - } - ], "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -41312,23 +39753,7 @@ "target": "com.amazonaws.ec2#VolumeAttachment" }, "traits": { - "smithy.api#documentation": "

    Detaches an EBS volume from an instance. Make sure to unmount any file systems on the\n device within your operating system before detaching the volume. Failure to do so can result\n in the volume becoming stuck in the busy state while detaching. If this happens,\n detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot\n the instance, or all three. If an EBS volume is the root device of an instance, it can't be\n detached while the instance is running. To detach the root volume, stop the instance\n first.

    \n

    When a volume with an Amazon Web Services Marketplace product code is detached from an instance, the\n product code is no longer associated with the instance.

    \n

    For more information, see Detach an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To detach a volume from an instance", - "documentation": "This example detaches the volume (``vol-049df61146c4d7901``) from the instance it is attached to.", - "input": { - "VolumeId": "vol-1234567890abcdef0" - }, - "output": { - "AttachTime": "2014-02-27T19:23:06.000Z", - "InstanceId": "i-1234567890abcdef0", - "VolumeId": "vol-049df61146c4d7901", - "State": "detaching", - "Device": "/dev/sdb" - } - } - ] + "smithy.api#documentation": "

    Detaches an EBS volume from an instance. Make sure to unmount any file systems on the\n device within your operating system before detaching the volume. Failure to do so can result\n in the volume becoming stuck in the busy state while detaching. If this happens,\n detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot\n the instance, or all three. If an EBS volume is the root device of an instance, it can't be\n detached while the instance is running. To detach the root volume, stop the instance\n first.

    \n

    When a volume with an Amazon Web Services Marketplace product code is detached from an instance, the\n product code is no longer associated with the instance.

    \n

    For more information, see Detach an Amazon EBS volume in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#DetachVolumeRequest": { @@ -42393,17 +40818,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Disables a virtual private gateway (VGW) from propagating routes to a specified route\n table of a VPC.

    ", - "smithy.api#examples": [ - { - "title": "To disable route propagation", - "documentation": "This example disables the specified virtual private gateway from propagating static routes to the specified route table.", - "input": { - "RouteTableId": "rtb-22574640", - "GatewayId": "vgw-9a4cacf3" - } - } - ] + "smithy.api#documentation": "

    Disables a virtual private gateway (VGW) from propagating routes to a specified route\n table of a VPC.

    " } }, "com.amazonaws.ec2#DisableVgwRoutePropagationRequest": { @@ -42551,16 +40966,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Disassociates an Elastic IP address from the instance or network interface it's associated with.

    \n

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

    ", - "smithy.api#examples": [ - { - "title": "To disassociate an Elastic IP address", - "documentation": "This example disassociates an Elastic IP address from an instance.", - "input": { - "AssociationId": "eipassoc-2bebb745" - } - } - ] + "smithy.api#documentation": "

    Disassociates an Elastic IP address from the instance or network interface it's associated with.

    \n

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

    " } }, "com.amazonaws.ec2#DisassociateAddressRequest": { @@ -42732,27 +41138,7 @@ "target": "com.amazonaws.ec2#DisassociateIamInstanceProfileResult" }, "traits": { - "smithy.api#documentation": "

    Disassociates an IAM instance profile from a running or stopped instance.

    \n

    Use DescribeIamInstanceProfileAssociations to get the association\n ID.

    ", - "smithy.api#examples": [ - { - "title": "To disassociate an IAM instance profile", - "documentation": "This example disassociates the specified IAM instance profile from an instance.", - "input": { - "AssociationId": "iip-assoc-05020b59952902f5f" - }, - "output": { - "IamInstanceProfileAssociation": { - "InstanceId": "i-123456789abcde123", - "State": "disassociating", - "AssociationId": "iip-assoc-05020b59952902f5f", - "IamInstanceProfile": { - "Id": "AIPAI5IVIHMFFYY2DKV5Y", - "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role" - } - } - } - } - ] + "smithy.api#documentation": "

    Disassociates an IAM instance profile from a running or stopped instance.

    \n

    Use DescribeIamInstanceProfileAssociations to get the association\n ID.

    " } }, "com.amazonaws.ec2#DisassociateIamInstanceProfileRequest": { @@ -45679,17 +44065,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Enables a virtual private gateway (VGW) to propagate routes to the specified route\n table of a VPC.

    ", - "smithy.api#examples": [ - { - "title": "To enable route propagation", - "documentation": "This example enables the specified virtual private gateway to propagate static routes to the specified route table.", - "input": { - "RouteTableId": "rtb-22574640", - "GatewayId": "vgw-9a4cacf3" - } - } - ] + "smithy.api#documentation": "

    Enables a virtual private gateway (VGW) to propagate routes to the specified route\n table of a VPC.

    " } }, "com.amazonaws.ec2#EnableVgwRoutePropagationRequest": { @@ -48337,7 +46713,7 @@ "target": "com.amazonaws.ec2#ImageId", "traits": { "aws.protocols#ec2QueryName": "ImageId", - "smithy.api#documentation": "

    The ID of the AMI. An AMI is required to launch an instance. The AMI ID must be specified here or in the launch template.

    ", + "smithy.api#documentation": "

    The ID of the AMI. An AMI is required to launch an instance. This parameter is only\n available for fleets of type instant. For fleets of type maintain\n and request, you must specify the AMI ID in the launch template.

    ", "smithy.api#xmlName": "imageId" } } @@ -48422,7 +46798,7 @@ "ImageId": { "target": "com.amazonaws.ec2#ImageId", "traits": { - "smithy.api#documentation": "

    The ID of the AMI. An AMI is required to launch an instance. The AMI ID must be specified here or in the launch template.

    " + "smithy.api#documentation": "

    The ID of the AMI. An AMI is required to launch an instance. This parameter is only\n available for fleets of type instant. For fleets of type maintain\n and request, you must specify the AMI ID in the launch template.

    " } } }, @@ -49781,21 +48157,7 @@ "target": "com.amazonaws.ec2#GetConsoleOutputResult" }, "traits": { - "smithy.api#documentation": "

    Gets the console output for the specified instance. For Linux instances, the instance\n console output displays the exact console output that would normally be displayed on a\n physical monitor attached to a computer. For Windows instances, the instance console\n output includes the last three system event log errors.

    \n

    By default, the console output returns buffered information that was posted shortly\n after an instance transition state (start, stop, reboot, or terminate). This information\n is available for at least one hour after the most recent post. Only the most recent 64\n KB of console output is available.

    \n

    You can optionally retrieve the latest serial console output at any time during the\n instance lifecycle. This option is supported on instance types that use the Nitro\n hypervisor.

    \n

    For more information, see Instance\n console output in the Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To get the console output", - "documentation": "This example gets the console output for the specified instance.", - "input": { - "InstanceId": "i-1234567890abcdef0" - }, - "output": { - "InstanceId": "i-1234567890abcdef0", - "Output": "...", - "Timestamp": "2018-05-25T21:23:53.000Z" - } - } - ] + "smithy.api#documentation": "

    Gets the console output for the specified instance. For Linux instances, the instance\n console output displays the exact console output that would normally be displayed on a\n physical monitor attached to a computer. For Windows instances, the instance console\n output includes the last three system event log errors.

    \n

    By default, the console output returns buffered information that was posted shortly\n after an instance transition state (start, stop, reboot, or terminate). This information\n is available for at least one hour after the most recent post. Only the most recent 64\n KB of console output is available.

    \n

    You can optionally retrieve the latest serial console output at any time during the\n instance lifecycle. This option is supported on instance types that use the Nitro\n hypervisor.

    \n

    For more information, see Instance\n console output in the Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#GetConsoleOutputRequest": { @@ -51080,64 +49442,7 @@ "target": "com.amazonaws.ec2#GetLaunchTemplateDataResult" }, "traits": { - "smithy.api#documentation": "

    Retrieves the configuration data of the specified instance. You can use this data to\n create a launch template.

    \n

    This action calls on other describe actions to get instance information. Depending on\n your instance configuration, you may need to allow the following actions in your IAM\n policy: DescribeSpotInstanceRequests,\n DescribeInstanceCreditSpecifications, DescribeVolumes,\n DescribeInstanceAttribute, and DescribeElasticGpus. Or,\n you can allow describe* depending on your instance requirements.

    ", - "smithy.api#examples": [ - { - "title": "To get the launch template data for an instance ", - "documentation": "This example gets the launch template data for the specified instance.", - "input": { - "InstanceId": "0123d646e8048babc" - }, - "output": { - "LaunchTemplateData": { - "NetworkInterfaces": [ - { - "DeviceIndex": 0, - "Groups": ["sg-d14e1bb4"], - "Ipv6Addresses": [], - "AssociatePublicIpAddress": false, - "NetworkInterfaceId": "eni-4338b5a9", - "DeleteOnTermination": true, - "Description": "", - "PrivateIpAddress": "10.0.3.233", - "SubnetId": "subnet-5264e837", - "PrivateIpAddresses": [ - { - "PrivateIpAddress": "10.0.3.233", - "Primary": true - } - ] - } - ], - "Placement": { - "GroupName": "", - "Tenancy": "default", - "AvailabilityZone": "us-east-2b" - }, - "InstanceType": "t2.medium", - "EbsOptimized": false, - "BlockDeviceMappings": [ - { - "Ebs": { - "VolumeType": "gp2", - "Encrypted": false, - "Iops": 100, - "VolumeSize": 8, - "SnapshotId": "snap-02594938353ef77d3", - "DeleteOnTermination": true - }, - "DeviceName": "/dev/xvda" - } - ], - "KeyName": "my-key-pair", - "ImageId": "ami-32cf7b4a", - "Monitoring": { - "Enabled": false - } - } - } - } - ] + "smithy.api#documentation": "

    Retrieves the configuration data of the specified instance. You can use this data to\n create a launch template.

    \n

    This action calls on other describe actions to get instance information. Depending on\n your instance configuration, you may need to allow the following actions in your IAM\n policy: DescribeSpotInstanceRequests,\n DescribeInstanceCreditSpecifications, DescribeVolumes,\n DescribeInstanceAttribute, and DescribeElasticGpus. Or,\n you can allow describe* depending on your instance requirements.

    " } }, "com.amazonaws.ec2#GetLaunchTemplateDataRequest": { @@ -53381,6 +51686,14 @@ "smithy.api#documentation": "

    Indicates whether host maintenance is enabled or disabled for the Dedicated\n Host.

    ", "smithy.api#xmlName": "hostMaintenance" } + }, + "AssetId": { + "target": "com.amazonaws.ec2#AssetId", + "traits": { + "aws.protocols#ec2QueryName": "AssetId", + "smithy.api#documentation": "

    The ID of the Outpost hardware asset on which the Dedicated Host is allocated.

    ", + "smithy.api#xmlName": "assetId" + } } }, "traits": { @@ -66982,7 +65295,7 @@ "target": "com.amazonaws.ec2#FleetLaunchTemplateSpecification", "traits": { "aws.protocols#ec2QueryName": "LaunchTemplateSpecification", - "smithy.api#documentation": "

    The launch template.

    ", + "smithy.api#documentation": "

    The launch template to use. Make sure that the launch template does not contain the\n NetworkInterfaceId parameter because you can't specify a network interface\n ID in a Spot Fleet.

    ", "smithy.api#xmlName": "launchTemplateSpecification" } }, @@ -71227,24 +69540,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

    \n

    To specify the attribute, you can use the Attribute parameter, or one of the following parameters: \n Description, ImdsSupport, or LaunchPermission.

    \n

    Images with an Amazon Web Services Marketplace product code cannot be made public.

    \n

    To enable the SriovNetSupport enhanced networking attribute of an image, enable SriovNetSupport on an instance \n and create an AMI from the instance.

    ", - "smithy.api#examples": [ - { - "title": "To make an AMI public", - "documentation": "This example makes the specified AMI public.", - "input": { - "ImageId": "ami-5731123e", - "LaunchPermission": { - "Add": [ - { - "Group": "all" - } - ] - } - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time.

    \n

    To specify the attribute, you can use the Attribute parameter, or one of the following parameters: \n Description, ImdsSupport, or LaunchPermission.

    \n

    Images with an Amazon Web Services Marketplace product code cannot be made public.

    \n

    To enable the SriovNetSupport enhanced networking attribute of an image, enable SriovNetSupport on an instance \n and create an AMI from the instance.

    " } }, "com.amazonaws.ec2#ModifyImageAttributeRequest": { @@ -71977,7 +70273,7 @@ "target": "com.amazonaws.ec2#HostTenancy", "traits": { "aws.protocols#ec2QueryName": "Tenancy", - "smithy.api#documentation": "

    The tenancy for the instance.

    \n \n

    For T3 instances, you can't change the tenancy from dedicated to\n host, or from host to dedicated.\n Attempting to make one of these unsupported tenancy changes results in the\n InvalidTenancy error code.

    \n     ", + "smithy.api#documentation": "

    The tenancy for the instance.

    \n \n

    For T3 instances, you must launch the instance on a Dedicated Host to use a\n tenancy of host. You can't change the tenancy from\n host to dedicated or default.\n Attempting to make one of these unsupported tenancy changes results in an\n InvalidRequest error code.

    \n     ", "smithy.api#xmlName": "tenancy" } }, @@ -71992,7 +70288,7 @@ "HostResourceGroupArn": { "target": "com.amazonaws.ec2#String", "traits": { - "smithy.api#documentation": "

    The ARN of the host resource group in which to place the instance.

    " + "smithy.api#documentation": "

    The ARN of the host resource group in which to place the instance. The instance must\n have a tenancy of host to specify this parameter.

    " } }, "GroupId": { @@ -72438,27 +70734,7 @@ "target": "com.amazonaws.ec2#ModifyLaunchTemplateResult" }, "traits": { - "smithy.api#documentation": "

    Modifies a launch template. You can specify which version of the launch template to\n set as the default version. When launching an instance, the default version applies when\n a launch template version is not specified.

    ", - "smithy.api#examples": [ - { - "title": "To change the default version of a launch template", - "documentation": "This example specifies version 2 as the default version of the specified launch template.", - "input": { - "LaunchTemplateId": "lt-0abcd290751193123", - "DefaultVersion": "2" - }, - "output": { - "LaunchTemplate": { - "LatestVersionNumber": 2, - "LaunchTemplateId": "lt-0abcd290751193123", - "LaunchTemplateName": "WebServers", - "DefaultVersionNumber": 2, - "CreatedBy": "arn:aws:iam::123456789012:root", - "CreateTime": "2017-12-01T13:35:46.000Z" - } - } - } - ] + "smithy.api#documentation": "

    Modifies a launch template. You can specify which version of the launch template to\n set as the default version. When launching an instance, the default version applies when\n a launch template version is not specified.

    " } }, "com.amazonaws.ec2#ModifyLaunchTemplateRequest": { @@ -72972,20 +71248,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Adds or removes permission settings for the specified snapshot. You may add or remove\n specified Amazon Web Services account IDs from a snapshot's list of create volume permissions, but you cannot\n do both in a single operation. If you need to both add and remove account IDs for a snapshot,\n you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.

    \n

    Encrypted snapshots and snapshots with Amazon Web Services Marketplace product codes cannot be made\n public. Snapshots encrypted with your default KMS key cannot be shared with other accounts.

    \n

    For more information about modifying snapshot permissions, see Share a snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To modify a snapshot attribute", - "documentation": "This example modifies snapshot ``snap-1234567890abcdef0`` to remove the create volume permission for a user with the account ID ``123456789012``. If the command succeeds, no output is returned.", - "input": { - "SnapshotId": "snap-1234567890abcdef0", - "Attribute": "createVolumePermission", - "OperationType": "remove", - "UserIds": ["123456789012"] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Adds or removes permission settings for the specified snapshot. You may add or remove\n specified Amazon Web Services account IDs from a snapshot's list of create volume permissions, but you cannot\n do both in a single operation. If you need to both add and remove account IDs for a snapshot,\n you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.

    \n

    Encrypted snapshots and snapshots with Amazon Web Services Marketplace product codes cannot be made\n public. Snapshots encrypted with your default KMS key cannot be shared with other accounts.

    \n

    For more information about modifying snapshot permissions, see Share a snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#ModifySnapshotAttributeRequest": { @@ -73210,19 +71473,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Modifies a subnet attribute. You can only modify one attribute at a time.

    \n

    Use this action to modify subnets on Amazon Web Services Outposts.

    \n \n

    For more information about Amazon Web Services Outposts, see the following:

    \n ", - "smithy.api#examples": [ - { - "title": "To change a subnet's public IP addressing behavior", - "documentation": "This example modifies the specified subnet so that all instances launched into this subnet are assigned a public IP address.", - "input": { - "SubnetId": "subnet-1a2b3c4d", - "MapPublicIpOnLaunch": { - "Value": true - } - } - } - ] + "smithy.api#documentation": "

    Modifies a subnet attribute. You can only modify one attribute at a time.

    \n

    Use this action to modify subnets on Amazon Web Services Outposts.

    \n \n

    For more information about Amazon Web Services Outposts, see the following:

    \n " } }, "com.amazonaws.ec2#ModifySubnetAttributeRequest": { @@ -74549,21 +72800,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Modifies a volume attribute.

    \n

    By default, all I/O operations for the volume are suspended when the data on the volume is\n determined to be potentially inconsistent, to prevent undetectable, latent data corruption.\n The I/O access to the volume can be resumed by first enabling I/O access and then checking the\n data consistency on your volume.

    \n

    You can change the default behavior to resume I/O operations. We recommend that you change\n this only for boot volumes or for volumes that are stateless or disposable.

    ", - "smithy.api#examples": [ - { - "title": "To modify a volume attribute", - "documentation": "This example sets the ``autoEnableIo`` attribute of the volume with the ID ``vol-1234567890abcdef0`` to ``true``. If the command succeeds, no output is returned.", - "input": { - "DryRun": true, - "VolumeId": "vol-1234567890abcdef0", - "AutoEnableIO": { - "Value": true - } - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Modifies a volume attribute.

    \n

    By default, all I/O operations for the volume are suspended when the data on the volume is\n determined to be potentially inconsistent, to prevent undetectable, latent data corruption.\n The I/O access to the volume can be resumed by first enabling I/O access and then checking the\n data consistency on your volume.

    \n

    You can change the default behavior to resume I/O operations. We recommend that you change\n this only for boot volumes or for volumes that are stateless or disposable.

    " } }, "com.amazonaws.ec2#ModifyVolumeAttributeRequest": { @@ -74685,19 +72922,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Modifies the specified attribute of the specified VPC.

    ", - "smithy.api#examples": [ - { - "title": "To modify the enableDnsSupport attribute", - "documentation": "This example modifies the enableDnsSupport attribute. This attribute indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for instances in the VPC to their corresponding IP addresses; otherwise, it does not.", - "input": { - "VpcId": "vpc-a01106c2", - "EnableDnsSupport": { - "Value": false - } - } - } - ] + "smithy.api#documentation": "

    Modifies the specified attribute of the specified VPC.

    " } }, "com.amazonaws.ec2#ModifyVpcAttributeRequest": { @@ -75618,7 +73843,7 @@ } }, "PreSharedKey": { - "target": "com.amazonaws.ec2#String", + "target": "com.amazonaws.ec2#preSharedKey", "traits": { "smithy.api#documentation": "

    The pre-shared key (PSK) to establish initial authentication between the virtual\n private gateway and the customer gateway.

    \n

    Constraints: Allowed characters are alphanumeric characters, periods (.), and\n underscores (_). Must be between 8 and 64 characters in length and cannot start with\n zero (0).

    " } @@ -75748,7 +73973,8 @@ } }, "traits": { - "smithy.api#documentation": "

    The Amazon Web Services Site-to-Site VPN tunnel options to modify.

    " + "smithy.api#documentation": "

    The Amazon Web Services Site-to-Site VPN tunnel options to modify.

    ", + "smithy.api#sensitive": {} } }, "com.amazonaws.ec2#MonitorInstances": { @@ -80654,7 +78880,7 @@ "target": "com.amazonaws.ec2#SupportedAdditionalProcessorFeatureList", "traits": { "aws.protocols#ec2QueryName": "SupportedFeatures", - "smithy.api#documentation": "

    Indicates whether the instance type supports AMD SEV-SNP. If the request returns \n amd-sev-snp, AMD SEV-SNP is supported. Otherwise, it is not supported.

    ", + "smithy.api#documentation": "

    Indicates whether the instance type supports AMD SEV-SNP. If the request returns \n amd-sev-snp, AMD SEV-SNP is supported. Otherwise, it is not supported. \n For more information, see \n AMD SEV-SNP.

    ", "smithy.api#xmlName": "supportedFeatures" } } @@ -81717,17 +79943,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Requests a reboot of the specified instances. This operation is asynchronous; it only\n queues a request to reboot the specified instances. The operation succeeds if the\n instances are valid and belong to you. Requests to reboot terminated instances are\n ignored.

    \n

    If an instance does not cleanly shut down within a few minutes, Amazon EC2 performs a\n hard reboot.

    \n

    For more information about troubleshooting, see Troubleshoot an unreachable\n instance in the Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To reboot an EC2 instance", - "documentation": "This example reboots the specified EC2 instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef5"] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Requests a reboot of the specified instances. This operation is asynchronous; it only\n queues a request to reboot the specified instances. The operation succeeds if the\n instances are valid and belong to you. Requests to reboot terminated instances are\n ignored.

    \n

    If an instance does not cleanly shut down within a few minutes, Amazon EC2 performs a\n hard reboot.

    \n

    For more information about troubleshooting, see Troubleshoot an unreachable\n instance in the Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#RebootInstancesRequest": { @@ -82582,16 +80798,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Releases the specified Elastic IP address.

    \n

    [Default VPC] Releasing an Elastic IP address automatically disassociates it\n\t\t\t\tfrom any instance that it's associated with. To disassociate an Elastic IP address without\n\t\t\t\treleasing it, use DisassociateAddress.

    \n

    [Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address\n\t\t\t before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

    \n

    After releasing an Elastic IP address, it is released to the IP address pool. \n Be sure to update your DNS records and any servers or devices that communicate with the address. \n If you attempt to release an Elastic IP address that you already released, you'll get an\n AuthFailure error if the address is already allocated to another Amazon Web Services account.

    \n

    After you release an Elastic IP address, you might be able to recover it.\n For more information, see AllocateAddress.

    ", - "smithy.api#examples": [ - { - "title": "To release an Elastic IP address", - "documentation": "This example releases the specified Elastic IP address.", - "input": { - "AllocationId": "eipalloc-64d5890a" - } - } - ] + "smithy.api#documentation": "

    Releases the specified Elastic IP address.

    \n

    [Default VPC] Releasing an Elastic IP address automatically disassociates it\n\t\t\t\tfrom any instance that it's associated with. To disassociate an Elastic IP address without\n\t\t\t\treleasing it, use DisassociateAddress.

    \n

    [Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address\n\t\t\t before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

    \n

    After releasing an Elastic IP address, it is released to the IP address pool. \n Be sure to update your DNS records and any servers or devices that communicate with the address. \n If you attempt to release an Elastic IP address that you already released, you'll get an\n AuthFailure error if the address is already allocated to another Amazon Web Services account.

    \n

    After you release an Elastic IP address, you might be able to recover it.\n For more information, see AllocateAddress.

    " } }, "com.amazonaws.ec2#ReleaseAddressRequest": { @@ -84084,30 +82291,7 @@ "target": "com.amazonaws.ec2#RequestSpotInstancesResult" }, "traits": { - "smithy.api#documentation": "

    Creates a Spot Instance request.

    \n

    For more information, see Spot Instance requests in\n the Amazon EC2 User Guide for Linux Instances.

    \n \n

    We strongly discourage using the RequestSpotInstances API because it is a legacy\n API with no planned investment. For options for requesting Spot Instances, see\n Which\n is the best Spot request method to use? in the\n Amazon EC2 User Guide for Linux Instances.

    \n     ", - "smithy.api#examples": [ - { - "title": "To create a one-time Spot Instance request", - "documentation": "This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone.", - "input": { - "SpotPrice": "0.03", - "InstanceCount": 5, - "Type": "one-time", - "LaunchSpecification": { - "ImageId": "ami-1a2b3c4d", - "KeyName": "my-key-pair", - "SecurityGroupIds": ["sg-1a2b3c4d"], - "InstanceType": "m3.medium", - "Placement": { - "AvailabilityZone": "us-west-2a" - }, - "IamInstanceProfile": { - "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role" - } - } - } - } - ] + "smithy.api#documentation": "

    Creates a Spot Instance request.

    \n

    For more information, see Spot Instance requests in\n the Amazon EC2 User Guide for Linux Instances.

    \n \n

    We strongly discourage using the RequestSpotInstances API because it is a legacy\n API with no planned investment. For options for requesting Spot Instances, see\n Which\n is the best Spot request method to use? in the\n Amazon EC2 User Guide for Linux Instances.

    \n     " } }, "com.amazonaws.ec2#RequestSpotInstancesRequest": { @@ -85516,18 +83700,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Resets an attribute of an AMI to its default value.

    ", - "smithy.api#examples": [ - { - "title": "To reset the launchPermission attribute", - "documentation": "This example resets the launchPermission attribute for the specified AMI. By default, AMIs are private.", - "input": { - "Attribute": "launchPermission", - "ImageId": "ami-5731123e" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Resets an attribute of an AMI to its default value.

    " } }, "com.amazonaws.ec2#ResetImageAttributeName": { @@ -85684,18 +83857,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "

    Resets permission settings for the specified snapshot.

    \n

    For more information about modifying snapshot permissions, see Share a snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To reset a snapshot attribute", - "documentation": "This example resets the create volume permissions for snapshot ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.", - "input": { - "SnapshotId": "snap-1234567890abcdef0", - "Attribute": "createVolumePermission" - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Resets permission settings for the specified snapshot.

    \n

    For more information about modifying snapshot permissions, see Share a snapshot in the\n Amazon Elastic Compute Cloud User Guide.

    " } }, "com.amazonaws.ec2#ResetSnapshotAttributeRequest": { @@ -87940,42 +86102,7 @@ "target": "com.amazonaws.ec2#Reservation" }, "traits": { - "smithy.api#documentation": "

    Launches the specified number of instances using an AMI for which you have\n permissions.

    \n

    You can specify a number of options, or leave the default options. The following rules\n apply:

    \n \n

    You can create a launch template,\n which is a resource that contains the parameters to launch an instance. When you launch\n an instance using RunInstances, you can specify the launch template\n instead of specifying the launch parameters.

    \n

    To ensure faster instance launches, break up large requests into smaller batches. For\n example, create five separate launch requests for 100 instances each instead of one\n launch request for 500 instances.

    \n

    An instance is ready for you to use when it's in the running state. You\n can check the state of your instance using DescribeInstances. You can\n tag instances and EBS volumes during launch, after launch, or both. For more\n information, see CreateTags and Tagging your Amazon EC2\n resources.

    \n

    Linux instances have access to the public key of the key pair at boot. You can use\n this key to provide secure access to the instance. Amazon EC2 public images use this\n feature to provide secure access without passwords. For more information, see Key\n pairs.

    \n

    For troubleshooting, see What to do if\n an instance immediately terminates, and Troubleshooting connecting to your instance.

    ", - "smithy.api#examples": [ - { - "title": "To launch an instance", - "documentation": "This example launches an instance using the specified AMI, instance type, security group, subnet, block device mapping, and tags.", - "input": { - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/sdh", - "Ebs": { - "VolumeSize": 100 - } - } - ], - "ImageId": "ami-abc12345", - "InstanceType": "t2.micro", - "KeyName": "my-key-pair", - "MaxCount": 1, - "MinCount": 1, - "SecurityGroupIds": ["sg-1a2b3c4d"], - "SubnetId": "subnet-6e7f829e", - "TagSpecifications": [ - { - "ResourceType": "instance", - "Tags": [ - { - "Key": "Purpose", - "Value": "test" - } - ] - } - ] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Launches the specified number of instances using an AMI for which you have\n permissions.

    \n

    You can specify a number of options, or leave the default options. The following rules\n apply:

    \n \n

    You can create a launch template,\n which is a resource that contains the parameters to launch an instance. When you launch\n an instance using RunInstances, you can specify the launch template\n instead of specifying the launch parameters.

    \n

    To ensure faster instance launches, break up large requests into smaller batches. For\n example, create five separate launch requests for 100 instances each instead of one\n launch request for 500 instances.

    \n

    An instance is ready for you to use when it's in the running state. You\n can check the state of your instance using DescribeInstances. You can\n tag instances and EBS volumes during launch, after launch, or both. For more\n information, see CreateTags and Tagging your Amazon EC2\n resources.

    \n

    Linux instances have access to the public key of the key pair at boot. You can use\n this key to provide secure access to the instance. Amazon EC2 public images use this\n feature to provide secure access without passwords. For more information, see Key\n pairs.

    \n

    For troubleshooting, see What to do if\n an instance immediately terminates, and Troubleshooting connecting to your instance.

    " } }, "com.amazonaws.ec2#RunInstancesMonitoringEnabled": { @@ -88016,7 +86143,7 @@ "InstanceType": { "target": "com.amazonaws.ec2#InstanceType", "traits": { - "smithy.api#documentation": "

    The instance type. For more information, see Instance types in the\n Amazon EC2 User Guide.

    \n

    Default: m1.small\n

    " + "smithy.api#documentation": "

    The instance type. For more information, see Instance types in the\n Amazon EC2 User Guide.

    \n

    When you change your EBS-backed instance type, instance restart or replacement behavior depends on the \n \t\tinstance type compatibility between the old and new types. An instance that's backed by an instance store volume \n \t\tis always replaced. For more information, see Change the instance type in the \n \t\tAmazon EC2 User Guide.

    \n

    Default: m1.small\n

    " } }, "Ipv6AddressCount": { @@ -92637,31 +90764,7 @@ "target": "com.amazonaws.ec2#StartInstancesResult" }, "traits": { - "smithy.api#documentation": "

    Starts an Amazon EBS-backed instance that you've previously stopped.

    \n

    Instances that use Amazon EBS volumes as their root devices can be quickly stopped and\n started. When an instance is stopped, the compute resources are released and you are not\n billed for instance usage. However, your root partition Amazon EBS volume remains and\n continues to persist your data, and you are charged for Amazon EBS volume usage. You can\n restart your instance at any time. Every time you start your instance, Amazon EC2\n charges a one-minute minimum for instance usage, and thereafter charges per second for\n instance usage.

    \n

    Before stopping an instance, make sure it is in a state from which it can be\n restarted. Stopping an instance does not preserve data stored in RAM.

    \n

    Performing this operation on an instance that uses an instance store as its root\n device returns an error.

    \n

    If you attempt to start a T3 instance with host tenancy and the\n unlimted CPU credit option, the request fails. The\n unlimited CPU credit option is not supported on Dedicated Hosts. Before\n you start the instance, either change its CPU credit option to standard, or\n change its tenancy to default or dedicated.

    \n

    For more information, see Stop and start your instance\n in the Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To start a stopped EC2 instance", - "documentation": "This example starts the specified EC2 instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef0"] - }, - "output": { - "StartingInstances": [ - { - "InstanceId": "i-1234567890abcdef0", - "CurrentState": { - "Code": 0, - "Name": "pending" - }, - "PreviousState": { - "Code": 80, - "Name": "stopped" - } - } - ] - } - } - ] + "smithy.api#documentation": "

    Starts an Amazon EBS-backed instance that you've previously stopped.

    \n

    Instances that use Amazon EBS volumes as their root devices can be quickly stopped and\n started. When an instance is stopped, the compute resources are released and you are not\n billed for instance usage. However, your root partition Amazon EBS volume remains and\n continues to persist your data, and you are charged for Amazon EBS volume usage. You can\n restart your instance at any time. Every time you start your instance, Amazon EC2\n charges a one-minute minimum for instance usage, and thereafter charges per second for\n instance usage.

    \n

    Before stopping an instance, make sure it is in a state from which it can be\n restarted. Stopping an instance does not preserve data stored in RAM.

    \n

    Performing this operation on an instance that uses an instance store as its root\n device returns an error.

    \n

    If you attempt to start a T3 instance with host tenancy and the\n unlimted CPU credit option, the request fails. The\n unlimited CPU credit option is not supported on Dedicated Hosts. Before\n you start the instance, either change its CPU credit option to standard, or\n change its tenancy to default or dedicated.

    \n

    For more information, see Stop and start your instance\n in the Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#StartInstancesRequest": { @@ -93096,31 +91199,7 @@ "target": "com.amazonaws.ec2#StopInstancesResult" }, "traits": { - "smithy.api#documentation": "

    Stops an Amazon EBS-backed instance. For more information, see Stop and start\n your instance in the Amazon EC2 User Guide.

    \n

    You can use the Stop action to hibernate an instance if the instance is enabled for\n hibernation and it meets the hibernation\n prerequisites. For more information, see Hibernate your instance in the\n Amazon EC2 User Guide.

    \n

    We don't charge usage for a stopped instance, or data transfer fees; however, your\n root partition Amazon EBS volume remains and continues to persist your data, and you are\n charged for Amazon EBS volume usage. Every time you start your instance, Amazon EC2\n charges a one-minute minimum for instance usage, and thereafter charges per second for\n instance usage.

    \n

    You can't stop or hibernate instance store-backed instances. You can't use the Stop\n action to hibernate Spot Instances, but you can specify that Amazon EC2 should hibernate\n Spot Instances when they are interrupted. For more information, see Hibernating interrupted Spot Instances in the\n Amazon EC2 User Guide.

    \n

    When you stop or hibernate an instance, we shut it down. You can restart your instance\n at any time. Before stopping or hibernating an instance, make sure it is in a state from\n which it can be restarted. Stopping an instance does not preserve data stored in RAM,\n but hibernating an instance does preserve data stored in RAM. If an instance cannot\n hibernate successfully, a normal shutdown occurs.

    \n

    Stopping and hibernating an instance is different to rebooting or terminating it. For\n example, when you stop or hibernate an instance, the root device and any other devices\n attached to the instance persist. When you terminate an instance, the root device and\n any other devices attached during the instance launch are automatically deleted. For\n more information about the differences between rebooting, stopping, hibernating, and\n terminating instances, see Instance lifecycle\n in the Amazon EC2 User Guide.

    \n

    When you stop an instance, we attempt to shut it down forcibly after a short while. If\n your instance appears stuck in the stopping state after a period of time, there may be\n an issue with the underlying host computer. For more information, see Troubleshoot\n stopping your instance in the Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To stop a running EC2 instance", - "documentation": "This example stops the specified EC2 instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef0"] - }, - "output": { - "StoppingInstances": [ - { - "InstanceId": "i-1234567890abcdef0", - "CurrentState": { - "Code": 64, - "Name": "stopping" - }, - "PreviousState": { - "Code": 16, - "Name": "running" - } - } - ] - } - } - ] + "smithy.api#documentation": "

    Stops an Amazon EBS-backed instance. For more information, see Stop and start\n your instance in the Amazon EC2 User Guide.

    \n

    You can use the Stop action to hibernate an instance if the instance is enabled for\n hibernation and it meets the hibernation\n prerequisites. For more information, see Hibernate your instance in the\n Amazon EC2 User Guide.

    \n

    We don't charge usage for a stopped instance, or data transfer fees; however, your\n root partition Amazon EBS volume remains and continues to persist your data, and you are\n charged for Amazon EBS volume usage. Every time you start your instance, Amazon EC2\n charges a one-minute minimum for instance usage, and thereafter charges per second for\n instance usage.

    \n

    You can't stop or hibernate instance store-backed instances. You can't use the Stop\n action to hibernate Spot Instances, but you can specify that Amazon EC2 should hibernate\n Spot Instances when they are interrupted. For more information, see Hibernating interrupted Spot Instances in the\n Amazon EC2 User Guide.

    \n

    When you stop or hibernate an instance, we shut it down. You can restart your instance\n at any time. Before stopping or hibernating an instance, make sure it is in a state from\n which it can be restarted. Stopping an instance does not preserve data stored in RAM,\n but hibernating an instance does preserve data stored in RAM. If an instance cannot\n hibernate successfully, a normal shutdown occurs.

    \n

    Stopping and hibernating an instance is different to rebooting or terminating it. For\n example, when you stop or hibernate an instance, the root device and any other devices\n attached to the instance persist. When you terminate an instance, the root device and\n any other devices attached during the instance launch are automatically deleted. For\n more information about the differences between rebooting, stopping, hibernating, and\n terminating instances, see Instance lifecycle\n in the Amazon EC2 User Guide.

    \n

    When you stop an instance, we attempt to shut it down forcibly after a short while. If\n your instance appears stuck in the stopping state after a period of time, there may be\n an issue with the underlying host computer. For more information, see Troubleshoot\n stopping your instance in the Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#StopInstancesRequest": { @@ -94598,31 +92677,7 @@ "target": "com.amazonaws.ec2#TerminateInstancesResult" }, "traits": { - "smithy.api#documentation": "

    Shuts down the specified instances. This operation is idempotent; if you terminate an\n instance more than once, each call succeeds.

    \n

    If you specify multiple instances and the request fails (for example, because of a\n single incorrect instance ID), none of the instances are terminated.

    \n

    If you terminate multiple instances across multiple Availability Zones, and one or\n more of the specified instances are enabled for termination protection, the request\n fails with the following results:

    \n \n

    For example, say you have the following instances:

    \n \n

    If you attempt to terminate all of these instances in the same request, the request\n reports failure with the following results:

    \n \n

    Terminated instances remain visible after termination (for approximately one\n hour).

    \n

    By default, Amazon EC2 deletes all EBS volumes that were attached when the instance\n launched. Volumes attached after instance launch continue running.

    \n

    You can stop, start, and terminate EBS-backed instances. You can only terminate\n instance store-backed instances. What happens to an instance differs if you stop it or\n terminate it. For example, when you stop an instance, the root device and any other\n devices attached to the instance persist. When you terminate an instance, any attached\n EBS volumes with the DeleteOnTermination block device mapping parameter set\n to true are automatically deleted. For more information about the\n differences between stopping and terminating instances, see Instance lifecycle\n in the Amazon EC2 User Guide.

    \n

    For more information about troubleshooting, see Troubleshooting terminating your instance in the\n Amazon EC2 User Guide.

    ", - "smithy.api#examples": [ - { - "title": "To terminate an EC2 instance", - "documentation": "This example terminates the specified EC2 instance.", - "input": { - "InstanceIds": ["i-1234567890abcdef0"] - }, - "output": { - "TerminatingInstances": [ - { - "InstanceId": "i-1234567890abcdef0", - "CurrentState": { - "Code": 32, - "Name": "shutting-down" - }, - "PreviousState": { - "Code": 16, - "Name": "running" - } - } - ] - } - } - ] + "smithy.api#documentation": "

    Shuts down the specified instances. This operation is idempotent; if you terminate an\n instance more than once, each call succeeds.

    \n

    If you specify multiple instances and the request fails (for example, because of a\n single incorrect instance ID), none of the instances are terminated.

    \n

    If you terminate multiple instances across multiple Availability Zones, and one or\n more of the specified instances are enabled for termination protection, the request\n fails with the following results:

    \n \n

    For example, say you have the following instances:

    \n \n

    If you attempt to terminate all of these instances in the same request, the request\n reports failure with the following results:

    \n \n

    Terminated instances remain visible after termination (for approximately one\n hour).

    \n

    By default, Amazon EC2 deletes all EBS volumes that were attached when the instance\n launched. Volumes attached after instance launch continue running.

    \n

    You can stop, start, and terminate EBS-backed instances. You can only terminate\n instance store-backed instances. What happens to an instance differs if you stop it or\n terminate it. For example, when you stop an instance, the root device and any other\n devices attached to the instance persist. When you terminate an instance, any attached\n EBS volumes with the DeleteOnTermination block device mapping parameter set\n to true are automatically deleted. For more information about the\n differences between stopping and terminating instances, see Instance lifecycle\n in the Amazon EC2 User Guide.

    \n

    For more information about troubleshooting, see Troubleshooting terminating your instance in the\n Amazon EC2 User Guide.

    " } }, "com.amazonaws.ec2#TerminateInstancesRequest": { @@ -98528,7 +96583,7 @@ } }, "PreSharedKey": { - "target": "com.amazonaws.ec2#String", + "target": "com.amazonaws.ec2#preSharedKey", "traits": { "aws.protocols#ec2QueryName": "PreSharedKey", "smithy.api#documentation": "

    The pre-shared key (PSK) to establish initial authentication between the virtual\n private gateway and the customer gateway.

    ", @@ -99144,30 +97199,7 @@ "target": "com.amazonaws.ec2#UpdateSecurityGroupRuleDescriptionsEgressResult" }, "traits": { - "smithy.api#documentation": "

    [VPC only] Updates the description of an egress (outbound) security group rule. You\n\t\t\tcan replace an existing description, or add a description to a rule that did not have one\n\t\t\tpreviously. You can remove a description for a security group rule by omitting the \n\t\t\tdescription parameter in the request.

    ", - "smithy.api#examples": [ - { - "title": "To update an outbound security group rule description", - "documentation": "This example updates the description for the specified security group rule.", - "input": { - "GroupId": "sg-123abc12", - "IpPermissions": [ - { - "IpProtocol": "tcp", - "FromPort": 80, - "ToPort": 80, - "IpRanges": [ - { - "CidrIp": "203.0.113.0/24", - "Description": "Outbound HTTP access to server 2" - } - ] - } - ] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    [VPC only] Updates the description of an egress (outbound) security group rule. You\n\t\t\tcan replace an existing description, or add a description to a rule that did not have one\n\t\t\tpreviously. You can remove a description for a security group rule by omitting the \n\t\t\tdescription parameter in the request.

    " } }, "com.amazonaws.ec2#UpdateSecurityGroupRuleDescriptionsEgressRequest": { @@ -99238,30 +97270,7 @@ "target": "com.amazonaws.ec2#UpdateSecurityGroupRuleDescriptionsIngressResult" }, "traits": { - "smithy.api#documentation": "

    Updates the description of an ingress (inbound) security group rule. You can replace an\n\t\t\texisting description, or add a description to a rule that did not have one previously.\n\t\t You can remove a description for a security group rule by omitting the description \n\t\t parameter in the request.

    ", - "smithy.api#examples": [ - { - "title": "To update an inbound security group rule description", - "documentation": "This example updates the description for the specified security group rule.", - "input": { - "GroupId": "sg-123abc12", - "IpPermissions": [ - { - "IpProtocol": "tcp", - "FromPort": 22, - "ToPort": 22, - "IpRanges": [ - { - "CidrIp": "203.0.113.0/16", - "Description": "SSH access from the LA office" - } - ] - } - ] - }, - "output": {} - } - ] + "smithy.api#documentation": "

    Updates the description of an ingress (inbound) security group rule. You can replace an\n\t\t\texisting description, or add a description to a rule that did not have one previously.\n\t\t You can remove a description for a security group rule by omitting the description \n\t\t parameter in the request.

    " } }, "com.amazonaws.ec2#UpdateSecurityGroupRuleDescriptionsIngressRequest": { @@ -102837,7 +100846,7 @@ "type": "structure", "members": { "CustomerGatewayConfiguration": { - "target": "com.amazonaws.ec2#String", + "target": "com.amazonaws.ec2#customerGatewayConfiguration", "traits": { "aws.protocols#ec2QueryName": "CustomerGatewayConfiguration", "smithy.api#documentation": "

    The configuration information for the VPN connection's customer gateway (in the native\n XML format). This element is always present in the CreateVpnConnection\n response; however, it's present in the DescribeVpnConnections response\n only if the VPN connection is in the pending or available\n state.

    ", @@ -103448,7 +101457,7 @@ } }, "PreSharedKey": { - "target": "com.amazonaws.ec2#String", + "target": "com.amazonaws.ec2#preSharedKey", "traits": { "smithy.api#documentation": "

    The pre-shared key (PSK) to establish initial authentication between the virtual\n private gateway and customer gateway.

    \n

    Constraints: Allowed characters are alphanumeric characters, periods (.), and\n underscores (_). Must be between 8 and 64 characters in length and cannot start with\n zero (0).

    " } @@ -103704,6 +101713,18 @@ } } }, + "com.amazonaws.ec2#customerGatewayConfiguration": { + "type": "string", + "traits": { + "smithy.api#sensitive": {} + } + }, + "com.amazonaws.ec2#preSharedKey": { + "type": "string", + "traits": { + "smithy.api#sensitive": {} + } + }, "com.amazonaws.ec2#scope": { "type": "enum", "members": {