Gecko [ www.leshallesdegournay.geraud-market.com ]

Name	Size	Permission	Date
accept-vpc-peering-connection.rst	691 B	-rw-r--r--	2017-04-04 16:39
allocate-address.rst	560 B	-rw-r--r--	2017-04-04 16:39
allocate-hosts.rst	379 B	-rw-r--r--	2017-04-04 16:39
assign-ipv6-addresses.rst	1.08 KB	-rw-r--r--	2017-04-04 16:39
assign-private-ip-addresses.rst	866 B	-rw-r--r--	2017-04-04 16:39
associate-address.rst	1014 B	-rw-r--r--	2017-04-04 16:39
associate-dhcp-options.rst	557 B	-rw-r--r--	2017-04-04 16:39
associate-iam-instance-profile.rst	650 B	-rw-r--r--	2017-04-04 16:39
associate-route-table.rst	286 B	-rw-r--r--	2017-04-04 16:39
associate-subnet-cidr-block.rst	521 B	-rw-r--r--	2017-04-04 16:39
associate-vpc-cidr-block.rst	424 B	-rw-r--r--	2017-04-04 16:39
attach-classic-link-vpc.rst	328 B	-rw-r--r--	2017-04-04 16:39
attach-internet-gateway.rst	272 B	-rw-r--r--	2017-04-04 16:39
attach-network-interface.rst	327 B	-rw-r--r--	2017-04-04 16:39
attach-volume.rst	498 B	-rw-r--r--	2017-04-04 16:39
attach-vpn-gateway.rst	346 B	-rw-r--r--	2017-04-04 16:39
authorize-security-group-egress.rst	746 B	-rw-r--r--	2017-04-04 16:39
authorize-security-group-ingress.rst	3.12 KB	-rw-r--r--	2017-04-04 16:39
bundle-instance.rst	914 B	-rw-r--r--	2017-04-04 16:39
cancel-bundle-task.rst	514 B	-rw-r--r--	2017-04-04 16:39
cancel-conversion-task.rst	274 B	-rw-r--r--	2017-04-04 16:39
cancel-export-task.rst	240 B	-rw-r--r--	2017-04-04 16:39
cancel-spot-fleet-requests.rst	1.11 KB	-rw-r--r--	2017-04-04 16:39
cancel-spot-instance-requests.rst	368 B	-rw-r--r--	2017-04-04 16:39
confirm-product-instance.rst	292 B	-rw-r--r--	2017-04-04 16:39
copy-image.rst	323 B	-rw-r--r--	2017-04-04 16:39
copy-snapshot.rst	462 B	-rw-r--r--	2017-04-04 16:39
create-customer-gateway.rst	455 B	-rw-r--r--	2017-04-04 16:39
create-dhcp-options.rst	527 B	-rw-r--r--	2017-04-04 16:39
create-egress-only-internet-gateway.rst	469 B	-rw-r--r--	2017-04-04 16:39
create-flow-logs.rst	662 B	-rw-r--r--	2017-04-04 16:39
create-image.rst	1.29 KB	-rw-r--r--	2017-04-04 16:39
create-instance-export-task.rst	921 B	-rw-r--r--	2017-04-04 16:39
create-internet-gateway.rst	274 B	-rw-r--r--	2017-04-04 16:39
create-key-pair.rst	435 B	-rw-r--r--	2017-04-04 16:39
create-nat-gateway.rst	645 B	-rw-r--r--	2017-04-04 16:39
create-network-acl-entry.rst	778 B	-rw-r--r--	2017-04-04 16:39
create-network-acl.rst	844 B	-rw-r--r--	2017-04-04 16:39
create-network-interface.rst	1.11 KB	-rw-r--r--	2017-04-04 16:39
create-placement-group.rst	193 B	-rw-r--r--	2017-04-04 16:39
create-route-table.rst	561 B	-rw-r--r--	2017-04-04 16:39
create-route.rst	1.12 KB	-rw-r--r--	2017-04-04 16:39
create-security-group.rst	775 B	-rw-r--r--	2017-04-04 16:39
create-snapshot.rst	617 B	-rw-r--r--	2017-04-04 16:39
create-spot-datafeed-subscription.rst	413 B	-rw-r--r--	2017-04-04 16:39
create-subnet.rst	1.74 KB	-rw-r--r--	2017-04-04 16:39
create-tags.rst	1.67 KB	-rw-r--r--	2017-04-04 16:39
create-volume.rst	1.24 KB	-rw-r--r--	2017-04-04 16:39
create-vpc-endpoint.rst	777 B	-rw-r--r--	2017-04-04 16:39
create-vpc-peering-connection.rst	1.22 KB	-rw-r--r--	2017-04-04 16:39
create-vpc.rst	1.77 KB	-rw-r--r--	2017-04-04 16:39
create-vpn-connection-route.rst	290 B	-rw-r--r--	2017-04-04 16:39
create-vpn-connection.rst	1.51 KB	-rw-r--r--	2017-04-04 16:39
create-vpn-gateway.rst	327 B	-rw-r--r--	2017-04-04 16:39
delete-customer-gateway.rst	216 B	-rw-r--r--	2017-04-04 16:39
delete-dhcp-options.rst	209 B	-rw-r--r--	2017-04-04 16:39
delete-egress-only-internet-gateway.rst	268 B	-rw-r--r--	2017-04-04 16:39
delete-flow-logs.rst	179 B	-rw-r--r--	2017-04-04 16:39
delete-internet-gateway.rst	217 B	-rw-r--r--	2017-04-04 16:39
delete-key-pair.rst	377 B	-rw-r--r--	2017-04-04 16:39
delete-nat-gateway.rst	231 B	-rw-r--r--	2017-04-04 16:39
delete-network-acl-entry.rst	265 B	-rw-r--r--	2017-04-04 16:39
delete-network-acl.rst	196 B	-rw-r--r--	2017-04-04 16:39
delete-network-interface.rst	220 B	-rw-r--r--	2017-04-04 16:39
delete-placement-group.rst	162 B	-rw-r--r--	2017-04-04 16:39
delete-route-table.rst	196 B	-rw-r--r--	2017-04-04 16:39
delete-route.rst	244 B	-rw-r--r--	2017-04-04 16:39
delete-security-group.rst	723 B	-rw-r--r--	2017-04-04 16:39
delete-snapshot.rst	241 B	-rw-r--r--	2017-04-04 16:39
delete-spot-datafeed-subscription.rst	234 B	-rw-r--r--	2017-04-04 16:39
delete-subnet.rst	179 B	-rw-r--r--	2017-04-04 16:39
delete-tags.rst	1.2 KB	-rw-r--r--	2017-04-04 16:39
delete-volume.rst	240 B	-rw-r--r--	2017-04-04 16:39
delete-vpc-endpoints.rst	373 B	-rw-r--r--	2017-04-04 16:39
delete-vpc-peering-connection.rst	232 B	-rw-r--r--	2017-04-04 16:39
delete-vpc.rst	164 B	-rw-r--r--	2017-04-04 16:39
delete-vpn-connection-route.rst	304 B	-rw-r--r--	2017-04-04 16:39
delete-vpn-connection.rst	208 B	-rw-r--r--	2017-04-04 16:39
delete-vpn-gateway.rst	220 B	-rw-r--r--	2017-04-04 16:39
deregister-image.rst	181 B	-rw-r--r--	2017-04-04 16:39
describe-account-attributes.rst	2.14 KB	-rw-r--r--	2017-04-04 16:39
describe-addresses.rst	3.11 KB	-rw-r--r--	2017-04-04 16:39
describe-availability-zones.rst	802 B	-rw-r--r--	2017-04-04 16:39
describe-bundle-tasks.rst	564 B	-rw-r--r--	2017-04-04 16:39
describe-classic-link-instances.rst	1.22 KB	-rw-r--r--	2017-04-04 16:39
describe-conversion-tasks.rst	1.36 KB	-rw-r--r--	2017-04-04 16:39
describe-customer-gateways.rst	1.06 KB	-rw-r--r--	2017-04-04 16:39
describe-dhcp-options.rst	856 B	-rw-r--r--	2017-04-04 16:39
describe-egress-only-internet-gateways.rst	487 B	-rw-r--r--	2017-04-04 16:39
describe-export-tasks.rst	807 B	-rw-r--r--	2017-04-04 16:39
describe-flow-logs.rst	704 B	-rw-r--r--	2017-04-04 16:39
describe-hosts.rst	1.41 KB	-rw-r--r--	2017-04-04 16:39
describe-iam-instance-profile-associations.rst	934 B	-rw-r--r--	2017-04-04 16:39
describe-id-format.rst	1.11 KB	-rw-r--r--	2017-04-04 16:39
describe-identity-id-format.rst	1.07 KB	-rw-r--r--	2017-04-04 16:39
describe-image-attribute.rst	699 B	-rw-r--r--	2017-04-04 16:39
describe-images.rst	1.88 KB	-rw-r--r--	2017-04-04 16:39
describe-instance-attribute.rst	1.66 KB	-rw-r--r--	2017-04-04 16:39
describe-instance-status.rst	1.02 KB	-rw-r--r--	2017-04-04 16:39
describe-instances.rst	1.3 KB	-rw-r--r--	2017-04-04 16:39
describe-internet-gateways.rst	1.14 KB	-rw-r--r--	2017-04-04 16:39
describe-key-pairs.rst	557 B	-rw-r--r--	2017-04-04 16:39
describe-moving-addresses.rst	469 B	-rw-r--r--	2017-04-04 16:39
describe-nat-gateways.rst	1.13 KB	-rw-r--r--	2017-04-04 16:39
describe-network-acls.rst	5.46 KB	-rw-r--r--	2017-04-04 16:39
describe-network-interface-attribute.rst	1.88 KB	-rw-r--r--	2017-04-04 16:39
describe-network-interfaces.rst	5.17 KB	-rw-r--r--	2017-04-04 16:39
describe-placement-groups.rst	354 B	-rw-r--r--	2017-04-04 16:39
describe-prefix-lists.rst	350 B	-rw-r--r--	2017-04-04 16:39
describe-regions.rst	2.62 KB	-rw-r--r--	2017-04-04 16:39
describe-reserved-instances-modifications.rst	1.62 KB	-rw-r--r--	2017-04-04 16:39
describe-reserved-instances-offerings.rst	3.48 KB	-rw-r--r--	2017-04-04 16:39
describe-reserved-instances.rst	2.27 KB	-rw-r--r--	2017-04-04 16:39
describe-route-tables.rst	3.27 KB	-rw-r--r--	2017-04-04 16:39
describe-scheduled-instance-availability.rst	1.39 KB	-rw-r--r--	2017-04-04 16:39
describe-scheduled-instances.rst	1.25 KB	-rw-r--r--	2017-04-04 16:39
describe-security-group-references.rst	543 B	-rw-r--r--	2017-04-04 16:39
describe-security-groups.rst	4.7 KB	-rw-r--r--	2017-04-04 16:39
describe-snapshot-attribute.rst	401 B	-rw-r--r--	2017-04-04 16:39
describe-snapshots.rst	1.81 KB	-rw-r--r--	2017-04-04 16:39
describe-spot-datafeed-subscription.rst	385 B	-rw-r--r--	2017-04-04 16:39
describe-spot-fleet-instances.rst	565 B	-rw-r--r--	2017-04-04 16:39
describe-spot-fleet-request-history.rst	1.66 KB	-rw-r--r--	2017-04-04 16:39
describe-spot-fleet-requests.rst	4.82 KB	-rw-r--r--	2017-04-04 16:39
describe-spot-instance-requests.rst	2.4 KB	-rw-r--r--	2017-04-04 16:39
describe-spot-price-history.rst	2.07 KB	-rw-r--r--	2017-04-04 16:39
describe-stale-security-groups.rst	1.97 KB	-rw-r--r--	2017-04-04 16:39
describe-subnets.rst	1.87 KB	-rw-r--r--	2017-04-04 16:39
describe-tags.rst	3.67 KB	-rw-r--r--	2017-04-04 16:39
describe-volume-attribute.rst	383 B	-rw-r--r--	2017-04-04 16:39
describe-volume-status.rst	1.47 KB	-rw-r--r--	2017-04-04 16:39
describe-volumes.rst	3.23 KB	-rw-r--r--	2017-04-04 16:39
describe-vpc-attribute.rst	1.02 KB	-rw-r--r--	2017-04-04 16:39
describe-vpc-classic-link-dns-support.rst	416 B	-rw-r--r--	2017-04-04 16:39
describe-vpc-classic-link.rst	659 B	-rw-r--r--	2017-04-04 16:39
describe-vpc-endpoint-services.rst	244 B	-rw-r--r--	2017-04-04 16:39
describe-vpc-endpoints.rst	626 B	-rw-r--r--	2017-04-04 16:39
describe-vpc-peering-connections.rst	2.79 KB	-rw-r--r--	2017-04-04 16:39
describe-vpcs.rst	1.99 KB	-rw-r--r--	2017-04-04 16:39
describe-vpn-connections.rst	1.24 KB	-rw-r--r--	2017-04-04 16:39
describe-vpn-gateways.rst	834 B	-rw-r--r--	2017-04-04 16:39
detach-classic-link-vpc.rst	271 B	-rw-r--r--	2017-04-04 16:39
detach-internet-gateway.rst	277 B	-rw-r--r--	2017-04-04 16:39
detach-network-interface.rst	268 B	-rw-r--r--	2017-04-04 16:39
detach-volume.rst	431 B	-rw-r--r--	2017-04-04 16:39
detach-vpn-gateway.rst	280 B	-rw-r--r--	2017-04-04 16:39
disable-vgw-route-propagation.rst	311 B	-rw-r--r--	2017-04-04 16:39
disable-vpc-classic-link-dns-support.rst	236 B	-rw-r--r--	2017-04-04 16:39
disable-vpc-classic-link.rst	195 B	-rw-r--r--	2017-04-04 16:39
disassociate-address.rst	515 B	-rw-r--r--	2017-04-04 16:39
disassociate-iam-instance-profile.rst	614 B	-rw-r--r--	2017-04-04 16:39
disassociate-route-table.rst	245 B	-rw-r--r--	2017-04-04 16:39
disassociate-subnet-cidr-block.rst	539 B	-rw-r--r--	2017-04-04 16:39
disassociate-vpc-cidr-block.rst	518 B	-rw-r--r--	2017-04-04 16:39
enable-vgw-route-propagation.rst	304 B	-rw-r--r--	2017-04-04 16:39
enable-volume-io.rst	206 B	-rw-r--r--	2017-04-04 16:39
enable-vpc-classic-link-dns-support.rst	233 B	-rw-r--r--	2017-04-04 16:39
enable-vpc-classic-link.rst	192 B	-rw-r--r--	2017-04-04 16:39
get-console-output.rst	308 B	-rw-r--r--	2017-04-04 16:39
get-password-data.rst	979 B	-rw-r--r--	2017-04-04 16:39
import-key-pair.rst	1.08 KB	-rw-r--r--	2017-04-04 16:39
modify-hosts.rst	1.41 KB	-rw-r--r--	2017-04-04 16:39
modify-id-format.rst	466 B	-rw-r--r--	2017-04-04 16:39
modify-identity-id-format.rst	762 B	-rw-r--r--	2017-04-04 16:39
modify-image-attribute.rst	1.08 KB	-rw-r--r--	2017-04-04 16:39
modify-instance-attribute.rst	1.44 KB	-rw-r--r--	2017-04-04 16:39
modify-instance-placement.rst	332 B	-rw-r--r--	2017-04-04 16:39
modify-network-interface-attribute.rst	1.15 KB	-rw-r--r--	2017-04-04 16:39
modify-reserved-instances.rst	2 KB	-rw-r--r--	2017-04-04 16:39
modify-snapshot-attribute.rst	655 B	-rw-r--r--	2017-04-04 16:39
modify-spot-fleet-request.rst	663 B	-rw-r--r--	2017-04-04 16:39
modify-subnet-attribute.rst	862 B	-rw-r--r--	2017-04-04 16:39
modify-volume-attribute.rst	293 B	-rw-r--r--	2017-04-04 16:39
modify-vpc-attribute.rst	930 B	-rw-r--r--	2017-04-04 16:39
modify-vpc-endpoint.rst	327 B	-rw-r--r--	2017-04-04 16:39
modify-vpc-peering-connection-options.rst	1.79 KB	-rw-r--r--	2017-04-04 16:39
monitor-instances.rst	403 B	-rw-r--r--	2017-04-04 16:39
move-address-to-vpc.rst	225 B	-rw-r--r--	2017-04-04 16:39
purchase-reserved-instances-offering.rst	426 B	-rw-r--r--	2017-04-04 16:39
purchase-scheduled-instances.rst	1.26 KB	-rw-r--r--	2017-04-04 16:39
reboot-instances.rst	412 B	-rw-r--r--	2017-04-04 16:39
register-image.rst	999 B	-rw-r--r--	2017-04-04 16:39
reject-vpc-peering-connection.rst	239 B	-rw-r--r--	2017-04-04 16:39
release-address.rst	498 B	-rw-r--r--	2017-04-04 16:39
release-hosts.rst	376 B	-rw-r--r--	2017-04-04 16:39
replace-iam-instance-profile.rst	721 B	-rw-r--r--	2017-04-04 16:39
replace-network-acl-association.rst	349 B	-rw-r--r--	2017-04-04 16:39
replace-network-acl-entry.rst	405 B	-rw-r--r--	2017-04-04 16:39
replace-route-table-association.rst	349 B	-rw-r--r--	2017-04-04 16:39
replace-route.rst	377 B	-rw-r--r--	2017-04-04 16:39
report-instance-status.rst	243 B	-rw-r--r--	2017-04-04 16:39
request-spot-fleet.rst	5 KB	-rw-r--r--	2017-04-04 16:39
request-spot-instances.rst	4.87 KB	-rw-r--r--	2017-04-04 16:39
reset-image-attribute.rst	319 B	-rw-r--r--	2017-04-04 16:39
reset-instance-attribute.rst	922 B	-rw-r--r--	2017-04-04 16:39
reset-snapshot-attribute.rst	294 B	-rw-r--r--	2017-04-04 16:39
restore-address-to-classic.rst	282 B	-rw-r--r--	2017-04-04 16:39
revoke-security-group-egress.rst	760 B	-rw-r--r--	2017-04-04 16:39
revoke-security-group-ingress.rst	1.02 KB	-rw-r--r--	2017-04-04 16:39
run-instances.rst	9.91 KB	-rw-r--r--	2017-04-04 16:39
run-scheduled-instances.rst	1.35 KB	-rw-r--r--	2017-04-04 16:39
start-instances.rst	776 B	-rw-r--r--	2017-04-04 16:39
stop-instances.rst	775 B	-rw-r--r--	2017-04-04 16:39
terminate-instances.rst	745 B	-rw-r--r--	2017-04-04 16:39
unassign-ipv6-addresses.rst	434 B	-rw-r--r--	2017-04-04 16:39
unassign-private-ip-addresses.rst	336 B	-rw-r--r--	2017-04-04 16:39
unmonitor-instances.rst	409 B	-rw-r--r--	2017-04-04 16:39

