org.jclouds.aws.ec2.services
Interface SpotInstanceClient


public interface SpotInstanceClient

Provides Spot Instance services for EC2. For more information, refer to the Amazon EC2 Developer Guide.

Author:
Adrian Cole

Method Summary
 String cancelSpotInstanceRequestsInRegion(String region, String... requestIds)
          Cancels one or more Spot Instance requests.
 Set<SpotInstanceRequest> describeSpotInstanceRequestsInRegion(String region, String... requestIds)
          Describes Spot Instance requests.
 Set<Spot> describeSpotPriceHistoryInRegion(String region, DescribeSpotPriceHistoryOptions... options)
          Describes Spot Price history.
 SpotInstanceRequest requestSpotInstanceInRegion(String region, float spotPrice, String imageId, String instanceType)
          request a single spot instance
 Set<SpotInstanceRequest> requestSpotInstancesInRegion(String region, float spotPrice, int instanceCount, LaunchSpecification launchSpec, RequestSpotInstancesOptions... options)
          Creates a Spot Instance request.
 

Method Detail

describeSpotInstanceRequestsInRegion

Set<SpotInstanceRequest> describeSpotInstanceRequestsInRegion(@Nullable
                                                              String region,
                                                              String... requestIds)
Describes Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

Parameters:
region - Region where the spot instance service is running
requestIds - Specifies the ID of the Spot Instance request.
Returns:
TODO
See Also:
requestSpotInstancesInRegion(java.lang.String, float, int, org.jclouds.aws.ec2.domain.LaunchSpecification, org.jclouds.aws.ec2.options.RequestSpotInstancesOptions...), cancelSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...), describeSpotPriceHistoryInRegion(java.lang.String, org.jclouds.aws.ec2.options.DescribeSpotPriceHistoryOptions...),

requestSpotInstanceInRegion

SpotInstanceRequest requestSpotInstanceInRegion(@Nullable
                                                String region,
                                                float spotPrice,
                                                String imageId,
                                                String instanceType)
request a single spot instance

Parameters:
region - Region where the spot instance service is running
spotPrice - Specifies the maximum hourly price for any Spot Instance launched to fulfill the request.
imageId - The AMI ID.
instanceType - The instance type (ex. m1.small)
Returns:
spot instance request
See Also:
requestSpotInstancesInRegion(java.lang.String, float, int, org.jclouds.aws.ec2.domain.LaunchSpecification, org.jclouds.aws.ec2.options.RequestSpotInstancesOptions...)

requestSpotInstancesInRegion

Set<SpotInstanceRequest> requestSpotInstancesInRegion(@Nullable
                                                      String region,
                                                      float spotPrice,
                                                      int instanceCount,
                                                      LaunchSpecification launchSpec,
                                                      RequestSpotInstancesOptions... options)
Creates a Spot Instance request. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

Parameters:
region - Region where the spot instance service is running
spotPrice - Specifies the maximum hourly price for any Spot Instance launched to fulfill the request.
instanceCount - number of instances to request
launchSpec - includes at least The AMI ID and instance type (ex. m1.small)
options - options including expiration time or grouping
Returns:
set of spot instance requests
See Also:
describeSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...), cancelSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...), describeSpotPriceHistoryInRegion(java.lang.String, org.jclouds.aws.ec2.options.DescribeSpotPriceHistoryOptions...),

describeSpotPriceHistoryInRegion

Set<Spot> describeSpotPriceHistoryInRegion(@Nullable
                                           String region,
                                           DescribeSpotPriceHistoryOptions... options)
Describes Spot Price history. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

Parameters:
region - Region where the spot instance service is running
options - options to control the list
Returns:
TODO
See Also:
describeSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...), requestSpotInstancesInRegion(java.lang.String, float, int, org.jclouds.aws.ec2.domain.LaunchSpecification, org.jclouds.aws.ec2.options.RequestSpotInstancesOptions...), cancelSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...),

cancelSpotInstanceRequestsInRegion

String cancelSpotInstanceRequestsInRegion(@Nullable
                                          String region,
                                          String... requestIds)
Cancels one or more Spot Instance requests. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current spot instance requests. For conceptual information about Spot Instances, refer to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

Parameters:
region - Region where the spot instance service is running
requestIds - Specifies the ID of the Spot Instance request.
Returns:
TODO
See Also:
describeSpotInstanceRequestsInRegion(java.lang.String, java.lang.String...), requestSpotInstancesInRegion(java.lang.String, float, int, org.jclouds.aws.ec2.domain.LaunchSpecification, org.jclouds.aws.ec2.options.RequestSpotInstancesOptions...), describeSpotPriceHistoryInRegion(java.lang.String, org.jclouds.aws.ec2.options.DescribeSpotPriceHistoryOptions...),


Copyright © 2009-2012 jclouds. All Rights Reserved.