NAME
    Net::XIPCloud - Perl extension for interacting with Internap's XIPCloud
    storage platform

SYNOPSIS
    use Net::XIPCloud;

    my $xip = Net::XIPCloud->new( username => 'myusername', password =>
    'mypassword );

    $xip->connect();

    $xip->cp("fromcontainer","fromobject","tocontainer","toobject");

    $xip->file("somecontainer","someobject");

    $xip->ls();

    $xip->ls("mycontainer");

    $xip->mkdir("newcontainer");

    $xip->rmdir("somecontainer");

    $xip->du();

    $xip->du("somecontainer");

    my $data = $xip->get_value("somecontainer","someobject");

    $xip->get_file("somecontainer","someobject","/tmp/someobject");

    $xip->put_value("somecontainer","someobject",$data,"text/html");

    $xip->put_file("somecontainer","someobject","/tmp/someobject","text/html
    ");

    $xip->get_fhstream("somecontainer","someobject",*STDOUT);

    $xip->rm("somecontainer","someobject");

DESCRIPTION
    This perl module creates an XIPCloud object, which allows direct
    manipulation of objects and containers within Internap's XIPCloud
    storage.

    A valid XIPCloud account is required to use this module

  new( username => 'username', password => 'password');
    Returns a reference to a new XIPCloud object. This method requires
    passing of a valid username and password.

  connect()
    Connects to XIPCloud using the username and password provids in the
    new() call.

    Method returns 1 for success and undef for failure.

  ls([CONTAINER])
    Depending on the calling arguments, this method returns the list of
    containers or list of objects within a single container as an array
    reference.

    Limit and marker values may be provided (see API documentation) for
    pagination.

  file("somecontainer","someobject")
    This call returns metadata about a specific object.

  cp("fromcontainer","fromobject",'tocontainer","toobject");
    Copy the contents of one object to another

  mkdir("somecontainer")
    This method creates a new container. It returns 1 for success and undef
    for failure.

  rmdir("somecontainer")
    This method removes a container and its contents. It returns 1 for
    success and undef for failure.

  du([CONTAINER])
    Depending on calling arguments, this method returns account or
    container-level statistics as a hash reference.

  get_value("somecontainer","someobject")
    This method returns a scalar value, containing the body of the requested
    object.

  put_value("somecontainer","someobject","..data..","text/html")
    This method places the contents of a passed scalar into the specified
    container and object.

    Content-type may be specified, but is optional. It defaults to
    "text/plain"

  get_file("somecontainer","someobject","/tmp/destfile")
    This method places the contents of the requested object in a target
    location of the filesystem.

  put_file("somecontainer","someobject","/tmp/sourcefile","text/html")
    This method places the contents of a specified source file into an
    object.

  get_fhstream("somecontainer","someobject",*FILE)
    This method takes a container, object and open file handle as arguments.
    It retrieves the object in chunks, which it writes to *FILE as they are
    received.

  rm("somecontainer","someobject")
    This method removes an object.

AUTHOR
    Dennis Opacki, dopacki@internap.com

SEE ALSO
    perl(1).