paws.compute (version 0.1.0)

ec2_run_scheduled_instances: Launches the specified Scheduled Instances

Description

Launches the specified Scheduled Instances.

Usage

ec2_run_scheduled_instances(ClientToken, DryRun, InstanceCount,
  LaunchSpecification, ScheduledInstanceId)

Arguments

ClientToken

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

DryRun

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 DryRunOperation. Otherwise, it is UnauthorizedOperation.

InstanceCount

The number of instances.

Default: 1

LaunchSpecification

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

ScheduledInstanceId

[required] The Scheduled Instance ID.

Request syntax

svc$run_scheduled_instances(
  ClientToken = "string",
  DryRun = TRUE|FALSE,
  InstanceCount = 123,
  LaunchSpecification = list(
    BlockDeviceMappings = list(
      list(
        DeviceName = "string",
        Ebs = list(
          DeleteOnTermination = TRUE|FALSE,
          Encrypted = TRUE|FALSE,
          Iops = 123,
          SnapshotId = "string",
          VolumeSize = 123,
          VolumeType = "string"
        ),
        NoDevice = "string",
        VirtualName = "string"
      )
    ),
    EbsOptimized = TRUE|FALSE,
    IamInstanceProfile = list(
      Arn = "string",
      Name = "string"
    ),
    ImageId = "string",
    InstanceType = "string",
    KernelId = "string",
    KeyName = "string",
    Monitoring = list(
      Enabled = TRUE|FALSE
    ),
    NetworkInterfaces = list(
      list(
        AssociatePublicIpAddress = TRUE|FALSE,
        DeleteOnTermination = TRUE|FALSE,
        Description = "string",
        DeviceIndex = 123,
        Groups = list(
          "string"
        ),
        Ipv6AddressCount = 123,
        Ipv6Addresses = list(
          list(
            Ipv6Address = "string"
          )
        ),
        NetworkInterfaceId = "string",
        PrivateIpAddress = "string",
        PrivateIpAddressConfigs = list(
          list(
            Primary = TRUE|FALSE,
            PrivateIpAddress = "string"
          )
        ),
        SecondaryPrivateIpAddressCount = 123,
        SubnetId = "string"
      )
    ),
    Placement = list(
      AvailabilityZone = "string",
      GroupName = "string"
    ),
    RamdiskId = "string",
    SecurityGroupIds = list(
      "string"
    ),
    SubnetId = "string",
    UserData = "string"
  ),
  ScheduledInstanceId = "string"
)

Details

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.

Examples

# NOT RUN {
# This example launches the specified Scheduled Instance in a VPC.
# }
# NOT RUN {
svc$run_scheduled_instances(
  InstanceCount = 1L,
  LaunchSpecification = list(
    IamInstanceProfile = list(
      Name = "my-iam-role"
    ),
    ImageId = "ami-12345678",
    InstanceType = "c4.large",
    KeyName = "my-key-pair",
    NetworkInterfaces = list(
      list(
        AssociatePublicIpAddress = TRUE,
        DeviceIndex = 0L,
        Groups = list(
          "sg-12345678"
        ),
        SubnetId = "subnet-12345678"
      )
    )
  ),
  ScheduledInstanceId = "sci-1234-1234-1234-1234-123456789012"
)
# }
# NOT RUN {
# This example launches the specified Scheduled Instance in EC2-Classic.
# }
# NOT RUN {
svc$run_scheduled_instances(
  InstanceCount = 1L,
  LaunchSpecification = list(
    IamInstanceProfile = list(
      Name = "my-iam-role"
    ),
    ImageId = "ami-12345678",
    InstanceType = "c4.large",
    KeyName = "my-key-pair",
    Placement = list(
      AvailabilityZone = "us-west-2b"
    ),
    SecurityGroupIds = list(
      "sg-12345678"
    )
  ),
  ScheduledInstanceId = "sci-1234-1234-1234-1234-123456789012"
)
# }
# NOT RUN {
# }