Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
VM::EC2::ReservedInstance(3) User Contributed Perl Documentation VM::EC2::ReservedInstance(3)

VM::EC2::ReservedInstance - Object describing an Amazon EC2 reserved instance

  use VM::EC2;
  $ec2       = VM::EC2->new(...);
  @offerings = $ec2->describe_reserved_instances();
  for my $o (@offerings) {
    print $o->reservedInstancesId,"\n";
    print $o->instanceType,"\n";
    print $o->availabilityZone,"\n";
    print $o->start,"\n";
    print $o->duration,"\n";
    print $o->fixedPrice,"\n";
    print $o->usagePrice,"\n";
    print $o->instanceCount,"\n";
    print $o->productDescription,"\n";
    print $o->state,"\n";
    print $o->instanceTenancy,"\n";
    print $o->currencyCode,"\n";
    $tags = $o->tags;
This object represents an Amazon EC2 reserved instance reservation that you have purchased, as returned by VM::EC2-> describe_reserved_instances().

These object methods are supported:
 reservedInstancesId -- ID of this reserved instance contract
 instanceType        -- The instance type on which these reserved
                         instance can be used.
 availabilityZone    -- The availability zone in which these reserved
                         instances can be used.
 start               -- The date and time that this contract was established.
 duration            -- The duration of this contract, in seconds.
 fixedPrice          -- The purchase price of the reserved instance for the indicated
 usagePrice          -- The usage price of the reserved instance, per hour.
 instanceCount       -- The number of instances that were purchased under this contract.
 productDescription  -- The reserved instance description. One of  "Linux/UNIX",
                         "Linux/UNIX (Amazon VPC)", "Windows", and "Windows (Amazon VPC)"
 state               -- The state of the reserved instance purchase. One of "payment-pending",
                         "active", "payment-failed", and "retired".
 tagSet              -- Tags for this reserved instance set. More conveniently accessed via
                         the tags(), add_tags() and delete_tags() methods.
 instanceTenancy     -- The tenancy of the reserved instance (VPC only).
 currencyCode        -- The currency of the reserved instance offering prices.
This object supports the various tag manipulation methods described in VM::EC2::Generic. In addition it supports the following methods:

Refreshes the object and returns its state, one of "payment-pending", "active", "payment-failed", and "retired". You can use this to monitor the progress of a purchase.

Calls VM::EC2-> describe_reserved_instances() to refresh the object against current information in Amazon.

When used in a string context, this object will interpolate the reservedInstancesId.

VM::EC2 VM::EC2::Generic VM::EC2::ReservedInstances::Offering

Lincoln Stein <>.
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.
2019-01-01 perl v5.28.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.