45 lines
2.3 KiB
XML
45 lines
2.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE section [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
<!-- Useful for describing APIs -->
|
|
<!ENTITY COPY '<command xmlns="http://docbook.org/ns/docbook">COPY</command>'>
|
|
<!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'>
|
|
<!ENTITY HEAD '<command xmlns="http://docbook.org/ns/docbook">HEAD</command>'>
|
|
<!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'>
|
|
<!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'>
|
|
<!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'>
|
|
]>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="storage-object-services">
|
|
<title>Storage object services</title>
|
|
<para>Creates, updates, gets details for, and deletes objects.
|
|
Gets and updates object metadata.</para>
|
|
<para>An object represents the data and metadata for the files
|
|
stored in the system. Through the REST interface, you can
|
|
include metadata for an object by adding custom HTTP headers
|
|
to the request and the data payload as the request
|
|
body.</para>
|
|
<para>Objects cannot exceed 5 GB and must have names that do not
|
|
exceed 1024 bytes after URL encoding. However, you can segment
|
|
a large object into 5 GB segments and upload the segments.
|
|
Then, you can download the segments as a single concatenated
|
|
object. You can use HTTP requests to work with the segments
|
|
and manifests directly.</para>
|
|
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
|
|
<wadl:resource
|
|
href="http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/object-api/src/os-object-api-1.0.wadl#object">
|
|
<wadl:method href="#listObjects"/>
|
|
<wadl:method href="#retrieveobject"/>
|
|
<wadl:method href="#createobject"/>
|
|
<wadl:method href="#deleteobject"/>
|
|
<wadl:method href="#copyobject"/>
|
|
<wadl:method href="#retrieveobjectmeta"/>
|
|
<wadl:method href="#updateaobjmeta"/>
|
|
</wadl:resource>
|
|
</wadl:resources>
|
|
</section>
|