Rename

**To launch an instance in EC2-Classic**

This example launches a single instance of type ``c3.large``.

The key pair and security group, named ``MyKeyPair`` and ``MySecurityGroup``, must exist.

Command::

aws ec2 run-instances --image-id ami-1a2b3c4d --count 1 --instance-type c3.large --key-name MyKeyPair --security-groups MySecurityGroup

Output::

{
      "OwnerId": "123456789012",
      "ReservationId": "r-08626e73c547023b1",
      "Groups": [
          {
              "GroupName": "MySecurityGroup",
              "GroupId": "sg-903004f8"
          }
      ],
      "Instances": [
          {
              "Monitoring": {
                  "State": "disabled"
              },
              "PublicDnsName": null,
              "RootDeviceType": "ebs",
              "State": {
                  "Code": 0,
                  "Name": "pending"
              },
              "EbsOptimized": false,
              "LaunchTime": "2013-07-19T02:42:39.000Z",
              "ProductCodes": [],
              "StateTransitionReason": null, 
              "InstanceId": "i-1234567890abcdef0",
              "ImageId": "ami-1a2b3c4d",
              "PrivateDnsName": null,
              "KeyName": "MyKeyPair",
              "SecurityGroups": [
                  {
                      "GroupName": "MySecurityGroup",
                      "GroupId": "sg-903004f8"
                  }
              ],
              "ClientToken": null,
              "InstanceType": "c3.large",
              "NetworkInterfaces": [],
              "Placement": {
                  "Tenancy": "default",
                  "GroupName": null,
                  "AvailabilityZone": "us-east-1b"
              },
              "Hypervisor": "xen",
              "BlockDeviceMappings": [],
              "Architecture": "x86_64",
              "StateReason": {
                  "Message": "pending",
                  "Code": "pending"
              },
              "RootDeviceName": "/dev/sda1",
              "VirtualizationType": "hvm",
              "AmiLaunchIndex": 0
          }
      ]
  }

