Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-171,1822,9897.4 MB

Launches the specified Scheduled Instances.

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, you can launch it again after a few minutes. For more information, see Scheduled Instances in the Amazon EC2 User Guide.

get/#Action=RunScheduledInstances

Query parameters

ClientTokenstring

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring Idempotency</a>.

DryRunboolean

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.

InstanceCountinteger
<p>The number of instances.</p> <p>Default: 1</p>
EbsOptimizedboolean
<p>Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.</p> <p>Default: <code>false</code> </p>
ImageIdstring required

The ID of the Amazon Machine Image (AMI).

InstanceTypestring

The instance type.

KernelIdstring

The ID of the kernel.

KeyNamestring

The name of the key pair.

RamdiskIdstring

The ID of the RAM disk.

SecurityGroupIdsstring[]

The IDs of the security groups.

SubnetIdstring

The ID of the subnet in which to launch the instances.

UserDatastring

The base64-encoded MIME user data.

The launch specification. You must match the instance type, Availability Zone, network, and platform of the schedule that you purchased.

ScheduledInstanceIdstring required

The Scheduled Instance ID.

Action'RunScheduledInstances' required
Version'2016-11-15' required

Response

Success