Use RunScheduledInstances with an AWS SDK or CLI

The following code examples show how to use RunScheduledInstances.

CLI

AWS CLI

To launch a Scheduled Instance

This example launches the specified Scheduled Instance in a VPC.

Command:

<userinput>aws ec2 run-scheduled-instances --scheduled-instance-id <replaceable>sci-1234-1234-1234-1234-123456789012</replaceable> --instance-count <replaceable>1</replaceable> --launch-specification <replaceable>file://launch-specification.json</replaceable></userinput>

Launch-specification.json:

{
  "ImageId": "ami-12345678",
  "KeyName": "my-key-pair",
  "InstanceType": "c4.large",
  "NetworkInterfaces": [
    {
        "DeviceIndex": 0,
        "SubnetId": "subnet-12345678",
        "AssociatePublicIpAddress": true,
        "Groups": ["sg-12345678"]
    }
  ],
  "IamInstanceProfile": {
      "Name": "my-iam-role"
  }
}

Output:

{
  "InstanceIdSet": [
      "i-1234567890abcdef0"
  ]
}

This example launches the specified Scheduled Instance in EC2-Classic.

Command:

<userinput>aws ec2 run-scheduled-instances --scheduled-instance-id <replaceable>sci-1234-1234-1234-1234-123456789012</replaceable> --instance-count <replaceable>1</replaceable> --launch-specification <replaceable>file://launch-specification.json</replaceable></userinput>

Launch-specification.json:

{
  "ImageId": "ami-12345678",
  "KeyName": "my-key-pair",
  "SecurityGroupIds": ["sg-12345678"],
  "InstanceType": "c4.large",
  "Placement": {
    "AvailabilityZone": "us-west-2b"
  }
  "IamInstanceProfile": {
      "Name": "my-iam-role"
  }
}

Output:

{
  "InstanceIdSet": [
      "i-1234567890abcdef0"
  ]
}

• For API details, see RunScheduledInstances in AWS CLI Command Reference.

PowerShell

Tools for PowerShell

Example 1: This example launches the specified Scheduled Instance.

New-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012 -InstanceCount 1 `
-IamInstanceProfile_Name my-iam-role `
-LaunchSpecification_ImageId ami-12345678 `
-LaunchSpecification_InstanceType c4.large `
-LaunchSpecification_SubnetId subnet-12345678`
-LaunchSpecification_SecurityGroupId sg-12345678

• For API details, see RunScheduledInstances in AWS Tools for PowerShell Cmdlet Reference.

For a complete list of AWS SDK developer guides and code examples, see Create Amazon EC2 resources using an AWS SDK. This topic also includes information about getting started and details about previous SDK versions.