@aws-sdk/client-ec2 3.288.0 → 3.289.0

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

@@ -44,6 +44,39 @@ export interface AllocateAddressCommandOutput extends AllocateAddressResult, __M
  * @see {@link AllocateAddressCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To allocate an Elastic IP address for EC2-VPC
+ * ```javascript
+ * // This example allocates an Elastic IP address to use with an instance in a VPC.
+ * const input = {
+ *   "Domain": "vpc"
+ * };
+ * const command = new AllocateAddressCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AllocationId": "eipalloc-64d5890a",
+ *   "Domain": "vpc",
+ *   "PublicIp": "203.0.113.0"
+ * }
+ * *\/
+ * // 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 declare class AllocateAddressCommand extends $Command<AllocateAddressCommandInput, AllocateAddressCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AllocateAddressCommandInput;

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

@@ -44,6 +44,32 @@ export interface AssignPrivateIpAddressesCommandOutput extends AssignPrivateIpAd
  * @see {@link AssignPrivateIpAddressesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To assign a specific secondary private IP address to an interface
+ * ```javascript
+ * // This example assigns the specified secondary private IP address to the specified network interface.
+ * const input = {
+ *   "NetworkInterfaceId": "eni-e5aa89a3",
+ *   "PrivateIpAddresses": [
+ *     "10.0.0.82"
+ *   ]
+ * };
+ * const command = new AssignPrivateIpAddressesCommand(input);
+ * await client.send(command);
+ * // example id: ec2-assign-private-ip-addresses-1
+ * ```
+ *
+ * @example To assign secondary private IP addresses that Amazon EC2 selects to an interface
+ * ```javascript
+ * // This example assigns two secondary private IP addresses to the specified network interface. Amazon EC2 automatically assigns these IP addresses from the available IP addresses in the CIDR block range of the subnet the network interface is associated with.
+ * const input = {
+ *   "NetworkInterfaceId": "eni-e5aa89a3",
+ *   "SecondaryPrivateIpAddressCount": 2
+ * };
+ * const command = new AssignPrivateIpAddressesCommand(input);
+ * await client.send(command);
+ * // example id: ec2-assign-private-ip-addresses-2
+ * ```
+ *
  */
 export declare class AssignPrivateIpAddressesCommand extends $Command<AssignPrivateIpAddressesCommandInput, AssignPrivateIpAddressesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AssignPrivateIpAddressesCommandInput;

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

@@ -56,6 +56,52 @@ export interface AssociateAddressCommandOutput extends AssociateAddressResult, _
  * @see {@link AssociateAddressCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To associate an Elastic IP address in EC2-VPC
+ * ```javascript
+ * // This example associates the specified Elastic IP address with the specified instance in a VPC.
+ * const input = {
+ *   "AllocationId": "eipalloc-64d5890a",
+ *   "InstanceId": "i-0b263919b6498b123"
+ * };
+ * const command = new AssociateAddressCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AssociationId": "eipassoc-2bebb745"
+ * }
+ * *\/
+ * // example id: ec2-associate-address-1
+ * ```
+ *
+ * @example To associate an Elastic IP address with a network interface
+ * ```javascript
+ * // This example associates the specified Elastic IP address with the specified network interface.
+ * const input = {
+ *   "AllocationId": "eipalloc-64d5890a",
+ *   "NetworkInterfaceId": "eni-1a2b3c4d"
+ * };
+ * const command = new AssociateAddressCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AssociationId": "eipassoc-2bebb745"
+ * }
+ * *\/
+ * // 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 declare class AssociateAddressCommand extends $Command<AssociateAddressCommandInput, AssociateAddressCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AssociateAddressCommandInput;

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

