€cdocutils.nodes
document
q)q}q(U	nametypesq}q(X   get object metadataqNX   note on object propertiesqNX   extract archiveqNX   conditional requestsq	NX   to upload large filesq
NX   to upload a single/basic file:qNX   setupqNX
   get objectqNX,   to upload multiple small-to-mid sized files:qNX   copy objectqNX   update an existing objectqNX   delete objectqNX   update object metadataqNX   create an objectqNX   bulk deleteqNX   list objects in a containerqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU
decorationqNUautofootnote_startqKUnameidsq}q(hUget-object-metadataqhUnote-on-object-propertiesq hUextract-archiveq!h	Uconditional-requestsq"h
Uto-upload-large-filesq#hUto-upload-a-single-basic-fileq$hUsetupq%hU
get-objectq&hU+to-upload-multiple-small-to-mid-sized-filesq'hUcopy-objectq(hUupdate-an-existing-objectq)hUdelete-objectq*hUupdate-object-metadataq+hUcreate-an-objectq,hUbulk-deleteq-hUlist-objects-in-a-containerq.uUchildrenq/]q0(cdocutils.nodes
section
q1)q2}q3(U	rawsourceq4U Uparentq5hUsourceq6XW   /Users/jamie/projects/php/php-opencloud/doc/services/object-store/Object.md.storage.rstq7Utagnameq8Usectionq9U
attributesq:}q;(Udupnamesq<]Uclassesq=]Ubackrefsq>]Uidsq?]q@h%aUnamesqA]qBhauUlineqCKUdocumentqDhh/]qE(cdocutils.nodes
title
qF)qG}qH(h4X   SetupqIh5h2h6h7h8UtitleqJh:}qK(h<]h=]h>]h?]hA]uhCKhDhh/]qLcdocutils.nodes
Text
qMX   SetupqN…qO}qP(h4hIh5hGubaubcdocutils.nodes
paragraph
qQ)qR}qS(h4X  Conceptually, a container contains objects (also known as files). In
order to work with objects, you will need to instantiate a container
object first as `documented
here <https://github.com/rackspace/php-opencloud/blob/master/docs/userguide/ObjectStore/Storage/Container.md>`__.h5h2h6h7h8U	paragraphqTh:}qU(h<]h=]h>]h?]hA]uhCKhDhh/]qV(hMXš   Conceptually, a container contains objects (also known as files). In
order to work with objects, you will need to instantiate a container
object first as qW…qX}qY(h4Xš   Conceptually, a container contains objects (also known as files). In
order to work with objects, you will need to instantiate a container
object first as h5hRubcdocutils.nodes
reference
qZ)q[}q\(h4X|   `documented
here <https://github.com/rackspace/php-opencloud/blob/master/docs/userguide/ObjectStore/Storage/Container.md>`__h:}q](UnameX   documented hereUrefuriq^Xf   https://github.com/rackspace/php-opencloud/blob/master/docs/userguide/ObjectStore/Storage/Container.mdh?]h>]h<]h=]hA]uh5hRh/]q_hMX   documented
hereq`…qa}qb(h4U h5h[ubah8U	referenceqcubhMX   .…qd}qe(h4X   .h5hRubeubeubh1)qf}qg(h4U h5hh6h7h8h9h:}qh(h<]h=]h>]h?]qih ahA]qjhauhCK
hDhh/]qk(hF)ql}qm(h4X   Note on object propertiesqnh5hfh6h7h8hJh:}qo(h<]h=]h>]h?]hA]uhCK
hDhh/]qphMX   Note on object propertiesqq…qr}qs(h4hnh5hlubaubhQ)qt}qu(h4XŠ   Please be aware that you cannot directly access the properties of
DataObject anymore, you **must** use appropriate getter/ setter methods:h5hfh6h7h8hTh:}qv(h<]h=]h>]h?]hA]uhCKhDhh/]qw(hMXZ   Please be aware that you cannot directly access the properties of
DataObject anymore, you qx…qy}qz(h4XZ   Please be aware that you cannot directly access the properties of
DataObject anymore, you h5htubcdocutils.nodes
strong
q{)q|}q}(h4X   **must**h:}q~(h<]h=]h>]h?]hA]uh5hth/]qhMX   mustq€…q}q‚(h4U h5h|ubah8UstrongqƒubhMX(    use appropriate getter/ setter methods:q„…q…}q†(h4X(    use appropriate getter/ setter methods:h5htubeubcdocutils.nodes
table
q‡)qˆ}q‰(h4U h5hfh6h7h8UtableqŠh:}q‹(h<]h=]h>]h?]hA]uhCNhDhh/]qŒcdocutils.nodes
tgroup
q)qŽ}q(h4U h:}q(h?]h>]h<]h=]hA]UcolsKuh5hˆh/]q‘(cdocutils.nodes
colspec
q’)q“}q”(h4U h:}q•(h?]h>]h<]h=]hA]UcolwidthKuh5hŽh/]h8Ucolspecq–ubh’)q—}q˜(h4U h:}q™(h?]h>]h<]h=]hA]UcolwidthKuh5hŽh/]h8h–ubcdocutils.nodes
thead
qš)q›}qœ(h4U h:}q(h<]h=]h>]h?]hA]uh5hŽh/]qžcdocutils.nodes
row
qŸ)q }q¡(h4U h:}q¢(h<]h=]h>]h?]hA]uh5h›h/]q£(cdocutils.nodes
entry
q¤)q¥}q¦(h4U h:}q§(h<]h=]h>]h?]hA]uh5h h/]q¨hQ)q©}qª(h4X   Propertyq«h5h¥h6h7h8hTh:}q¬(h<]h=]h>]h?]hA]uhCKh/]q­hMX   Propertyq®…q¯}q°(h4h«h5h©ubaubah8Uentryq±ubh¤)q²}q³(h4U h:}q´(h<]h=]h>]h?]hA]uh5h h/]qµhQ)q¶}q·(h4X   Methodq¸h5h²h6h7h8hTh:}q¹(h<]h=]h>]h?]hA]uhCKh/]qºhMX   Methodq»…q¼}q½(h4h¸h5h¶ubaubah8h±ubeh8Urowq¾ubah8Utheadq¿ubcdocutils.nodes
tbody
qÀ)qÁ}qÂ(h4U h:}qÃ(h<]h=]h>]h?]hA]uh5hŽh/]qÄ(hŸ)qÅ}qÆ(h4U h:}qÇ(h<]h=]h>]h?]hA]uh5hÁh/]qÈ(h¤)qÉ}qÊ(h4U h:}qË(h<]h=]h>]h?]hA]uh5hÅh/]qÌhQ)qÍ}qÎ(h4X   Parent containerqÏh5hÉh6h7h8hTh:}qÐ(h<]h=]h>]h?]hA]uhCKh/]qÑhMX   Parent containerqÒ…qÓ}qÔ(h4hÏh5hÍubaubah8h±ubh¤)qÕ}qÖ(h4U h:}q×(h<]h=]h>]h?]hA]uh5hÅh/]qØhQ)qÙ}qÚ(h4X   ``getContainer``qÛh5hÕh6h7h8hTh:}qÜ(h<]h=]h>]h?]hA]uhCKh/]qÝcdocutils.nodes
literal
qÞ)qß}qà(h4hÛh:}qá(h<]h=]h>]h?]hA]uh5hÙh/]qâhMX   getContainerqã…qä}qå(h4U h5hßubah8Uliteralqæubaubah8h±ubeh8h¾ubhŸ)qç}qè(h4U h:}qé(h<]h=]h>]h?]hA]uh5hÁh/]qê(h¤)që}qì(h4U h:}qí(h<]h=]h>]h?]hA]uh5hçh/]qîhQ)qï}qð(h4X   Nameqñh5hëh6h7h8hTh:}qò(h<]h=]h>]h?]hA]uhCKh/]qóhMX   Nameqô…qõ}qö(h4hñh5hïubaubah8h±ubh¤)q÷}qø(h4U h:}qù(h<]h=]h>]h?]hA]uh5hçh/]qúhQ)qû}qü(h4X   ``getName``qýh5h÷h6h7h8hTh:}qþ(h<]h=]h>]h?]hA]uhCKh/]qÿhÞ)r   }r  (h4hýh:}r  (h<]h=]h>]h?]hA]uh5hûh/]r  hMX   getNamer  …r  }r  (h4U h5j   ubah8hæubaubah8h±ubeh8h¾ubhŸ)r  }r  (h4U h:}r	  (h<]h=]h>]h?]hA]uh5hÁh/]r
  (h¤)r  }r  (h4U h:}r  (h<]h=]h>]h?]hA]uh5j  h/]r  hQ)r  }r  (h4X   Body of filer  h5j  h6h7h8hTh:}r  (h<]h=]h>]h?]hA]uhCKh/]r  hMX   Body of filer  …r  }r  (h4j  h5j  ubaubah8h±ubh¤)r  }r  (h4U h:}r  (h<]h=]h>]h?]hA]uh5j  h/]r  hQ)r  }r  (h4X   ``getContent``r  h5j  h6h7h8hTh:}r  (h<]h=]h>]h?]hA]uhCKh/]r  hÞ)r   }r!  (h4j  h:}r"  (h<]h=]h>]h?]hA]uh5j  h/]r#  hMX
   getContentr$  …r%  }r&  (h4U h5j   ubah8hæubaubah8h±ubeh8h¾ubhŸ)r'  }r(  (h4U h:}r)  (h<]h=]h>]h?]hA]uh5hÁh/]r*  (h¤)r+  }r,  (h4U h:}r-  (h<]h=]h>]h?]hA]uh5j'  h/]r.  hQ)r/  }r0  (h4X   Size of filer1  h5j+  h6h7h8hTh:}r2  (h<]h=]h>]h?]hA]uhCKh/]r3  hMX   Size of filer4  …r5  }r6  (h4j1  h5j/  ubaubah8h±ubh¤)r7  }r8  (h4U h:}r9  (h<]h=]h>]h?]hA]uh5j'  h/]r:  hQ)r;  }r<  (h4X   ``getContentLength``r=  h5j7  h6h7h8hTh:}r>  (h<]h=]h>]h?]hA]uhCKh/]r?  hÞ)r@  }rA  (h4j=  h:}rB  (h<]h=]h>]h?]hA]uh5j;  h/]rC  hMX   getContentLengthrD  …rE  }rF  (h4U h5j@  ubah8hæubaubah8h±ubeh8h¾ubhŸ)rG  }rH  (h4U h:}rI  (h<]h=]h>]h?]hA]uh5hÁh/]rJ  (h¤)rK  }rL  (h4U h:}rM  (h<]h=]h>]h?]hA]uh5jG  h/]rN  hQ)rO  }rP  (h4X   Type of filerQ  h5jK  h6h7h8hTh:}rR  (h<]h=]h>]h?]hA]uhCKh/]rS  hMX   Type of filerT  …rU  }rV  (h4jQ  h5jO  ubaubah8h±ubh¤)rW  }rX  (h4U h:}rY  (h<]h=]h>]h?]hA]uh5jG  h/]rZ  hQ)r[  }r\  (h4X   ``getContentType``r]  h5jW  h6h7h8hTh:}r^  (h<]h=]h>]h?]hA]uhCKh/]r_  hÞ)r`  }ra  (h4j]  h:}rb  (h<]h=]h>]h?]hA]uh5j[  h/]rc  hMX   getContentTyperd  …re  }rf  (h4U h5j`  ubah8hæubaubah8h±ubeh8h¾ubhŸ)rg  }rh  (h4U h:}ri  (h<]h=]h>]h?]hA]uh5hÁh/]rj  (h¤)rk  }rl  (h4U h:}rm  (h<]h=]h>]h?]hA]uh5jg  h/]rn  hQ)ro  }rp  (h4X   ETag checksumrq  h5jk  h6h7h8hTh:}rr  (h<]h=]h>]h?]hA]uhCKh/]rs  hMX   ETag checksumrt  …ru  }rv  (h4jq  h5jo  ubaubah8h±ubh¤)rw  }rx  (h4U h:}ry  (h<]h=]h>]h?]hA]uh5jg  h/]rz  hQ)r{  }r|  (h4X   ``getEtag``r}  h5jw  h6h7h8hTh:}r~  (h<]h=]h>]h?]hA]uhCKh/]r  hÞ)r€  }r  (h4j}  h:}r‚  (h<]h=]h>]h?]hA]uh5j{  h/]rƒ  hMX   getEtagr„  …r…  }r†  (h4U h5j€  ubah8hæubaubah8h±ubeh8h¾ubhŸ)r‡  }rˆ  (h4U h:}r‰  (h<]h=]h>]h?]hA]uh5hÁh/]rŠ  (h¤)r‹  }rŒ  (h4U h:}r  (h<]h=]h>]h?]hA]uh5j‡  h/]rŽ  hQ)r  }r  (h4X   Last modified dater‘  h5j‹  h6h7h8hTh:}r’  (h<]h=]h>]h?]hA]uhCKh/]r“  hMX   Last modified dater”  …r•  }r–  (h4j‘  h5j  ubaubah8h±ubh¤)r—  }r˜  (h4U h:}r™  (h<]h=]h>]h?]hA]uh5j‡  h/]rš  hQ)r›  }rœ  (h4X   ``getLastModified``r  h5j—  h6h7h8hTh:}rž  (h<]h=]h>]h?]hA]uhCKh/]rŸ  hÞ)r   }r¡  (h4j  h:}r¢  (h<]h=]h>]h?]hA]uh5j›  h/]r£  hMX   getLastModifiedr¤  …r¥  }r¦  (h4U h5j   ubah8hæubaubah8h±ubeh8h¾ubeh8Utbodyr§  ubeh8Utgroupr¨  ubaubeubh1)r©  }rª  (h4U h5hh6h7h8h9h:}r«  (h<]h=]h>]h?]r¬  h,ahA]r­  hauhCK"hDhh/]r®  (hF)r¯  }r°  (h4X   Create an objectr±  h5j©  h6h7h8hJh:}r²  (h<]h=]h>]h?]hA]uhCK"hDhh/]r³  hMX   Create an objectr´  …rµ  }r¶  (h4j±  h5j¯  ubaubhQ)r·  }r¸  (h4XV   There are three ways to upload a new file, each of which has different
business needs.r¹  h5j©  h6h7h8hTh:}rº  (h<]h=]h>]h?]hA]uhCK$hDhh/]r»  hMXV   There are three ways to upload a new file, each of which has different
business needs.r¼  …r½  }r¾  (h4j¹  h5j·  ubaubcdocutils.nodes
block_quote
r¿  )rÀ  }rÁ  (h4U h5j©  h6h7h8Ublock_quoterÂ  h:}rÃ  (h<]h=]h>]h?]hA]uhCNhDhh/]rÄ  (hQ)rÅ  }rÆ  (h4X   **Note:** Unlike previous versions, you do not need to manually
specify your object's content type. The API will do this for you.h5jÀ  h6h7h8hTh:}rÇ  (h<]h=]h>]h?]hA]uhCK'h/]rÈ  (h{)rÉ  }rÊ  (h4X	   **Note:**h:}rË  (h<]h=]h>]h?]hA]uh5jÅ  h/]rÌ  hMX   Note:rÍ  …rÎ  }rÏ  (h4U h5jÉ  ubah8hƒubhMXx    Unlike previous versions, you do not need to manually
specify your object's content type. The API will do this for you.rÐ  …rÑ  }rÒ  (h4Xx    Unlike previous versions, you do not need to manually
specify your object's content type. The API will do this for you.h5jÅ  ubeubhQ)rÓ  }rÔ  (h4Xë   **Note:** when working with names that contain non-standard
alphanumerical characters (such as spaces or non-English
characters), you must ensure they are encoded with
```urlencode`` <http://php.net/urlencode>`__ before passing them inh5jÀ  h6h7h8hTh:}rÕ  (h<]h=]h>]h?]hA]uhCK*h/]rÖ  (h{)r×  }rØ  (h4X	   **Note:**h:}rÙ  (h<]h=]h>]h?]hA]uh5jÓ  h/]rÚ  hMX   Note:rÛ  …rÜ  }rÝ  (h4U h5j×  ubah8hƒubhMXŸ    when working with names that contain non-standard
alphanumerical characters (such as spaces or non-English
characters), you must ensure they are encoded with
rÞ  …rß  }rà  (h4XŸ    when working with names that contain non-standard
alphanumerical characters (such as spaces or non-English
characters), you must ensure they are encoded with
h5jÓ  ubhÞ)rá  }râ  (h4X   ```urlencode``h:}rã  (h<]h=]h>]h?]hA]uh5jÓ  h/]rä  hMX
   `urlencoderå  …ræ  }rç  (h4U h5já  ubah8hæubhMX    <rè  …ré  }rê  (h4X    <h5jÓ  ubhZ)rë  }rì  (h4X   http://php.net/urlencoderí  h:}rî  (Urefurijí  h?]h>]h<]h=]hA]uh5jÓ  h/]rï  hMX   http://php.net/urlencoderð  …rñ  }rò  (h4U h5jë  ubah8hcubhMX   >`__ before passing them inró  …rô  }rõ  (h4X   >`__ before passing them inh5jÓ  ubeubeubh1)rö  }r÷  (h4U h5j©  h6h7h8h9h:}rø  (h<]h=]h>]h?]rù  h$ahA]rú  hauhCK0hDhh/]rû  (hF)rü  }rý  (h4X   To upload a single/basic file:rþ  h5jö  h6h7h8hJh:}rÿ  (h<]h=]h>]h?]hA]uhCK0hDhh/]r   hMX   To upload a single/basic file:r  …r  }r  (h4jþ  h5jü  ubaubcdocutils.nodes
literal_block
r  )r  }r  (h4XÉ  use OpenCloud\ObjectStore\Resource\DataObject;

$data = fopen('/path/to/sample.mp3', 'r+');

// alternatively, you can pass in a string as the file contents `$data` argument (instead of a resource)

$meta = array(
    'Author' => 'Camera Obscura',
    'Origin' => 'Glasgow'
);

$metaHeaders = DataObject::stockHeaders($meta);
$customHeaders = array();
$allHeaders = $metaHeaders + $customHeaders;

$container->uploadObject('sample.mp3', $data, $allHeaders);h5jö  h6h7h8Uliteral_blockr  h:}r  (U	xml:spacer	  Upreserver
  h?]h>]h<]h=]r  (Ucoder  X   phpr  ehA]uhCKDhDhh/]r  cdocutils.nodes
inline
r  )r  }r  (h4XÉ  use OpenCloud\ObjectStore\Resource\DataObject;

$data = fopen('/path/to/sample.mp3', 'r+');

// alternatively, you can pass in a string as the file contents `$data` argument (instead of a resource)

$meta = array(
    'Author' => 'Camera Obscura',
    'Origin' => 'Glasgow'
);

$metaHeaders = DataObject::stockHeaders($meta);
$customHeaders = array();
$allHeaders = $metaHeaders + $customHeaders;

$container->uploadObject('sample.mp3', $data, $allHeaders);h:}r  (h<]h=]r  Uotherr  ah>]h?]hA]uh5j  h/]r  hMXÉ  use OpenCloud\ObjectStore\Resource\DataObject;

$data = fopen('/path/to/sample.mp3', 'r+');

// alternatively, you can pass in a string as the file contents `$data` argument (instead of a resource)

$meta = array(
    'Author' => 'Camera Obscura',
    'Origin' => 'Glasgow'
);

$metaHeaders = DataObject::stockHeaders($meta);
$customHeaders = array();
$allHeaders = $metaHeaders + $customHeaders;

$container->uploadObject('sample.mp3', $data, $allHeaders);r  …r  }r  (h4U h5j  ubah8Uinliner  ubaubeubh1)r  }r  (h4U h5j©  h6h7h8h9h:}r  (h<]h=]h>]h?]r  h'ahA]r  hauhCKFhDhh/]r  (hF)r   }r!  (h4X,   To upload multiple small-to-mid sized files:r"  h5j  h6h7h8hJh:}r#  (h<]h=]h>]h?]hA]uhCKFhDhh/]r$  hMX,   To upload multiple small-to-mid sized files:r%  …r&  }r'  (h4j"  h5j   ubaubj  )r(  }r)  (h4XK  $files = array(
    array(
        'name' => 'apache.log',
        'path' => '/etc/httpd/logs/error_log'
    ),
    array(
        'name' => 'mysql.log',
        'body' => fopen('/tmp/mysql.log', 'r+')
    ),
    array(
        'name' => 'to_do_list.txt',
        'body' => 'PHONE HOME'
    )
);

$container->uploadObjects($files);h5j  h6h7h8j  h:}r*  (j	  j
  h?]h>]h<]h=]r+  (j  X   phpr,  ehA]uhCKZhDhh/]r-  j  )r.  }r/  (h4XK  $files = array(
    array(
        'name' => 'apache.log',
        'path' => '/etc/httpd/logs/error_log'
    ),
    array(
        'name' => 'mysql.log',
        'body' => fopen('/tmp/mysql.log', 'r+')
    ),
    array(
        'name' => 'to_do_list.txt',
        'body' => 'PHONE HOME'
    )
);

$container->uploadObjects($files);h:}r0  (h<]h=]r1  Uotherr2  ah>]h?]hA]uh5j(  h/]r3  hMXK  $files = array(
    array(
        'name' => 'apache.log',
        'path' => '/etc/httpd/logs/error_log'
    ),
    array(
        'name' => 'mysql.log',
        'body' => fopen('/tmp/mysql.log', 'r+')
    ),
    array(
        'name' => 'to_do_list.txt',
        'body' => 'PHONE HOME'
    )
);

$container->uploadObjects($files);r4  …r5  }r6  (h4U h5j.  ubah8j  ubaubhQ)r7  }r8  (h4Xô   As you can see, the ``name`` key is required for every file. You must
also specify *either* a path key (to an existing file), or a ``body``.
The ``body`` can either be a PHP resource or a string representation of
the content you want to upload.h5j  h6h7h8hTh:}r9  (h<]h=]h>]h?]hA]uhCK[hDhh/]r:  (hMX   As you can see, the r;  …r<  }r=  (h4X   As you can see, the h5j7  ubhÞ)r>  }r?  (h4X   ``name``h:}r@  (h<]h=]h>]h?]hA]uh5j7  h/]rA  hMX   namerB  …rC  }rD  (h4U h5j>  ubah8hæubhMX7    key is required for every file. You must
also specify rE  …rF  }rG  (h4X7    key is required for every file. You must
also specify h5j7  ubcdocutils.nodes
emphasis
rH  )rI  }rJ  (h4X   *either*h:}rK  (h<]h=]h>]h?]hA]uh5j7  h/]rL  hMX   eitherrM  …rN  }rO  (h4U h5jI  ubah8UemphasisrP  ubhMX(    a path key (to an existing file), or a rQ  …rR  }rS  (h4X(    a path key (to an existing file), or a h5j7  ubhÞ)rT  }rU  (h4X   ``body``h:}rV  (h<]h=]h>]h?]hA]uh5j7  h/]rW  hMX   bodyrX  …rY  }rZ  (h4U h5jT  ubah8hæubhMX   .
The r[  …r\  }r]  (h4X   .
The h5j7  ubhÞ)r^  }r_  (h4X   ``body``h:}r`  (h<]h=]h>]h?]hA]uh5j7  h/]ra  hMX   bodyrb  …rc  }rd  (h4U h5j^  ubah8hæubhMX[    can either be a PHP resource or a string representation of
the content you want to upload.re  …rf  }rg  (h4X[    can either be a PHP resource or a string representation of
the content you want to upload.h5j7  ubeubeubh1)rh  }ri  (h4U h5j©  h6h7h8h9h:}rj  (h<]h=]h>]h?]rk  h#ahA]rl  h
auhCKahDhh/]rm  (hF)rn  }ro  (h4X   To upload large filesrp  h5jh  h6h7h8hJh:}rq  (h<]h=]h>]h?]hA]uhCKahDhh/]rr  hMX   To upload large filesrs  …rt  }ru  (h4jp  h5jn  ubaubhQ)rv  }rw  (h4X"  For files over 5GB, you will need to use the
``OpenCloud\ObjectStore\Upload\TransferBuilder`` factory to build your
transfer, upon which you can execute your upload functionality. For your
convenience, the Container resource object contains a simple method to
do this heavy lifting for you:h5jh  h6h7h8hTh:}rx  (h<]h=]h>]h?]hA]uhCKchDhh/]ry  (hMX-   For files over 5GB, you will need to use the
rz  …r{  }r|  (h4X-   For files over 5GB, you will need to use the
h5jv  ubhÞ)r}  }r~  (h4X0   ``OpenCloud\ObjectStore\Upload\TransferBuilder``h:}r  (h<]h=]h>]h?]hA]uh5jv  h/]r€  hMX,   OpenCloud\ObjectStore\Upload\TransferBuilderr  …r‚  }rƒ  (h4U h5j}  ubah8hæubhMXÅ    factory to build your
transfer, upon which you can execute your upload functionality. For your
convenience, the Container resource object contains a simple method to
do this heavy lifting for you:r„  …r…  }r†  (h4XÅ    factory to build your
transfer, upon which you can execute your upload functionality. For your
convenience, the Container resource object contains a simple method to
do this heavy lifting for you:h5jv  ubeubj  )r‡  }rˆ  (h4X  $transfer = $container->setupObjectTransfer(array(
    'name' => 'video.mov',
    'path' => '/home/jamie/video.mov',
    'metadata' => array(
        'Author' => 'Jamie'
    ),
    'concurrency' => 4,
    'partSize'    => 1.5 * Size::GB
));

$transfer->upload();h5jh  h6h7h8j  h:}r‰  (j	  j
  h?]h>]h<]h=]rŠ  (j  X   phpr‹  ehA]uhCKvhDhh/]rŒ  j  )r  }rŽ  (h4X  $transfer = $container->setupObjectTransfer(array(
    'name' => 'video.mov',
    'path' => '/home/jamie/video.mov',
    'metadata' => array(
        'Author' => 'Jamie'
    ),
    'concurrency' => 4,
    'partSize'    => 1.5 * Size::GB
));

$transfer->upload();h:}r  (h<]h=]r  Uotherr‘  ah>]h?]hA]uh5j‡  h/]r’  hMX  $transfer = $container->setupObjectTransfer(array(
    'name' => 'video.mov',
    'path' => '/home/jamie/video.mov',
    'metadata' => array(
        'Author' => 'Jamie'
    ),
    'concurrency' => 4,
    'partSize'    => 1.5 * Size::GB
));

$transfer->upload();r“  …r”  }r•  (h4U h5j  ubah8j  ubaubhQ)r–  }r—  (h4Xå  You can specify how many concurrent cURL connections are used to upload
parts of your file. The file is fragmented into chunks, each of which is
uploaded individually as a separate file (the filename of each part will
indicate that it's a segment rather than the full file). After all parts
are uploaded, a manifest is uploaded. When the end-user accesses the 5GB
by its true filename, it actually references the manifest file which
concatenates each segment into a streaming download.r˜  h5jh  h6h7h8hTh:}r™  (h<]h=]h>]h?]hA]uhCKwhDhh/]rš  hMXå  You can specify how many concurrent cURL connections are used to upload
parts of your file. The file is fragmented into chunks, each of which is
uploaded individually as a separate file (the filename of each part will
indicate that it's a segment rather than the full file). After all parts
are uploaded, a manifest is uploaded. When the end-user accesses the 5GB
by its true filename, it actually references the manifest file which
concatenates each segment into a streaming download.r›  …rœ  }r  (h4j˜  h5j–  ubaubeubeubh1)rž  }rŸ  (h4U h5hh6h7h8h9h:}r   (h<]h=]h>]h?]r¡  h.ahA]r¢  hauhCK€hDhh/]r£  (hF)r¤  }r¥  (h4X   List objects in a containerr¦  h5jž  h6h7h8hJh:}r§  (h<]h=]h>]h?]hA]uhCK€hDhh/]r¨  hMX   List objects in a containerr©  …rª  }r«  (h4j¦  h5j¤  ubaubhQ)r¬  }r­  (h4X   To return a list of objects:r®  h5jž  h6h7h8hTh:}r¯  (h<]h=]h>]h?]hA]uhCK‚hDhh/]r°  hMX   To return a list of objects:r±  …r²  }r³  (h4j®  h5j¬  ubaubj  )r´  }rµ  (h4XY   $files = $container->objectList();

foreach ($files as $file) {
    // ... do something
}h5jž  h6h7h8j  h:}r¶  (j	  j
  h?]h>]h<]h=]r·  (j  X   phpr¸  ehA]uhCK‹hDhh/]r¹  j  )rº  }r»  (h4XY   $files = $container->objectList();

foreach ($files as $file) {
    // ... do something
}h:}r¼  (h<]h=]r½  Uotherr¾  ah>]h?]hA]uh5j´  h/]r¿  hMXY   $files = $container->objectList();

foreach ($files as $file) {
    // ... do something
}rÀ  …rÁ  }rÂ  (h4U h5jº  ubah8j  ubaubhQ)rÃ  }rÄ  (h4XC  By default, 10,000 objects are returned as a maximum. To get around
this, you can construct a query which refines your result set. For a
full specification of query parameters relating to collection filtering,
see the `official
docs <http://docs.openstack.org/api/openstack-object-storage/1.0/content/list-objects.html>`__.h5jž  h6h7h8hTh:}rÅ  (h<]h=]h>]h?]hA]uhCKŒhDhh/]rÆ  (hMXÚ   By default, 10,000 objects are returned as a maximum. To get around
this, you can construct a query which refines your result set. For a
full specification of query parameters relating to collection filtering,
see the rÇ  …rÈ  }rÉ  (h4XÚ   By default, 10,000 objects are returned as a maximum. To get around
this, you can construct a query which refines your result set. For a
full specification of query parameters relating to collection filtering,
see the h5jÃ  ubhZ)rÊ  }rË  (h4Xh   `official
docs <http://docs.openstack.org/api/openstack-object-storage/1.0/content/list-objects.html>`__h:}rÌ  (UnameX   official docsh^XT   http://docs.openstack.org/api/openstack-object-storage/1.0/content/list-objects.htmlh?]h>]h<]h=]hA]uh5jÃ  h/]rÍ  hMX   official
docsrÎ  …rÏ  }rÐ  (h4U h5jÊ  ubah8hcubhMX   .…rÑ  }rÒ  (h4X   .h5jÃ  ubeubj  )rÓ  }rÔ  (h4X6   $container->objectList(array('prefix' => 'logFile_'));h5jž  h6h7h8j  h:}rÕ  (j	  j
  h?]h>]h<]h=]rÖ  (j  X   phpr×  ehA]uhCK•hDhh/]rØ  j  )rÙ  }rÚ  (h4X6   $container->objectList(array('prefix' => 'logFile_'));h:}rÛ  (h<]h=]rÜ  UotherrÝ  ah>]h?]hA]uh5jÓ  h/]rÞ  hMX6   $container->objectList(array('prefix' => 'logFile_'));rß  …rà  }rá  (h4U h5jÙ  ubah8j  ubaubeubh1)râ  }rã  (h4U h5hh6h7h8h9h:}rä  (h<]h=]h>]h?]rå  h&ahA]ræ  hauhCK—hDhh/]rç  (hF)rè  }ré  (h4X
   Get objectrê  h5jâ  h6h7h8hJh:}rë  (h<]h=]h>]h?]hA]uhCK—hDhh/]rì  hMX
   Get objectrí  …rî  }rï  (h4jê  h5jè  ubaubhQ)rð  }rñ  (h4X-   To retrieve a specific file from Cloud Files:rò  h5jâ  h6h7h8hTh:}ró  (h<]h=]h>]h?]hA]uhCK™hDhh/]rô  hMX-   To retrieve a specific file from Cloud Files:rõ  …rö  }r÷  (h4jò  h5jð  ubaubj  )rø  }rù  (h4X5   $file = $container->getObject('summer_vacation.mp4');h5jâ  h6h7h8j  h:}rú  (j	  j
  h?]h>]h<]h=]rû  (j  X   phprü  ehA]uhCKžhDhh/]rý  j  )rþ  }rÿ  (h4X5   $file = $container->getObject('summer_vacation.mp4');h:}r   (h<]h=]r  Uotherr  ah>]h?]hA]uh5jø  h/]r  hMX5   $file = $container->getObject('summer_vacation.mp4');r  …r  }r  (h4U h5jþ  ubah8j  ubaubh1)r  }r  (h4U h5jâ  h6h7h8h9h:}r	  (h<]h=]h>]h?]r
  h"ahA]r  h	auhCK hDhh/]r  (hF)r  }r  (h4X   Conditional requestsr  h5j  h6h7h8hJh:}r  (h<]h=]h>]h?]hA]uhCK hDhh/]r  hMX   Conditional requestsr  …r  }r  (h4j  h5j  ubaubhQ)r  }r  (h4Xò   You can also perform conditional requests according to `RFC 2616
specification <http://www.ietf.org/rfc/rfc2616.txt>`__ (Â§Â§ 14.24-26).
Supported headers are ``If-Match``, ``If-None-Match``,
``If-Modified-Since`` and ``If-Unmodified-Since``.h5j  h6h7h8hTh:}r  (h<]h=]h>]h?]hA]uhCK¢hDhh/]r  (hMX7   You can also perform conditional requests according to r  …r  }r  (h4X7   You can also perform conditional requests according to h5j  ubhZ)r  }r  (h4X@   `RFC 2616
specification <http://www.ietf.org/rfc/rfc2616.txt>`__h:}r  (UnameX   RFC 2616 specificationh^X#   http://www.ietf.org/rfc/rfc2616.txth?]h>]h<]h=]hA]uh5j  h/]r  hMX   RFC 2616
specificationr   …r!  }r"  (h4U h5j  ubah8hcubhMX(    (Â§Â§ 14.24-26).
Supported headers are r#  …r$  }r%  (h4X(    (Â§Â§ 14.24-26).
Supported headers are h5j  ubhÞ)r&  }r'  (h4X   ``If-Match``h:}r(  (h<]h=]h>]h?]hA]uh5j  h/]r)  hMX   If-Matchr*  …r+  }r,  (h4U h5j&  ubah8hæubhMX   , r-  …r.  }r/  (h4X   , h5j  ubhÞ)r0  }r1  (h4X   ``If-None-Match``h:}r2  (h<]h=]h>]h?]hA]uh5j  h/]r3  hMX   If-None-Matchr4  …r5  }r6  (h4U h5j0  ubah8hæubhMX   ,
r7  …r8  }r9  (h4X   ,
h5j  ubhÞ)r:  }r;  (h4X   ``If-Modified-Since``h:}r<  (h<]h=]h>]h?]hA]uh5j  h/]r=  hMX   If-Modified-Sincer>  …r?  }r@  (h4U h5j:  ubah8hæubhMX    and rA  …rB  }rC  (h4X    and h5j  ubhÞ)rD  }rE  (h4X   ``If-Unmodified-Since``h:}rF  (h<]h=]h>]h?]hA]uh5j  h/]rG  hMX   If-Unmodified-SincerH  …rI  }rJ  (h4U h5jD  ubah8hæubhMX   .…rK  }rL  (h4X   .h5j  ubeubhQ)rM  }rN  (h4XD   So, to retrieve a file's contents only if it's been recently changedrO  h5j  h6h7h8hTh:}rP  (h<]h=]h>]h?]hA]uhCK§hDhh/]rQ  hMXD   So, to retrieve a file's contents only if it's been recently changedrR  …rS  }rT  (h4jO  h5jM  ubaubj  )rU  }rV  (h4Xô   $file = $container->getObject('error_log.txt', array(
    'If-Modified-Since' => 'Tue, 15 Nov 1994 08:12:31 GMT'
));

if ($file->getContentLength()) {
    echo 'Has been changed since the above date';
} else {
    echo 'Has not been changed';
}h5j  h6h7h8j  h:}rW  (j	  j
  h?]h>]h<]h=]rX  (j  X   phprY  ehA]uhCK´hDhh/]rZ  j  )r[  }r\  (h4Xô   $file = $container->getObject('error_log.txt', array(
    'If-Modified-Since' => 'Tue, 15 Nov 1994 08:12:31 GMT'
));

if ($file->getContentLength()) {
    echo 'Has been changed since the above date';
} else {
    echo 'Has not been changed';
}h:}r]  (h<]h=]r^  Uotherr_  ah>]h?]hA]uh5jU  h/]r`  hMXô   $file = $container->getObject('error_log.txt', array(
    'If-Modified-Since' => 'Tue, 15 Nov 1994 08:12:31 GMT'
));

if ($file->getContentLength()) {
    echo 'Has been changed since the above date';
} else {
    echo 'Has not been changed';
}ra  …rb  }rc  (h4U h5j[  ubah8j  ubaubhQ)rd  }re  (h4XO   Retrieve a file only if it has NOT been modified (and expect a 412 on
failure):rf  h5j  h6h7h8hTh:}rg  (h<]h=]h>]h?]hA]uhCKµhDhh/]rh  hMXO   Retrieve a file only if it has NOT been modified (and expect a 412 on
failure):ri  …rj  }rk  (h4jf  h5jd  ubaubj  )rl  }rm  (h4X*  use Guzzle\Http\Exception\ClientErrorResponseException;

try {
    $oldImmutableFile = $container->getObject('payroll_2001.xlsx', array(
        'If-Unmodified-Since' => 'Mon, 31 Dec 2001 23:00:00 GMT'
    ));
} catch (ClientErrorResponseException $e) {
    echo 'This file has been modified...';
}h5j  h6h7h8j  h:}rn  (j	  j
  h?]h>]h<]h=]hA]uhCKºhDhh/]ro  hMX*  use Guzzle\Http\Exception\ClientErrorResponseException;

try {
    $oldImmutableFile = $container->getObject('payroll_2001.xlsx', array(
        'If-Unmodified-Since' => 'Mon, 31 Dec 2001 23:00:00 GMT'
    ));
} catch (ClientErrorResponseException $e) {
    echo 'This file has been modified...';
}rp  …rq  }rr  (h4U h5jl  ubaubhQ)rs  }rt  (h4X   Finally, you can specify a range - which will return a subset of bytes
from the file specified. To return the last 20B of a file:ru  h5j  h6h7h8hTh:}rv  (h<]h=]h>]h?]hA]uhCKÄhDhh/]rw  hMX   Finally, you can specify a range - which will return a subset of bytes
from the file specified. To return the last 20B of a file:rx  …ry  }rz  (h4ju  h5js  ubaubj  )r{  }r|  (h4XN   $snippet = $container->getObject('output.log', array('range' => 'bytes=-20'));h5j  h6h7h8j  h:}r}  (j	  j
  h?]h>]h<]h=]r~  (j  X   phpr  ehA]uhCKÊhDhh/]r€  j  )r  }r‚  (h4XN   $snippet = $container->getObject('output.log', array('range' => 'bytes=-20'));h:}rƒ  (h<]h=]r„  Uotherr…  ah>]h?]hA]uh5j{  h/]r†  hMXN   $snippet = $container->getObject('output.log', array('range' => 'bytes=-20'));r‡  …rˆ  }r‰  (h4U h5j  ubah8j  ubaubeubeubh1)rŠ  }r‹  (h4U h5hh6h7h8h9h:}rŒ  (h<]h=]h>]h?]r  h)ahA]rŽ  hauhCKÌhDhh/]r  (hF)r  }r‘  (h4X   Update an existing objectr’  h5jŠ  h6h7h8hJh:}r“  (h<]h=]h>]h?]hA]uhCKÌhDhh/]r”  hMX   Update an existing objectr•  …r–  }r—  (h4j’  h5j  ubaubhQ)r˜  }r™  (h4X   Updating content is easy:rš  h5jŠ  h6h7h8hTh:}r›  (h<]h=]h>]h?]hA]uhCKÎhDhh/]rœ  hMX   Updating content is easy:r  …rž  }rŸ  (h4jš  h5j˜  ubaubj  )r   }r¡  (h4XH   $file->setContent(fopen('/path/to/new/content', 'r+'));
$file->update();h5jŠ  h6h7h8j  h:}r¢  (j	  j
  h?]h>]h<]h=]r£  (j  X   phpr¤  ehA]uhCKÔhDhh/]r¥  j  )r¦  }r§  (h4XH   $file->setContent(fopen('/path/to/new/content', 'r+'));
$file->update();h:}r¨  (h<]h=]r©  Uotherrª  ah>]h?]hA]uh5j   h/]r«  hMXH   $file->setContent(fopen('/path/to/new/content', 'r+'));
$file->update();r¬  …r­  }r®  (h4U h5j¦  ubah8j  ubaubhQ)r¯  }r°  (h4XŒ   Bear in mind that updating a file name will result in a new file being
generated (under the new name). You will need to delete the old file.r±  h5jŠ  h6h7h8hTh:}r²  (h<]h=]h>]h?]hA]uhCKÕhDhh/]r³  hMXŒ   Bear in mind that updating a file name will result in a new file being
generated (under the new name). You will need to delete the old file.r´  …rµ  }r¶  (h4j±  h5j¯  ubaubeubh1)r·  }r¸  (h4U h5hh6h7h8h9h:}r¹  (h<]h=]h>]h?]rº  h(ahA]r»  hauhCKÙhDhh/]r¼  (hF)r½  }r¾  (h4X   Copy objectr¿  h5j·  h6h7h8hJh:}rÀ  (h<]h=]h>]h?]hA]uhCKÙhDhh/]rÁ  hMX   Copy objectrÂ  …rÃ  }rÄ  (h4j¿  h5j½  ubaubhQ)rÅ  }rÆ  (h4XX   To copy a file to another location, you need to specify a string-based
destination path:rÇ  h5j·  h6h7h8hTh:}rÈ  (h<]h=]h>]h?]hA]uhCKÛhDhh/]rÉ  hMXX   To copy a file to another location, you need to specify a string-based
destination path:rÊ  …rË  }rÌ  (h4jÇ  h5jÅ  ubaubj  )rÍ  }rÎ  (h4X.   $object->copy('/container_2/new_object_name');h5j·  h6h7h8j  h:}rÏ  (j	  j
  h?]h>]h<]h=]rÐ  (j  X   phprÑ  ehA]uhCKáhDhh/]rÒ  j  )rÓ  }rÔ  (h4X.   $object->copy('/container_2/new_object_name');h:}rÕ  (h<]h=]rÖ  Uotherr×  ah>]h?]hA]uh5jÍ  h/]rØ  hMX.   $object->copy('/container_2/new_object_name');rÙ  …rÚ  }rÛ  (h4U h5jÓ  ubah8j  ubaubeubh1)rÜ  }rÝ  (h4U h5hh6h7h8h9h:}rÞ  (h<]h=]h>]h?]rß  h*ahA]rà  hauhCKãhDhh/]rá  (hF)râ  }rã  (h4X   Delete objecträ  h5jÜ  h6h7h8hJh:}rå  (h<]h=]h>]h?]hA]uhCKãhDhh/]ræ  hMX   Delete objectrç  …rè  }ré  (h4jä  h5jâ  ubaubj  )rê  }rë  (h4X   $object->delete();h5jÜ  h6h7h8j  h:}rì  (j	  j
  h?]h>]h<]h=]rí  (j  X   phprî  ehA]uhCKèhDhh/]rï  j  )rð  }rñ  (h4X   $object->delete();h:}rò  (h<]h=]ró  Uotherrô  ah>]h?]hA]uh5jê  h/]rõ  hMX   $object->delete();rö  …r÷  }rø  (h4U h5jð  ubah8j  ubaubeubh1)rù  }rú  (h4U h5hh6h7h8h9h:}rû  (h<]h=]h>]h?]rü  hahA]rý  hauhCKêhDhh/]rþ  (hF)rÿ  }r   (h4X   Get object metadatar  h5jù  h6h7h8hJh:}r  (h<]h=]h>]h?]hA]uhCKêhDhh/]r  hMX   Get object metadatar  …r  }r  (h4j  h5jÿ  ubaubhQ)r  }r  (h4XI   You can fetch just the object metadata without fetching the full
content:r	  h5jù  h6h7h8hTh:}r
  (h<]h=]h>]h?]hA]uhCKìhDhh/]r  hMXI   You can fetch just the object metadata without fetching the full
content:r  …r  }r  (h4j	  h5j  ubaubj  )r  }r  (h4X4   $container->getPartialObject('summer_vacation.mp4');h5jù  h6h7h8j  h:}r  (j	  j
  h?]h>]h<]h=]r  (j  X   phpr  ehA]uhCKòhDhh/]r  j  )r  }r  (h4X4   $container->getPartialObject('summer_vacation.mp4');h:}r  (h<]h=]r  Uotherr  ah>]h?]hA]uh5j  h/]r  hMX4   $container->getPartialObject('summer_vacation.mp4');r  …r  }r  (h4U h5j  ubah8j  ubaubhQ)r  }r  (h4XE   In order to access the metadata on a partial or complete object, use:r   h5jù  h6h7h8hTh:}r!  (h<]h=]h>]h?]hA]uhCKóhDhh/]r"  hMXE   In order to access the metadata on a partial or complete object, use:r#  …r$  }r%  (h4j   h5j  ubaubj  )r&  }r'  (h4X   $object->getMetadata();h5jù  h6h7h8j  h:}r(  (j	  j
  h?]h>]h<]h=]r)  (j  X   phpr*  ehA]uhCKøhDhh/]r+  j  )r,  }r-  (h4X   $object->getMetadata();h:}r.  (h<]h=]r/  Uotherr0  ah>]h?]hA]uh5j&  h/]r1  hMX   $object->getMetadata();r2  …r3  }r4  (h4U h5j,  ubah8j  ubaubhQ)r5  }r6  (h4Xb   You can turn a partial object into a full object to get the content
after looking at the metadata:r7  h5jù  h6h7h8hTh:}r8  (h<]h=]h>]h?]hA]uhCKùhDhh/]r9  hMXb   You can turn a partial object into a full object to get the content
after looking at the metadata:r:  …r;  }r<  (h4j7  h5j5  ubaubj  )r=  }r>  (h4X   $object->refresh();h5jù  h6h7h8j  h:}r?  (j	  j
  h?]h>]h<]h=]r@  (j  X   phprA  ehA]uhCKÿhDhh/]rB  j  )rC  }rD  (h4X   $object->refresh();h:}rE  (h<]h=]rF  UotherrG  ah>]h?]hA]uh5j=  h/]rH  hMX   $object->refresh();rI  …rJ  }rK  (h4U h5jC  ubah8j  ubaubhQ)rL  }rM  (h4X/   You can also update to get the latest metadata:rN  h5jù  h6h7h8hTh:}rO  (h<]h=]h>]h?]hA]uhCM hDhh/]rP  hMX/   You can also update to get the latest metadata:rQ  …rR  }rS  (h4jN  h5jL  ubaubj  )rT  }rU  (h4X   $object->retrieveMetadata();h5jù  h6h7h8j  h:}rV  (j	  j
  h?]h>]h<]h=]rW  (j  X   phprX  ehA]uhCMhDhh/]rY  j  )rZ  }r[  (h4X   $object->retrieveMetadata();h:}r\  (h<]h=]r]  Uotherr^  ah>]h?]hA]uh5jT  h/]r_  hMX   $object->retrieveMetadata();r`  …ra  }rb  (h4U h5jZ  ubah8j  ubaubeubh1)rc  }rd  (h4U h5hh6h7h8h9h:}re  (h<]h=]h>]h?]rf  h+ahA]rg  hauhCMhDhh/]rh  (hF)ri  }rj  (h4X   Update object metadatark  h5jc  h6h7h8hJh:}rl  (h<]h=]h>]h?]hA]uhCMhDhh/]rm  hMX   Update object metadatarn  …ro  }rp  (h4jk  h5ji  ubaubhQ)rq  }rr  (h4X×   Similarly, with setting metadata there are two options: you can update
the metadata values of the local object (i.e. no HTTP request) if you
anticipate you'll be executing one soon (an update operation for
example):rs  h5jc  h6h7h8hTh:}rt  (h<]h=]h>]h?]hA]uhCM	hDhh/]ru  hMX×   Similarly, with setting metadata there are two options: you can update
the metadata values of the local object (i.e. no HTTP request) if you
anticipate you'll be executing one soon (an update operation for
example):rv  …rw  }rx  (h4js  h5jq  ubaubj  )ry  }rz  (h4XÉ   // There's no need to execute a HTTP request, because we'll soon do one anyway for the update operation
$object->setMetadata(array(
    'Author' => 'Hemingway'
));

// ... code here

$object->update();h5jc  h6h7h8j  h:}r{  (j	  j
  h?]h>]h<]h=]r|  (j  X   phpr}  ehA]uhCMhDhh/]r~  j  )r  }r€  (h4XÉ   // There's no need to execute a HTTP request, because we'll soon do one anyway for the update operation
$object->setMetadata(array(
    'Author' => 'Hemingway'
));

// ... code here

$object->update();h:}r  (h<]h=]r‚  Uotherrƒ  ah>]h?]hA]uh5jy  h/]r„  hMXÉ   // There's no need to execute a HTTP request, because we'll soon do one anyway for the update operation
$object->setMetadata(array(
    'Author' => 'Hemingway'
));

