@aws-sdk/client-ec2 3.287.0 → 3.289.0

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

@@ -45,6 +45,37 @@ 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/CreateInternetGatewayCommand.d.ts

@@ -31,6 +31,24 @@ 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/CreateKeyPairCommand.d.ts

@@ -39,6 +39,17 @@ export interface CreateKeyPairCommandOutput extends KeyPair, __MetadataBearer {
  * @see {@link CreateKeyPairCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a key pair
+ * ```javascript
+ * // This example creates a key pair named my-key-pair.
+ * const input = {
+ *   "KeyName": "my-key-pair"
+ * };
+ * const command = new CreateKeyPairCommand(input);
+ * await client.send(command);
+ * // example id: ec2-create-key-pair-1
+ * ```
+ *
  */
 export declare class CreateKeyPairCommand extends $Command<CreateKeyPairCommandInput, CreateKeyPairCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateKeyPairCommandInput;

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

@@ -38,6 +38,53 @@ export interface CreateLaunchTemplateCommandOutput extends CreateLaunchTemplateR
  * @see {@link CreateLaunchTemplateCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a launch template
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   "LaunchTemplateData": {
+ *     "ImageId": "ami-8c1be5f6",
+ *     "InstanceType": "t2.small",
+ *     "NetworkInterfaces": [
+ *       {
+ *         "AssociatePublicIpAddress": true,
+ *         "DeviceIndex": 0,
+ *         "Ipv6AddressCount": 1,
+ *         "SubnetId": "subnet-7b16de0c"
+ *       }
+ *     ],
+ *     "TagSpecifications": [
+ *       {
+ *         "ResourceType": "instance",
+ *         "Tags": [
+ *           {
+ *             "Key": "Name",
+ *             "Value": "webserver"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   },
+ *   "LaunchTemplateName": "my-template",
+ *   "VersionDescription": "WebVersion1"
+ * };
+ * const command = new CreateLaunchTemplateCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "LaunchTemplate": {
+ *     "CreateTime": "2017-11-27T09:13:24.000Z",
+ *     "CreatedBy": "arn:aws:iam::123456789012:root",
+ *     "DefaultVersionNumber": 1,
+ *     "LatestVersionNumber": 1,
+ *     "LaunchTemplateId": "lt-01238c059e3466abc",
+ *     "LaunchTemplateName": "my-template"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-launch-template-1529023655488
+ * ```
+ *
  */
 export declare class CreateLaunchTemplateCommand extends $Command<CreateLaunchTemplateCommandInput, CreateLaunchTemplateCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateLaunchTemplateCommandInput;

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

@@ -37,6 +37,51 @@ export interface CreateLaunchTemplateVersionCommandOutput extends CreateLaunchTe
  * @see {@link CreateLaunchTemplateVersionCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a launch template version
+ * ```javascript
+ * // This example creates a new launch template version based on version 1 of the specified launch template and specifies a different AMI ID.
+ * const input = {
+ *   "LaunchTemplateData": {
+ *     "ImageId": "ami-c998b6b2"
+ *   },
+ *   "LaunchTemplateId": "lt-0abcd290751193123",
+ *   "SourceVersion": "1",
+ *   "VersionDescription": "WebVersion2"
+ * };
+ * const command = new CreateLaunchTemplateVersionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "LaunchTemplateVersion": {
+ *     "CreateTime": "2017-12-01T13:35:46.000Z",
+ *     "CreatedBy": "arn:aws:iam::123456789012:root",
+ *     "DefaultVersion": false,
+ *     "LaunchTemplateData": {
+ *       "ImageId": "ami-c998b6b2",
+ *       "InstanceType": "t2.micro",
+ *       "NetworkInterfaces": [
+ *         {
+ *           "AssociatePublicIpAddress": true,
+ *           "DeviceIndex": 0,
+ *           "Ipv6Addresses": [
+ *             {
+ *               "Ipv6Address": "2001:db8:1234:1a00::123"
+ *             }
+ *           ],
+ *           "SubnetId": "subnet-7b16de0c"
+ *         }
+ *       ]
+ *     },
+ *     "LaunchTemplateId": "lt-0abcd290751193123",
+ *     "LaunchTemplateName": "my-template",
+ *     "VersionDescription": "WebVersion2",
+ *     "VersionNumber": 2
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-launch-template-version-1529024195702
+ * ```
+ *
  */
 export declare class CreateLaunchTemplateVersionCommand extends $Command<CreateLaunchTemplateVersionCommandInput, CreateLaunchTemplateVersionCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateLaunchTemplateVersionCommandInput;

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

@@ -38,6 +38,34 @@ export interface CreateNatGatewayCommandOutput extends CreateNatGatewayResult, _
  * @see {@link CreateNatGatewayCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a NAT gateway
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   "AllocationId": "eipalloc-37fc1a52",
+ *   "SubnetId": "subnet-1a2b3c4d"
+ * };
+ * const command = new CreateNatGatewayCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "NatGateway": {
+ *     "CreateTime": "2015-12-17T12:45:26.732Z",
+ *     "NatGatewayAddresses": [
+ *       {
+ *         "AllocationId": "eipalloc-37fc1a52"
+ *       }
+ *     ],
+ *     "NatGatewayId": "nat-08d48af2a8e83edfd",
+ *     "State": "pending",
+ *     "SubnetId": "subnet-1a2b3c4d",
+ *     "VpcId": "vpc-1122aabb"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-nat-gateway-1
+ * ```
+ *
  */
 export declare class CreateNatGatewayCommand extends $Command<CreateNatGatewayCommandInput, CreateNatGatewayCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateNatGatewayCommandInput;

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

@@ -31,6 +31,44 @@ export interface CreateNetworkAclCommandOutput extends CreateNetworkAclResult, _
  * @see {@link CreateNetworkAclCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a network ACL
+ * ```javascript
+ * // This example creates a network ACL for the specified VPC.
+ * const input = {
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new CreateNetworkAclCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "NetworkAcl": {
+ *     "Associations": [],
+ *     "Entries": [
+ *       {
+ *         "CidrBlock": "0.0.0.0/0",
+ *         "Egress": true,
+ *         "Protocol": "-1",
+ *         "RuleAction": "deny",
+ *         "RuleNumber": 32767
+ *       },
+ *       {
+ *         "CidrBlock": "0.0.0.0/0",
+ *         "Egress": false,
+ *         "Protocol": "-1",
+ *         "RuleAction": "deny",
+ *         "RuleNumber": 32767
+ *       }
+ *     ],
+ *     "IsDefault": false,
+ *     "NetworkAclId": "acl-5fb85d36",
+ *     "Tags": [],
+ *     "VpcId": "vpc-a01106c2"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-network-acl-1
+ * ```
+ *
  */
 export declare class CreateNetworkAclCommand extends $Command<CreateNetworkAclCommandInput, CreateNetworkAclCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateNetworkAclCommandInput;

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

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

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

@@ -34,6 +34,52 @@ export interface CreateNetworkInterfaceCommandOutput extends CreateNetworkInterf
  * @see {@link CreateNetworkInterfaceCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a network interface
+ * ```javascript
+ * // This example creates a network interface for the specified subnet.
+ * const input = {
+ *   "Description": "my network interface",
+ *   "Groups": [
+ *     "sg-903004f8"
+ *   ],
+ *   "PrivateIpAddress": "10.0.2.17",
+ *   "SubnetId": "subnet-9d4a7b6c"
+ * };
+ * const command = new CreateNetworkInterfaceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "NetworkInterface": {
+ *     "AvailabilityZone": "us-east-1d",
+ *     "Description": "my network interface",
+ *     "Groups": [
+ *       {
+ *         "GroupId": "sg-903004f8",
+ *         "GroupName": "default"
+ *       }
+ *     ],
+ *     "MacAddress": "02:1a:80:41:52:9c",
+ *     "NetworkInterfaceId": "eni-e5aa89a3",
+ *     "OwnerId": "123456789012",
+ *     "PrivateIpAddress": "10.0.2.17",
+ *     "PrivateIpAddresses": [
+ *       {
+ *         "Primary": true,
+ *         "PrivateIpAddress": "10.0.2.17"
+ *       }
+ *     ],
+ *     "RequesterManaged": false,
+ *     "SourceDestCheck": true,
+ *     "Status": "pending",
+ *     "SubnetId": "subnet-9d4a7b6c",
+ *     "TagSet": [],
+ *     "VpcId": "vpc-a01106c2"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-network-interface-1
+ * ```
+ *
  */
 export declare class CreateNetworkInterfaceCommand extends $Command<CreateNetworkInterfaceCommandInput, CreateNetworkInterfaceCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateNetworkInterfaceCommandInput;

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

@@ -38,6 +38,18 @@ export interface CreatePlacementGroupCommandOutput extends CreatePlacementGroupR
  * @see {@link CreatePlacementGroupCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a placement group
+ * ```javascript
+ * // This example creates a placement group with the specified name.
+ * const input = {
+ *   "GroupName": "my-cluster",
+ *   "Strategy": "cluster"
+ * };
+ * const command = new CreatePlacementGroupCommand(input);
+ * await client.send(command);
+ * // example id: to-create-a-placement-group-1472712245768
+ * ```
+ *
  */
 export declare class CreatePlacementGroupCommand extends $Command<CreatePlacementGroupCommandInput, CreatePlacementGroupCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreatePlacementGroupCommandInput;

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

@@ -49,6 +49,19 @@ export interface CreateRouteCommandOutput extends CreateRouteResult, __MetadataB
  * @see {@link CreateRouteCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a route
+ * ```javascript
+ * // This example creates a route for the specified route table. The route matches all traffic (0.0.0.0/0) and routes it to the specified Internet gateway.
+ * const input = {
+ *   "DestinationCidrBlock": "0.0.0.0/0",
+ *   "GatewayId": "igw-c0a643a9",
+ *   "RouteTableId": "rtb-22574640"
+ * };
+ * const command = new CreateRouteCommand(input);
+ * await client.send(command);
+ * // example id: ec2-create-route-1
+ * ```
+ *
  */
 export declare class CreateRouteCommand extends $Command<CreateRouteCommandInput, CreateRouteCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateRouteCommandInput;

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

@@ -32,6 +32,35 @@ export interface CreateRouteTableCommandOutput extends CreateRouteTableResult, _
  * @see {@link CreateRouteTableCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a route table
+ * ```javascript
+ * // This example creates a route table for the specified VPC.
+ * const input = {
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new CreateRouteTableCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "RouteTable": {
+ *     "Associations": [],
+ *     "PropagatingVgws": [],
+ *     "RouteTableId": "rtb-22574640",
+ *     "Routes": [
+ *       {
+ *         "DestinationCidrBlock": "10.0.0.0/16",
+ *         "GatewayId": "local",
+ *         "State": "active"
+ *       }
+ *     ],
+ *     "Tags": [],
+ *     "VpcId": "vpc-a01106c2"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-route-table-1
+ * ```
+ *
  */
 export declare class CreateRouteTableCommand extends $Command<CreateRouteTableCommandInput, CreateRouteTableCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateRouteTableCommandInput;

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

@@ -46,6 +46,24 @@ export interface CreateSecurityGroupCommandOutput extends CreateSecurityGroupRes
  * @see {@link CreateSecurityGroupCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a security group for a VPC
+ * ```javascript
+ * // This example creates a security group for the specified VPC.
+ * const input = {
+ *   "Description": "My security group",
+ *   "GroupName": "my-security-group",
+ *   "VpcId": "vpc-1a2b3c4d"
+ * };
+ * const command = new CreateSecurityGroupCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "GroupId": "sg-903004f8"
+ * }
+ * *\/
+ * // example id: to-create-a-security-group-for-a-vpc-1529024532716
+ * ```
+ *
  */
 export declare class CreateSecurityGroupCommand extends $Command<CreateSecurityGroupCommandInput, CreateSecurityGroupCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateSecurityGroupCommandInput;

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

@@ -53,6 +53,30 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer
  * @see {@link CreateSnapshotCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a snapshot
+ * ```javascript
+ * // This example creates a snapshot of the volume with a volume ID of ``vol-1234567890abcdef0`` and a short description to identify the snapshot.
+ * const input = {
+ *   "Description": "This is my root volume snapshot.",
+ *   "VolumeId": "vol-1234567890abcdef0"
+ * };
+ * const command = new CreateSnapshotCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Description": "This is my root volume snapshot.",
+ *   "OwnerId": "012345678910",
+ *   "SnapshotId": "snap-066877671789bd71b",
+ *   "StartTime": "2014-02-28T21:06:01.000Z",
+ *   "State": "pending",
+ *   "Tags": [],
+ *   "VolumeId": "vol-1234567890abcdef0",
+ *   "VolumeSize": 8
+ * }
+ * *\/
+ * // example id: to-create-a-snapshot-1472502529790
+ * ```
+ *
  */
 export declare class CreateSnapshotCommand extends $Command<CreateSnapshotCommandInput, CreateSnapshotCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateSnapshotCommandInput;

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

@@ -32,6 +32,28 @@ export interface CreateSpotDatafeedSubscriptionCommandOutput extends CreateSpotD
  * @see {@link CreateSpotDatafeedSubscriptionCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a Spot Instance datafeed
+ * ```javascript
+ * // This example creates a Spot Instance data feed for your AWS account.
+ * const input = {
+ *   "Bucket": "my-s3-bucket",
+ *   "Prefix": "spotdata"
+ * };
+ * const command = new CreateSpotDatafeedSubscriptionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SpotDatafeedSubscription": {
+ *     "Bucket": "my-s3-bucket",
+ *     "OwnerId": "123456789012",
+ *     "Prefix": "spotdata",
+ *     "State": "Active"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-spot-datafeed-subscription-1
+ * ```
+ *
  */
 export declare class CreateSpotDatafeedSubscriptionCommand extends $Command<CreateSpotDatafeedSubscriptionCommandInput, CreateSpotDatafeedSubscriptionCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateSpotDatafeedSubscriptionCommandInput;

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

@@ -45,6 +45,30 @@ export interface CreateSubnetCommandOutput extends CreateSubnetResult, __Metadat
  * @see {@link CreateSubnetCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a subnet
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   "CidrBlock": "10.0.1.0/24",
+ *   "VpcId": "vpc-a01106c2"
+ * };
+ * const command = new CreateSubnetCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Subnet": {
+ *     "AvailabilityZone": "us-west-2c",
+ *     "AvailableIpAddressCount": 251,
+ *     "CidrBlock": "10.0.1.0/24",
+ *     "State": "pending",
+ *     "SubnetId": "subnet-9d4a7b6c",
+ *     "VpcId": "vpc-a01106c2"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-subnet-1
+ * ```
+ *
  */
 export declare class CreateSubnetCommand extends $Command<CreateSubnetCommandInput, CreateSubnetCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateSubnetCommandInput;

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

@@ -37,6 +37,25 @@ export interface CreateTagsCommandOutput extends __MetadataBearer {
  * @see {@link CreateTagsCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To add a tag to a resource
+ * ```javascript
+ * // This example adds the tag Stack=production to the specified image, or overwrites an existing tag for the AMI where the tag key is Stack.
+ * const input = {
+ *   "Resources": [
+ *     "ami-78a54011"
+ *   ],
+ *   "Tags": [
+ *     {
+ *       "Key": "Stack",
+ *       "Value": "production"
+ *     }
+ *   ]
+ * };
+ * const command = new CreateTagsCommand(input);
+ * await client.send(command);
+ * // example id: ec2-create-tags-1
+ * ```
+ *
  */
 export declare class CreateTagsCommand extends $Command<CreateTagsCommandInput, CreateTagsCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateTagsCommandInput;

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

@@ -39,6 +39,60 @@ export interface CreateVolumeCommandOutput extends Volume, __MetadataBearer {
  * @see {@link CreateVolumeCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a new volume
+ * ```javascript
+ * // This example creates an 80 GiB General Purpose (SSD) volume in the Availability Zone ``us-east-1a``.
+ * const input = {
+ *   "AvailabilityZone": "us-east-1a",
+ *   "Size": 80,
+ *   "VolumeType": "gp2"
+ * };
+ * const command = new CreateVolumeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AvailabilityZone": "us-east-1a",
+ *   "CreateTime": "2016-08-29T18:52:32.724Z",
+ *   "Encrypted": false,
+ *   "Iops": 240,
+ *   "Size": 80,
+ *   "SnapshotId": "",
+ *   "State": "creating",
+ *   "VolumeId": "vol-6b60b7c7",
+ *   "VolumeType": "gp2"
+ * }
+ * *\/
+ * // example id: to-create-a-new-volume-1472496724296
+ * ```
+ *
+ * @example To create a new Provisioned IOPS (SSD) volume from a snapshot
+ * ```javascript
+ * // This example creates a new Provisioned IOPS (SSD) volume with 1000 provisioned IOPS from a snapshot in the Availability Zone ``us-east-1a``.
+ * const input = {
+ *   "AvailabilityZone": "us-east-1a",
+ *   "Iops": 1000,
+ *   "SnapshotId": "snap-066877671789bd71b",
+ *   "VolumeType": "io1"
+ * };
+ * const command = new CreateVolumeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Attachments": [],
+ *   "AvailabilityZone": "us-east-1a",
+ *   "CreateTime": "2016-08-29T18:52:32.724Z",
+ *   "Iops": 1000,
+ *   "Size": 500,
+ *   "SnapshotId": "snap-066877671789bd71b",
+ *   "State": "creating",
+ *   "Tags": [],
+ *   "VolumeId": "vol-1234567890abcdef0",
+ *   "VolumeType": "io1"
+ * }
+ * *\/
+ * // example id: to-create-a-new-provisioned-iops-ssd-volume-from-a-snapshot-1472498975176
+ * ```
+ *
  */
 export declare class CreateVolumeCommand extends $Command<CreateVolumeCommandInput, CreateVolumeCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateVolumeCommandInput;

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

@@ -39,6 +39,28 @@ export interface CreateVpcCommandOutput extends CreateVpcResult, __MetadataBeare
  * @see {@link CreateVpcCommandOutput} for command's `response` shape.
  * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape.
  *
+ * @example To create a VPC
+ * ```javascript
+ * // This example creates a VPC with the specified CIDR block.
+ * const input = {
+ *   "CidrBlock": "10.0.0.0/16"
+ * };
+ * const command = new CreateVpcCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Vpc": {
+ *     "CidrBlock": "10.0.0.0/16",
+ *     "DhcpOptionsId": "dopt-7a8b9c2d",
+ *     "InstanceTenancy": "default",
+ *     "State": "pending",
+ *     "VpcId": "vpc-a01106c2"
+ *   }
+ * }
+ * *\/
+ * // example id: ec2-create-vpc-1
+ * ```
+ *
  */
 export declare class CreateVpcCommand extends $Command<CreateVpcCommandInput, CreateVpcCommandOutput, EC2ClientResolvedConfig> {
     readonly input: CreateVpcCommandInput;