NAME
Net::Mosso::CloudFiles::Container - Represent a Cloud Files container
DESCRIPTION
This class represents a container in Cloud Files. It is created by calling new_container or container on a Net::Mosso::CloudFiles object.
METHODS
name
Returns the name of the container:
say 'have container ' . $container->name;object_count
Returns the total number of objects in the container:
my $object_count = $container->object_count;bytes_used
Returns the total number of bytes used by objects in the container:
my $bytes_used = $container->bytes_used;objects
Returns a list of objects in the container as Net::Mosso::CloudFiles::Object objects. As the API only returns ten thousand objects per request, this module may have to do multiple requests to fetch all the objects in the container. This is exposed by using a Data::Stream::Bulk object. You can also pass in a prefix:
foreach my $object ($container->objects->all) {
...
}
my @objects = $container->objects(prefix => 'dir/')->all;object
This returns a <Net::Mosso::CloudFiles::Object> representing an object.
my $xxx = $container->object( name => 'XXX' );
my $yyy = $container->object( name => 'YYY', content_type => 'text/plain' );delete
Deletes the container, which should be empty:
$container->delete;SEE ALSO
Net::Mosso::CloudFiles, Net::Mosso::CloudFiles::Object.
AUTHOR
Leon Brocard <acme@astray.com>.
COPYRIGHT
Copyright (C) 2008-9, Leon Brocard
LICENSE
This module is free software; you can redistribute it or modify it under the same terms as Perl itself.