Class Net::Amazon::S3::Bucket
In: lib/net/amazon/s3/bucket.rb
Parent: Object

Represents an Amazon S3 bucket. This class should only be instantiated through one of the methods in the S3 class.

Methods

<=>   []   []=   create_object   delete_object   each   get_object   get_objects   has_object?   new   object_exist?  

Included Modules

Comparable Enumerable

Attributes

creation_date  [R] 
name  [R] 

Public Class methods

new(s3, bucket_name, creation_date)

Creates and returns a new Bucket object. You should never create new Bucket objects directly. Instead, use one of the methods in the S3 class.

Public Instance methods

<=>(bucket)

Compares two buckets by name.

[](object_key)

Alias for get_object

[]=(object_key, value, metadata = {})

Alias for create_object

create_object(object_key, value, metadata = {})

Creates and returns a new S3::Object with the specified object_key and value. If this bucket already contains an object with the specified key, that object will be overwritten.

If value is an open IO stream, the value of the object will be read from the stream.

delete_object(object_key)

Deletes the specified object from this bucket.

each() {|key, value| ...}

Iterates through the list of objects.

get_object(object_key)

Returns a S3::Object representing the specified object_key, or nil if the object doesn‘t exist in this bucket.

get_objects(prefix = '')

Gets a list of all objects in this bucket whose keys begin with prefix. Returns a Hash of S3::Object objects indexed by object key.

has_object?(object_key)

Alias for object_exist?

object_exist?(object_key)

Returns true if an object with the specified object_key exists in this bucket, false otherwise.

[Validate]