AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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 Elastic Compute Cloud User Guide.

Note:

For PCL this operation is only available in asynchronous form. Please refer to RunScheduledInstancesAsync.

Namespace: Amazon.EC2
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public virtual RunScheduledInstancesResponse RunScheduledInstances(
         RunScheduledInstancesRequest request
)
Parameters
request
Type: Amazon.EC2.Model.RunScheduledInstancesRequest

Container for the necessary parameters to execute the RunScheduledInstances service method.

Return Value
The response from the RunScheduledInstances service method, as returned by EC2.

Examples

This example launches the specified Scheduled Instance in a VPC.

To launch a Scheduled Instance in a VPC


var response = client.RunScheduledInstances(new RunScheduledInstancesRequest 
{
    InstanceCount = 1,
    LaunchSpecification = new ScheduledInstancesLaunchSpecification {
        IamInstanceProfile = new ScheduledInstancesIamInstanceProfile { Name = "my-iam-role" },
        ImageId = "ami-12345678",
        InstanceType = "c4.large",
        KeyName = "my-key-pair",
        NetworkInterfaces = new List {
            new ScheduledInstancesNetworkInterface {
                AssociatePublicIpAddress = true,
                DeviceIndex = 0,
                Groups = new List {
                    "sg-12345678"
                },
                SubnetId = "subnet-12345678"
            }
        }
    },
    ScheduledInstanceId = "sci-1234-1234-1234-1234-123456789012"
});

List instanceIdSet = response.InstanceIdSet;

            

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

To launch a Scheduled Instance in EC2-Classic


var response = client.RunScheduledInstances(new RunScheduledInstancesRequest 
{
    InstanceCount = 1,
    LaunchSpecification = new ScheduledInstancesLaunchSpecification {
        IamInstanceProfile = new ScheduledInstancesIamInstanceProfile { Name = "my-iam-role" },
        ImageId = "ami-12345678",
        InstanceType = "c4.large",
        KeyName = "my-key-pair",
        Placement = new ScheduledInstancesPlacement { AvailabilityZone = "us-west-2b" },
        SecurityGroupIds = new List {
            "sg-12345678"
        }
    },
    ScheduledInstanceId = "sci-1234-1234-1234-1234-123456789012"
});

List instanceIdSet = response.InstanceIdSet;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also