// ... code here

$object->update();r…  …r†  }r‡  (h4U h5j  ubah8j  ubaubhQ)rˆ  }r‰  (h4XU   Alternatively, you can update the API straight away - so that everything
is retained:rŠ  h5jc  h6h7h8hTh:}r‹  (h<]h=]h>]h?]hA]uhCMhDhh/]rŒ  hMXU   Alternatively, you can update the API straight away - so that everything
is retained:r  …rŽ  }r  (h4jŠ  h5jˆ  ubaubj  )r  }r‘  (h4X<   $object->saveMetadata(array(
    'Author' => 'Hemingway'
));h5jc  h6h7h8j  h:}r’  (j	  j
  h?]h>]h<]h=]r“  (j  X   phpr”  ehA]uhCM!hDhh/]r•  j  )r–  }r—  (h4X<   $object->saveMetadata(array(
    'Author' => 'Hemingway'
));h:}r˜  (h<]h=]r™  Uotherrš  ah>]h?]hA]uh5j  h/]r›  hMX<   $object->saveMetadata(array(
    'Author' => 'Hemingway'
));rœ  …r  }rž  (h4U h5j–  ubah8j  ubaubhQ)rŸ  }r   (h4XŒ   Please be aware that these methods override and wipe existing values. If
you want to append values to your metadata, use the correct method:r¡  h5jc  h6h7h8hTh:}r¢  (h<]h=]h>]h?]hA]uhCM"hDhh/]r£  hMXŒ   Please be aware that these methods override and wipe existing values. If
you want to append values to your metadata, use the correct method:r¤  …r¥  }r¦  (h4j¡  h5jŸ  ubaubj  )r§  }r¨  (h4Xm   $metadata = $object->appendToMetadata(array(
  'Author' => 'Hemingway'
));

$object->saveMetadata($metadata);h5jc  h6h7h8j  h:}r©  (j	  j
  h?]h>]h<]h=]rª  (j  X   phpr«  ehA]uhCM,hDhh/]r¬  j  )r­  }r®  (h4Xm   $metadata = $object->appendToMetadata(array(
  'Author' => 'Hemingway'
));

$object->saveMetadata($metadata);h:}r¯  (h<]h=]r°  Uotherr±  ah>]h?]hA]uh5j§  h/]r²  hMXm   $metadata = $object->appendToMetadata(array(
  'Author' => 'Hemingway'
));

$object->saveMetadata($metadata);r³  …r´  }rµ  (h4U h5j­  ubah8j  ubaubeubh1)r¶  }r·  (h4U h5hh6h7h8h9h:}r¸  (h<]h=]h>]h?]r¹  h!ahA]rº  hauhCM.hDhh/]r»  (hF)r¼  }r½  (h4X   Extract archiver¾  h5j¶  h6h7h8hJh:}r¿  (h<]h=]h>]h?]hA]uhCM.hDhh/]rÀ  hMX   Extract archiverÁ  …rÂ  }rÃ  (h4j¾  h5j¼  ubaubhQ)rÄ  }rÅ  (h4X  CloudFiles provides you the ability to extract uploaded archives to
particular destinations. The archive will be extracted and its contents
will populate the particular area specified. To upload file (which might
represent a directory structure) into a particular container:rÆ  h5j¶  h6h7h8hTh:}rÇ  (h<]h=]h>]h?]hA]uhCM0hDhh/]rÈ  hMX  CloudFiles provides you the ability to extract uploaded archives to
particular destinations. The archive will be extracted and its contents
will populate the particular area specified. To upload file (which might
represent a directory structure) into a particular container:rÉ  …rÊ  }rË  (h4jÆ  h5jÄ  ubaubj  )rÌ  }rÍ  (h4X‹   use OpenCloud\ObjectStore\Constants\UrlType;

$service->bulkExtract('container_1', fopen('/home/jamie/files.tar.gz','r'), UrlType::TAR_GZ);h5j¶  h6h7h8j  h:}rÎ  (j	  j
  h?]h>]h<]h=]rÏ  (j  X   phprÐ  ehA]uhCM:hDhh/]rÑ  j  )rÒ  }rÓ  (h4X‹   use OpenCloud\ObjectStore\Constants\UrlType;

$service->bulkExtract('container_1', fopen('/home/jamie/files.tar.gz','r'), UrlType::TAR_GZ);h:}rÔ  (h<]h=]rÕ  UotherrÖ  ah>]h?]hA]uh5jÌ  h/]r×  hMX‹   use OpenCloud\ObjectStore\Constants\UrlType;