**To launch an instance in EC2-VPC**

This example launches a single instance of type ``t2.micro`` into the specified subnet.

The key pair named ``MyKeyPair`` and the security group sg-903004f8 must exist.

Command::

aws ec2 run-instances --image-id ami-abc12345 --count 1 --instance-type t2.micro --key-name MyKeyPair --security-group-ids sg-903004f8 --subnet-id subnet-6e7f829e

Output::

{
      "OwnerId": "123456789012",
      "ReservationId": "r-08626e73c547023b2",
      "Groups": [],
      "Instances": [
          {
              "Monitoring": {
                  "State": "disabled"
              },
              "PublicDnsName": null,
              "RootDeviceType": "ebs",
              "State": {
                  "Code": 0,
                  "Name": "pending"
              },
              "EbsOptimized": false,
              "LaunchTime": "2013-07-19T02:42:39.000Z",
              "PrivateIpAddress": "10.0.1.114",
              "ProductCodes": [],
              "VpcId": "vpc-1a2b3c4d",
              "InstanceId": "i-1234567890abcdef5",
              "ImageId": "ami-abc12345",
              "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
              "KeyName": "MyKeyPair",
              "SecurityGroups": [
                  {
                      "GroupName": "MySecurityGroup",
                      "GroupId": "sg-903004f8"
                  }
              ],
              "ClientToken": null,
              "SubnetId": "subnet-6e7f829e",
              "InstanceType": "t2.micro",
              "NetworkInterfaces": [
                  {
                      "Status": "in-use",
                      "MacAddress": "0e:ad:05:3b:60:52",
                      "SourceDestCheck": true,
                      "VpcId": "vpc-1a2b3c4d",
                      "Description": "null",
                      "NetworkInterfaceId": "eni-a7edb1c9",
                      "PrivateIpAddresses": [
                          {
                              "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
                              "Primary": true,
                              "PrivateIpAddress": "10.0.1.114"
                          }
                      ],
                      "Ipv6Addresses": [],
                      "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
                      "Attachment": {
                          "Status": "attached",
                          "DeviceIndex": 0,
                          "DeleteOnTermination": true,
                          "AttachmentId": "eni-attach-52193138",
                          "AttachTime": "2013-07-19T02:42:39.000Z"
                      },
                      "Groups": [
                          {
                              "GroupName": "MySecurityGroup",
                              "GroupId": "sg-903004f8"
                          }
                      ],
                      "SubnetId": "subnet-6e7f829e",
                      "OwnerId": "123456789012",
                      "PrivateIpAddress": "10.0.1.114"
                  }
              ],
              "SourceDestCheck": true,
              "Placement": {
                  "Tenancy": "default",
                  "GroupName": null,
                  "AvailabilityZone": "us-east-1b"
              },
              "Hypervisor": "xen",
              "BlockDeviceMappings": [],
              "Architecture": "x86_64",
              "StateReason": {
                  "Message": "pending",
                  "Code": "pending"
              },
              "RootDeviceName": "/dev/sda1",
              "VirtualizationType": "hvm",
              "AmiLaunchIndex": 0
          }
      ]
  }

The following example requests a public IP address for an instance that you're launching into a nondefault subnet:

Command::

aws ec2 run-instances --image-id ami-c3b8d6aa --count 1 --instance-type t2.medium --key-name MyKeyPair --security-group-ids sg-903004f8 --subnet-id subnet-6e7f829e --associate-public-ip-address

**To launch an instance using a block device mapping**

Add the following parameter to your ``run-instances`` command to specify block devices::

--block-device-mappings file://mapping.json

To add an Amazon EBS volume with the device name ``/dev/sdh`` and a volume size of 100, specify the following in mapping.json::

[
    {
      "DeviceName": "/dev/sdh",
      "Ebs": {
        "VolumeSize": 100
      }
    }
  ]

To add ``ephemeral1`` as an instance store volume with the device name ``/dev/sdc``, specify the following in mapping.json::

[
    {
      "DeviceName": "/dev/sdc",
      "VirtualName": "ephemeral1"
    }
  ]

To omit a device specified by the AMI used to launch the instance (for example, ``/dev/sdf``), specify the following in mapping.json::

[
    {
      "DeviceName": "/dev/sdf",
      "NoDevice": ""
    }
  ]

You can view only the Amazon EBS volumes in your block device mapping using the console or the ``describe-instances`` command. To view all volumes, including the instance store volumes, use the following command.

Command::

curl http://169.254.169.254/latest/meta-data/block-device-mapping/

Output::

ami
  ephemeral1

Note that ``ami`` represents the root volume. To get details about the instance store volume ``ephemeral1``, use the following command.

Command::

curl http://169.254.169.254/latest/meta-data/block-device-mapping/ephemeral1

Output::

sdc

**To launch an instance with a modified block device mapping**

You can change individual characteristics of existing AMI block device mappings to suit your needs. Perhaps you want to use an existing AMI, but you want a larger root volume than the usual 8 GiB. Or, you would like to use a General Purpose (SSD) volume for an AMI that currently uses a Magnetic volume.

Use the ``describe-images`` command with the image ID of the AMI you want to use to find its existing block device mapping. You should see a block device mapping in the output::

{
    "DeviceName": "/dev/sda1",
    "Ebs": {
      "DeleteOnTermination": true,
      "SnapshotId": "snap-1234567890abcdef0",
      "VolumeSize": 8,
      "VolumeType": "standard",
      "Encrypted": false
    }
  }

You can modify the above mapping by changing the individual parameters. For example, to launch an instance with a modified block device mapping, add the following parameter to your ``run-instances`` command to change the above mapping's volume size and type::

--block-device-mappings file://mapping.json

Where mapping.json contains the following::