@@ -32,6 +32,30 @@ export interface AssociateDhcpOptionsCommandOutput extends __MetadataBearer {
  * @see {@link AssociateDhcpOptionsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To associate a DHCP options set with a VPC
+ * ```javascript
+ * // This example associates the specified DHCP options set with the specified VPC.
+ * const input = {
+ *   "DhcpOptionsId": "dopt-d9070ebb",
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new AssociateDhcpOptionsCommand(input);
+ * await client.send(command);
+ * // example id: ec2-associate-dhcp-options-1
+ * ```
+ *
+ * @example To associate the default DHCP options set with a VPC
+ * ```javascript
+ * // This example associates the default DHCP options set with the specified VPC.
+ * const input = {
+ *   "DhcpOptionsId": "default",
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new AssociateDhcpOptionsCommand(input);
+ * await client.send(command);
+ * // example id: ec2-associate-dhcp-options-2
+ * ```
+ *
  */
 export declare class AssociateDhcpOptionsCommand extends $Command<AssociateDhcpOptionsCommandInput, AssociateDhcpOptionsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AssociateDhcpOptionsCommandInput;

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

@@ -30,6 +30,33 @@ export interface AssociateIamInstanceProfileCommandOutput extends AssociateIamIn
  * @see {@link AssociateIamInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To associate an IAM instance profile with an instance
+ * ```javascript
+ * // This example associates an IAM instance profile named admin-role with the specified instance.
+ * const input = {
+ *   "IamInstanceProfile": {
+ *     "Name": "admin-role"
+ *   },
+ *   "InstanceId": "i-123456789abcde123"
+ * };
+ * const command = new AssociateIamInstanceProfileCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "IamInstanceProfileAssociation": {
+ *     "AssociationId": "iip-assoc-0e7736511a163c209",
+ *     "IamInstanceProfile": {
+ *       "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role",
+ *       "Id": "AIPAJBLK7RKJKWDXVHIEC"
+ *     },
+ *     "InstanceId": "i-123456789abcde123",
+ *     "State": "associating"
+ *   }
+ * }
+ * *\/
+ * // example id: to-associate-an-iam-instance-profile-with-an-instance-1528928429850
+ * ```
+ *
  */
 export declare class AssociateIamInstanceProfileCommand extends $Command<AssociateIamInstanceProfileCommandInput, AssociateIamInstanceProfileCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AssociateIamInstanceProfileCommandInput;

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

@@ -35,6 +35,23 @@ export interface AssociateRouteTableCommandOutput extends AssociateRouteTableRes
  * @see {@link AssociateRouteTableCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To associate a route table with a subnet
+ * ```javascript
+ * // This example associates the specified route table with the specified subnet.
+ * const input = {
+ *   "RouteTableId": "rtb-22574640",
+ *   "SubnetId": "subnet-9d4a7b6"
+ * };
+ * const command = new AssociateRouteTableCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AssociationId": "rtbassoc-781d0d1a"
+ * }
+ * *\/
+ * // example id: ec2-associate-route-table-1
+ * ```
+ *
  */
 export declare class AssociateRouteTableCommand extends $Command<AssociateRouteTableCommandInput, AssociateRouteTableCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AssociateRouteTableCommandInput;

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

@@ -30,6 +30,18 @@ export interface AttachInternetGatewayCommandOutput extends __MetadataBearer {
  * @see {@link AttachInternetGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To attach an Internet gateway to a VPC
+ * ```javascript
+ * // This example attaches the specified Internet gateway to the specified VPC.
+ * const input = {
+ *   "InternetGatewayId": "igw-c0a643a9",
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new AttachInternetGatewayCommand(input);
+ * await client.send(command);
+ * // example id: ec2-attach-internet-gateway-1
+ * ```
+ *
  */
 export declare class AttachInternetGatewayCommand extends $Command<AttachInternetGatewayCommandInput, AttachInternetGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AttachInternetGatewayCommandInput;

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

@@ -29,6 +29,24 @@ export interface AttachNetworkInterfaceCommandOutput extends AttachNetworkInterf
  * @see {@link AttachNetworkInterfaceCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To attach a network interface to an instance
+ * ```javascript
+ * // This example attaches the specified network interface to the specified instance.
+ * const input = {
+ *   "DeviceIndex": 1,
+ *   "InstanceId": "i-1234567890abcdef0",
+ *   "NetworkInterfaceId": "eni-e5aa89a3"
+ * };
+ * const command = new AttachNetworkInterfaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AttachmentId": "eni-attach-66c4350a"
+ * }
+ * *\/
+ * // example id: ec2-attach-network-interface-1
+ * ```
+ *
  */
 export declare class AttachNetworkInterfaceCommand extends $Command<AttachNetworkInterfaceCommandInput, AttachNetworkInterfaceCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AttachNetworkInterfaceCommandInput;

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

@@ -53,6 +53,28 @@ export interface AttachVolumeCommandOutput extends VolumeAttachment, __MetadataB
  * @see {@link AttachVolumeCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To attach a volume to an instance
+ * ```javascript
+ * // This example attaches a volume (``vol-1234567890abcdef0``) to an instance (``i-01474ef662b89480``) as ``/dev/sdf``.
+ * const input = {
+ *   "Device": "/dev/sdf",
+ *   "InstanceId": "i-01474ef662b89480",
+ *   "VolumeId": "vol-1234567890abcdef0"
+ * };
+ * const command = new AttachVolumeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AttachTime": "2016-08-29T18:52:32.724Z",
+ *   "Device": "/dev/sdf",
+ *   "InstanceId": "i-01474ef662b89480",
+ *   "State": "attaching",
+ *   "VolumeId": "vol-1234567890abcdef0"
+ * }
+ * *\/
+ * // example id: to-attach-a-volume-to-an-instance-1472499213109
+ * ```
+ *
  */
 export declare class AttachVolumeCommand extends $Command<AttachVolumeCommandInput, AttachVolumeCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AttachVolumeCommandInput;

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

@@ -39,6 +39,52 @@ export interface AuthorizeSecurityGroupEgressCommandOutput extends AuthorizeSecu
  * @see {@link AuthorizeSecurityGroupEgressCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To add a rule that allows outbound traffic to a specific address range
+ * ```javascript
+ * // This example adds a rule that grants access to the specified address ranges on TCP port 80.
+ * const input = {
+ *   "GroupId": "sg-1a2b3c4d",
+ *   "IpPermissions": [
+ *     {
+ *       "FromPort": 80,
+ *       "IpProtocol": "tcp",
+ *       "IpRanges": [
+ *         {
+ *           "CidrIp": "10.0.0.0/16"
+ *         }
+ *       ],
+ *       "ToPort": 80
+ *     }
+ *   ]
+ * };
+ * const command = new AuthorizeSecurityGroupEgressCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-rule-that-allows-outbound-traffic-to-a-specific-address-range-1528929309636
+ * ```
+ *
+ * @example To add a rule that allows outbound traffic to a specific security group
+ * ```javascript
+ * // This example adds a rule that grants access to the specified security group on TCP port 80.
+ * const input = {
+ *   "GroupId": "sg-1a2b3c4d",
+ *   "IpPermissions": [
+ *     {
+ *       "FromPort": 80,
+ *       "IpProtocol": "tcp",
+ *       "ToPort": 80,
+ *       "UserIdGroupPairs": [
+ *         {
+ *           "GroupId": "sg-4b51a32f"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new AuthorizeSecurityGroupEgressCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-rule-that-allows-outbound-traffic-to-a-specific-security-group-1528929760260
+ * ```
+ *
  */
 export declare class AuthorizeSecurityGroupEgressCommand extends $Command<AuthorizeSecurityGroupEgressCommandInput, AuthorizeSecurityGroupEgressCommandOutput, EC2ClientResolvedConfig> {
     readonly input: AuthorizeSecurityGroupEgressCommandInput;

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

@@ -43,6 +43,78 @@ 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/CancelSpotFleetRequestsCommand.d.ts

@@ -35,6 +35,56 @@ 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,29 @@ 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,23 @@ 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/CopyImageCommand.d.ts

@@ -47,6 +47,25 @@ 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,25 @@ 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/CreateCustomerGatewayCommand.d.ts

@@ -42,6 +42,30 @@ 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/CreateDhcpOptionsCommand.d.ts

@@ -80,6 +80,45 @@ 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;