@aws-sdk/client-ec2 3.288.0 → 3.290.0

package/dist-types/commands/AuthorizeSecurityGroupIngressCommand.d.ts

@@ -43,6 +43,79 @@ export interface AuthorizeSecurityGroupIngressCommandOutput extends AuthorizeSec
  * @see {@link AuthorizeSecurityGroupIngressCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To add a rule that allows inbound SSH traffic from an IPv4 address range
+ * ```javascript
+ * // This example enables inbound traffic on TCP port 22 (SSH). The rule includes a description to help you identify it later.
+ * const input = {
+ *   "GroupId": "sg-903004f8",
+ *   "IpPermissions": [
+ *     {
+ *       "FromPort": 22,
+ *       "IpProtocol": "tcp",
+ *       "IpRanges": [
+ *         {
+ *           "CidrIp": "203.0.113.0/24",
+ *           "Description": "SSH access from the LA office"
+ *         }
+ *       ],
+ *       "ToPort": 22
+ *     }
+ *   ]
+ * };
+ * const command = new AuthorizeSecurityGroupIngressCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-rule-that-allows-inbound-ssh-traffic-1529011610328
+ * ```
+ *
+ * @example To add a rule that allows inbound HTTP traffic from another security group
+ * ```javascript
+ * // This example enables inbound traffic on TCP port 80 from the specified security group. The group must be in the same VPC or a peer VPC. Incoming traffic is allowed based on the private IP addresses of instances that are associated with the specified security group.
+ * const input = {
+ *   "GroupId": "sg-111aaa22",
+ *   "IpPermissions": [
+ *     {
+ *       "FromPort": 80,
+ *       "IpProtocol": "tcp",
+ *       "ToPort": 80,
+ *       "UserIdGroupPairs": [
+ *         {
+ *           "Description": "HTTP access from other instances",
+ *           "GroupId": "sg-1a2b3c4d"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new AuthorizeSecurityGroupIngressCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-rule-that-allows-inbound-http-traffic-from-another-security-group-1529012163168
+ * ```
+ *
+ * @example To add a rule that allows inbound RDP traffic from an IPv6 address range
+ * ```javascript
+ * // This example adds an inbound rule that allows RDP traffic from the specified IPv6 address range. The rule includes a description to help you identify it later.
+ * const input = {
+ *   "GroupId": "sg-123abc12 ",
+ *   "IpPermissions": [
+ *     {
+ *       "FromPort": 3389,
+ *       "IpProtocol": "tcp",
+ *       "Ipv6Ranges": [
+ *         {
+ *           "CidrIpv6": "2001:db8:1234:1a00::/64",
+ *           "Description": "RDP access from the NY office"
+ *         }
+ *       ],
+ *       "ToPort": 3389
+ *     }
+ *   ]
+ * };
+ * const command = new AuthorizeSecurityGroupIngressCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-rule-with-a-description-1529012418116
+ * ```
+ *
  */
 export declare class AuthorizeSecurityGroupIngressCommand extends $Command<AuthorizeSecurityGroupIngressCommandInput, AuthorizeSecurityGroupIngressCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AuthorizeSecurityGroupIngressCommandInput;

package/dist-types/commands/BundleInstanceCommand.d.ts

@@ -33,6 +33,7 @@ export interface BundleInstanceCommandOutput extends BundleInstanceResult, __Met
  * @see {@link BundleInstanceCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class BundleInstanceCommand extends $Command<BundleInstanceCommandInput, BundleInstanceCommandOutput, EC2ClientResolvedConfig> {
     readonly input: BundleInstanceCommandInput;

package/dist-types/commands/CancelBundleTaskCommand.d.ts

@@ -29,6 +29,7 @@ export interface CancelBundleTaskCommandOutput extends CancelBundleTaskResult, _
  * @see {@link CancelBundleTaskCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelBundleTaskCommand extends $Command<CancelBundleTaskCommandInput, CancelBundleTaskCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelBundleTaskCommandInput;

package/dist-types/commands/CancelCapacityReservationCommand.d.ts

@@ -34,6 +34,7 @@ export interface CancelCapacityReservationCommandOutput extends CancelCapacityRe
  * @see {@link CancelCapacityReservationCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelCapacityReservationCommand extends $Command<CancelCapacityReservationCommandInput, CancelCapacityReservationCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelCapacityReservationCommandInput;

package/dist-types/commands/CancelCapacityReservationFleetsCommand.d.ts

@@ -43,6 +43,7 @@ export interface CancelCapacityReservationFleetsCommandOutput extends CancelCapa
  * @see {@link CancelCapacityReservationFleetsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelCapacityReservationFleetsCommand extends $Command<CancelCapacityReservationFleetsCommandInput, CancelCapacityReservationFleetsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelCapacityReservationFleetsCommandInput;

package/dist-types/commands/CancelConversionTaskCommand.d.ts

@@ -33,6 +33,7 @@ export interface CancelConversionTaskCommandOutput extends __MetadataBearer {
  * @see {@link CancelConversionTaskCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelConversionTaskCommand extends $Command<CancelConversionTaskCommandInput, CancelConversionTaskCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelConversionTaskCommandInput;

package/dist-types/commands/CancelExportTaskCommand.d.ts

@@ -31,6 +31,7 @@ export interface CancelExportTaskCommandOutput extends __MetadataBearer {
  * @see {@link CancelExportTaskCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelExportTaskCommand extends $Command<CancelExportTaskCommandInput, CancelExportTaskCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelExportTaskCommandInput;

package/dist-types/commands/CancelImageLaunchPermissionCommand.d.ts

@@ -32,6 +32,7 @@ export interface CancelImageLaunchPermissionCommandOutput extends CancelImageLau
  * @see {@link CancelImageLaunchPermissionCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelImageLaunchPermissionCommand extends $Command<CancelImageLaunchPermissionCommandInput, CancelImageLaunchPermissionCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelImageLaunchPermissionCommandInput;

package/dist-types/commands/CancelImportTaskCommand.d.ts

@@ -29,6 +29,7 @@ export interface CancelImportTaskCommandOutput extends CancelImportTaskResult, _
  * @see {@link CancelImportTaskCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelImportTaskCommand extends $Command<CancelImportTaskCommandInput, CancelImportTaskCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelImportTaskCommandInput;

package/dist-types/commands/CancelReservedInstancesListingCommand.d.ts

@@ -32,6 +32,7 @@ export interface CancelReservedInstancesListingCommandOutput extends CancelReser
  * @see {@link CancelReservedInstancesListingCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CancelReservedInstancesListingCommand extends $Command<CancelReservedInstancesListingCommandInput, CancelReservedInstancesListingCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelReservedInstancesListingCommandInput;

package/dist-types/commands/CancelSpotFleetRequestsCommand.d.ts

@@ -35,6 +35,57 @@ export interface CancelSpotFleetRequestsCommandOutput extends CancelSpotFleetReq
  * @see {@link CancelSpotFleetRequestsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To cancel a Spot fleet request
+ * ```javascript
+ * // This example cancels the specified Spot fleet request and terminates its associated Spot Instances.
+ * const input = {
+ *   "SpotFleetRequestIds": [
+ *     "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ *   ],
+ *   "TerminateInstances": true
+ * };
+ * const command = new CancelSpotFleetRequestsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SuccessfulFleetRequests": [
+ *     {
+ *       "CurrentSpotFleetRequestState": "cancelled_running",
+ *       "PreviousSpotFleetRequestState": "active",
+ *       "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: ec2-cancel-spot-fleet-requests-1
+ * ```
+ *
+ * @example To cancel a Spot fleet request without terminating its Spot Instances
+ * ```javascript
+ * // This example cancels the specified Spot fleet request without terminating its associated Spot Instances.
+ * const input = {
+ *   "SpotFleetRequestIds": [
+ *     "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ *   ],
+ *   "TerminateInstances": false
+ * };
+ * const command = new CancelSpotFleetRequestsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SuccessfulFleetRequests": [
+ *     {
+ *       "CurrentSpotFleetRequestState": "cancelled_terminating",
+ *       "PreviousSpotFleetRequestState": "active",
+ *       "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: ec2-cancel-spot-fleet-requests-2
+ * ```
+ *
  */
 export declare class CancelSpotFleetRequestsCommand extends $Command<CancelSpotFleetRequestsCommandInput, CancelSpotFleetRequestsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelSpotFleetRequestsCommandInput;

package/dist-types/commands/CancelSpotInstanceRequestsCommand.d.ts

@@ -33,6 +33,30 @@ export interface CancelSpotInstanceRequestsCommandOutput extends CancelSpotInsta
  * @see {@link CancelSpotInstanceRequestsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To cancel Spot Instance requests
+ * ```javascript
+ * // This example cancels a Spot Instance request.
+ * const input = {
+ *   "SpotInstanceRequestIds": [
+ *     "sir-08b93456"
+ *   ]
+ * };
+ * const command = new CancelSpotInstanceRequestsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CancelledSpotInstanceRequests": [
+ *     {
+ *       "SpotInstanceRequestId": "sir-08b93456",
+ *       "State": "cancelled"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: ec2-cancel-spot-instance-requests-1
+ * ```
+ *
  */
 export declare class CancelSpotInstanceRequestsCommand extends $Command<CancelSpotInstanceRequestsCommandInput, CancelSpotInstanceRequestsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CancelSpotInstanceRequestsCommandInput;

package/dist-types/commands/ConfirmProductInstanceCommand.d.ts

@@ -31,6 +31,24 @@ export interface ConfirmProductInstanceCommandOutput extends ConfirmProductInsta
  * @see {@link ConfirmProductInstanceCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To confirm the product instance
+ * ```javascript
+ * // This example determines whether the specified product code is associated with the specified instance.
+ * const input = {
+ *   "InstanceId": "i-1234567890abcdef0",
+ *   "ProductCode": "774F4FF8"
+ * };
+ * const command = new ConfirmProductInstanceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OwnerId": "123456789012"
+ * }
+ * *\/
+ * // example id: to-confirm-the-product-instance-1472712108494
+ * ```
+ *
  */
 export declare class ConfirmProductInstanceCommand extends $Command<ConfirmProductInstanceCommandInput, ConfirmProductInstanceCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ConfirmProductInstanceCommandInput;

package/dist-types/commands/CopyFpgaImageCommand.d.ts

@@ -29,6 +29,7 @@ export interface CopyFpgaImageCommandOutput extends CopyFpgaImageResult, __Metad
  * @see {@link CopyFpgaImageCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CopyFpgaImageCommand extends $Command<CopyFpgaImageCommandInput, CopyFpgaImageCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CopyFpgaImageCommandInput;

package/dist-types/commands/CopyImageCommand.d.ts

@@ -47,6 +47,26 @@ export interface CopyImageCommandOutput extends CopyImageResult, __MetadataBeare
  * @see {@link CopyImageCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To copy an AMI to another region
+ * ```javascript
+ * // This example copies the specified AMI from the us-east-1 region to the current region.
+ * const input = {
+ *   "Description": "",
+ *   "Name": "My server",
+ *   "SourceImageId": "ami-5731123e",
+ *   "SourceRegion": "us-east-1"
+ * };
+ * const command = new CopyImageCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ImageId": "ami-438bea42"
+ * }
+ * *\/
+ * // example id: to-copy-an-ami-to-another-region-1529022820832
+ * ```
+ *
  */
 export declare class CopyImageCommand extends $Command<CopyImageCommandInput, CopyImageCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CopyImageCommandInput;

package/dist-types/commands/CopySnapshotCommand.d.ts

@@ -48,6 +48,26 @@ export interface CopySnapshotCommandOutput extends CopySnapshotResult, __Metadat
  * @see {@link CopySnapshotCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To copy a snapshot
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   "Description": "This is my copied snapshot.",
+ *   "DestinationRegion": "us-east-1",
+ *   "SourceRegion": "us-west-2",
+ *   "SourceSnapshotId": "snap-066877671789bd71b"
+ * };
+ * const command = new CopySnapshotCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SnapshotId": "snap-066877671789bd71b"
+ * }
+ * *\/
+ * // example id: to-copy-a-snapshot-1472502259774
+ * ```
+ *
  */
 export declare class CopySnapshotCommand extends $Command<CopySnapshotCommandInput, CopySnapshotCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CopySnapshotCommandInput;

package/dist-types/commands/CreateCapacityReservationCommand.d.ts

@@ -43,6 +43,7 @@ export interface CreateCapacityReservationCommandOutput extends CreateCapacityRe
  * @see {@link CreateCapacityReservationCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateCapacityReservationCommand extends $Command<CreateCapacityReservationCommandInput, CreateCapacityReservationCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCapacityReservationCommandInput;

package/dist-types/commands/CreateCapacityReservationFleetCommand.d.ts

@@ -30,6 +30,7 @@ export interface CreateCapacityReservationFleetCommandOutput extends CreateCapac
  * @see {@link CreateCapacityReservationFleetCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateCapacityReservationFleetCommand extends $Command<CreateCapacityReservationFleetCommandInput, CreateCapacityReservationFleetCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCapacityReservationFleetCommandInput;

package/dist-types/commands/CreateCarrierGatewayCommand.d.ts

@@ -29,6 +29,7 @@ export interface CreateCarrierGatewayCommandOutput extends CreateCarrierGatewayR
  * @see {@link CreateCarrierGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateCarrierGatewayCommand extends $Command<CreateCarrierGatewayCommandInput, CreateCarrierGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCarrierGatewayCommandInput;

package/dist-types/commands/CreateClientVpnEndpointCommand.d.ts

@@ -31,6 +31,7 @@ export interface CreateClientVpnEndpointCommandOutput extends CreateClientVpnEnd
  * @see {@link CreateClientVpnEndpointCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateClientVpnEndpointCommand extends $Command<CreateClientVpnEndpointCommandInput, CreateClientVpnEndpointCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateClientVpnEndpointCommandInput;

package/dist-types/commands/CreateClientVpnRouteCommand.d.ts

@@ -30,6 +30,7 @@ export interface CreateClientVpnRouteCommandOutput extends CreateClientVpnRouteR
  * @see {@link CreateClientVpnRouteCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateClientVpnRouteCommand extends $Command<CreateClientVpnRouteCommandInput, CreateClientVpnRouteCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateClientVpnRouteCommandInput;

package/dist-types/commands/CreateCoipCidrCommand.d.ts

@@ -31,6 +31,7 @@ export interface CreateCoipCidrCommandOutput extends CreateCoipCidrResult, __Met
  * @see {@link CreateCoipCidrCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateCoipCidrCommand extends $Command<CreateCoipCidrCommandInput, CreateCoipCidrCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCoipCidrCommandInput;

package/dist-types/commands/CreateCoipPoolCommand.d.ts

@@ -29,6 +29,7 @@ export interface CreateCoipPoolCommandOutput extends CreateCoipPoolResult, __Met
  * @see {@link CreateCoipPoolCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateCoipPoolCommand extends $Command<CreateCoipPoolCommandInput, CreateCoipPoolCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCoipPoolCommandInput;

package/dist-types/commands/CreateCustomerGatewayCommand.d.ts

@@ -42,6 +42,31 @@ export interface CreateCustomerGatewayCommandOutput extends CreateCustomerGatewa
  * @see {@link CreateCustomerGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To create a customer gateway
+ * ```javascript
+ * // This example creates a customer gateway with the specified IP address for its outside interface.
+ * const input = {
+ *   "BgpAsn": 65534,
+ *   "PublicIp": "12.1.2.3",
+ *   "Type": "ipsec.1"
+ * };
+ * const command = new CreateCustomerGatewayCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CustomerGateway": {
+ *     "BgpAsn": "65534",
+ *     "CustomerGatewayId": "cgw-0e11f167",
+ *     "IpAddress": "12.1.2.3",
+ *     "State": "available",
+ *     "Type": "ipsec.1"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-customer-gateway-1
+ * ```
+ *
  */
 export declare class CreateCustomerGatewayCommand extends $Command<CreateCustomerGatewayCommandInput, CreateCustomerGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateCustomerGatewayCommandInput;

package/dist-types/commands/CreateDefaultSubnetCommand.d.ts

@@ -32,6 +32,7 @@ export interface CreateDefaultSubnetCommandOutput extends CreateDefaultSubnetRes
  * @see {@link CreateDefaultSubnetCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateDefaultSubnetCommand extends $Command<CreateDefaultSubnetCommandInput, CreateDefaultSubnetCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateDefaultSubnetCommandInput;

package/dist-types/commands/CreateDefaultVpcCommand.d.ts

@@ -43,6 +43,7 @@ export interface CreateDefaultVpcCommandOutput extends CreateDefaultVpcResult, _
  * @see {@link CreateDefaultVpcCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateDefaultVpcCommand extends $Command<CreateDefaultVpcCommandInput, CreateDefaultVpcCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateDefaultVpcCommandInput;

package/dist-types/commands/CreateDhcpOptionsCommand.d.ts

@@ -80,6 +80,46 @@ export interface CreateDhcpOptionsCommandOutput extends CreateDhcpOptionsResult,
  * @see {@link CreateDhcpOptionsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To create a DHCP options set
+ * ```javascript
+ * // This example creates a DHCP options set.
+ * const input = {
+ *   "DhcpConfigurations": [
+ *     {
+ *       "Key": "domain-name-servers",
+ *       "Values": [
+ *         "10.2.5.1",
+ *         "10.2.5.2"
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new CreateDhcpOptionsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DhcpOptions": {
+ *     "DhcpConfigurations": [
+ *       {
+ *         "Key": "domain-name-servers",
+ *         "Values": [
+ *           {
+ *             "Value": "10.2.5.2"
+ *           },
+ *           {
+ *             "Value": "10.2.5.1"
+ *           }
+ *         ]
+ *       }
+ *     ],
+ *     "DhcpOptionsId": "dopt-d9070ebb"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-dhcp-options-1
+ * ```
+ *
  */
 export declare class CreateDhcpOptionsCommand extends $Command<CreateDhcpOptionsCommandInput, CreateDhcpOptionsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateDhcpOptionsCommandInput;

package/dist-types/commands/CreateEgressOnlyInternetGatewayCommand.d.ts

@@ -32,6 +32,7 @@ export interface CreateEgressOnlyInternetGatewayCommandOutput extends CreateEgre
  * @see {@link CreateEgressOnlyInternetGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateEgressOnlyInternetGatewayCommand extends $Command<CreateEgressOnlyInternetGatewayCommandInput, CreateEgressOnlyInternetGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateEgressOnlyInternetGatewayCommandInput;

package/dist-types/commands/CreateFleetCommand.d.ts

@@ -32,6 +32,7 @@ export interface CreateFleetCommandOutput extends CreateFleetResult, __MetadataB
  * @see {@link CreateFleetCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateFleetCommand extends $Command<CreateFleetCommandInput, CreateFleetCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateFleetCommandInput;

package/dist-types/commands/CreateFlowLogsCommand.d.ts

@@ -39,6 +39,7 @@ export interface CreateFlowLogsCommandOutput extends CreateFlowLogsResult, __Met
  * @see {@link CreateFlowLogsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateFlowLogsCommand extends $Command<CreateFlowLogsCommandInput, CreateFlowLogsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateFlowLogsCommandInput;

package/dist-types/commands/CreateFpgaImageCommand.d.ts

@@ -34,6 +34,7 @@ export interface CreateFpgaImageCommandOutput extends CreateFpgaImageResult, __M
  * @see {@link CreateFpgaImageCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateFpgaImageCommand extends $Command<CreateFpgaImageCommandInput, CreateFpgaImageCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateFpgaImageCommandInput;

package/dist-types/commands/CreateImageCommand.d.ts

@@ -45,6 +45,38 @@ export interface CreateImageCommandOutput extends CreateImageResult, __MetadataB
  * @see {@link CreateImageCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To create an AMI from an Amazon EBS-backed instance
+ * ```javascript
+ * // This example creates an AMI from the specified instance and adds an EBS volume with the device name /dev/sdh and an instance store volume with the device name /dev/sdc.
+ * const input = {
+ *   "BlockDeviceMappings": [
+ *     {
+ *       "DeviceName": "/dev/sdh",
+ *       "Ebs": {
+ *         "VolumeSize": "100"
+ *       }
+ *     },
+ *     {
+ *       "DeviceName": "/dev/sdc",
+ *       "VirtualName": "ephemeral1"
+ *     }
+ *   ],
+ *   "Description": "An AMI for my server",
+ *   "InstanceId": "i-1234567890abcdef0",
+ *   "Name": "My server",
+ *   "NoReboot": true
+ * };
+ * const command = new CreateImageCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ImageId": "ami-1a2b3c4d"
+ * }
+ * *\/
+ * // example id: to-create-an-ami-from-an-amazon-ebs-backed-instance-1529023150636
+ * ```
+ *
  */
 export declare class CreateImageCommand extends $Command<CreateImageCommandInput, CreateImageCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateImageCommandInput;

package/dist-types/commands/CreateInstanceEventWindowCommand.d.ts

@@ -51,6 +51,7 @@ export interface CreateInstanceEventWindowCommandOutput extends CreateInstanceEv
  * @see {@link CreateInstanceEventWindowCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateInstanceEventWindowCommand extends $Command<CreateInstanceEventWindowCommandInput, CreateInstanceEventWindowCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateInstanceEventWindowCommandInput;

package/dist-types/commands/CreateInstanceExportTaskCommand.d.ts

@@ -32,6 +32,7 @@ export interface CreateInstanceExportTaskCommandOutput extends CreateInstanceExp
  * @see {@link CreateInstanceExportTaskCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateInstanceExportTaskCommand extends $Command<CreateInstanceExportTaskCommandInput, CreateInstanceExportTaskCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateInstanceExportTaskCommandInput;

package/dist-types/commands/CreateInternetGatewayCommand.d.ts

@@ -31,6 +31,25 @@ export interface CreateInternetGatewayCommandOutput extends CreateInternetGatewa
  * @see {@link CreateInternetGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
+ * @example To create an Internet gateway
+ * ```javascript
+ * // This example creates an Internet gateway.
+ * const input = undefined;
+ * const command = new CreateInternetGatewayCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "InternetGateway": {
+ *     "Attachments": [],
+ *     "InternetGatewayId": "igw-c0a643a9",
+ *     "Tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-internet-gateway-1
+ * ```
+ *
  */
 export declare class CreateInternetGatewayCommand extends $Command<CreateInternetGatewayCommandInput, CreateInternetGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateInternetGatewayCommandInput;

package/dist-types/commands/CreateIpamCommand.d.ts

@@ -34,6 +34,7 @@ export interface CreateIpamCommandOutput extends CreateIpamResult, __MetadataBea
  * @see {@link CreateIpamCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateIpamCommand extends $Command<CreateIpamCommandInput, CreateIpamCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateIpamCommandInput;

package/dist-types/commands/CreateIpamPoolCommand.d.ts

@@ -31,6 +31,7 @@ export interface CreateIpamPoolCommandOutput extends CreateIpamPoolResult, __Met
  * @see {@link CreateIpamPoolCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ *
  */
 export declare class CreateIpamPoolCommand extends $Command<CreateIpamPoolCommandInput, CreateIpamPoolCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateIpamPoolCommandInput;