|
NAME VM::EC2::REST::spot_instanceSYNOPSISuse VM::EC2 ':misc'; METHODSThese methods allow you to request spot instances and manipulate spot data feed subscriptions.Implemented: CancelSpotInstanceRequests CreateSpotDatafeedSubscription DeleteSpotDatafeedSubscription DescribeSpotDatafeedSubscription DescribeSpotInstanceRequests DescribeSpotPriceHistory RequestSpotInstances Unimplemented: (none) $subscription = $ec2->create_spot_datafeed_subscription($bucket,$prefix)This method creates a spot datafeed subscription. Provide the method with the name of an S3 bucket associated with your account, and a prefix to be appended to the files written by the datafeed. Spot instance usage logs will be written into the requested bucket, and prefixed with the desired prefix.If no prefix is specified, it defaults to "SPOT_DATAFEED_"; On success, a VM::EC2::Spot::DatafeedSubscription object is returned; Only one datafeed is allowed per account; $boolean = $ec2->delete_spot_datafeed_subscription()This method delete's the current account's spot datafeed subscription, if any. It takes no arguments.On success, it returns true. $subscription = $ec2->describe_spot_datafeed_subscription()This method describes the current account's spot datafeed subscription, if any. It takes no arguments.On success, a VM::EC2::Spot::DatafeedSubscription object is returned; @spot_price_history = $ec2->describe_spot_price_history(@filters)This method applies the specified filters to spot instances and returns a list of instances, timestamps and their price at the indicated time. Each spot price history point is represented as a VM::EC2::Spot::PriceHistory object.Option arguments are: -start_time Start date and time of the desired history data, in the form yyyy-mm-ddThh:mm:ss (GMT). The Perl DateTime module provides a convenient way to create times in this format. -end_time End date and time of the desired history data. -instance_type The instance type, e.g. "m1.small", can be a scalar value or an arrayref. -product_description The product description. One of "Linux/UNIX", "SUSE Linux" or "Windows". Can be a scalar value or an arrayref. -availability_zone A single availability zone, such as "us-east-1a". -max_results Maximum number of rows to return in a single call. -next_token Specifies the next set of results to return; used internally. -filter Hashref containing additional filters to apply, The following filters are recognized: "instance-type", "product-description", "spot-price", "timestamp", "availability-zone". The '*' and '?' wildcards can be used in filter values, but numeric comparison operations are not supported by the Amazon API. Note that wildcards are not generally allowed in the standard options. Hence if you wish to get spot price history in all availability zones in us-east, this will work: $ec2->describe_spot_price_history(-filter=>{'availability-zone'=>'us-east*'}) but this will return an invalid parameter error: $ec2->describe_spot_price_history(-availability_zone=>'us-east*') If you specify -max_results, then the list of history objects returned may not represent the complete result set. In this case, the method more_spot_prices() will return true. You can then call describe_spot_price_history() repeatedly with no arguments in order to retrieve the remainder of the results. When there are no more results, more_spot_prices() will return false. my @results = $ec2->describe_spot_price_history(-max_results => 20, -instance_type => 'm1.small', -availability_zone => 'us-east*', -product_description=>'Linux/UNIX'); print_history(\@results); while ($ec2->more_spot_prices) { @results = $ec2->describe_spot_price_history print_history(\@results); } @requests = $ec2->request_spot_instances(%args)This method will request one or more spot instances to be launched when the current spot instance run-hour price drops below a preset value and terminated when the spot instance run-hour price exceeds the value.On success, will return a series of VM::EC2::Spot::InstanceRequest objects, one for each instance specified in -instance_count.
@requests = $ec2->cancel_spot_instance_requests(@request_ids)This method cancels the pending requests. It does not terminate any instances that are already running as a result of the requests. It returns a list of VM::EC2::Spot::InstanceRequest objects, whose fields will be unpopulated except for spotInstanceRequestId and state.@requests = $ec2->describe_spot_instance_requests(@spot_instance_request_ids)@requests = $ec2->describe_spot_instance_requests(\%filters)@requests = $ec2->describe_spot_instance_requests(-spot_instance_request_id=>\@ids,-filter=>\%filters)This method will return information about current spot instance requests as a list of VM::EC2::Spot::InstanceRequest objects.Optional arguments: -spot_instance_request_id -- Scalar or arrayref of request Ids. -filter -- Tags and other filters to apply. There are many filters available, described fully at http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html?ApiReference-ItemType-SpotInstanceRequestSetItemType.html: availability-zone-group create-time fault-code fault-message instance-id launch-group launch.block-device-mapping.delete-on-termination launch.block-device-mapping.device-name launch.block-device-mapping.snapshot-id launch.block-device-mapping.volume-size launch.block-device-mapping.volume-type launch.group-id launch.image-id launch.instance-type launch.kernel-id launch.key-name launch.monitoring-enabled launch.ramdisk-id launch.network-interface.network-interface-id launch.network-interface.device-index launch.network-interface.subnet-id launch.network-interface.description launch.network-interface.private-ip-address launch.network-interface.delete-on-termination launch.network-interface.group-id launch.network-interface.group-name launch.network-interface.addresses.primary product-description spot-instance-request-id spot-price state status-code status-message tag-key tag-value tag:<key> type launched-availability-zone valid-from valid-until SEE ALSOVM::EC2AUTHORLincoln Stein <lincoln.stein@gmail.com>.Copyright (c) 2011 Ontario Institute for Cancer Research This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty. POD ERRORSHey! The above document had some coding errors, which are explained below:
Visit the GSP FreeBSD Man Page Interface. |