a0431b8570
backport: havana Change-Id: Ic9a831568002b6ab02d7506693c0ff36852795f6 author: diane fleming
83 lines
3.2 KiB
XML
83 lines
3.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
<!DOCTYPE chapter [
|
|
<!-- 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>'>
|
|
|
|
<!ENTITY CHECK '<inlinemediaobject xmlns="http://docbook.org/ns/docbook">
|
|
<imageobject>
|
|
<imagedata fileref="img/Check_mark_23x20_02.svg"
|
|
format="SVG" scale="60"/>
|
|
</imageobject>
|
|
</inlinemediaobject>'>
|
|
|
|
<!ENTITY ARROW '<inlinemediaobject xmlns="http://docbook.org/ns/docbook">
|
|
<imageobject>
|
|
<imagedata fileref="img/Arrow_east.svg"
|
|
format="SVG" scale="60"/>
|
|
</imageobject>
|
|
</inlinemediaobject>'>
|
|
]>
|
|
<chapter 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="ch_object-storage-dev-api-storage">
|
|
<title>API Operations for Storage Services</title>
|
|
<para>Use the ReST API to interact with the storage component of
|
|
OpenStack Object Storage. All requests are directed to the host
|
|
and URL described in the <code>X-Storage-Url</code> HTTP header
|
|
obtained during successful authentication.</para>
|
|
<para>Review the following requirements for using storage
|
|
services:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Container names cannot exceed 256 bytes and cannot contain
|
|
the <literal>/</literal> character.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Object names cannot exceed 1024 bytes, and have no
|
|
character restrictions.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Object and container names must be UTF-8 encoded and then
|
|
URL-encoded to interact with the ReST API.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para><!--<info>Added paragraph to forecast info structure -\- dsh -2012-03-09 </info>-->The
|
|
following sections describe the actions that you can perform in
|
|
the storage system.</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><xref linkend="storage-account-services"/>. Actions that
|
|
you can perform at the account level of the storage system.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><xref linkend="storage-container-services"/>. Actions that
|
|
you can perform on containers.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><xref linkend="Create_Static_Website-dle4000"/>. How to
|
|
use your swift account to create a static website.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><xref linkend="storage-object-services"/>. Actions that
|
|
you can perform on objects.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<xi:include href="section_object-api-storage_account_svc.xml"/>
|
|
<xi:include href="section_object-api-storage-container-svc.xml"/>
|
|
<xi:include href="section_object-api-create-website.xml"/>
|
|
<xi:include href="section_object-api-storage-object-svc.xml"/>
|
|
</chapter>
|