ed4f3c4db9
Point to WADL files that generate the API Reference
page so that the method descriptions and request
and response parameters are consistent between
these two docs:
http://api.openstack.org/api-ref-objectstorage.html
(API Reference page for Object Storage)
http://docs.openstack.org/api/openstack-object-storage/1.0/
(API Reference (or spec) for Object Storage)
Add descriptions of ACLs, FormPOST, TempURLs,
StaticWeb, Bulk Upload, Bulk Delete, the OPTIONS operation
(though this is implicit in CORS support)
Validate all code examples
Remove duplication.
Co-Author: Donagh McCabe
Closes-Bug: #1187119
Closes-Bug: #1214139
Closes-Bug: #1074198
Partial-Bug: #1255770
Change-Id: I94054b046a94260ba8825bdb42439adfcaf9fdce
author: diane fleming
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>
|