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
52 lines
2.6 KiB
XML
52 lines
2.6 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE section [
|
|
<!-- Useful for describing APIs -->
|
|
<!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:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:svg="http://www.w3.org/2000/svg"
|
|
xmlns:m="http://www.w3.org/1998/Math/MathML"
|
|
xmlns:html="http://www.w3.org/1999/xhtml"
|
|
xmlns:db="http://docbook.org/ns/docbook" version="5.0"
|
|
xml:id="container-quotas">
|
|
<title>Container quotas</title>
|
|
<para>You can set quotas on the size and number of objects stored
|
|
in a container by setting the following metadata:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><literal>X-Container-Meta-Quota-Bytes</literal>. The
|
|
size, in bytes, of objects that can be stored in a
|
|
container.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><literal>X-Container-Meta-Quota-Count</literal>. The
|
|
number of objects that can be stored in a container.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>When you exceed a container quota, subsequent requests to
|
|
create objects fail with a <errorcode>413</errorcode>
|
|
<errortext>Request Entity Too Large</errortext> error.</para>
|
|
<para>The Object Storage system uses an <emphasis role="italic"
|
|
>eventual consistency</emphasis> model. When you create a
|
|
new object, the container size and object count might not be
|
|
immediately updated. Consequently, you might be allowed to
|
|
create objects even though you have actually exceeded the
|
|
quota.</para>
|
|
<para>At some later time, the system updates the container size
|
|
and object count to the actual values. At this time,
|
|
subsequent requests fails. In addition, if you are currently
|
|
under the <literal>X-Container-Meta-Quota-Bytes</literal>
|
|
limit and a request uses chunked transfer encoding, the system
|
|
cannot know if the request will exceed the quota so the system
|
|
allows the request. However, once the quota is exceeded, any
|
|
subsequent uploads that use chunked transfer encoding
|
|
fail.</para>
|
|
</section>
|