mirror of
https://github.com/fog/fog.git
synced 2022-11-09 13:51:43 -05:00
83 lines
3.6 KiB
Ruby
83 lines
3.6 KiB
Ruby
module Fog
|
|
module AWS
|
|
module S3
|
|
class Real
|
|
|
|
# List information about object versions in an S3 bucket
|
|
#
|
|
# ==== Parameters
|
|
# * bucket_name<~String> - name of bucket to list object keys from
|
|
# * options<~Hash> - config arguments for list. Defaults to {}.
|
|
# * 'delimiter'<~String> - causes keys with the same string between the prefix
|
|
# value and the first occurence of delimiter to be rolled up
|
|
# * 'key-marker'<~String> - limits object keys to only those that appear
|
|
# lexicographically after its value.
|
|
# * 'max-keys'<~Integer> - limits number of object keys returned
|
|
# * 'prefix'<~String> - limits object keys to those beginning with its value.
|
|
# * 'version-id-marker'<~String> - limits object versions to only those that
|
|
# appear lexicographically after its value
|
|
#
|
|
# ==== Returns
|
|
# * response<~Excon::Response>:
|
|
# * body<~Hash>:
|
|
# * 'Delimeter'<~String> - Delimiter specified for query
|
|
# * 'KeyMarker'<~String> - Key marker specified for query
|
|
# * 'MaxKeys'<~Integer> - Maximum number of keys specified for query
|
|
# * 'Name'<~String> - Name of the bucket
|
|
# * 'Prefix'<~String> - Prefix specified for query
|
|
# * 'VersionIdMarker'<~String> - Version id marker specified for query
|
|
# * 'IsTruncated'<~Boolean> - Whether or not this is the totality of the bucket
|
|
# * 'Versions'<~Array>:
|
|
# * 'DeleteMarker'<~Hash>:
|
|
# * 'IsLatest'<~Boolean> - Whether or not this is the latest version
|
|
# * 'Key'<~String> - Name of object
|
|
# * 'LastModified'<~String>: Timestamp of last modification of object
|
|
# * 'Owner'<~Hash>:
|
|
# * 'DisplayName'<~String> - Display name of object owner
|
|
# * 'ID'<~String> - Id of object owner
|
|
# * 'VersionId'<~String> - The id of this version
|
|
# or
|
|
# * 'Version'<~Hash>:
|
|
# * 'ETag'<~String>: Etag of object
|
|
# * 'IsLatest'<~Boolean> - Whether or not this is the latest version
|
|
# * 'Key'<~String> - Name of object
|
|
# * 'LastModified'<~String>: Timestamp of last modification of object
|
|
# * 'Owner'<~Hash>:
|
|
# * 'DisplayName'<~String> - Display name of object owner
|
|
# * 'ID'<~String> - Id of object owner
|
|
# * 'Size'<~Integer> - Size of object
|
|
# * 'StorageClass'<~String> - Storage class of object
|
|
# * 'VersionId'<~String> - The id of this version
|
|
#
|
|
def get_bucket_object_versions(bucket_name, options = {})
|
|
unless bucket_name
|
|
raise ArgumentError.new('bucket_name is required')
|
|
end
|
|
query = ''
|
|
for key, value in options
|
|
query << "#{key}=#{CGI.escape(value.to_s).gsub(/\+/, '%20')}&"
|
|
end
|
|
query.chop!
|
|
request({
|
|
:expects => 200,
|
|
:headers => {},
|
|
:host => "#{bucket_name}.#{@host}",
|
|
:idempotent => true,
|
|
:method => 'GET',
|
|
:parser => Fog::Parsers::AWS::S3::GetBucketObjectVersions.new,
|
|
:query => query
|
|
})
|
|
end
|
|
|
|
end
|
|
|
|
class Mock
|
|
|
|
def get_bucket_object_versions(bucket_name, options = {})
|
|
raise MockNotImplemented.new("Contributions welcome!")
|
|
end
|
|
|
|
end
|
|
end
|
|
end
|
|
end
|