@aws-sdk/client-ec2 3.288.0 → 3.289.0

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

@@ -46,6 +46,28 @@ export interface ReleaseAddressCommandOutput extends __MetadataBearer {
  * @see {@link ReleaseAddressCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To release an Elastic IP address for EC2-VPC
+ * ```javascript
+ * // This example releases an Elastic IP address for use with instances in a VPC.
+ * const input = {
+ *   "AllocationId": "eipalloc-64d5890a"
+ * };
+ * const command = new ReleaseAddressCommand(input);
+ * await client.send(command);
+ * // 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 declare class ReleaseAddressCommand extends $Command<ReleaseAddressCommandInput, ReleaseAddressCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ReleaseAddressCommandInput;

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

@@ -33,6 +33,23 @@ export interface ReplaceNetworkAclAssociationCommandOutput extends ReplaceNetwor
  * @see {@link ReplaceNetworkAclAssociationCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To replace the network ACL associated with a subnet
+ * ```javascript
+ * // This example associates the specified network ACL with the subnet for the specified network ACL association.
+ * const input = {
+ *   "AssociationId": "aclassoc-e5b95c8c",
+ *   "NetworkAclId": "acl-5fb85d36"
+ * };
+ * const command = new ReplaceNetworkAclAssociationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "NewAssociationId": "aclassoc-3999875b"
+ * }
+ * *\/
+ * // example id: ec2-replace-network-acl-association-1
+ * ```
+ *
  */
 export declare class ReplaceNetworkAclAssociationCommand extends $Command<ReplaceNetworkAclAssociationCommandInput, ReplaceNetworkAclAssociationCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ReplaceNetworkAclAssociationCommandInput;

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

@@ -30,6 +30,26 @@ export interface ReplaceNetworkAclEntryCommandOutput extends __MetadataBearer {
  * @see {@link ReplaceNetworkAclEntryCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To replace a network ACL entry
+ * ```javascript
+ * // This example replaces an entry for the specified network ACL. The new rule 100 allows ingress traffic from 203.0.113.12/24 on UDP port 53 (DNS) into any associated subnet.
+ * const input = {
+ *   "CidrBlock": "203.0.113.12/24",
+ *   "Egress": false,
+ *   "NetworkAclId": "acl-5fb85d36",
+ *   "PortRange": {
+ *     "From": 53,
+ *     "To": 53
+ *   },
+ *   "Protocol": "17",
+ *   "RuleAction": "allow",
+ *   "RuleNumber": 100
+ * };
+ * const command = new ReplaceNetworkAclEntryCommand(input);
+ * await client.send(command);
+ * // example id: ec2-replace-network-acl-entry-1
+ * ```
+ *
  */
 export declare class ReplaceNetworkAclEntryCommand extends $Command<ReplaceNetworkAclEntryCommandInput, ReplaceNetworkAclEntryCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ReplaceNetworkAclEntryCommandInput;

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

@@ -34,6 +34,19 @@ export interface ReplaceRouteCommandOutput extends __MetadataBearer {
  * @see {@link ReplaceRouteCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To replace a route
+ * ```javascript
+ * // This example replaces the specified route in the specified table table. The new route matches the specified CIDR and sends the traffic to the specified virtual private gateway.
+ * const input = {
+ *   "DestinationCidrBlock": "10.0.0.0/16",
+ *   "GatewayId": "vgw-9a4cacf3",
+ *   "RouteTableId": "rtb-22574640"
+ * };
+ * const command = new ReplaceRouteCommand(input);
+ * await client.send(command);
+ * // example id: ec2-replace-route-1
+ * ```
+ *
  */
 export declare class ReplaceRouteCommand extends $Command<ReplaceRouteCommandInput, ReplaceRouteCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ReplaceRouteCommandInput;

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

@@ -33,6 +33,23 @@ export interface ReplaceRouteTableAssociationCommandOutput extends ReplaceRouteT
  * @see {@link ReplaceRouteTableAssociationCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To replace the route table associated with a subnet
+ * ```javascript
+ * // This example associates the specified route table with the subnet for the specified route table association.
+ * const input = {
+ *   "AssociationId": "rtbassoc-781d0d1a",
+ *   "RouteTableId": "rtb-22574640"
+ * };
+ * const command = new ReplaceRouteTableAssociationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "NewAssociationId": "rtbassoc-3a1f0f58"
+ * }
+ * *\/
+ * // example id: ec2-replace-route-table-association-1
+ * ```
+ *
  */
 export declare class ReplaceRouteTableAssociationCommand extends $Command<ReplaceRouteTableAssociationCommandInput, ReplaceRouteTableAssociationCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ReplaceRouteTableAssociationCommandInput;

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

@@ -55,6 +55,158 @@ export interface RequestSpotFleetCommandOutput extends RequestSpotFleetResponse,
  * @see {@link RequestSpotFleetCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To request a Spot fleet in the subnet with the lowest price
+ * ```javascript
+ * // This example creates a Spot fleet request with two launch specifications that differ only by subnet. The Spot fleet launches the instances in the specified subnet with the lowest price. If the instances are launched in a default VPC, they receive a public IP address by default. If the instances are launched in a nondefault VPC, they do not receive a public IP address by default. Note that you can't specify different subnets from the same Availability Zone in a Spot fleet request.
+ * const input = {
+ *   "SpotFleetRequestConfig": {
+ *     "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
+ *     "LaunchSpecifications": [
+ *       {
+ *         "IamInstanceProfile": {
+ *           "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
+ *         },
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "m3.medium",
+ *         "KeyName": "my-key-pair",
+ *         "SecurityGroups": [
+ *           {
+ *             "GroupId": "sg-1a2b3c4d"
+ *           }
+ *         ],
+ *         "SubnetId": "subnet-1a2b3c4d, subnet-3c4d5e6f"
+ *       }
+ *     ],
+ *     "SpotPrice": "0.04",
+ *     "TargetCapacity": 2
+ *   }
+ * };
+ * const command = new RequestSpotFleetCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ * }
+ * *\/
+ * // example id: ec2-request-spot-fleet-1
+ * ```
+ *
+ * @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.
+ * const input = {
+ *   "SpotFleetRequestConfig": {
+ *     "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
+ *     "LaunchSpecifications": [
+ *       {
+ *         "IamInstanceProfile": {
+ *           "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
+ *         },
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "m3.medium",
+ *         "KeyName": "my-key-pair",
+ *         "Placement": {
+ *           "AvailabilityZone": "us-west-2a, us-west-2b"
+ *         },
+ *         "SecurityGroups": [
+ *           {
+ *             "GroupId": "sg-1a2b3c4d"
+ *           }
+ *         ]
+ *       }
+ *     ],
+ *     "SpotPrice": "0.04",
+ *     "TargetCapacity": 2
+ *   }
+ * };
+ * const command = new RequestSpotFleetCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ * }
+ * *\/
+ * // example id: ec2-request-spot-fleet-2
+ * ```
+ *
+ * @example To launch Spot instances in a subnet and assign them public IP addresses
+ * ```javascript
+ * // This example assigns public addresses to instances launched in a nondefault VPC. Note that when you specify a network interface, you must include the subnet ID and security group ID using the network interface.
+ * const input = {
+ *   "SpotFleetRequestConfig": {
+ *     "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
+ *     "LaunchSpecifications": [
+ *       {
+ *         "IamInstanceProfile": {
+ *           "Arn": "arn:aws:iam::880185128111:instance-profile/my-iam-role"
+ *         },
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "m3.medium",
+ *         "KeyName": "my-key-pair",
+ *         "NetworkInterfaces": [
+ *           {
+ *             "AssociatePublicIpAddress": true,
+ *             "DeviceIndex": 0,
+ *             "Groups": [
+ *               "sg-1a2b3c4d"
+ *             ],
+ *             "SubnetId": "subnet-1a2b3c4d"
+ *           }
+ *         ]
+ *       }
+ *     ],
+ *     "SpotPrice": "0.04",
+ *     "TargetCapacity": 2
+ *   }
+ * };
+ * const command = new RequestSpotFleetCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ * }
+ * *\/
+ * // example id: ec2-request-spot-fleet-3
+ * ```
+ *
+ * @example To request a Spot fleet using the diversified allocation strategy
+ * ```javascript
+ * // This example creates a Spot fleet request that launches 30 instances using the diversified allocation strategy. The launch specifications differ by instance type. The Spot fleet distributes the instances across the launch specifications such that there are 10 instances of each type.
+ * const input = {
+ *   "SpotFleetRequestConfig": {
+ *     "AllocationStrategy": "diversified",
+ *     "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
+ *     "LaunchSpecifications": [
+ *       {
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "c4.2xlarge",
+ *         "SubnetId": "subnet-1a2b3c4d"
+ *       },
+ *       {
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "m3.2xlarge",
+ *         "SubnetId": "subnet-1a2b3c4d"
+ *       },
+ *       {
+ *         "ImageId": "ami-1a2b3c4d",
+ *         "InstanceType": "r3.2xlarge",
+ *         "SubnetId": "subnet-1a2b3c4d"
+ *       }
+ *     ],
+ *     "SpotPrice": "0.70",
+ *     "TargetCapacity": 30
+ *   }
+ * };
+ * const command = new RequestSpotFleetCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
+ * }
+ * *\/
+ * // example id: ec2-request-spot-fleet-4
+ * ```
+ *
  */
 export declare class RequestSpotFleetCommand extends $Command<RequestSpotFleetCommandInput, RequestSpotFleetCommandOutput, EC2ClientResolvedConfig> {
     readonly input: RequestSpotFleetCommandInput;

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

@@ -41,6 +41,57 @@ export interface RequestSpotInstancesCommandOutput extends RequestSpotInstancesR
  * @see {@link RequestSpotInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @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.
+ * const input = {
+ *   "InstanceCount": 5,
+ *   "LaunchSpecification": {
+ *     "IamInstanceProfile": {
+ *       "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
+ *     },
+ *     "ImageId": "ami-1a2b3c4d",
+ *     "InstanceType": "m3.medium",
+ *     "KeyName": "my-key-pair",
+ *     "Placement": {
+ *       "AvailabilityZone": "us-west-2a"
+ *     },
+ *     "SecurityGroupIds": [
+ *       "sg-1a2b3c4d"
+ *     ]
+ *   },
+ *   "SpotPrice": "0.03",
+ *   "Type": "one-time"
+ * };
+ * const command = new RequestSpotInstancesCommand(input);
+ * await client.send(command);
+ * // example id: ec2-request-spot-instances-1
+ * ```
+ *
+ * @example To create a one-time Spot Instance request
+ * ```javascript
+ * // This example command creates a one-time Spot Instance request for five instances in the specified subnet. Amazon EC2 launches the instances in the specified subnet. If the VPC is a nondefault VPC, the instances do not receive a public IP address by default.
+ * const input = {
+ *   "InstanceCount": 5,
+ *   "LaunchSpecification": {
+ *     "IamInstanceProfile": {
+ *       "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
+ *     },
+ *     "ImageId": "ami-1a2b3c4d",
+ *     "InstanceType": "m3.medium",
+ *     "SecurityGroupIds": [
+ *       "sg-1a2b3c4d"
+ *     ],
+ *     "SubnetId": "subnet-1a2b3c4d"
+ *   },
+ *   "SpotPrice": "0.050",
+ *   "Type": "one-time"
+ * };
+ * const command = new RequestSpotInstancesCommand(input);
+ * await client.send(command);
+ * // example id: ec2-request-spot-instances-2
+ * ```
+ *
  */
 export declare class RequestSpotInstancesCommand extends $Command<RequestSpotInstancesCommandInput, RequestSpotInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: RequestSpotInstancesCommandInput;

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

@@ -29,6 +29,18 @@ export interface ResetImageAttributeCommandOutput extends __MetadataBearer {
  * @see {@link ResetImageAttributeCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To reset the launchPermission attribute
+ * ```javascript
+ * // This example resets the launchPermission attribute for the specified AMI. By default, AMIs are private.
+ * const input = {
+ *   "Attribute": "launchPermission",
+ *   "ImageId": "ami-5731123e"
+ * };
+ * const command = new ResetImageAttributeCommand(input);
+ * await client.send(command);
+ * // example id: to-reset-the-launchpermission-attribute-1529359519534
+ * ```
+ *
  */
 export declare class ResetImageAttributeCommand extends $Command<ResetImageAttributeCommandInput, ResetImageAttributeCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ResetImageAttributeCommandInput;

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

@@ -37,6 +37,18 @@ export interface ResetInstanceAttributeCommandOutput extends __MetadataBearer {
  * @see {@link ResetInstanceAttributeCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To reset the sourceDestCheck attribute
+ * ```javascript
+ * // This example resets the sourceDestCheck attribute for the specified instance.
+ * const input = {
+ *   "Attribute": "sourceDestCheck",
+ *   "InstanceId": "i-1234567890abcdef0"
+ * };
+ * const command = new ResetInstanceAttributeCommand(input);
+ * await client.send(command);
+ * // example id: to-reset-the-sourcedestcheck-attribute-1529359630708
+ * ```
+ *
  */
 export declare class ResetInstanceAttributeCommand extends $Command<ResetInstanceAttributeCommandInput, ResetInstanceAttributeCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ResetInstanceAttributeCommandInput;

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

@@ -31,6 +31,18 @@ export interface ResetSnapshotAttributeCommandOutput extends __MetadataBearer {
  * @see {@link ResetSnapshotAttributeCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To reset a snapshot attribute
+ * ```javascript
+ * // This example resets the create volume permissions for snapshot ``snap-1234567890abcdef0``. If the command succeeds, no output is returned.
+ * const input = {
+ *   "Attribute": "createVolumePermission",
+ *   "SnapshotId": "snap-1234567890abcdef0"
+ * };
+ * const command = new ResetSnapshotAttributeCommand(input);
+ * await client.send(command);
+ * // example id: to-reset-a-snapshot-attribute-1472508825735
+ * ```
+ *
  */
 export declare class ResetSnapshotAttributeCommand extends $Command<ResetSnapshotAttributeCommandInput, ResetSnapshotAttributeCommandOutput, EC2ClientResolvedConfig> {
     readonly input: ResetSnapshotAttributeCommandInput;

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

@@ -32,6 +32,23 @@ export interface RestoreAddressToClassicCommandOutput extends RestoreAddressToCl
  * @see {@link RestoreAddressToClassicCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @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 declare class RestoreAddressToClassicCommand extends $Command<RestoreAddressToClassicCommandInput, RestoreAddressToClassicCommandOutput, EC2ClientResolvedConfig> {
     readonly input: RestoreAddressToClassicCommandInput;

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

@@ -91,6 +91,44 @@ export interface RunInstancesCommandOutput extends Reservation, __MetadataBearer
  * @see {@link RunInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To launch an instance
+ * ```javascript
+ * // This example launches an instance using the specified AMI, instance type, security group, subnet, block device mapping, and tags.
+ * const 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"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * };
+ * const command = new RunInstancesCommand(input);
+ * await client.send(command);
+ * // example id: to-launch-an-instance-1529360150806
+ * ```
+ *
  */
 export declare class RunInstancesCommand extends $Command<RunInstancesCommandInput, RunInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: RunInstancesCommandInput;

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

@@ -34,6 +34,76 @@ export interface RunScheduledInstancesCommandOutput extends RunScheduledInstance
  * @see {@link RunScheduledInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @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 declare class RunScheduledInstancesCommand extends $Command<RunScheduledInstancesCommandInput, RunScheduledInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: RunScheduledInstancesCommandInput;

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

@@ -47,6 +47,36 @@ export interface StartInstancesCommandOutput extends StartInstancesResult, __Met
  * @see {@link StartInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To start a stopped EC2 instance
+ * ```javascript
+ * // This example starts the specified EC2 instance.
+ * const input = {
+ *   "InstanceIds": [
+ *     "i-1234567890abcdef0"
+ *   ]
+ * };
+ * const command = new StartInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "StartingInstances": [
+ *     {
+ *       "CurrentState": {
+ *         "Code": 0,
+ *         "Name": "pending"
+ *       },
+ *       "InstanceId": "i-1234567890abcdef0",
+ *       "PreviousState": {
+ *         "Code": 80,
+ *         "Name": "stopped"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-start-a-stopped-ec2-instance-1529358792730
+ * ```
+ *
  */
 export declare class StartInstancesCommand extends $Command<StartInstancesCommandInput, StartInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: StartInstancesCommandInput;

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

@@ -59,6 +59,36 @@ export interface StopInstancesCommandOutput extends StopInstancesResult, __Metad
  * @see {@link StopInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To stop a running EC2 instance
+ * ```javascript
+ * // This example stops the specified EC2 instance.
+ * const input = {
+ *   "InstanceIds": [
+ *     "i-1234567890abcdef0"
+ *   ]
+ * };
+ * const command = new StopInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "StoppingInstances": [
+ *     {
+ *       "CurrentState": {
+ *         "Code": 64,
+ *         "Name": "stopping"
+ *       },
+ *       "InstanceId": "i-1234567890abcdef0",
+ *       "PreviousState": {
+ *         "Code": 16,
+ *         "Name": "running"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-stop-a-running-ec2-instance-1529358905540
+ * ```
+ *
  */
 export declare class StopInstancesCommand extends $Command<StopInstancesCommandInput, StopInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: StopInstancesCommandInput;

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

@@ -89,6 +89,36 @@ export interface TerminateInstancesCommandOutput extends TerminateInstancesResul
  * @see {@link TerminateInstancesCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To terminate an EC2 instance
+ * ```javascript
+ * // This example terminates the specified EC2 instance.
+ * const input = {
+ *   "InstanceIds": [
+ *     "i-1234567890abcdef0"
+ *   ]
+ * };
+ * const command = new TerminateInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "TerminatingInstances": [
+ *     {
+ *       "CurrentState": {
+ *         "Code": 32,
+ *         "Name": "shutting-down"
+ *       },
+ *       "InstanceId": "i-1234567890abcdef0",
+ *       "PreviousState": {
+ *         "Code": 16,
+ *         "Name": "running"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-terminate-an-ec2-instance-1529359350660
+ * ```
+ *
  */
 export declare class TerminateInstancesCommand extends $Command<TerminateInstancesCommandInput, TerminateInstancesCommandOutput, EC2ClientResolvedConfig> {
     readonly input: TerminateInstancesCommandInput;