1
0
Fork 0
mirror of https://github.com/fog/fog.git synced 2022-11-09 13:51:43 -05:00
fog--fog/lib/fog/openstack/requests/storage/put_object_manifest.rb
Brian D. Burns eca5a275df [openstack|storage] allow headers to be specified for object manifest
Allows additional headers to be set, as well as overriding the default
X-Object-Manifest header.
2013-06-02 21:09:59 -04:00

38 lines
1.9 KiB
Ruby

module Fog
module Storage
class OpenStack
class Real
# Create a new manifest object
#
# Creates an object with a +X-Object-Manifest+ header that specifies the common prefix ("<container>/<prefix>")
# for all uploaded segments. Retrieving the manifest object streams all segments matching this prefix.
# Segments must sort in the order they should be concatenated. Note that any future objects stored in the container
# along with the segments that match the prefix will be included when retrieving the manifest object.
#
# All segments must be stored in the same container, but may be in a different container than the manifest object.
# The default +X-Object-Manifest+ header is set to "+container+/+object+", but may be overridden in +options+
# to specify the prefix and/or the container where segments were stored.
# If overridden, names should be CGI escaped (excluding spaces) if needed (see {Fog::Rackspace.escape}).
#
# @param container [String] Name for container where +object+ will be stored. Should be < 256 bytes and must not contain '/'
# @param object [String] Name for manifest object.
# @param options [Hash] Config headers for +object+.
# @option options [String] 'X-Object-Manifest' ("container/object") "<container>/<prefix>" for segment objects.
#
# @see http://docs.openstack.org/api/openstack-object-storage/1.0/content/large-object-creation.html
def put_object_manifest(container, object, options = {})
path = "#{Fog::OpenStack.escape(container)}/#{Fog::OpenStack.escape(object)}"
headers = {'X-Object-Manifest' => path}.merge(options)
request(
:expects => 201,
:headers => headers,
:method => 'PUT',
:path => path
)
end
end
end
end
end