org.jclouds.aws.ec2.options
Class AWSRunInstancesOptions

java.lang.Object
  extended by org.jclouds.http.options.BaseHttpRequestOptions
      extended by org.jclouds.ec2.options.internal.BaseEC2RequestOptions
          extended by org.jclouds.ec2.options.RunInstancesOptions
              extended by org.jclouds.aws.ec2.options.AWSRunInstancesOptions
All Implemented Interfaces:
HttpRequestOptions

public class AWSRunInstancesOptions
extends RunInstancesOptions

Contains options supported in the Form API for the RunInstances operation.

Usage

The recommended way to instantiate a RunInstancesOptions object is to statically import RunInstancesOptions.Builder.* and invoke a static creation method followed by an instance mutator (if needed):

import static org.jclouds.aws.ec2.options.RunInstancesOptions.Builder.*

EC2Client connection = // get connection Future instances = connection.runInstances(executableBy("123125").imageIds(1000, 1004));

Author:
Adrian Cole
See Also:

Nested Class Summary
static class AWSRunInstancesOptions.Builder
           
 
Field Summary
static AWSRunInstancesOptions NONE
           
 
Fields inherited from class org.jclouds.http.options.BaseHttpRequestOptions
formParameters, headers, matrixParameters, pathSuffix, payload, queryParameters
 
Constructor Summary
AWSRunInstancesOptions()
           
 
Method Summary
 AWSRunInstancesOptions asType(String type)
          Specifies the instance type.
 AWSRunInstancesOptions enableMonitoring()
          Enables monitoring for the instance.
 LaunchSpecification.Builder getLaunchSpecificationBuilder()
           
 AWSRunInstancesOptions inPlacementGroup(String placementGroup)
          Specifies the name of an existing placement group you want to launch the instance into (for cluster compute instances).
 AWSRunInstancesOptions withBlockDeviceMappings(Set<? extends BlockDeviceMapping> mappings)
          Specifies the Block Device Mapping for the instance
 AWSRunInstancesOptions withKernelId(String kernelId)
          The ID of the kernel with which to launch the instance.
 AWSRunInstancesOptions withKeyName(String keyName)
          The name of the key pair.
 AWSRunInstancesOptions withRamdisk(String ramDiskId)
          The ID of the RAM disk with which to launch the instance.
 AWSRunInstancesOptions withSecurityGroup(String securityGroup)
          Attaches a single security group.
 AWSRunInstancesOptions withSecurityGroupId(String securityGroup)
           
 AWSRunInstancesOptions withSecurityGroupIds(Iterable<String> securityGroupIds)
           
 AWSRunInstancesOptions withSecurityGroupIds(String... securityGroupIds)
           
 AWSRunInstancesOptions withSecurityGroups(Iterable<String> securityGroups)
          Attach multiple security groups
 AWSRunInstancesOptions withSecurityGroups(String... securityGroups)
          Attach multiple security groups
 AWSRunInstancesOptions withSubnetId(String subnetId)
          Specifies the subnet ID within which to launch the instance(s) for Amazon Virtual Private Cloud.
 AWSRunInstancesOptions withUserData(byte[] unencodedData)
          Unencoded data
 
Methods inherited from class org.jclouds.ec2.options.internal.BaseEC2RequestOptions
getFormValuesWithKeysPrefixedBy, indexFormValuesWithPrefix, indexFormValuesWithPrefix, toString
 
Methods inherited from class org.jclouds.http.options.BaseHttpRequestOptions
buildFormParameters, buildMatrixParameters, buildPathSuffix, buildQueryParameters, buildRequestHeaders, buildStringPayload, equals, getFirstFormOrNull, getFirstHeaderOrNull, getFirstMatrixOrNull, getFirstQueryOrNull, hashCode, replaceHeader
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

NONE

public static final AWSRunInstancesOptions NONE
Constructor Detail

AWSRunInstancesOptions

public AWSRunInstancesOptions()
Method Detail

inPlacementGroup

public AWSRunInstancesOptions inPlacementGroup(String placementGroup)
Specifies the name of an existing placement group you want to launch the instance into (for cluster compute instances).

Parameters:
placementGroup - name of an existing placement group

enableMonitoring

public AWSRunInstancesOptions enableMonitoring()
Enables monitoring for the instance.


withSubnetId

public AWSRunInstancesOptions withSubnetId(String subnetId)
Specifies the subnet ID within which to launch the instance(s) for Amazon Virtual Private Cloud.


withSecurityGroupId

public AWSRunInstancesOptions withSecurityGroupId(String securityGroup)

withSecurityGroupIds

public AWSRunInstancesOptions withSecurityGroupIds(Iterable<String> securityGroupIds)

withSecurityGroupIds

public AWSRunInstancesOptions withSecurityGroupIds(String... securityGroupIds)

withBlockDeviceMappings

public AWSRunInstancesOptions withBlockDeviceMappings(Set<? extends BlockDeviceMapping> mappings)
Description copied from class: RunInstancesOptions
Specifies the Block Device Mapping for the instance

Overrides:
withBlockDeviceMappings in class RunInstancesOptions

withKernelId

public AWSRunInstancesOptions withKernelId(String kernelId)
Description copied from class: RunInstancesOptions
The ID of the kernel with which to launch the instance.

Overrides:
withKernelId in class RunInstancesOptions

withKeyName

public AWSRunInstancesOptions withKeyName(String keyName)
Description copied from class: RunInstancesOptions
The name of the key pair.

Overrides:
withKeyName in class RunInstancesOptions

withRamdisk

public AWSRunInstancesOptions withRamdisk(String ramDiskId)
Description copied from class: RunInstancesOptions
The ID of the RAM disk with which to launch the instance. Some kernels require additional drivers at l aunch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, go to th e Resource Center and search for the kernel ID.

Overrides:
withRamdisk in class RunInstancesOptions

withSecurityGroup

public AWSRunInstancesOptions withSecurityGroup(String securityGroup)
Description copied from class: RunInstancesOptions
Attaches a single security group. Multiple calls to this method won't add more groups.

Overrides:
withSecurityGroup in class RunInstancesOptions
Parameters:
securityGroup - name of an existing security group

withSecurityGroups

public AWSRunInstancesOptions withSecurityGroups(Iterable<String> securityGroups)
Description copied from class: RunInstancesOptions
Attach multiple security groups

Overrides:
withSecurityGroups in class RunInstancesOptions

withSecurityGroups

public AWSRunInstancesOptions withSecurityGroups(String... securityGroups)
Description copied from class: RunInstancesOptions
Attach multiple security groups

Overrides:
withSecurityGroups in class RunInstancesOptions

withUserData

public AWSRunInstancesOptions withUserData(byte[] unencodedData)
Description copied from class: RunInstancesOptions
Unencoded data

Overrides:
withUserData in class RunInstancesOptions

asType

public AWSRunInstancesOptions asType(String type)
Description copied from class: RunInstancesOptions
Specifies the instance type. default small;

Overrides:
asType in class RunInstancesOptions

getLaunchSpecificationBuilder

public LaunchSpecification.Builder getLaunchSpecificationBuilder()


Copyright © 2009-2011 jclouds. All Rights Reserved.