ec2:RunInstances

Write

ec2:RunInstances is a Write access-level action in the ec2 service. Grants permission to launch one or more instances

Resource types

ARNs that ec2:RunInstances can be scoped to in an IAM policy.

arn:${Partition}:ec2:${Region}:${Account}:capacity-reservation/${CapacityReservationId}

capacity-reservation

arn:${Partition}:ec2:${Region}:${Account}:elastic-gpu/${ElasticGpuId}

elastic-gpu

arn:${Partition}:elastic-inference:${Region}:${Account}:elastic-inference-accelerator/${AcceleratorId}

elastic-inference

arn:${Partition}:resource-groups:${Region}:${Account}:group/${GroupName}

group

arn:${Partition}:ec2:${Region}::image/${ImageId} required

image

arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} required

instance

arn:${Partition}:ec2:${Region}:${Account}:key-pair/${KeyPairName}

key-pair

arn:${Partition}:ec2:${Region}:${Account}:launch-template/${LaunchTemplateId}

launch-template

arn:${Partition}:license-manager:${Region}:${Account}:license-configuration:${LicenseConfigurationId}

license-configuration

arn:${Partition}:ec2:${Region}:${Account}:network-interface/${NetworkInterfaceId} required

network-interface

arn:${Partition}:ec2:${Region}:${Account}:placement-group/${PlacementGroupName}

placement-group

arn:${Partition}:ec2:${Region}:${Account}:secondary-interface/${SecondaryInterfaceId}

secondary-interface

arn:${Partition}:ec2:${Region}:${Account}:secondary-subnet/${SecondarySubnetId}

secondary-subnet

arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} required

security-group

arn:${Partition}:ec2:${Region}::snapshot/${SnapshotId}

snapshot

arn:${Partition}:ec2:${Region}:${Account}:spot-instances-request/${SpotInstanceRequestId}

spot-instances-request

arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} required

subnet

arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}

volume

Condition keys

Keys you can use in the Condition block of a policy that grants ec2:RunInstances.

ec2:Region String

Filters access by the name of the AWS Region

aws:ResourceTag/${TagKey} String

Filters access by a tag key and value pair of a resource

ec2:IsLaunchTemplateResource Bool

Filters access by whether users are able to override resources that are specified in the launch template

ec2:LaunchTemplate ARN

Filters access by the ARN of a launch template

ec2:ElasticGpuType String

Filters access by the type of Elastic Graphics accelerator

ec2:ResourceTag/${TagKey} String

Filters access by a tag key and value pair of a resource

ec2:ImageID String

Filters access by the ID of an image

ec2:ImageType String

Filters access by the type of image (machine, aki, or ari)

ec2:Owner String

Filters access by the owner of the resource (amazon, aws-marketplace, or an AWS account ID)

ec2:Public Bool

Filters access by whether the image has public launch permissions

ec2:RootDeviceType String

Filters access by the root device type of the instance (ebs or instance-store)

aws:RequestTag/${TagKey} String

Filters access by a tag key and value pair that is allowed in the request

aws:TagKeys ArrayOfString

Filters access by a list of tag keys that are allowed in the request

ec2:AvailabilityZone String

Filters access by the name of an Availability Zone in an AWS Region

ec2:AvailabilityZoneId String

Filters access by the ID of an Availability Zone in an AWS Region

ec2:CpuOptionsAmdSevSnp String

Filters access by the state of AMD SEV-SNP CPU Options. Currently, only US East (Ohio) and Europe (Ireland) are supported

ec2:EbsOptimized Bool

Filters access by whether the instance is enabled for EBS optimization

ec2:InstanceAutoRecovery String

Filters access by whether the instance type supports auto recovery

ec2:InstanceBandwidthWeighting String

Filters access by the bandwidth weighting of an instance

ec2:InstanceID String

Filters access by the ID of an instance

ec2:InstanceMarketType String

Filters access by the market or purchasing option of an instance (capacity-block, on-demand, or spot)

ec2:InstanceMetadataTags String

Filters access by whether the instance allows access to instance tags from the instance metadata

ec2:InstanceProfile ARN

Filters access by the ARN of an instance profile

ec2:InstanceType String

Filters access by the type of instance

ec2:ManagedResourceOperator String

Filters access by the presence of an EC2 operator provisioning a managed resource

ec2:MetadataHttpEndpoint String

Filters access by whether the HTTP endpoint is enabled for the instance metadata service

ec2:MetadataHttpPutResponseHopLimit Numeric

Filters access by the allowed number of hops when calling the instance metadata service

ec2:MetadataHttpTokens String

Filters access by whether tokens are required when calling the instance metadata service (optional or required)

ec2:PlacementGroup ARN

Filters access by the ARN of the placement group

ec2:ProductCode String

Filters access by the product code that is associated with the AMI

ec2:Tenancy String

Filters access by the tenancy of the VPC or instance (default, dedicated, or host)

ec2:KeyPairName String

Filters access by the name of a key pair

ec2:KeyPairType String

Filters access by the type of a key pair

ec2:AssociatePublicIpAddress Bool

Filters access by whether the user wants to associate a public IP address with the instance

ec2:AuthorizedService String

Filters access by the AWS service that has permission to use a resource

ec2:NetworkInterfaceID String

Filters access by the ID of an elastic network interface

ec2:Subnet ARN

Filters access by the ARN of the subnet

ec2:Vpc ARN

Filters access by the ARN of the VPC

ec2:PlacementGroupName String

Filters access by the name of a placement group

ec2:PlacementGroupStrategy String

Filters access by the instance placement strategy used by the placement group (cluster, spread, or partition)

ec2:SecurityGroupID String

Filters access by the ID of a security group

ec2:ParentVolume ARN

Filters access by the ARN of the parent volume from which the snapshot was created

ec2:SnapshotID String

Filters access by the ID of a snapshot

ec2:SnapshotTime String

Filters access by the initiation time of a snapshot

ec2:VolumeSize Numeric

Filters access by the size of the volume, in GiB

ec2:SubnetID String

Filters access by the ID of a subnet

ec2:Encrypted Bool

Filters access by whether the EBS volume is encrypted

ec2:ParentSnapshot ARN

Filters access by the ARN of the parent snapshot

ec2:VolumeID String

Filters access by the ID of a volume

ec2:VolumeInitializationRate Numeric

Filters access by the initialization rate of the volume, in MiBps

ec2:VolumeIops Numeric

Filters access by the the number of input/output operations per second (IOPS) provisioned for the volume

ec2:VolumeThroughput Numeric

Filters access by the throughput of the volume, in MiBps

ec2:VolumeType String

Filters access by the type of volume (gp2, gp3, io1, io2, st1, sc1, or standard)

Example IAM policy

A minimal policy that allows ec2:RunInstances. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEc2RunInstances",
      "Effect": "Allow",
      "Action": "ec2:RunInstances",
      "Resource": "*"
    }
  ]
}

Related actions in ec2

ec2:AcceptAddressTransfer Write ec2:AcceptCapacityReservationBillingOwnership Write ec2:AcceptReservedInstancesExchangeQuote Write ec2:AcceptTransitGatewayClientVpnAttachment Write ec2:AcceptTransitGatewayMulticastDomainAssociations Write ec2:AcceptTransitGatewayPeeringAttachment Write ec2:AcceptTransitGatewayVpcAttachment Write ec2:AcceptVpcEndpointConnections Write ec2:AcceptVpcPeeringConnection Write ec2:AdvertiseByoipCidr Write ec2:AllocateAddress Write ec2:AllocateHosts Write

View all ec2 actions →