$service->bulkExtract('container_1', fopen('/home/jamie/files.tar.gz','r'), UrlType::TAR_GZ);rØ  …rÙ  }rÚ  (h4U h5jÒ  ubah8j  ubaubhQ)rÛ  }rÜ  (h4Xî   You can also omit the container name (i.e. provide an empty string as
the first argument). If you do this, the API will create the containers
necessary to house the extracted files - this is done based on the
filenames inside the archive.rÝ  h5j¶  h6h7h8hTh:}rÞ  (h<]h=]h>]h?]hA]uhCM;hDhh/]rß  hMXî   You can also omit the container name (i.e. provide an empty string as
the first argument). If you do this, the API will create the containers
necessary to house the extracted files - this is done based on the
filenames inside the archive.rà  …rá  }râ  (h4jÝ  h5jÛ  ubaubeubh1)rã  }rä  (h4U h5hh6h7h8h9h:}rå  (h<]h=]h>]h?]ræ  h-ahA]rç  hauhCMAhDhh/]rè  (hF)ré  }rê  (h4X   Bulk deleterë  h5jã  h6h7h8hJh:}rì  (h<]h=]h>]h?]hA]uhCMAhDhh/]rí  hMX   Bulk deleterî  …rï  }rð  (h4jë  h5jé  ubaubhQ)rñ  }rò  (h4X   Bulk delete a set of paths:ró  h5jã  h6h7h8hTh:}rô  (h<]h=]h>]h?]hA]uhCMChDhh/]rõ  hMX   Bulk delete a set of paths:rö  …r÷  }rø  (h4jó  h5jñ  ubaubj  )rù  }rú  (h4X–   $pathsToBeDeleted = array('/container_1/old_file', '/container_2/notes.txt', '/container_1/older_file.log');

$service->bulkDelete($pathsToBeDeleted);h5jã  h6h7h8j  h:}rû  (j	  j
  h?]h>]h<]h=]rü  (j  X   phprý  ehA]uhCMJhDhh/]rþ  j  )rÿ  }r   (h4X–   $pathsToBeDeleted = array('/container_1/old_file', '/container_2/notes.txt', '/container_1/older_file.log');

$service->bulkDelete($pathsToBeDeleted);h:}r  (h<]h=]r  Uotherr  ah>]h?]hA]uh5jù  h/]r  hMX–   $pathsToBeDeleted = array('/container_1/old_file', '/container_2/notes.txt', '/container_1/older_file.log');