[
    {
      "DeviceName": "/dev/sda1",
      "Ebs": {
        "DeleteOnTermination": true,
        "SnapshotId": "snap-1234567890abcdef0", 
        "VolumeSize": 100,
        "VolumeType": "gp2"
      }
    }
  ]

**To launch an instance with user data**

You can launch an instance and specify user data that performs instance configuration, or that runs a script. The user data needs to be passed as normal string, base64 encoding is handled internally. The following example passes user data in a file called ``my_script.txt`` that contains a configuration script for your instance. The script runs at launch.

Command::

aws ec2 run-instances --image-id ami-abc1234 --count 1 --instance-type m4.large --key-name keypair --user-data file://my_script.txt --subnet-id subnet-abcd1234 --security-group-ids sg-abcd1234

For more information about launching instances, see `Using Amazon EC2 Instances`_ in the *AWS Command Line Interface User Guide*.

.. _`Using Amazon EC2 Instances`: http://docs.aws.amazon.com/cli/latest/userguide/cli-ec2-launch.html

**To launch an instance with an instance profile**

This example shows the use of the ``iam-instance-profile`` option to specify an `IAM instance profile`_ by name.

.. _`IAM instance profile`: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html

Command::

aws ec2 run-instances --iam-instance-profile Name=MyInstanceProfile --image-id ami-1a2b3c4d --count 1 --instance-type t2.micro --key-name MyKeyPair --security-groups MySecurityGroup