$service->bulkDelete($pathsToBeDeleted);r  …r  }r  (h4U h5jÿ  ubah8j  ubaubeubeh4U Utransformerr  NUfootnote_refsr	  }r
  Urefnamesr  }r  Usymbol_footnotesr  ]r  Uautofootnote_refsr  ]r  Usymbol_footnote_refsr  ]r  U	citationsr  ]r  hDhUcurrent_liner  NUtransform_messagesr  ]r  Ureporterr  NUid_startr  KUautofootnotesr  ]r  Ucitation_refsr  }r  Uindirect_targetsr  ]r  Usettingsr   (cdocutils.frontend
Values
r!  or"  }r#  (Ufootnote_backlinksr$  KUrecord_dependenciesr%  NUrfc_base_urlr&  Uhttp://tools.ietf.org/html/r'  U	tracebackr(  ˆUpep_referencesr)  NUstrip_commentsr*  NUtoc_backlinksr+  h±Ulanguage_coder,  Uenr-  U	datestampr.  NUreport_levelr/  KU_destinationr0  NU
halt_levelr1  KUstrip_classesr2  NhJNUerror_encoding_error_handlerr3  Ubackslashreplacer4  Udebugr5  NUembed_stylesheetr6  ‰Uoutput_encoding_error_handlerr7  Ustrictr8  Usectnum_xformr9  KUdump_transformsr:  NUdocinfo_xformr;  KUwarning_streamr<  NUpep_file_url_templater=  Upep-%04dr>  Uexit_status_levelr?  KUconfigr@  NUstrict_visitorrA  NUcloak_email_addressesrB  ˆUtrim_footnote_reference_spacerC  ‰UenvrD  NUdump_pseudo_xmlrE  NUexpose_internalsrF  NUsectsubtitle_xformrG  ‰Usource_linkrH  NUrfc_referencesrI  NUoutput_encodingrJ  Uutf-8rK  U
source_urlrL  NUinput_encodingrM  U	utf-8-sigrN  U_disable_configrO  NU	id_prefixrP  U U	tab_widthrQ  KUerror_encodingrR  UUTF-8rS  U_sourcerT  h7Ugettext_compactrU  ˆU	generatorrV  NUdump_internalsrW  NUsmart_quotesrX  ‰Upep_base_urlrY  Uhttp://www.python.org/dev/peps/rZ  Usyntax_highlightr[  Ulongr\  Uinput_encoding_error_handlerr]  j8  Uauto_id_prefixr^  Uidr_  Udoctitle_xformr`  ‰Ustrip_elements_with_classesra  NU_config_filesrb  ]Ufile_insertion_enabledrc  ˆUraw_enabledrd  KUdump_settingsre  NubUsymbol_footnote_startrf  K Uidsrg  }rh  (h!j¶  h'j  h(j·  h%h2h-jã  h,j©  h.jž  h"j  h hfh&jâ  h+jc  hjù  h#jh  h$jö  h)jŠ  h*jÜ  uUsubstitution_namesri  }rj  h8hDh:}rk  (h<]h?]h>]Usourceh7h=]hA]uU	footnotesrl  ]rm  Urefidsrn  }ro  ub.