€cdocutils.nodes document q)q}q(U nametypesq}q(Xretrieve accountqNXget container detailsqNXget container metadataqNXupdate cdn container ttlq NXenable cdn containerq NXsecure http urlq NXobject store serviceq NXaccountsq NX3the complete user guide to the object store serviceqNXupload multiple objectsqNX delete objectqNX large objectsqNX#get quota for total size of objectsqNXget object countqNXdelete containerqNX bulk deleteqNXdisable cdn containerqNXget quota for number of objectsqNXcreate containerqNXtemporary urlsqNXauto-extract archive filesqNX streaming urlqNXupdate object metadataqNX containersqNXhttp urlqNXretrieve object metadataqNX copy objectq NXget bytes usedq!NXobjectsq"NXset quota for number of objectsq#NX update objectq$NXcdn containersq%NX set or update container metadataq&NX public urlsq'NXios streaming urlq(NXlist objects in a containerq)NXlist containersq*NX prerequisitesq+NXget container countq,NXclientq-NXpseudo-hierarchical foldersq.NX upload objectq/NXretrieve objectq0NXcontainer quotasq1NX#set quota for total size of objectsq2NuUsubstitution_defsq3}q4Uparse_messagesq5]q6(cdocutils.nodes system_message q7)q8}q9(U rawsourceq:UUparentq;cdocutils.nodes section q<)q=}q>(h:UU referencedq?Kh;h<)q@}qA(h:Uh;h<)qB}qC(h:Uh;hUsourceqDXR/Users/jamie/projects/php/php-opencloud/doc/services/object-store/USERGUIDE.md.rstqEUtagnameqFUsectionqGU attributesqH}qI(UdupnamesqJ]UclassesqK]UbackrefsqL]UidsqM]qNU3the-complete-user-guide-to-the-object-store-serviceqOaUnamesqP]qQhauUlineqRKUdocumentqShUchildrenqT]qU(cdocutils.nodes title qV)qW}qX(h:X3The Complete User Guide to the Object Store ServiceqYh;hBhDhEhFUtitleqZhH}q[(hJ]hK]hL]hM]hP]uhRKhShhT]q\cdocutils.nodes Text q]X3The Complete User Guide to the Object Store Serviceq^…q_}q`(h:hYh;hWubaubcdocutils.nodes paragraph qa)qb}qc(h:Xj**Object Store** is an object-based storage system that stores content and metadata as objects in a cloud.h;hBhDhEhFU paragraphqdhH}qe(hJ]hK]hL]hM]hP]uhRKhShhT]qf(cdocutils.nodes strong qg)qh}qi(h:X**Object Store**hH}qj(hJ]hK]hL]hM]hP]uh;hbhT]qkh]X Object Storeql…qm}qn(h:Uh;hhubahFUstrongqoubh]XZ is an object-based storage system that stores content and metadata as objects in a cloud.qp…qq}qr(h:XZ is an object-based storage system that stores content and metadata as objects in a cloud.h;hbubeubh<)qs}qt(h:Uh;hBhDhEhFhGhH}qu(hJ]hK]hL]hM]qvU prerequisitesqwahP]qxh+auhRKhShhT]qy(hV)qz}q{(h:X Prerequisitesq|h;hshDhEhFhZhH}q}(hJ]hK]hL]hM]hP]uhRKhShhT]q~h]X Prerequisitesq…q€}q(h:h|h;hzubaubh<)q‚}qƒ(h:Uh;hshDhEhFhGhH}q„(hJ]hK]hL]hM]q…Uclientq†ahP]q‡h-auhRK hShhT]qˆ(hV)q‰}qŠ(h:XClientq‹h;h‚hDhEhFhZhH}qŒ(hJ]hK]hL]hM]hP]uhRK hShhT]qh]XClientqŽ…q}q(h:h‹h;h‰ubaubha)q‘}q’(h:XkTo use the object store service, you must first instantiate a ``OpenStack`` or ``Rackspace`` client object.h;h‚hDhEhFhdhH}q“(hJ]hK]hL]hM]hP]uhRK hShhT]q”(h]X>To use the object store service, you must first instantiate a q•…q–}q—(h:X>To use the object store service, you must first instantiate a h;h‘ubcdocutils.nodes literal q˜)q™}qš(h:X ``OpenStack``hH}q›(hJ]hK]hL]hM]hP]uh;h‘hT]qœh]X OpenStackq…qž}qŸ(h:Uh;h™ubahFUliteralq ubh]X or q¡…q¢}q£(h:X or h;h‘ubh˜)q¤}q¥(h:X ``Rackspace``hH}q¦(hJ]hK]hL]hM]hP]uh;h‘hT]q§h]X Rackspaceq¨…q©}qª(h:Uh;h¤ubahFh ubh]X client object.q«…q¬}q­(h:X client object.h;h‘ubeubcdocutils.nodes bullet_list q®)q¯}q°(h:Uh;h‚hDhEhFU bullet_listq±hH}q²(Ubulletq³X-hM]hL]hJ]hK]hP]uhRKhShhT]q´(cdocutils.nodes list_item qµ)q¶}q·(h:XuIf you are working with a vanilla OpenStack cloud, instantiate an ``OpenCloud\OpenStack`` client as shown below. .. code:: php use OpenCloud\OpenStack; $client = new OpenStack('', array( 'username' => '', 'apiKey' => '' )); h;h¯hDNhFU list_itemq¸hH}q¹(hJ]hK]hL]hM]hP]uhRNhShhT]qº(ha)q»}q¼(h:XpIf you are working with a vanilla OpenStack cloud, instantiate an ``OpenCloud\OpenStack`` client as shown below.h;h¶hDhEhFhdhH}q½(hJ]hK]hL]hM]hP]uhRKhT]q¾(h]XBIf you are working with a vanilla OpenStack cloud, instantiate an q¿…qÀ}qÁ(h:XBIf you are working with a vanilla OpenStack cloud, instantiate an h;h»ubh˜)qÂ}qÃ(h:X``OpenCloud\OpenStack``hH}qÄ(hJ]hK]hL]hM]hP]uh;h»hT]qÅh]XOpenCloud\OpenStackqÆ…qÇ}qÈ(h:Uh;hÂubahFh ubh]X client as shown below.qÉ…qÊ}qË(h:X client as shown below.h;h»ubeubcdocutils.nodes literal_block qÌ)qÍ}qÎ(h:Xßuse OpenCloud\OpenStack; $client = new OpenStack('', array( 'username' => '', 'apiKey' => '' ));hH}qÏ(U xml:spaceqÐUpreserveqÑhM]hL]hJ]hK]qÒ(UcodeqÓXphpqÔehP]uh;h¶hT]qÕcdocutils.nodes inline qÖ)q×}qØ(h:Xßuse OpenCloud\OpenStack; $client = new OpenStack('', array( 'username' => '', 'apiKey' => '' ));hH}qÙ(hJ]hK]qÚUotherqÛahL]hM]hP]uh;hÍhT]qÜh]Xßuse OpenCloud\OpenStack; $client = new OpenStack('', array( 'username' => '', 'apiKey' => '' ));qÝ…qÞ}qß(h:Uh;h×ubahFUinlineqàubahFU literal_blockqáubeubhµ)qâ}qã(h:XdIf you are working with the Rackspace cloud, instantiate a ``OpenCloud\Rackspace`` client as shown below. .. code:: php use OpenCloud\Rackspace; $client = new Rackspace(Rackspace::US_IDENTITY_ENDPOINT, array( 'username' => '', 'apiKey' => '' )); h;h¯hDNhFh¸hH}qä(hJ]hK]hL]hM]hP]uhRNhShhT]qå(ha)qæ}qç(h:XiIf you are working with the Rackspace cloud, instantiate a ``OpenCloud\Rackspace`` client as shown below.h;hâhDhEhFhdhH}qè(hJ]hK]hL]hM]hP]uhRKhT]qé(h]X;If you are working with the Rackspace cloud, instantiate a qê…që}qì(h:X;If you are working with the Rackspace cloud, instantiate a h;hæubh˜)qí}qî(h:X``OpenCloud\Rackspace``hH}qï(hJ]hK]hL]hM]hP]uh;hæhT]qðh]XOpenCloud\Rackspaceqñ…qò}qó(h:Uh;híubahFh ubh]X client as shown below.qô…qõ}qö(h:X client as shown below.h;hæubeubhÌ)q÷}qø(h:XÕuse OpenCloud\Rackspace; $client = new Rackspace(Rackspace::US_IDENTITY_ENDPOINT, array( 'username' => '', 'apiKey' => '' ));hH}qù(hÐhÑhM]hL]hJ]hK]qú(hÓXphpqûehP]uh;hâhT]qühÖ)qý}qþ(h:XÕuse OpenCloud\Rackspace; $client = new Rackspace(Rackspace::US_IDENTITY_ENDPOINT, array( 'username' => '', 'apiKey' => '' ));hH}qÿ(hJ]hK]rUotherrahL]hM]hP]uh;h÷hT]rh]XÕuse OpenCloud\Rackspace; $client = new Rackspace(Rackspace::US_IDENTITY_ENDPOINT, array( 'username' => '', 'apiKey' => '' ));r…r}r(h:Uh;hýubahFhàubahFháubeubeubeubh<)r}r(h:Uh;hshDhEhFhGhH}r(hJ]hK]hL]hM]r Uobject-store-servicer ahP]r h auhRK)hShhT]r (hV)r }r(h:XObject Store Servicerh;jhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRK)hShhT]rh]XObject Store Servicer…r}r(h:jh;j ubaubha)r}r(h:XOAll operations on the object store are done via an object store service object.rh;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRK+hShhT]rh]XOAll operations on the object store are done via an object store service object.r…r}r(h:jh;jubaubhÌ)r}r(h:XR$region = 'DFW'; $objectStoreService = $client->objectStoreService(null, $region);h;jhDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]r (hÓXphpr!ehP]uhRK2hShhT]r"hÖ)r#}r$(h:XR$region = 'DFW'; $objectStoreService = $client->objectStoreService(null, $region);hH}r%(hJ]hK]r&Uotherr'ahL]hM]hP]uh;jhT]r(h]XR$region = 'DFW'; $objectStoreService = $client->objectStoreService(null, $region);r)…r*}r+(h:Uh;j#ubahFhàubaubha)r,}r-(h:X¿In the example above, you are connecting to the ``DFW`` region of the cloud. Any containers and objects created with this ``$objectStoreService`` instance will be stored in that cloud region.h;jhDhEhFhdhH}r.(hJ]hK]hL]hM]hP]uhRK3hShhT]r/(h]X0In the example above, you are connecting to the r0…r1}r2(h:X0In the example above, you are connecting to the h;j,ubh˜)r3}r4(h:X``DFW``hH}r5(hJ]hK]hL]hM]hP]uh;j,hT]r6h]XDFWr7…r8}r9(h:Uh;j3ubahFh ubh]XC region of the cloud. Any containers and objects created with this r:…r;}r<(h:XC region of the cloud. Any containers and objects created with this h;j,ubh˜)r=}r>(h:X``$objectStoreService``hH}r?(hJ]hK]hL]hM]hP]uh;j,hT]r@h]X$objectStoreServicerA…rB}rC(h:Uh;j=ubahFh ubh]X. instance will be stored in that cloud region.rD…rE}rF(h:X. instance will be stored in that cloud region.h;j,ubeubeubeubh<)rG}rH(h:Uh;hBhDhEhFhGhH}rI(hJ]hK]hL]hM]rJU containersrKahP]rLhauhRK8hShhT]rM(hV)rN}rO(h:X ContainersrPh;jGhDhEhFhZhH}rQ(hJ]hK]hL]hM]hP]uhRK8hShhT]rRh]X ContainersrS…rT}rU(h:jPh;jNubaubha)rV}rW(h:XA **container** defines a namespace for **objects**. An object with the same name in two different containers represents two different objects.h;jGhDhEhFhdhH}rX(hJ]hK]hL]hM]hP]uhRK:hShhT]rY(h]XA rZ…r[}r\(h:XA h;jVubhg)r]}r^(h:X **container**hH}r_(hJ]hK]hL]hM]hP]uh;jVhT]r`h]X containerra…rb}rc(h:Uh;j]ubahFhoubh]X defines a namespace for rd…re}rf(h:X defines a namespace for h;jVubhg)rg}rh(h:X **objects**hH}ri(hJ]hK]hL]hM]hP]uh;jVhT]rjh]Xobjectsrk…rl}rm(h:Uh;jgubahFhoubh]X\. An object with the same name in two different containers represents two different objects.rn…ro}rp(h:X\. An object with the same name in two different containers represents two different objects.h;jVubeubha)rq}rr(h:XcFor example, you may create a container called ``logos`` to hold all the image files for your blog.h;jGhDhEhFhdhH}rs(hJ]hK]hL]hM]hP]uhRK=hShhT]rt(h]X/For example, you may create a container called ru…rv}rw(h:X/For example, you may create a container called h;jqubh˜)rx}ry(h:X ``logos``hH}rz(hJ]hK]hL]hM]hP]uh;jqhT]r{h]Xlogosr|…r}}r~(h:Uh;jxubahFh ubh]X+ to hold all the image files for your blog.r…r€}r(h:X+ to hold all the image files for your blog.h;jqubeubha)r‚}rƒ(h:X3A container may contain zero or more objects in it.r„h;jGhDhEhFhdhH}r…(hJ]hK]hL]hM]hP]uhRK@hShhT]r†h]X3A container may contain zero or more objects in it.r‡…rˆ}r‰(h:j„h;j‚ubaubcdocutils.nodes block_quote rŠ)r‹}rŒ(h:Uh;jGhDhEhFU block_quoterhH}rŽ(hJ]hK]hL]hM]hP]uhRNhShhT]rha)r}r‘(h:Xë**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`` `__ before passing them inh;j‹hDhEhFhdhH}r’(hJ]hK]hL]hM]hP]uhRKBhT]r“(hg)r”}r•(h:X **Note:**hH}r–(hJ]hK]hL]hM]hP]uh;jhT]r—h]XNote:r˜…r™}rš(h:Uh;j”ubahFhoubh]XŸ 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(h:XŸ when working with names that contain non-standard alphanumerical characters (such as spaces or non-English characters), you must ensure they are encoded with h;jubh˜)rž}rŸ(h:X```urlencode``hH}r (hJ]hK]hL]hM]hP]uh;jhT]r¡h]X `urlencoder¢…r£}r¤(h:Uh;jžubahFh ubh]X `__ before passing them inr²…r³}r´(h:X>`__ before passing them inh;jubeubaubh<)rµ}r¶(h:Uh;jGhDhEhFhGhH}r·(hJ]hK]hL]hM]r¸Ucreate-containerr¹ahP]rºhauhRKHhShhT]r»(hV)r¼}r½(h:XCreate Containerr¾h;jµhDhEhFhZhH}r¿(hJ]hK]hL]hM]hP]uhRKHhShhT]rÀh]XCreate ContainerrÁ…rÂ}rÃ(h:j¾h;j¼ubaubhÌ)rÄ}rÅ(h:X;$container = $objectStoreService->createContainer('logos');h;jµhDhEhFháhH}rÆ(hÐhÑhM]hL]hJ]hK]rÇ(hÓXphprÈehP]uhRKMhShhT]rÉhÖ)rÊ}rË(h:X;$container = $objectStoreService->createContainer('logos');hH}rÌ(hJ]hK]rÍUotherrÎahL]hM]hP]uh;jÄhT]rÏh]X;$container = $objectStoreService->createContainer('logos');rÐ…rÑ}rÒ(h:Uh;jÊubahFhàubaubha)rÓ}rÔ(h:Xb[ `Get the executable PHP script for this example `__ ]h;jµhDhEhFhdhH}rÕ(hJ]hK]hL]hM]hP]uhRKNhShhT]rÖ(h]X[ r×…rØ}rÙ(h:X[ h;jÓubj¨)rÚ}rÛ(h:X^`Get the executable PHP script for this example `__hH}rÜ(UnameX.Get the executable PHP script for this exampleUrefurirÝX)/samples/ObjectStore/create-container.phphM]hL]hJ]hK]hP]uh;jÓhT]rÞh]X.Get the executable PHP script for this examplerß…rà}rá(h:Uh;jÚubahFj±ubh]X ]râ…rã}rä(h:X ]h;jÓubeubeubh<)rå}ræ(h:Uh;jGhDhEhFhGhH}rç(hJ]hK]hL]hM]rèUget-container-detailsréahP]rêhauhRKRhShhT]rë(hV)rì}rí(h:XGet Container Detailsrîh;jåhDhEhFhZhH}rï(hJ]hK]hL]hM]hP]uhRKRhShhT]rðh]XGet Container Detailsrñ…rò}ró(h:jîh;jìubaubha)rô}rõ(h:X‰You can retrieve a single container's details by using its name. An instance of ``OpenCloud\ObjectStore\Resource\Container`` is returned.h;jåhDhEhFhdhH}rö(hJ]hK]hL]hM]hP]uhRKThShhT]r÷(h]XPYou can retrieve a single container's details by using its name. An instance of rø…rù}rú(h:XPYou can retrieve a single container's details by using its name. An instance of h;jôubh˜)rû}rü(h:X,``OpenCloud\ObjectStore\Resource\Container``hH}rý(hJ]hK]hL]hM]hP]uh;jôhT]rþh]X(OpenCloud\ObjectStore\Resource\Containerrÿ…r}r(h:Uh;jûubahFh ubh]X is returned.r…r}r(h:X is returned.h;jôubeubhÌ)r}r(h:Xz$container = $objectStoreService->getContainer('logos'); /** @var $container OpenCloud\ObjectStore\Resource\Container **/h;jåhDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]r(hÓXphpr ehP]uhRK\hShhT]r hÖ)r }r (h:Xz$container = $objectStoreService->getContainer('logos'); /** @var $container OpenCloud\ObjectStore\Resource\Container **/hH}r (hJ]hK]rUotherrahL]hM]hP]uh;jhT]rh]Xz$container = $objectStoreService->getContainer('logos'); /** @var $container OpenCloud\ObjectStore\Resource\Container **/r…r}r(h:Uh;j ubahFhàubaubha)r}r(h:X_[ `Get the executable PHP script for this example `__ ]h;jåhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRK]hShhT]r(h]X[ r…r}r(h:X[ h;jubj¨)r}r(h:X[`Get the executable PHP script for this example `__hH}r(UnameX.Get the executable PHP script for this examplejÝX&/samples/ObjectStore/get-container.phphM]hL]hJ]hK]hP]uh;jhT]rh]X.Get the executable PHP script for this exampler…r }r!(h:Uh;jubahFj±ubh]X ]r"…r#}r$(h:X ]h;jubeubeubh<)r%}r&(h:Uh;jGhDhEhFhGhH}r'(hJ]hK]hL]hM]r(Ulist-containersr)ahP]r*h*auhRKahShhT]r+(hV)r,}r-(h:XList Containersr.h;j%hDhEhFhZhH}r/(hJ]hK]hL]hM]hP]uhRKahShhT]r0h]XList Containersr1…r2}r3(h:j.h;j,ubaubha)r4}r5(h:X}You can retrieve a list of all your containers. An instance of ``OpenCloud\Common\Collection\PaginatedIterator`` is returned.h;j%hDhEhFhdhH}r6(hJ]hK]hL]hM]hP]uhRKchShhT]r7(h]X?You can retrieve a list of all your containers. An instance of r8…r9}r:(h:X?You can retrieve a list of all your containers. An instance of h;j4ubh˜)r;}r<(h:X1``OpenCloud\Common\Collection\PaginatedIterator``hH}r=(hJ]hK]hL]hM]hP]uh;j4hT]r>h]X-OpenCloud\Common\Collection\PaginatedIteratorr?…r@}rA(h:Uh;j;ubahFh ubh]X is returned.rB…rC}rD(h:X is returned.h;j4ubeubhÌ)rE}rF(h:X¢$containers = $objectStoreService->listContainers(); foreach ($containers as $container) { /** @var $container OpenCloud\ObjectStore\Resource\Container **/ }h;j%hDhEhFháhH}rG(hÐhÑhM]hL]hJ]hK]rH(hÓXphprIehP]uhRKlhShhT]rJhÖ)rK}rL(h:X¢$containers = $objectStoreService->listContainers(); foreach ($containers as $container) { /** @var $container OpenCloud\ObjectStore\Resource\Container **/ }hH}rM(hJ]hK]rNUotherrOahL]hM]hP]uh;jEhT]rPh]X¢$containers = $objectStoreService->listContainers(); foreach ($containers as $container) { /** @var $container OpenCloud\ObjectStore\Resource\Container **/ }rQ…rR}rS(h:Uh;jKubahFhàubaubha)rT}rU(h:Xa[ `Get the executable PHP script for this example `__ ]h;j%hDhEhFhdhH}rV(hJ]hK]hL]hM]hP]uhRKmhShhT]rW(h]X[ rX…rY}rZ(h:X[ h;jTubj¨)r[}r\(h:X]`Get the executable PHP script for this example `__hH}r](UnameX.Get the executable PHP script for this examplejÝX(/samples/ObjectStore/list-containers.phphM]hL]hJ]hK]hP]uh;jThT]r^h]X.Get the executable PHP script for this exampler_…r`}ra(h:Uh;j[ubahFj±ubh]X ]rb…rc}rd(h:X ]h;jTubeubeubh<)re}rf(h:Uh;jGhDhEhFhGhH}rg(hJ]hK]hL]hM]rhU set-or-update-container-metadatariahP]rjh&auhRKqhShhT]rk(hV)rl}rm(h:X Set or Update Container Metadatarnh;jehDhEhFhZhH}ro(hJ]hK]hL]hM]hP]uhRKqhShhT]rph]X Set or Update Container Metadatarq…rr}rs(h:jnh;jlubaubha)rt}ru(h:X$You can set metadata on a container.rvh;jehDhEhFhdhH}rw(hJ]hK]hL]hM]hP]uhRKshShhT]rxh]X$You can set metadata on a container.ry…rz}r{(h:jvh;jtubaubhÌ)r|}r}(h:X>$container->saveMetadata(array( 'author' => 'John Doe' ));h;jehDhEhFháhH}r~(hÐhÑhM]hL]hJ]hK]r(hÓXphpr€ehP]uhRKzhShhT]rhÖ)r‚}rƒ(h:X>$container->saveMetadata(array( 'author' => 'John Doe' ));hH}r„(hJ]hK]r…Uotherr†ahL]hM]hP]uh;j|hT]r‡h]X>$container->saveMetadata(array( 'author' => 'John Doe' ));rˆ…r‰}rŠ(h:Uh;j‚ubahFhàubaubha)r‹}rŒ(h:Xh[ `Get the executable PHP script for this example `__ ]h;jehDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRK{hShhT]rŽ(h]X[ r…r}r‘(h:X[ h;j‹ubj¨)r’}r“(h:Xd`Get the executable PHP script for this example `__hH}r”(UnameX.Get the executable PHP script for this examplejÝX//samples/ObjectStore/set-container-metadata.phphM]hL]hJ]hK]hP]uh;j‹hT]r•h]X.Get the executable PHP script for this exampler–…r—}r˜(h:Uh;j’ubahFj±ubh]X ]r™…rš}r›(h:X ]h;j‹ubeubeubh<)rœ}r(h:Uh;jGhDhEhFhGhH}rž(hJ]hK]hL]hM]rŸUget-container-metadatar ahP]r¡hauhRKhShhT]r¢(hV)r£}r¤(h:XGet Container Metadatar¥h;jœhDhEhFhZhH}r¦(hJ]hK]hL]hM]hP]uhRKhShhT]r§h]XGet Container Metadatar¨…r©}rª(h:j¥h;j£ubaubha)r«}r¬(h:X.You can retrieve the metadata for a container.r­h;jœhDhEhFhdhH}r®(hJ]hK]hL]hM]hP]uhRKhShhT]r¯h]X.You can retrieve the metadata for a container.r°…r±}r²(h:j­h;j«ubaubhÌ)r³}r´(h:X/$containerMetadata = $container->getMetadata();h;jœhDhEhFháhH}rµ(hÐhÑhM]hL]hJ]hK]r¶(hÓXphpr·ehP]uhRK†hShhT]r¸hÖ)r¹}rº(h:X/$containerMetadata = $container->getMetadata();hH}r»(hJ]hK]r¼Uotherr½ahL]hM]hP]uh;j³hT]r¾h]X/$containerMetadata = $container->getMetadata();r¿…rÀ}rÁ(h:Uh;j¹ubahFhàubaubha)rÂ}rÃ(h:Xh[ `Get the executable PHP script for this example `__ ]h;jœhDhEhFhdhH}rÄ(hJ]hK]hL]hM]hP]uhRK‡hShhT]rÅ(h]X[ rÆ…rÇ}rÈ(h:X[ h;jÂubj¨)rÉ}rÊ(h:Xd`Get the executable PHP script for this example `__hH}rË(UnameX.Get the executable PHP script for this examplejÝX//samples/ObjectStore/get-container-metadata.phphM]hL]hJ]hK]hP]uh;jÂhT]rÌh]X.Get the executable PHP script for this examplerÍ…rÎ}rÏ(h:Uh;jÉubahFj±ubh]X ]rÐ…rÑ}rÒ(h:X ]h;jÂubeubeubh<)rÓ}rÔ(h:Uh;jGhDhEhFhGhH}rÕ(hJ]hK]hL]hM]rÖUdelete-containerr×ahP]rØhauhRK‹hShhT]rÙ(hV)rÚ}rÛ(h:XDelete ContainerrÜh;jÓhDhEhFhZhH}rÝ(hJ]hK]hL]hM]hP]uhRK‹hShhT]rÞh]XDelete Containerrß…rà}rá(h:jÜh;jÚubaubha)râ}rã(h:XDWhen you no longer have a need for the container, you can remove it.räh;jÓhDhEhFhdhH}rå(hJ]hK]hL]hM]hP]uhRKhShhT]ræh]XDWhen you no longer have a need for the container, you can remove it.rç…rè}ré(h:jäh;jâubaubha)rê}rë(h:X_If the container is empty (that is, it has no objects in it), you can remove it as shown below:rìh;jÓhDhEhFhdhH}rí(hJ]hK]hL]hM]hP]uhRKhShhT]rîh]X_If the container is empty (that is, it has no objects in it), you can remove it as shown below:rï…rð}rñ(h:jìh;jêubaubhÌ)rò}ró(h:X$container->delete();h;jÓhDhEhFháhH}rô(hÐhÑhM]hL]hJ]hK]rõ(hÓXphpröehP]uhRK•hShhT]r÷hÖ)rø}rù(h:X$container->delete();hH}rú(hJ]hK]rûUotherrüahL]hM]hP]uh;jòhT]rýh]X$container->delete();rþ…rÿ}r(h:Uh;jøubahFhàubaubha)r}r(h:Xb[ `Get the executable PHP script for this example `__ ]h;jÓhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRK–hShhT]r(h]X[ r…r}r(h:X[ h;jubj¨)r}r (h:X^`Get the executable PHP script for this example `__hH}r (UnameX.Get the executable PHP script for this examplejÝX)/samples/ObjectStore/delete-container.phphM]hL]hJ]hK]hP]uh;jhT]r h]X.Get the executable PHP script for this exampler …r }r(h:Uh;jubahFj±ubh]X ]r…r}r(h:X ]h;jubeubha)r}r(h:XhIf the container is not empty (that is, it has objects in it), you have two choices in how to remove it:rh;jÓhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRK™hShhT]rh]XhIf the container is not empty (that is, it has objects in it), you have two choices in how to remove it:r…r}r(h:jh;jubaubh®)r}r(h:Uh;jÓhDhEhFh±hH}r(h³X-hM]hL]hJ]hK]hP]uhRKœhShhT]r(hµ)r}r(h:X{`Individually remove each object <#delete-object>`__ in the container, then remove the container itself as shown above, or h;jhDhEhFh¸hH}r (hJ]hK]hL]hM]hP]uhRNhShhT]r!ha)r"}r#(h:Xz`Individually remove each object <#delete-object>`__ in the container, then remove the container itself as shown above, orh;jhDhEhFhdhH}r$(hJ]hK]hL]hM]hP]uhRKœhT]r%(j¨)r&}r'(h:X4`Individually remove each object <#delete-object>`__hH}r((UnameXIndividually remove each objectjÝX#delete-objecthM]hL]hJ]hK]hP]uh;j"hT]r)h]XIndividually remove each objectr*…r+}r,(h:Uh;j&ubahFj±ubh]XF in the container, then remove the container itself as shown above, orr-…r.}r/(h:XF in the container, then remove the container itself as shown above, orh;j"ubeubaubhµ)r0}r1(h:XßRemove the container and all the objects within it as shown below: .. code:: php $container->delete(true); [ `Get the executable PHP script for this example `__ ] h;jhDhEhFh¸hH}r2(hJ]hK]hL]hM]hP]uhRNhShhT]r3(ha)r4}r5(h:XBRemove the container and all the objects within it as shown below:r6h;j0hDhEhFhdhH}r7(hJ]hK]hL]hM]hP]uhRKŸhT]r8h]XBRemove the container and all the objects within it as shown below:r9…r:}r;(h:j6h;j4ubaubhÌ)r<}r=(h:X$container->delete(true);hH}r>(hÐhÑhM]hL]hJ]hK]r?(hÓXphpr@ehP]uh;j0hT]rAhÖ)rB}rC(h:X$container->delete(true);hH}rD(hJ]hK]rEUotherrFahL]hM]hP]uh;j<hT]rGh]X$container->delete(true);rH…rI}rJ(h:Uh;jBubahFhàubahFháubha)rK}rL(h:Xl[ `Get the executable PHP script for this example `__ ]h;j0hDhEhFhdhH}rM(hJ]hK]hL]hM]hP]uhRK¥hT]rN(h]X[ rO…rP}rQ(h:X[ h;jKubj¨)rR}rS(h:Xh`Get the executable PHP script for this example `__hH}rT(UnameX.Get the executable PHP script for this examplejÝX3/samples/ObjectStore/delete-container-recursive.phphM]hL]hJ]hK]hP]uh;jKhT]rUh]X.Get the executable PHP script for this examplerV…rW}rX(h:Uh;jRubahFj±ubh]X ]rY…rZ}r[(h:X ]h;jKubeubeubeubeubh<)r\}r](h:Uh?Kh;jGhDhEhFhGhH}r^(hJ]r_Xget object countr`ahK]hL]hM]raUget-object-countrbahP]uhRK©hShhT]rc(hV)rd}re(h:XGet Object Countrfh;j\hDhEhFhZhH}rg(hJ]hK]hL]hM]hP]uhRK©hShhT]rhh]XGet Object Countri…rj}rk(h:jfh;jdubaubha)rl}rm(h:X=You can quickly find out how many objects are in a container.rnh;j\hDhEhFhdhH}ro(hJ]hK]hL]hM]hP]uhRK«hShhT]rph]X=You can quickly find out how many objects are in a container.rq…rr}rs(h:jnh;jlubaubhÌ)rt}ru(h:X5$containerObjectCount = $container->getObjectCount();h;j\hDhEhFháhH}rv(hÐhÑhM]hL]hJ]hK]rw(hÓXphprxehP]uhRK°hShhT]ryhÖ)rz}r{(h:X5$containerObjectCount = $container->getObjectCount();hH}r|(hJ]hK]r}Uotherr~ahL]hM]hP]uh;jthT]rh]X5$containerObjectCount = $container->getObjectCount();r€…r}r‚(h:Uh;jzubahFhàubaubha)rƒ}r„(h:Xl[ `Get the executable PHP script for this example `__ ]h;j\hDhEhFhdhH}r…(hJ]hK]hL]hM]hP]uhRK±hShhT]r†(h]X[ r‡…rˆ}r‰(h:X[ h;jƒubj¨)rŠ}r‹(h:Xh`Get the executable PHP script for this example `__hH}rŒ(UnameX.Get the executable PHP script for this examplejÝX3/samples/ObjectStore/get-container-object-count.phphM]hL]hJ]hK]hP]uh;jƒhT]rh]X.Get the executable PHP script for this examplerŽ…r}r(h:Uh;jŠubahFj±ubh]X ]r‘…r’}r“(h:X ]h;jƒubeubha)r”}r•(h:X‚In the example above, ``$containerObjectCount`` will contain the number of objects in the container represented by ``$container``.h;j\hDhEhFhdhH}r–(hJ]hK]hL]hM]hP]uhRK´hShhT]r—(h]XIn the example above, r˜…r™}rš(h:XIn the example above, h;j”ubh˜)r›}rœ(h:X``$containerObjectCount``hH}r(hJ]hK]hL]hM]hP]uh;j”hT]ržh]X$containerObjectCountrŸ…r }r¡(h:Uh;j›ubahFh ubh]XD will contain the number of objects in the container represented by r¢…r£}r¤(h:XD will contain the number of objects in the container represented by h;j”ubh˜)r¥}r¦(h:X``$container``hH}r§(hJ]hK]hL]hM]hP]uh;j”hT]r¨h]X $containerr©…rª}r«(h:Uh;j¥ubahFh ubh]X.…r¬}r­(h:X.h;j”ubeubeubh<)r®}r¯(h:Uh?Kh;jGhDhEhFhGhH}r°(hJ]r±Xget bytes usedr²ahK]hL]hM]r³Uget-bytes-usedr´ahP]uhRK¸hShhT]rµ(hV)r¶}r·(h:XGet Bytes Usedr¸h;j®hDhEhFhZhH}r¹(hJ]hK]hL]hM]hP]uhRK¸hShhT]rºh]XGet Bytes Usedr»…r¼}r½(h:j¸h;j¶ubaubha)r¾}r¿(h:XAYou can quickly find out the space used by a container, in bytes.rÀh;j®hDhEhFhdhH}rÁ(hJ]hK]hL]hM]hP]uhRKºhShhT]rÂh]XAYou can quickly find out the space used by a container, in bytes.rÃ…rÄ}rÅ(h:jÀh;j¾ubaubhÌ)rÆ}rÇ(h:X3$containerSizeInBytes = $container->getBytesUsed();h;j®hDhEhFháhH}rÈ(hÐhÑhM]hL]hJ]hK]rÉ(hÓXphprÊehP]uhRK¿hShhT]rËhÖ)rÌ}rÍ(h:X3$containerSizeInBytes = $container->getBytesUsed();hH}rÎ(hJ]hK]rÏUotherrÐahL]hM]hP]uh;jÆhT]rÑh]X3$containerSizeInBytes = $container->getBytesUsed();rÒ…rÓ}rÔ(h:Uh;jÌubahFhàubaubha)rÕ}rÖ(h:Xj[ `Get the executable PHP script for this example `__ ]h;j®hDhEhFhdhH}r×(hJ]hK]hL]hM]hP]uhRKÀhShhT]rØ(h]X[ rÙ…rÚ}rÛ(h:X[ h;jÕubj¨)rÜ}rÝ(h:Xf`Get the executable PHP script for this example `__hH}rÞ(UnameX.Get the executable PHP script for this examplejÝX1/samples/ObjectStore/get-container-bytes-used.phphM]hL]hJ]hK]hP]uh;jÕhT]rßh]X.Get the executable PHP script for this examplerà…rá}râ(h:Uh;jÜubahFj±ubh]X ]rã…rä}rå(h:X ]h;jÕubeubha)ræ}rç(h:X†In the example above, ``$containerSizeInBytes`` will contain the space used, in bytes, by the container represented by ``$container``.h;j®hDhEhFhdhH}rè(hJ]hK]hL]hM]hP]uhRKÃhShhT]ré(h]XIn the example above, rê…rë}rì(h:XIn the example above, h;jæubh˜)rí}rî(h:X``$containerSizeInBytes``hH}rï(hJ]hK]hL]hM]hP]uh;jæhT]rðh]X$containerSizeInBytesrñ…rò}ró(h:Uh;jíubahFh ubh]XH will contain the space used, in bytes, by the container represented by rô…rõ}rö(h:XH will contain the space used, in bytes, by the container represented by h;jæubh˜)r÷}rø(h:X``$container``hH}rù(hJ]hK]hL]hM]hP]uh;jæhT]rúh]X $containerrû…rü}rý(h:Uh;j÷ubahFh ubh]X.…rþ}rÿ(h:X.h;jæubeubeubh<)r}r(h:Uh;jGhDhEhFhGhH}r(hJ]hK]hL]hM]rUcontainer-quotasrahP]rh1auhRKÇhShhT]r(hV)r}r(h:XContainer Quotasr h;jhDhEhFhZhH}r (hJ]hK]hL]hM]hP]uhRKÇhShhT]r h]XContainer Quotasr …r }r(h:j h;jubaubh<)r}r(h:Uh;jhDhEhFhGhH}r(hJ]hK]hL]hM]rUset-quota-for-number-of-objectsrahP]rh#auhRKÊhShhT]r(hV)r}r(h:XSet Quota for Number of Objectsrh;jhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRKÊhShhT]rh]XSet Quota for Number of Objectsr…r}r(h:jh;jubaubha)r}r(h:XXYou can set a quota for the maximum number of objects that may be stored in a container.r h;jhDhEhFhdhH}r!(hJ]hK]hL]hM]hP]uhRKÌhShhT]r"h]XXYou can set a quota for the maximum number of objects that may be stored in a container.r#…r$}r%(h:j h;jubaubhÌ)r&}r'(h:Xu$maximumNumberOfObjectsAllowedInContainer = 25; $container->setCountQuota($maximumNumberOfObjectsAllowedInContainer);h;jhDhEhFháhH}r((hÐhÑhM]hL]hJ]hK]r)(hÓXphpr*ehP]uhRKÓhShhT]r+hÖ)r,}r-(h:Xu$maximumNumberOfObjectsAllowedInContainer = 25; $container->setCountQuota($maximumNumberOfObjectsAllowedInContainer);hH}r.(hJ]hK]r/Uotherr0ahL]hM]hP]uh;j&hT]r1h]Xu$maximumNumberOfObjectsAllowedInContainer = 25; $container->setCountQuota($maximumNumberOfObjectsAllowedInContainer);r2…r3}r4(h:Uh;j,ubahFhàubaubha)r5}r6(h:Xk[ `Get the executable PHP script for this example `__ ]h;jhDhEhFhdhH}r7(hJ]hK]hL]hM]hP]uhRKÔhShhT]r8(h]X[ r9…r:}r;(h:X[ h;j5ubj¨)r<}r=(h:Xg`Get the executable PHP script for this example `__hH}r>(UnameX.Get the executable PHP script for this examplejÝX2/samples/ObjectStore/set-container-count-quota.phphM]hL]hJ]hK]hP]uh;j5hT]r?h]X.Get the executable PHP script for this exampler@…rA}rB(h:Uh;j<ubahFj±ubh]X ]rC…rD}rE(h:X ]h;j5ubeubeubh<)rF}rG(h:Uh;jhDhEhFhGhH}rH(hJ]hK]hL]hM]rIU#set-quota-for-total-size-of-objectsrJahP]rKh2auhRKØhShhT]rL(hV)rM}rN(h:X#Set Quota for Total Size of ObjectsrOh;jFhDhEhFhZhH}rP(hJ]hK]hL]hM]hP]uhRKØhShhT]rQh]X#Set Quota for Total Size of ObjectsrR…rS}rT(h:jOh;jMubaubha)rU}rV(h:XZYou can set a quota for the maximum total space (in bytes) used by objects in a container.rWh;jFhDhEhFhdhH}rX(hJ]hK]hL]hM]hP]uhRKÚhShhT]rYh]XZYou can set a quota for the maximum total space (in bytes) used by objects in a container.rZ…r[}r\(h:jWh;jUubaubhÌ)r]}r^(h:Xuse OpenCloud\Common\Constants\Size; $maximumTotalSizeOfObjectsInContainer = 5 * Size::GB; $container->setBytesQuota($maximumTotalSizeOfObjectsInContainer);h;jFhDhEhFháhH}r_(hÐhÑhM]hL]hJ]hK]r`(hÓXphpraehP]uhRKãhShhT]rbhÖ)rc}rd(h:Xuse OpenCloud\Common\Constants\Size; $maximumTotalSizeOfObjectsInContainer = 5 * Size::GB; $container->setBytesQuota($maximumTotalSizeOfObjectsInContainer);hH}re(hJ]hK]rfUotherrgahL]hM]hP]uh;j]hT]rhh]Xuse OpenCloud\Common\Constants\Size; $maximumTotalSizeOfObjectsInContainer = 5 * Size::GB; $container->setBytesQuota($maximumTotalSizeOfObjectsInContainer);ri…rj}rk(h:Uh;jcubahFhàubaubha)rl}rm(h:Xk[ `Get the executable PHP script for this example `__ ]h;jFhDhEhFhdhH}rn(hJ]hK]hL]hM]hP]uhRKähShhT]ro(h]X[ rp…rq}rr(h:X[ h;jlubj¨)rs}rt(h:Xg`Get the executable PHP script for this example `__hH}ru(UnameX.Get the executable PHP script for this examplejÝX2/samples/ObjectStore/set-container-bytes-quota.phphM]hL]hJ]hK]hP]uh;jlhT]rvh]X.Get the executable PHP script for this examplerw…rx}ry(h:Uh;jsubahFj±ubh]X ]rz…r{}r|(h:X ]h;jlubeubeubh<)r}}r~(h:Uh;jhDhEhFhGhH}r(hJ]hK]hL]hM]r€Uget-quota-for-number-of-objectsrahP]r‚hauhRKèhShhT]rƒ(hV)r„}r…(h:XGet Quota for Number of Objectsr†h;j}hDhEhFhZhH}r‡(hJ]hK]hL]hM]hP]uhRKèhShhT]rˆh]XGet Quota for Number of Objectsr‰…rŠ}r‹(h:j†h;j„ubaubha)rŒ}r(h:X_You can retrieve the quota for the maximum number of objects that may be stored in a container.rŽh;j}hDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRKêhShhT]rh]X_You can retrieve the quota for the maximum number of objects that may be stored in a container.r‘…r’}r“(h:jŽh;jŒubaubhÌ)r”}r•(h:XH$maximumNumberOfObjectsAllowedInContainer = $container->getCountQuota();h;j}hDhEhFháhH}r–(hÐhÑhM]hL]hJ]hK]r—(hÓXphpr˜ehP]uhRKðhShhT]r™hÖ)rš}r›(h:XH$maximumNumberOfObjectsAllowedInContainer = $container->getCountQuota();hH}rœ(hJ]hK]rUotherržahL]hM]hP]uh;j”hT]rŸh]XH$maximumNumberOfObjectsAllowedInContainer = $container->getCountQuota();r …r¡}r¢(h:Uh;jšubahFhàubaubha)r£}r¤(h:Xk[ `Get the executable PHP script for this example `__ ]h;j}hDhEhFhdhH}r¥(hJ]hK]hL]hM]hP]uhRKñhShhT]r¦(h]X[ r§…r¨}r©(h:X[ h;j£ubj¨)rª}r«(h:Xg`Get the executable PHP script for this example `__hH}r¬(UnameX.Get the executable PHP script for this examplejÝX2/samples/ObjectStore/get-container-count-quota.phphM]hL]hJ]hK]hP]uh;j£hT]r­h]X.Get the executable PHP script for this exampler®…r¯}r°(h:Uh;jªubahFj±ubh]X ]r±…r²}r³(h:X ]h;j£ubeubeubh<)r´}rµ(h:Uh;jhDhEhFhGhH}r¶(hJ]hK]hL]hM]r·U#get-quota-for-total-size-of-objectsr¸ahP]r¹hauhRKõhShhT]rº(hV)r»}r¼(h:X#Get Quota for Total Size of Objectsr½h;j´hDhEhFhZhH}r¾(hJ]hK]hL]hM]hP]uhRKõhShhT]r¿h]X#Get Quota for Total Size of ObjectsrÀ…rÁ}rÂ(h:j½h;j»ubaubha)rÃ}rÄ(h:XaYou can retrieve the quota for the maximum total space (in bytes) used by objects in a container.rÅh;j´hDhEhFhdhH}rÆ(hJ]hK]hL]hM]hP]uhRK÷hShhT]rÇh]XaYou can retrieve the quota for the maximum total space (in bytes) used by objects in a container.rÈ…rÉ}rÊ(h:jÅh;jÃubaubhÌ)rË}rÌ(h:XK$maximumTotalSizeOfObjectsAllowedInContainer = $container->getBytesQuota();h;j´hDhEhFháhH}rÍ(hÐhÑhM]hL]hJ]hK]rÎ(hÓXphprÏehP]uhRKýhShhT]rÐhÖ)rÑ}rÒ(h:XK$maximumTotalSizeOfObjectsAllowedInContainer = $container->getBytesQuota();hH}rÓ(hJ]hK]rÔUotherrÕahL]hM]hP]uh;jËhT]rÖh]XK$maximumTotalSizeOfObjectsAllowedInContainer = $container->getBytesQuota();r×…rØ}rÙ(h:Uh;jÑubahFhàubaubha)rÚ}rÛ(h:Xk[ `Get the executable PHP script for this example `__ ]h;j´hDhEhFhdhH}rÜ(hJ]hK]hL]hM]hP]uhRKþhShhT]rÝ(h]X[ rÞ…rß}rà(h:X[ h;jÚubj¨)rá}râ(h:Xg`Get the executable PHP script for this example `__hH}rã(UnameX.Get the executable PHP script for this examplejÝX2/samples/ObjectStore/get-container-bytes-quota.phphM]hL]hJ]hK]hP]uh;jÚhT]räh]X.Get the executable PHP script for this examplerå…ræ}rç(h:Uh;jáubahFj±ubh]X ]rè…ré}rê(h:X ]h;jÚubeubeubeubeubh<)rë}rì(h:Uh;hBhDhEhFhGhH}rí(hJ]hK]hL]hM]rîUobjectsrïahP]rðh"auhRMhShhT]rñ(hV)rò}ró(h:XObjectsrôh;jëhDhEhFhZhH}rõ(hJ]hK]hL]hM]hP]uhRMhShhT]röh]XObjectsr÷…rø}rù(h:jôh;jòubaubha)rú}rû(h:X•An **object** (sometimes referred to as a file) is the unit of storage in an Object Store. An object is a combination of content (data) and metadata.h;jëhDhEhFhdhH}rü(hJ]hK]hL]hM]hP]uhRMhShhT]rý(h]XAn rþ…rÿ}r(h:XAn h;júubhg)r}r(h:X **object**hH}r(hJ]hK]hL]hM]hP]uh;júhT]rh]Xobjectr…r}r(h:Uh;jubahFhoubh]Xˆ (sometimes referred to as a file) is the unit of storage in an Object Store. An object is a combination of content (data) and metadata.r…r }r (h:Xˆ (sometimes referred to as a file) is the unit of storage in an Object Store. An object is a combination of content (data) and metadata.h;júubeubha)r }r (h:XçFor example, you may upload an object named ``php-elephant.jpg``, a JPEG image file, to the ``logos`` container. Further, you may assign metadata to this object to indicate that the author of this object was someone named Jane Doe.h;jëhDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMhShhT]r(h]X,For example, you may upload an object named r…r}r(h:X,For example, you may upload an object named h;j ubh˜)r}r(h:X``php-elephant.jpg``hH}r(hJ]hK]hL]hM]hP]uh;j hT]rh]Xphp-elephant.jpgr…r}r(h:Uh;jubahFh ubh]X, a JPEG image file, to the r…r}r(h:X, a JPEG image file, to the h;j ubh˜)r}r(h:X ``logos``hH}r(hJ]hK]hL]hM]hP]uh;j hT]rh]Xlogosr …r!}r"(h:Uh;jubahFh ubh]X‚ container. Further, you may assign metadata to this object to indicate that the author of this object was someone named Jane Doe.r#…r$}r%(h:X‚ container. Further, you may assign metadata to this object to indicate that the author of this object was someone named Jane Doe.h;j ubeubjŠ)r&}r'(h:Uh;jëhDhEhFjhH}r((hJ]hK]hL]hM]hP]uhRNhShhT]r)ha)r*}r+(h:Xë**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`` `__ before passing them inh;j&hDhEhFhdhH}r,(hJ]hK]hL]hM]hP]uhRM hT]r-(hg)r.}r/(h:X **Note:**hH}r0(hJ]hK]hL]hM]hP]uh;j*hT]r1h]XNote:r2…r3}r4(h:Uh;j.ubahFhoubh]XŸ when working with names that contain non-standard alphanumerical characters (such as spaces or non-English characters), you must ensure they are encoded with r5…r6}r7(h:XŸ when working with names that contain non-standard alphanumerical characters (such as spaces or non-English characters), you must ensure they are encoded with h;j*ubh˜)r8}r9(h:X```urlencode``hH}r:(hJ]hK]hL]hM]hP]uh;j*hT]r;h]X `urlencoder<…r=}r>(h:Uh;j8ubahFh ubh]X `__ before passing them inrJ…rK}rL(h:X>`__ before passing them inh;j*ubeubaubh<)rM}rN(h:Uh;jëhDhEhFhGhH}rO(hJ]hK]hL]hM]rPU upload-objectrQahP]rRh/auhRMhShhT]rS(hV)rT}rU(h:X Upload ObjectrVh;jMhDhEhFhZhH}rW(hJ]hK]hL]hM]hP]uhRMhShhT]rXh]X Upload ObjectrY…rZ}r[(h:jVh;jTubaubha)r\}r](h:X@Once you have created a container, you can upload objects to it.r^h;jMhDhEhFhdhH}r_(hJ]hK]hL]hM]hP]uhRMhShhT]r`h]X@Once you have created a container, you can upload objects to it.ra…rb}rc(h:j^h;j\ubaubhÌ)rd}re(h:X¹$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);h;jMhDhEhFháhH}rf(hÐhÑhM]hL]hJ]hK]rg(hÓXphprhehP]uhRMhShhT]rihÖ)rj}rk(h:X¹$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);hH}rl(hJ]hK]rmUotherrnahL]hM]hP]uh;jdhT]roh]X¹$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);rp…rq}rr(h:Uh;jjubahFhàubaubha)rs}rt(h:X_[ `Get the executable PHP script for this example `__ ]h;jMhDhEhFhdhH}ru(hJ]hK]hL]hM]hP]uhRMhShhT]rv(h]X[ rw…rx}ry(h:X[ h;jsubj¨)rz}r{(h:X[`Get the executable PHP script for this example `__hH}r|(UnameX.Get the executable PHP script for this examplejÝX&/samples/ObjectStore/upload-object.phphM]hL]hJ]hK]hP]uh;jshT]r}h]X.Get the executable PHP script for this exampler~…r}r€(h:Uh;jzubahFj±ubh]X ]r…r‚}rƒ(h:X ]h;jsubeubha)r„}r…(h:X’In the example above, an image file from the local filesystem (``path/to/local/php-elephant.jpg``) is uploaded to a container in the Object Store.h;jMhDhEhFhdhH}r†(hJ]hK]hL]hM]hP]uhRM"hShhT]r‡(h]X?In the example above, an image file from the local filesystem (rˆ…r‰}rŠ(h:X?In the example above, an image file from the local filesystem (h;j„ubh˜)r‹}rŒ(h:X"``path/to/local/php-elephant.jpg``hH}r(hJ]hK]hL]hM]hP]uh;j„hT]rŽh]Xpath/to/local/php-elephant.jpgr…r}r‘(h:Uh;j‹ubahFh ubh]X1) is uploaded to a container in the Object Store.r’…r“}r”(h:X1) is uploaded to a container in the Object Store.h;j„ubeubha)r•}r–(h:X®Note that while we call ``fopen`` to open the file resource, we do not call ``fclose`` at the end. The file resource is automatically closed inside the ``uploadObject`` call.h;jMhDhEhFhdhH}r—(hJ]hK]hL]hM]hP]uhRM&hShhT]r˜(h]XNote that while we call r™…rš}r›(h:XNote that while we call h;j•ubh˜)rœ}r(h:X ``fopen``hH}rž(hJ]hK]hL]hM]hP]uh;j•hT]rŸh]Xfopenr …r¡}r¢(h:Uh;jœubahFh ubh]X+ to open the file resource, we do not call r£…r¤}r¥(h:X+ to open the file resource, we do not call h;j•ubh˜)r¦}r§(h:X ``fclose``hH}r¨(hJ]hK]hL]hM]hP]uh;j•hT]r©h]Xfcloserª…r«}r¬(h:Uh;j¦ubahFh ubh]XB at the end. The file resource is automatically closed inside the r­…r®}r¯(h:XB at the end. The file resource is automatically closed inside the h;j•ubh˜)r°}r±(h:X``uploadObject``hH}r²(hJ]hK]hL]hM]hP]uh;j•hT]r³h]X uploadObjectr´…rµ}r¶(h:Uh;j°ubahFh ubh]X call.r·…r¸}r¹(h:X call.h;j•ubeubha)rº}r»(h:XGIt is also possible to upload an object and associate metadata with it.r¼h;jMhDhEhFhdhH}r½(hJ]hK]hL]hM]hP]uhRM*hShhT]r¾h]XGIt is also possible to upload an object and associate metadata with it.r¿…rÀ}rÁ(h:j¼h;jºubaubhÌ)rÂ}rÃ(h:X¥use OpenCloud\ObjectStore\Resource\DataObject; $localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $metadata = array('author' => 'Jane Doe'); $customHeaders = array(); $metadataHeaders = DataObject::stockHeaders($metadata); $allHeaders = $customHeaders + $metadataHeaders; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData, $allHeaders);h;jMhDhEhFháhH}rÄ(hÐhÑhM]hL]hJ]hK]rÅ(hÓXphprÆehP]uhRM:hShhT]rÇhÖ)rÈ}rÉ(h:X¥use OpenCloud\ObjectStore\Resource\DataObject; $localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $metadata = array('author' => 'Jane Doe'); $customHeaders = array(); $metadataHeaders = DataObject::stockHeaders($metadata); $allHeaders = $customHeaders + $metadataHeaders; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData, $allHeaders);hH}rÊ(hJ]hK]rËUotherrÌahL]hM]hP]uh;jÂhT]rÍh]X¥use OpenCloud\ObjectStore\Resource\DataObject; $localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'php-elephant.jpg'; $metadata = array('author' => 'Jane Doe'); $customHeaders = array(); $metadataHeaders = DataObject::stockHeaders($metadata); $allHeaders = $customHeaders + $metadataHeaders; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData, $allHeaders);rÎ…rÏ}rÐ(h:Uh;jÈubahFhàubaubha)rÑ}rÒ(h:Xm[ `Get the executable PHP script for this example `__ ]h;jMhDhEhFhdhH}rÓ(hJ]hK]hL]hM]hP]uhRM;hShhT]rÔ(h]X[ rÕ…rÖ}r×(h:X[ h;jÑubj¨)rØ}rÙ(h:Xi`Get the executable PHP script for this example `__hH}rÚ(UnameX.Get the executable PHP script for this examplejÝX4/samples/ObjectStore/upload-object-with-metadata.phphM]hL]hJ]hK]hP]uh;jÑhT]rÛh]X.Get the executable PHP script for this examplerÜ…rÝ}rÞ(h:Uh;jØubahFj±ubh]X ]rß…rà}rá(h:X ]h;jÑubeubha)râ}rã(h:X®Note that while we call ``fopen`` to open the file resource, we do not call ``fclose`` at the end. The file resource is automatically closed inside the ``uploadObject`` call.h;jMhDhEhFhdhH}rä(hJ]hK]hL]hM]hP]uhRM>hShhT]rå(h]XNote that while we call ræ…rç}rè(h:XNote that while we call h;jâubh˜)ré}rê(h:X ``fopen``hH}rë(hJ]hK]hL]hM]hP]uh;jâhT]rìh]Xfopenrí…rî}rï(h:Uh;jéubahFh ubh]X+ to open the file resource, we do not call rð…rñ}rò(h:X+ to open the file resource, we do not call h;jâubh˜)ró}rô(h:X ``fclose``hH}rõ(hJ]hK]hL]hM]hP]uh;jâhT]röh]Xfcloser÷…rø}rù(h:Uh;jóubahFh ubh]XB at the end. The file resource is automatically closed inside the rú…rû}rü(h:XB at the end. The file resource is automatically closed inside the h;jâubh˜)rý}rþ(h:X``uploadObject``hH}rÿ(hJ]hK]hL]hM]hP]uh;jâhT]rh]X uploadObjectr…r}r(h:Uh;jýubahFh ubh]X call.r…r}r(h:X call.h;jâubeubh<)r}r(h:Uh;jMhDhEhFhGhH}r (hJ]hK]hL]hM]r Upseudo-hierarchical-foldersr ahP]r h.auhRMChShhT]r (hV)r}r(h:XPseudo-hierarchical Foldersrh;jhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRMChShhT]rh]XPseudo-hierarchical Foldersr…r}r(h:jh;jubaubha)r}r(h:X»Although you cannot nest directories in an Object Store, you can simulate a hierarchical structure within a single container by adding forward slash characters (``/``) in the object name.h;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMEhShhT]r(h]X¡Although you cannot nest directories in an Object Store, you can simulate a hierarchical structure within a single container by adding forward slash characters (r…r}r(h:X¡Although you cannot nest directories in an Object Store, you can simulate a hierarchical structure within a single container by adding forward slash characters (h;jubh˜)r}r(h:X``/``hH}r(hJ]hK]hL]hM]hP]uh;jhT]r h]X/…r!}r"(h:Uh;jubahFh ubh]X) in the object name.r#…r$}r%(h:X) in the object name.h;jubeubhÌ)r&}r'(h:XÃ$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'languages/php/elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);h;jhDhEhFháhH}r((hÐhÑhM]hL]hJ]hK]r)(hÓXphpr*ehP]uhRMPhShhT]r+hÖ)r,}r-(h:XÃ$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'languages/php/elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);hH}r.(hJ]hK]r/Uotherr0ahL]hM]hP]uh;j&hT]r1h]XÃ$localFileName = '/path/to/local/php-elephant.jpg'; $remoteFileName = 'languages/php/elephant.jpg'; $fileData = fopen($localFileName, 'r'); $container->uploadObject($remoteFileName, $fileData);r2…r3}r4(h:Uh;j,ubahFhàubaubha)r5}r6(h:Xm[ `Get the executable PHP script for this example `__ ]h;jhDhEhFhdhH}r7(hJ]hK]hL]hM]hP]uhRMQhShhT]r8(h]X[ r9…r:}r;(h:X[ h;j5ubj¨)r<}r=(h:Xi`Get the executable PHP script for this example `__hH}r>(UnameX.Get the executable PHP script for this examplejÝX4/samples/ObjectStore/pseudo-hierarchical-folders.phphM]hL]hJ]hK]hP]uh;j5hT]r?h]X.Get the executable PHP script for this exampler@…rA}rB(h:Uh;j<ubahFj±ubh]X ]rC…rD}rE(h:X ]h;j5ubeubha)rF}rG(h:XIn the example above, an image file from the local filesystem (``/path/to/local/php-elephant.jpg``) is uploaded to a container in the Object Store. Within that container, the filename is ``languages/php/elephant.jpg``, where ``languages/php/`` is a pseudo-hierarchical folder hierarchy.h;jhDhEhFhdhH}rH(hJ]hK]hL]hM]hP]uhRMThShhT]rI(h]X?In the example above, an image file from the local filesystem (rJ…rK}rL(h:X?In the example above, an image file from the local filesystem (h;jFubh˜)rM}rN(h:X#``/path/to/local/php-elephant.jpg``hH}rO(hJ]hK]hL]hM]hP]uh;jFhT]rPh]X/path/to/local/php-elephant.jpgrQ…rR}rS(h:Uh;jMubahFh ubh]XY) is uploaded to a container in the Object Store. Within that container, the filename is rT…rU}rV(h:XY) is uploaded to a container in the Object Store. Within that container, the filename is h;jFubh˜)rW}rX(h:X``languages/php/elephant.jpg``hH}rY(hJ]hK]hL]hM]hP]uh;jFhT]rZh]Xlanguages/php/elephant.jpgr[…r\}r](h:Uh;jWubahFh ubh]X, where r^…r_}r`(h:X, where h;jFubh˜)ra}rb(h:X``languages/php/``hH}rc(hJ]hK]hL]hM]hP]uh;jFhT]rdh]Xlanguages/php/re…rf}rg(h:Uh;jaubahFh ubh]X+ is a pseudo-hierarchical folder hierarchy.rh…ri}rj(h:X+ is a pseudo-hierarchical folder hierarchy.h;jFubeubha)rk}rl(h:X®Note that while we call ``fopen`` to open the file resource, we do not call ``fclose`` at the end. The file resource is automatically closed inside the ``uploadObject`` call.h;jhDhEhFhdhH}rm(hJ]hK]hL]hM]hP]uhRMZhShhT]rn(h]XNote that while we call ro…rp}rq(h:XNote that while we call h;jkubh˜)rr}rs(h:X ``fopen``hH}rt(hJ]hK]hL]hM]hP]uh;jkhT]ruh]Xfopenrv…rw}rx(h:Uh;jrubahFh ubh]X+ to open the file resource, we do not call ry…rz}r{(h:X+ to open the file resource, we do not call h;jkubh˜)r|}r}(h:X ``fclose``hH}r~(hJ]hK]hL]hM]hP]uh;jkhT]rh]Xfcloser€…r}r‚(h:Uh;j|ubahFh ubh]XB at the end. The file resource is automatically closed inside the rƒ…r„}r…(h:XB at the end. The file resource is automatically closed inside the h;jkubh˜)r†}r‡(h:X``uploadObject``hH}rˆ(hJ]hK]hL]hM]hP]uh;jkhT]r‰h]X uploadObjectrŠ…r‹}rŒ(h:Uh;j†ubahFh ubh]X call.r…rŽ}r(h:X call.h;jkubeubeubh<)r}r‘(h:Uh;jMhDhEhFhGhH}r’(hJ]hK]hL]hM]r“Uupload-multiple-objectsr”ahP]r•hauhRM_hShhT]r–(hV)r—}r˜(h:XUpload Multiple Objectsr™h;jhDhEhFhZhH}rš(hJ]hK]hL]hM]hP]uhRM_hShhT]r›h]XUpload Multiple Objectsrœ…r}rž(h:j™h;j—ubaubha)rŸ}r (h:X=You can upload more than one object at a time to a container.r¡h;jhDhEhFhdhH}r¢(hJ]hK]hL]hM]hP]uhRMahShhT]r£h]X=You can upload more than one object at a time to a container.r¤…r¥}r¦(h:j¡h;jŸubaubhÌ)r§}r¨(h:X$objects = array( array( 'name' => 'php-elephant.jpg', 'path' => '/path/to/local/php-elephant.jpg' ), array( 'name' => 'python-snake.jpg', 'path' => '/path/to/local/python-snake.jpg' ), a ); $container->uploadObjects($objects);h;jhDhEhFháhH}r©(hÐhÑhM]hL]hJ]hK]rª(hÓXphpr«ehP]uhRMrhShhT]r¬hÖ)r­}r®(h:X$objects = array( array( 'name' => 'php-elephant.jpg', 'path' => '/path/to/local/php-elephant.jpg' ), array( 'name' => 'python-snake.jpg', 'path' => '/path/to/local/python-snake.jpg' ), a ); $container->uploadObjects($objects);hH}r¯(hJ]hK]r°Uotherr±ahL]hM]hP]uh;j§hT]r²h]X$objects = array( array( 'name' => 'php-elephant.jpg', 'path' => '/path/to/local/php-elephant.jpg' ), array( 'name' => 'python-snake.jpg', 'path' => '/path/to/local/python-snake.jpg' ), a ); $container->uploadObjects($objects);r³…r´}rµ(h:Uh;j­ubahFhàubaubha)r¶}r·(h:Xi[ `Get the executable PHP script for this example `__ ]h;jhDhEhFhdhH}r¸(hJ]hK]hL]hM]hP]uhRMshShhT]r¹(h]X[ rº…r»}r¼(h:X[ h;j¶ubj¨)r½}r¾(h:Xe`Get the executable PHP script for this example `__hH}r¿(UnameX.Get the executable PHP script for this examplejÝX0/samples/ObjectStore/upload-multiple-objects.phphM]hL]hJ]hK]hP]uh;j¶hT]rÀh]X.Get the executable PHP script for this examplerÁ…rÂ}rÃ(h:Uh;j½ubahFj±ubh]X ]rÄ…rÅ}rÆ(h:X ]h;j¶ubeubha)rÇ}rÈ(h:X–In the above example, the contents of two files present on the local filesystem are uploaded as objects to the container referenced by ``$container``.h;jhDhEhFhdhH}rÉ(hJ]hK]hL]hM]hP]uhRMvhShhT]rÊ(h]X‡In the above example, the contents of two files present on the local filesystem are uploaded as objects to the container referenced by rË…rÌ}rÍ(h:X‡In the above example, the contents of two files present on the local filesystem are uploaded as objects to the container referenced by h;jÇubh˜)rÎ}rÏ(h:X``$container``hH}rÐ(hJ]hK]hL]hM]hP]uh;jÇhT]rÑh]X $containerrÒ…rÓ}rÔ(h:Uh;jÎubahFh ubh]X.…rÕ}rÖ(h:X.h;jÇubeubha)r×}rØ(h:X¢Instead of specifying the ``path`` key in an element of the ``$objects`` array, you can specify a ``body`` key whose value is a string or a stream representation.h;jhDhEhFhdhH}rÙ(hJ]hK]hL]hM]hP]uhRMzhShhT]rÚ(h]XInstead of specifying the rÛ…rÜ}rÝ(h:XInstead of specifying the h;j×ubh˜)rÞ}rß(h:X``path``hH}rà(hJ]hK]hL]hM]hP]uh;j×hT]ráh]Xpathrâ…rã}rä(h:Uh;jÞubahFh ubh]X key in an element of the rå…ræ}rç(h:X key in an element of the h;j×ubh˜)rè}ré(h:X ``$objects``hH}rê(hJ]hK]hL]hM]hP]uh;j×hT]rëh]X$objectsrì…rí}rî(h:Uh;jèubahFh ubh]X array, you can specify a rï…rð}rñ(h:X array, you can specify a h;j×ubh˜)rò}ró(h:X``body``hH}rô(hJ]hK]hL]hM]hP]uh;j×hT]rõh]Xbodyrö…r÷}rø(h:Uh;jòubahFh ubh]X8 key whose value is a string or a stream representation.rù…rú}rû(h:X8 key whose value is a string or a stream representation.h;j×ubeubha)rü}rý(h:X–Finally, you can pass headers as the second parameter to the ``uploadObjects`` method. These headers will be applied to every object that is uploaded.h;jhDhEhFhdhH}rþ(hJ]hK]hL]hM]hP]uhRM~hShhT]rÿ(h]X=Finally, you can pass headers as the second parameter to the r…r}r(h:X=Finally, you can pass headers as the second parameter to the h;jüubh˜)r}r(h:X``uploadObjects``hH}r(hJ]hK]hL]hM]hP]uh;jühT]rh]X uploadObjectsr…r}r (h:Uh;jubahFh ubh]XH method. These headers will be applied to every object that is uploaded.r …r }r (h:XH method. These headers will be applied to every object that is uploaded.h;jüubeubhÌ)r }r(h:Xá$metadata = array('author' => 'Jane Doe'); $customHeaders = array(); $metadataHeaders = DataObject::stockHeaders($metadata); $allHeaders = $customHeaders + $metadataHeaders; $container->uploadObjects($objects, $allHeaders);h;jhDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]hP]uhRM„hShhT]rh]Xá$metadata = array('author' => 'Jane Doe'); $customHeaders = array(); $metadataHeaders = DataObject::stockHeaders($metadata); $allHeaders = $customHeaders + $metadataHeaders; $container->uploadObjects($objects, $allHeaders);r…r}r(h:Uh;j ubaubha)r}r(h:Xw[ `Get the executable PHP script for this example `__ ]h;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMŒhShhT]r(h]X[ r…r}r(h:X[ h;jubj¨)r}r(h:Xs`Get the executable PHP script for this example `__hH}r(UnameX.Get the executable PHP script for this examplejÝX>/samples/ObjectStore/upload-multiple-objects-with-metadata.phphM]hL]hJ]hK]hP]uh;jhT]rh]X.Get the executable PHP script for this exampler…r }r!(h:Uh;jubahFj±ubh]X ]r"…r#}r$(h:X ]h;jubeubha)r%}r&(h:XtIn the example above, every object referenced within the ``$objects`` array will be uploaded with the same metadata.h;jhDhEhFhdhH}r'(hJ]hK]hL]hM]hP]uhRMhShhT]r((h]X9In the example above, every object referenced within the r)…r*}r+(h:X9In the example above, every object referenced within the h;j%ubh˜)r,}r-(h:X ``$objects``hH}r.(hJ]hK]hL]hM]hP]uh;j%hT]r/h]X$objectsr0…r1}r2(h:Uh;j,ubahFh ubh]X/ array will be uploaded with the same metadata.r3…r4}r5(h:X/ array will be uploaded with the same metadata.h;j%ubeubeubeubh<)r6}r7(h:Uh;jëhDhEhFhGhH}r8(hJ]hK]hL]hM]r9U large-objectsr:ahP]r;hauhRM”hShhT]r<(hV)r=}r>(h:X Large Objectsr?h;j6hDhEhFhZhH}r@(hJ]hK]hL]hM]hP]uhRM”hShhT]rAh]X Large ObjectsrB…rC}rD(h:j?h;j=ubaubha)rE}rF(h:X_If you want to upload objects larger than 5GB in size, you must use a different upload process.rGh;j6hDhEhFhdhH}rH(hJ]hK]hL]hM]hP]uhRM–hShhT]rIh]X_If you want to upload objects larger than 5GB in size, you must use a different upload process.rJ…rK}rL(h:jGh;jEubaubhÌ)rM}rN(h:XÙ$options = array( 'name' => 'san_diego_vacation_video.mp4', 'path' => '/path/to/local/videos/san_diego_vacation.mp4' ); $objectTransfer = $container->setupObjectTransfer($options); $objectTransfer->upload();h;j6hDhEhFháhH}rO(hÐhÑhM]hL]hJ]hK]rP(hÓXphprQehP]uhRM¡hShhT]rRhÖ)rS}rT(h:XÙ$options = array( 'name' => 'san_diego_vacation_video.mp4', 'path' => '/path/to/local/videos/san_diego_vacation.mp4' ); $objectTransfer = $container->setupObjectTransfer($options); $objectTransfer->upload();hH}rU(hJ]hK]rVUotherrWahL]hM]hP]uh;jMhT]rXh]XÙ$options = array( 'name' => 'san_diego_vacation_video.mp4', 'path' => '/path/to/local/videos/san_diego_vacation.mp4' ); $objectTransfer = $container->setupObjectTransfer($options); $objectTransfer->upload();rY…rZ}r[(h:Uh;jSubahFhàubaubha)r\}r](h:Xe[ `Get the executable PHP script for this example `__ ]h;j6hDhEhFhdhH}r^(hJ]hK]hL]hM]hP]uhRM¢hShhT]r_(h]X[ r`…ra}rb(h:X[ h;j\ubj¨)rc}rd(h:Xa`Get the executable PHP script for this example `__hH}re(UnameX.Get the executable PHP script for this examplejÝX,/samples/ObjectStore/upload-large-object.phphM]hL]hJ]hK]hP]uh;j\hT]rfh]X.Get the executable PHP script for this examplerg…rh}ri(h:Uh;jcubahFj±ubh]X ]rj…rk}rl(h:X ]h;j\ubeubha)rm}rn(h:X¥The process shown above will automatically partition your large object into small chunks and upload them concurrently to the container represented by ``$container``.h;j6hDhEhFhdhH}ro(hJ]hK]hL]hM]hP]uhRM¥hShhT]rp(h]X–The process shown above will automatically partition your large object into small chunks and upload them concurrently to the container represented by rq…rr}rs(h:X–The process shown above will automatically partition your large object into small chunks and upload them concurrently to the container represented by h;jmubh˜)rt}ru(h:X``$container``hH}rv(hJ]hK]hL]hM]hP]uh;jmhT]rwh]X $containerrx…ry}rz(h:Uh;jtubahFh ubh]X.…r{}r|(h:X.h;jmubeubha)r}}r~(h:X»You can tune the parameters of this process by specifying additional options in the ``$options`` array. Here is a complete listing of keys that can be specified in the ``$options`` array:h;j6hDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM©hShhT]r€(h]XTYou can tune the parameters of this process by specifying additional options in the r…r‚}rƒ(h:XTYou can tune the parameters of this process by specifying additional options in the h;j}ubh˜)r„}r…(h:X ``$options``hH}r†(hJ]hK]hL]hM]hP]uh;j}hT]r‡h]X$optionsrˆ…r‰}rŠ(h:Uh;j„ubahFh ubh]XH array. Here is a complete listing of keys that can be specified in the r‹…rŒ}r(h:XH array. Here is a complete listing of keys that can be specified in the h;j}ubh˜)rŽ}r(h:X ``$options``hH}r(hJ]hK]hL]hM]hP]uh;j}hT]r‘h]X$optionsr’…r“}r”(h:Uh;jŽubahFh ubh]X array:r•…r–}r—(h:X array:h;j}ubeubcdocutils.nodes table r˜)r™}rš(h:Uh;j6hDhEhFUtabler›hH}rœ(hJ]hK]hL]hM]hP]uhRNhShhT]rcdocutils.nodes tgroup rž)rŸ}r (h:UhH}r¡(hM]hL]hJ]hK]hP]UcolsKuh;j™hT]r¢(cdocutils.nodes colspec r£)r¤}r¥(h:UhH}r¦(hM]hL]hJ]hK]hP]UcolwidthKuh;jŸhT]hFUcolspecr§ubj£)r¨}r©(h:UhH}rª(hM]hL]hJ]hK]hP]UcolwidthM0uh;jŸhT]hFj§ubj£)r«}r¬(h:UhH}r­(hM]hL]hJ]hK]hP]UcolwidthK1uh;jŸhT]hFj§ubj£)r®}r¯(h:UhH}r°(hM]hL]hJ]hK]hP]UcolwidthK1uh;jŸhT]hFj§ubj£)r±}r²(h:UhH}r³(hM]hL]hJ]hK]hP]UcolwidthK2uh;jŸhT]hFj§ubj£)r´}rµ(h:UhH}r¶(hM]hL]hJ]hK]hP]UcolwidthK4uh;jŸhT]hFj§ubcdocutils.nodes thead r·)r¸}r¹(h:UhH}rº(hJ]hK]hL]hM]hP]uh;jŸhT]r»cdocutils.nodes row r¼)r½}r¾(h:UhH}r¿(hJ]hK]hL]hM]hP]uh;j¸hT]rÀ(cdocutils.nodes entry rÁ)rÂ}rÃ(h:UhH}rÄ(hJ]hK]hL]hM]hP]uh;j½hT]rÅha)rÆ}rÇ(h:XKey namerÈh;jÂhDhEhFhdhH}rÉ(hJ]hK]hL]hM]hP]uhRM®hT]rÊh]XKey namerË…rÌ}rÍ(h:jÈh;jÆubaubahFUentryrÎubjÁ)rÏ}rÐ(h:UhH}rÑ(hJ]hK]hL]hM]hP]uh;j½hT]rÒha)rÓ}rÔ(h:X DescriptionrÕh;jÏhDhEhFhdhH}rÖ(hJ]hK]hL]hM]hP]uhRM®hT]r×h]X DescriptionrØ…rÙ}rÚ(h:jÕh;jÓubaubahFjÎubjÁ)rÛ}rÜ(h:UhH}rÝ(hJ]hK]hL]hM]hP]uh;j½hT]rÞha)rß}rà(h:X Data Typeráh;jÛhDhEhFhdhH}râ(hJ]hK]hL]hM]hP]uhRM®hT]rãh]X Data Typerä…rå}ræ(h:jáh;jßubaubahFjÎubjÁ)rç}rè(h:UhH}ré(hJ]hK]hL]hM]hP]uh;j½hT]rêha)rë}rì(h:X Required?ríh;jçhDhEhFhdhH}rî(hJ]hK]hL]hM]hP]uhRM®hT]rïh]X Required?rð…rñ}rò(h:jíh;jëubaubahFjÎubjÁ)ró}rô(h:UhH}rõ(hJ]hK]hL]hM]hP]uh;j½hT]röha)r÷}rø(h:X Default Valuerùh;jóhDhEhFhdhH}rú(hJ]hK]hL]hM]hP]uhRM®hT]rûh]X Default Valuerü…rý}rþ(h:jùh;j÷ubaubahFjÎubjÁ)rÿ}r(h:UhH}r(hJ]hK]hL]hM]hP]uh;j½hT]rha)r}r(h:XExamplerh;jÿhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM®hT]rh]XExampler…r }r (h:jh;jubaubahFjÎubehFUrowr ubahFUtheadr ubcdocutils.nodes tbody r )r}r(h:UhH}r(hJ]hK]hL]hM]hP]uh;jŸhT]r(j¼)r}r(h:UhH}r(hJ]hK]hL]hM]hP]uh;jhT]r(jÁ)r}r(h:UhH}r(hJ]hK]hL]hM]hP]uh;jhT]rha)r}r(h:X``name``rh;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM°hT]rh˜)r}r (h:jhH}r!(hJ]hK]hL]hM]hP]uh;jhT]r"h]Xnamer#…r$}r%(h:Uh;jubahFh ubaubahFjÎubjÁ)r&}r'(h:UhH}r((hJ]hK]hL]hM]hP]uh;jhT]r)ha)r*}r+(h:X!Name of large object in containerr,h;j&hDhEhFhdhH}r-(hJ]hK]hL]hM]hP]uhRM°hT]r.h]X!Name of large object in containerr/…r0}r1(h:j,h;j*ubaubahFjÎubjÁ)r2}r3(h:UhH}r4(hJ]hK]hL]hM]hP]uh;jhT]r5ha)r6}r7(h:XStringr8h;j2hDhEhFhdhH}r9(hJ]hK]hL]hM]hP]uhRM°hT]r:h]XStringr;…r<}r=(h:j8h;j6ubaubahFjÎubjÁ)r>}r?(h:UhH}r@(hJ]hK]hL]hM]hP]uh;jhT]rAha)rB}rC(h:XYesrDh;j>hDhEhFhdhH}rE(hJ]hK]hL]hM]hP]uhRM°hT]rFh]XYesrG…rH}rI(h:jDh;jBubaubahFjÎubjÁ)rJ}rK(h:UhH}rL(hJ]hK]hL]hM]hP]uh;jhT]rMh®)rN}rO(h:UhH}rP(h³X-hM]hL]hJ]hK]hP]uh;jJhT]rQhµ)rR}rS(h:UhH}rT(hJ]hK]hL]hM]hP]uh;jNhT]hFh¸ubahFh±ubahFjÎubjÁ)rU}rV(h:UhH}rW(hJ]hK]hL]hM]hP]uh;jhT]rXha)rY}rZ(h:X ``san_diego_vacation_video.mp4``r[h;jUhDhEhFhdhH}r\(hJ]hK]hL]hM]hP]uhRM°hT]r]h˜)r^}r_(h:j[hH}r`(hJ]hK]hL]hM]hP]uh;jYhT]rah]Xsan_diego_vacation_video.mp4rb…rc}rd(h:Uh;j^ubahFh ubaubahFjÎubehFj ubj¼)re}rf(h:UhH}rg(hJ]hK]hL]hM]hP]uh;jhT]rh(jÁ)ri}rj(h:UhH}rk(hJ]hK]hL]hM]hP]uh;jehT]rlha)rm}rn(h:X``path``roh;jihDhEhFhdhH}rp(hJ]hK]hL]hM]hP]uhRM²hT]rqh˜)rr}rs(h:johH}rt(hJ]hK]hL]hM]hP]uh;jmhT]ruh]Xpathrv…rw}rx(h:Uh;jrubahFh ubaubahFjÎubjÁ)ry}rz(h:UhH}r{(hJ]hK]hL]hM]hP]uh;jehT]r|ha)r}}r~(h:X7Path to file containing object data on local filesystemrh;jyhDhEhFhdhH}r€(hJ]hK]hL]hM]hP]uhRM²hT]rh]X7Path to file containing object data on local filesystemr‚…rƒ}r„(h:jh;j}ubaubahFjÎubjÁ)r…}r†(h:UhH}r‡(hJ]hK]hL]hM]hP]uh;jehT]rˆha)r‰}rŠ(h:XStringr‹h;j…hDhEhFhdhH}rŒ(hJ]hK]hL]hM]hP]uhRM²hT]rh]XStringrŽ…r}r(h:j‹h;j‰ubaubahFjÎubjÁ)r‘}r’(h:UhH}r“(hJ]hK]hL]hM]hP]uh;jehT]r”ha)r•}r–(h:X-One of ``path`` or ``body`` must be specifiedh;j‘hDhEhFhdhH}r—(hJ]hK]hL]hM]hP]uhRM²hT]r˜(h]XOne of r™…rš}r›(h:XOne of h;j•ubh˜)rœ}r(h:X``path``hH}rž(hJ]hK]hL]hM]hP]uh;j•hT]rŸh]Xpathr …r¡}r¢(h:Uh;jœubahFh ubh]X or r£…r¤}r¥(h:X or h;j•ubh˜)r¦}r§(h:X``body``hH}r¨(hJ]hK]hL]hM]hP]uh;j•hT]r©h]Xbodyrª…r«}r¬(h:Uh;j¦ubahFh ubh]X must be specifiedr­…r®}r¯(h:X must be specifiedh;j•ubeubahFjÎubjÁ)r°}r±(h:UhH}r²(hJ]hK]hL]hM]hP]uh;jehT]r³h®)r´}rµ(h:UhH}r¶(h³X-hM]hL]hJ]hK]hP]uh;j°hT]r·hµ)r¸}r¹(h:UhH}rº(hJ]hK]hL]hM]hP]uh;j´hT]hFh¸ubahFh±ubahFjÎubjÁ)r»}r¼(h:UhH}r½(hJ]hK]hL]hM]hP]uh;jehT]r¾ha)r¿}rÀ(h:X0``/path/to/local/videos/san_diego_vacation.mp4``rÁh;j»hDhEhFhdhH}rÂ(hJ]hK]hL]hM]hP]uhRM²hT]rÃh˜)rÄ}rÅ(h:jÁhH}rÆ(hJ]hK]hL]hM]hP]uh;j¿hT]rÇh]X,/path/to/local/videos/san_diego_vacation.mp4rÈ…rÉ}rÊ(h:Uh;jÄubahFh ubaubahFjÎubehFj ubj¼)rË}rÌ(h:UhH}rÍ(hJ]hK]hL]hM]hP]uh;jhT]rÎ(jÁ)rÏ}rÐ(h:UhH}rÑ(hJ]hK]hL]hM]hP]uh;jËhT]rÒha)rÓ}rÔ(h:X``body``rÕh;jÏhDhEhFhdhH}rÖ(hJ]hK]hL]hM]hP]uhRM´hT]r×h˜)rØ}rÙ(h:jÕhH}rÚ(hJ]hK]hL]hM]hP]uh;jÓhT]rÛh]XbodyrÜ…rÝ}rÞ(h:Uh;jØubahFh ubaubahFjÎubjÁ)rß}rà(h:UhH}rá(hJ]hK]hL]hM]hP]uh;jËhT]râha)rã}rä(h:X.String or stream representation of object dataråh;jßhDhEhFhdhH}ræ(hJ]hK]hL]hM]hP]uhRM´hT]rçh]X.String or stream representation of object datarè…ré}rê(h:jåh;jãubaubahFjÎubjÁ)rë}rì(h:UhH}rí(hJ]hK]hL]hM]hP]uh;jËhT]rîha)rï}rð(h:XString \| Streamh;jëhDhEhFhdhH}rñ(hJ]hK]hL]hM]hP]uhRM´hT]ròh]XString | Streamró…rô}rõ(h:XString \| Streamh;jïubaubahFjÎubjÁ)rö}r÷(h:UhH}rø(hJ]hK]hL]hM]hP]uh;jËhT]rùha)rú}rû(h:X-One of ``path`` or ``body`` must be specifiedh;jöhDhEhFhdhH}rü(hJ]hK]hL]hM]hP]uhRM´hT]rý(h]XOne of rþ…rÿ}r (h:XOne of h;júubh˜)r }r (h:X``path``hH}r (hJ]hK]hL]hM]hP]uh;júhT]r h]Xpathr …r }r (h:Uh;j ubahFh ubh]X or r …r }r (h:X or h;júubh˜)r }r (h:X``body``hH}r (hJ]hK]hL]hM]hP]uh;júhT]r h]Xbodyr …r }r (h:Uh;j ubahFh ubh]X must be specifiedr …r }r (h:X must be specifiedh;júubeubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jËhT]r h®)r }r (h:UhH}r (h³X-hM]hL]hJ]hK]hP]uh;j hT]r hµ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;j hT]hFh¸ubahFh±ubahFjÎubjÁ)r }r! (h:UhH}r" (hJ]hK]hL]hM]hP]uh;jËhT]r# ha)r$ }r% (h:X``... lots of data ...``r& h;j hDhEhFhdhH}r' (hJ]hK]hL]hM]hP]uhRM´hT]r( h˜)r) }r* (h:j& hH}r+ (hJ]hK]hL]hM]hP]uh;j$ hT]r, h]X... lots of data ...r- …r. }r/ (h:Uh;j) ubahFh ubaubahFjÎubehFj ubj¼)r0 }r1 (h:UhH}r2 (hJ]hK]hL]hM]hP]uh;jhT]r3 (jÁ)r4 }r5 (h:UhH}r6 (hJ]hK]hL]hM]hP]uh;j0 hT]r7 ha)r8 }r9 (h:X ``metadata``r: h;j4 hDhEhFhdhH}r; (hJ]hK]hL]hM]hP]uhRM¶hT]r< h˜)r= }r> (h:j: hH}r? (hJ]hK]hL]hM]hP]uh;j8 hT]r@ h]XmetadatarA …rB }rC (h:Uh;j= ubahFh ubaubahFjÎubjÁ)rD }rE (h:UhH}rF (hJ]hK]hL]hM]hP]uh;j0 hT]rG ha)rH }rI (h:XMetadata for the objectrJ h;jD hDhEhFhdhH}rK (hJ]hK]hL]hM]hP]uhRM¶hT]rL h]XMetadata for the objectrM …rN }rO (h:jJ h;jH ubaubahFjÎubjÁ)rP }rQ (h:UhH}rR (hJ]hK]hL]hM]hP]uh;j0 hT]rS ha)rT }rU (h:X-Associative array of metadata key-value pairsrV h;jP hDhEhFhdhH}rW (hJ]hK]hL]hM]hP]uhRM¶hT]rX h]X-Associative array of metadata key-value pairsrY …rZ }r[ (h:jV h;jT ubaubahFjÎubjÁ)r\ }r] (h:UhH}r^ (hJ]hK]hL]hM]hP]uh;j0 hT]r_ ha)r` }ra (h:XNorb h;j\ hDhEhFhdhH}rc (hJ]hK]hL]hM]hP]uhRM¶hT]rd h]XNore …rf }rg (h:jb h;j` ubaubahFjÎubjÁ)rh }ri (h:UhH}rj (hJ]hK]hL]hM]hP]uh;j0 hT]rk ha)rl }rm (h:X ``array()``rn h;jh hDhEhFhdhH}ro (hJ]hK]hL]hM]hP]uhRM¶hT]rp h˜)rq }rr (h:jn hH}rs (hJ]hK]hL]hM]hP]uh;jl hT]rt h]Xarray()ru …rv }rw (h:Uh;jq ubahFh ubaubahFjÎubjÁ)rx }ry (h:UhH}rz (hJ]hK]hL]hM]hP]uh;j0 hT]r{ ha)r| }r} (h:X#``array( "Author" => "Jane Doe" )``r~ h;jx hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRM¶hT]r€ h˜)r }r‚ (h:j~ hH}rƒ (hJ]hK]hL]hM]hP]uh;j| hT]r„ h]Xarray( "Author" => "Jane Doe" )r… …r† }r‡ (h:Uh;j ubahFh ubaubahFjÎubehFj ubj¼)rˆ }r‰ (h:UhH}rŠ (hJ]hK]hL]hM]hP]uh;jhT]r‹ (jÁ)rŒ }r (h:UhH}rŽ (hJ]hK]hL]hM]hP]uh;jˆ hT]r ha)r }r‘ (h:X ``partSize``r’ h;jŒ hDhEhFhdhH}r“ (hJ]hK]hL]hM]hP]uhRM¸hT]r” h˜)r• }r– (h:j’ hH}r— (hJ]hK]hL]hM]hP]uh;j hT]r˜ h]XpartSizer™ …rš }r› (h:Uh;j• ubahFh ubaubahFjÎubjÁ)rœ }r (h:UhH}rž (hJ]hK]hL]hM]hP]uh;jˆ hT]rŸ ha)r  }r¡ (h:X^The size, in bytes, of each chunk that the large object is partitioned into prior to uploadingr¢ h;jœ hDhEhFhdhH}r£ (hJ]hK]hL]hM]hP]uhRM¸hT]r¤ h]X^The size, in bytes, of each chunk that the large object is partitioned into prior to uploadingr¥ …r¦ }r§ (h:j¢ h;j  ubaubahFjÎubjÁ)r¨ }r© (h:UhH}rª (hJ]hK]hL]hM]hP]uh;jˆ hT]r« ha)r¬ }r­ (h:XIntegerr® h;j¨ hDhEhFhdhH}r¯ (hJ]hK]hL]hM]hP]uhRM¸hT]r° h]XIntegerr± …r² }r³ (h:j® h;j¬ ubaubahFjÎubjÁ)r´ }rµ (h:UhH}r¶ (hJ]hK]hL]hM]hP]uh;jˆ hT]r· ha)r¸ }r¹ (h:XNorº h;j´ hDhEhFhdhH}r» (hJ]hK]hL]hM]hP]uhRM¸hT]r¼ h]XNor½ …r¾ }r¿ (h:jº h;j¸ ubaubahFjÎubjÁ)rÀ }rÁ (h:UhH}r (hJ]hK]hL]hM]hP]uh;jˆ hT]rà ha)rÄ }rÅ (h:X``1073741824`` (1GB)h;jÀ hDhEhFhdhH}rÆ (hJ]hK]hL]hM]hP]uhRM¸hT]rÇ (h˜)rÈ }rÉ (h:X``1073741824``hH}rÊ (hJ]hK]hL]hM]hP]uh;jÄ hT]rË h]X 1073741824rÌ …rÍ }rÎ (h:Uh;jÈ ubahFh ubh]X (1GB)rÏ …rÐ }rÑ (h:X (1GB)h;jÄ ubeubahFjÎubjÁ)rÒ }rÓ (h:UhH}rÔ (hJ]hK]hL]hM]hP]uh;jˆ hT]rÕ ha)rÖ }r× (h:X``52428800`` (50MB)h;jÒ hDhEhFhdhH}rØ (hJ]hK]hL]hM]hP]uhRM¸hT]rÙ (h˜)rÚ }rÛ (h:X ``52428800``hH}rÜ (hJ]hK]hL]hM]hP]uh;jÖ hT]rÝ h]X52428800rÞ …rß }rà (h:Uh;jÚ ubahFh ubh]X (50MB)rá …râ }rã (h:X (50MB)h;jÖ ubeubahFjÎubehFj ubj¼)rä }rå (h:UhH}ræ (hJ]hK]hL]hM]hP]uh;jhT]rç (jÁ)rè }ré (h:UhH}rê (hJ]hK]hL]hM]hP]uh;jä hT]rë ha)rì }rí (h:X``concurrency``rî h;jè hDhEhFhdhH}rï (hJ]hK]hL]hM]hP]uhRMºhT]rð h˜)rñ }rò (h:jî hH}ró (hJ]hK]hL]hM]hP]uh;jì hT]rô h]X concurrencyrõ …rö }r÷ (h:Uh;jñ ubahFh ubaubahFjÎubjÁ)rø }rù (h:UhH}rú (hJ]hK]hL]hM]hP]uh;jä hT]rû ha)rü }rý (h:XCThe number of concurrent transfers to execute as part of the uploadrþ h;jø hDhEhFhdhH}rÿ (hJ]hK]hL]hM]hP]uhRMºhT]r h]XCThe number of concurrent transfers to execute as part of the uploadr …r }r (h:jþ h;jü ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jä hT]r ha)r }r (h:XIntegerr h;j hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMºhT]r h]XIntegerr …r }r (h:j h;j ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jä hT]r ha)r }r (h:XNor h;j hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMºhT]r h]XNor …r }r (h:j h;j ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jä hT]r ha)r }r! (h:X.``1`` (no concurrency; upload chunks serially)h;j hDhEhFhdhH}r" (hJ]hK]hL]hM]hP]uhRMºhT]r# (h˜)r$ }r% (h:X``1``hH}r& (hJ]hK]hL]hM]hP]uh;j hT]r' h]X1…r( }r) (h:Uh;j$ ubahFh ubh]X) (no concurrency; upload chunks serially)r* …r+ }r, (h:X) (no concurrency; upload chunks serially)h;j ubeubahFjÎubjÁ)r- }r. (h:UhH}r/ (hJ]hK]hL]hM]hP]uh;jä hT]r0 ha)r1 }r2 (h:X``10``r3 h;j- hDhEhFhdhH}r4 (hJ]hK]hL]hM]hP]uhRMºhT]r5 h˜)r6 }r7 (h:j3 hH}r8 (hJ]hK]hL]hM]hP]uh;j1 hT]r9 h]X10r: …r; }r< (h:Uh;j6 ubahFh ubaubahFjÎubehFj ubj¼)r= }r> (h:UhH}r? (hJ]hK]hL]hM]hP]uh;jhT]r@ (jÁ)rA }rB (h:UhH}rC (hJ]hK]hL]hM]hP]uh;j= hT]rD ha)rE }rF (h:X ``progress``rG h;jA hDhEhFhdhH}rH (hJ]hK]hL]hM]hP]uhRM¼hT]rI h˜)rJ }rK (h:jG hH}rL (hJ]hK]hL]hM]hP]uh;jE hT]rM h]XprogressrN …rO }rP (h:Uh;jJ ubahFh ubaubahFjÎubjÁ)rQ }rR (h:UhH}rS (hJ]hK]hL]hM]hP]uh;j= hT]rT ha)rU }rV (h:X,A `callable function or method `__ which is called to report progress of the the upload. See ```CURLOPT_PROGRESSFUNCTION`` documentation `__ for details on parameters passed to this callable function or method.h;jQ hDhEhFhdhH}rW (hJ]hK]hL]hM]hP]uhRM¼hT]rX (h]XA rY …rZ }r[ (h:XA h;jU ubj¨)r\ }r] (h:XZ`callable function or method `__hH}r^ (UnameXcallable function or methodjÝX8http://us1.php.net/manual/en/language.types.callable.phphM]hL]hJ]hK]hP]uh;jU hT]r_ h]Xcallable function or methodr` …ra }rb (h:Uh;j\ ubahFj±ubh]X; which is called to report progress of the the upload. See rc …rd }re (h:X; which is called to report progress of the the upload. See h;jU ubh˜)rf }rg (h:X```CURLOPT_PROGRESSFUNCTION``hH}rh (hJ]hK]hL]hM]hP]uh;jU hT]ri h]X`CURLOPT_PROGRESSFUNCTIONrj …rk }rl (h:Uh;jf ubahFh ubh]X documentation `__ for details on parameters passed to this callable function or method.rx …ry }rz (h:XJ>`__ for details on parameters passed to this callable function or method.h;jU ubeubahFjÎubjÁ)r{ }r| (h:UhH}r} (hJ]hK]hL]hM]hP]uh;j= hT]r~ ha)r }r€ (h:X)String (callable function or method name)r h;j{ hDhEhFhdhH}r‚ (hJ]hK]hL]hM]hP]uhRM¼hT]rƒ h]X)String (callable function or method name)r„ …r… }r† (h:j h;j ubaubahFjÎubjÁ)r‡ }rˆ (h:UhH}r‰ (hJ]hK]hL]hM]hP]uh;j= hT]rŠ ha)r‹ }rŒ (h:XNor h;j‡ hDhEhFhdhH}rŽ (hJ]hK]hL]hM]hP]uhRM¼hT]r h]XNor …r‘ }r’ (h:j h;j‹ ubaubahFjÎubjÁ)r“ }r” (h:UhH}r• (hJ]hK]hL]hM]hP]uh;j= hT]r– ha)r— }r˜ (h:XNoner™ h;j“ hDhEhFhdhH}rš (hJ]hK]hL]hM]hP]uhRM¼hT]r› h]XNonerœ …r }rž (h:j™ h;j— ubaubahFjÎubjÁ)rŸ }r  (h:UhH}r¡ (hJ]hK]hL]hM]hP]uh;j= hT]r¢ ha)r£ }r¤ (h:X``reportProgress``r¥ h;jŸ hDhEhFhdhH}r¦ (hJ]hK]hL]hM]hP]uhRM¼hT]r§ h˜)r¨ }r© (h:j¥ hH}rª (hJ]hK]hL]hM]hP]uh;j£ hT]r« h]XreportProgressr¬ …r­ }r® (h:Uh;j¨ ubahFh ubaubahFjÎubehFj ubehFUtbodyr¯ ubehFUtgroupr° ubaubeubh<)r± }r² (h:Uh;jëhDhEhFhGhH}r³ (hJ]hK]hL]hM]r´ Uauto-extract-archive-filesrµ ahP]r¶ hauhRMÀhShhT]r· (hV)r¸ }r¹ (h:XAuto-extract Archive Filesrº h;j± hDhEhFhZhH}r» (hJ]hK]hL]hM]hP]uhRMÀhShhT]r¼ h]XAuto-extract Archive Filesr½ …r¾ }r¿ (h:jº h;j¸ ubaubha)rÀ }rÁ (h:XnYou can upload a tar archive file and have the Object Store service automatically extract it into a container.r h;j± hDhEhFhdhH}rà (hJ]hK]hL]hM]hP]uhRMÂhShhT]rÄ h]XnYou can upload a tar archive file and have the Object Store service automatically extract it into a container.rÅ …rÆ }rÇ (h:j h;jÀ ubaubhÌ)rÈ }rÉ (h:Xÿuse OpenCloud\ObjectStore\Constants\UrlType; $localArchiveFileName = '/path/to/local/image_files.tar.gz'; $remotePath = 'images/'; $fileData = fopen($localArchiveFileName, 'r'); $objectStoreService->bulkExtract($remotePath, $fileData, UrlType::TAR_GZ);h;j± hDhEhFháhH}rÊ (hÐhÑhM]hL]hJ]hK]rË (hÓXphprÌ ehP]uhRMÎhShhT]rÍ hÖ)rÎ }rÏ (h:Xÿuse OpenCloud\ObjectStore\Constants\UrlType; $localArchiveFileName = '/path/to/local/image_files.tar.gz'; $remotePath = 'images/'; $fileData = fopen($localArchiveFileName, 'r'); $objectStoreService->bulkExtract($remotePath, $fileData, UrlType::TAR_GZ);hH}rÐ (hJ]hK]rÑ UotherrÒ ahL]hM]hP]uh;jÈ hT]rÓ h]Xÿuse OpenCloud\ObjectStore\Constants\UrlType; $localArchiveFileName = '/path/to/local/image_files.tar.gz'; $remotePath = 'images/'; $fileData = fopen($localArchiveFileName, 'r'); $objectStoreService->bulkExtract($remotePath, $fileData, UrlType::TAR_GZ);rÔ …rÕ }rÖ (h:Uh;jÎ ubahFhàubaubha)r× }rØ (h:Xl[ `Get the executable PHP script for this example `__ ]h;j± hDhEhFhdhH}rÙ (hJ]hK]hL]hM]hP]uhRMÏhShhT]rÚ (h]X[ rÛ …rÜ }rÝ (h:X[ h;j× ubj¨)rÞ }rß (h:Xh`Get the executable PHP script for this example `__hH}rà (UnameX.Get the executable PHP script for this examplejÝX3/samples/ObjectStore/auto-extract-archive-files.phphM]hL]hJ]hK]hP]uh;j× hT]rá h]X.Get the executable PHP script for this examplerâ …rã }rä (h:Uh;jÞ ubahFj±ubh]X ]rå …ræ }rç (h:X ]h;j× ubeubha)rè }ré (h:X¬In the above example, a local archive file named ``image_files.tar.gz`` is uploaded to an Object Store container named ``images`` (defined by the ``$remotePath`` variable).h;j± hDhEhFhdhH}rê (hJ]hK]hL]hM]hP]uhRMÒhShhT]rë (h]X1In the above example, a local archive file named rì …rí }rî (h:X1In the above example, a local archive file named h;jè ubh˜)rï }rð (h:X``image_files.tar.gz``hH}rñ (hJ]hK]hL]hM]hP]uh;jè hT]rò h]Ximage_files.tar.gzró …rô }rõ (h:Uh;jï ubahFh ubh]X0 is uploaded to an Object Store container named rö …r÷ }rø (h:X0 is uploaded to an Object Store container named h;jè ubh˜)rù }rú (h:X ``images``hH}rû (hJ]hK]hL]hM]hP]uh;jè hT]rü h]Ximagesrý …rþ }rÿ (h:Uh;jù ubahFh ubh]X (defined by the r …r }r (h:X (defined by the h;jè ubh˜)r }r (h:X``$remotePath``hH}r (hJ]hK]hL]hM]hP]uh;jè hT]r h]X $remotePathr …r }r (h:Uh;j ubahFh ubh]X variable).r …r }r (h:X variable).h;jè ubeubha)r }r (h:X«Note that while we call ``fopen`` to open a file resource, we do not call ``fclose`` at the end. The file resource is automatically closed inside the ``bulkExtract`` call.h;j± hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMÖhShhT]r (h]XNote that while we call r …r }r (h:XNote that while we call h;j ubh˜)r }r (h:X ``fopen``hH}r (hJ]hK]hL]hM]hP]uh;j hT]r h]Xfopenr …r }r (h:Uh;j ubahFh ubh]X) to open a file resource, we do not call r …r }r (h:X) to open a file resource, we do not call h;j ubh˜)r }r (h:X ``fclose``hH}r (hJ]hK]hL]hM]hP]uh;j hT]r! h]Xfcloser" …r# }r$ (h:Uh;j ubahFh ubh]XB at the end. The file resource is automatically closed inside the r% …r& }r' (h:XB at the end. The file resource is automatically closed inside the h;j ubh˜)r( }r) (h:X``bulkExtract``hH}r* (hJ]hK]hL]hM]hP]uh;j hT]r+ h]X bulkExtractr, …r- }r. (h:Uh;j( ubahFh ubh]X call.r/ …r0 }r1 (h:X call.h;j ubeubha)r2 }r3 (h:XzThe third parameter to ``bulkExtract`` is the type of the archive file being uploaded. The acceptable values for this are:h;j± hDhEhFhdhH}r4 (hJ]hK]hL]hM]hP]uhRMÚhShhT]r5 (h]XThe third parameter to r6 …r7 }r8 (h:XThe third parameter to h;j2 ubh˜)r9 }r: (h:X``bulkExtract``hH}r; (hJ]hK]hL]hM]hP]uh;j2 hT]r< h]X bulkExtractr= …r> }r? (h:Uh;j9 ubahFh ubh]XT is the type of the archive file being uploaded. The acceptable values for this are:r@ …rA }rB (h:XT is the type of the archive file being uploaded. The acceptable values for this are:h;j2 ubeubh®)rC }rD (h:Uh;j± hDhEhFh±hH}rE (h³X-hM]hL]hJ]hK]hP]uhRMÝhShhT]rF (hµ)rG }rH (h:X-``UrlType::TAR`` for tar archive files, *or*,rI h;jC hDhEhFh¸hH}rJ (hJ]hK]hL]hM]hP]uhRNhShhT]rK ha)rL }rM (h:jI h;jG hDhEhFhdhH}rN (hJ]hK]hL]hM]hP]uhRMÝhT]rO (h˜)rP }rQ (h:X``UrlType::TAR``hH}rR (hJ]hK]hL]hM]hP]uh;jL hT]rS h]X UrlType::TARrT …rU }rV (h:Uh;jP ubahFh ubh]X for tar archive files, rW …rX }rY (h:X for tar archive files, h;jL ubcdocutils.nodes emphasis rZ )r[ }r\ (h:X*or*hH}r] (hJ]hK]hL]hM]hP]uh;jL hT]r^ h]Xorr_ …r` }ra (h:Uh;j[ ubahFUemphasisrb ubh]X,…rc }rd (h:X,h;jL ubeubaubhµ)re }rf (h:XL``UrlType:TAR_GZ`` for tar archive files that are compressed with gzip, *or*h;jC hDhEhFh¸hH}rg (hJ]hK]hL]hM]hP]uhRNhShhT]rh ha)ri }rj (h:XL``UrlType:TAR_GZ`` for tar archive files that are compressed with gzip, *or*h;je hDhEhFhdhH}rk (hJ]hK]hL]hM]hP]uhRMÞhT]rl (h˜)rm }rn (h:X``UrlType:TAR_GZ``hH}ro (hJ]hK]hL]hM]hP]uh;ji hT]rp h]XUrlType:TAR_GZrq …rr }rs (h:Uh;jm ubahFh ubh]X6 for tar archive files that are compressed with gzip, rt …ru }rv (h:X6 for tar archive files that are compressed with gzip, h;ji ubjZ )rw }rx (h:X*or*hH}ry (hJ]hK]hL]hM]hP]uh;ji hT]rz h]Xorr{ …r| }r} (h:Uh;jw ubahFjb ubeubaubhµ)r~ }r (h:XG``UrlType::TAR_BZ`` for tar archive file that are compressed with bzip h;jC hDhEhFh¸hH}r€ (hJ]hK]hL]hM]hP]uhRNhShhT]r ha)r‚ }rƒ (h:XF``UrlType::TAR_BZ`` for tar archive file that are compressed with bziph;j~ hDhEhFhdhH}r„ (hJ]hK]hL]hM]hP]uhRMàhT]r… (h˜)r† }r‡ (h:X``UrlType::TAR_BZ``hH}rˆ (hJ]hK]hL]hM]hP]uh;j‚ hT]r‰ h]XUrlType::TAR_BZrŠ …r‹ }rŒ (h:Uh;j† ubahFh ubh]X3 for tar archive file that are compressed with bzipr …rŽ }r (h:X3 for tar archive file that are compressed with bziph;j‚ ubeubaubeubha)r }r‘ (h:X”Note that the value of ``$remotePath`` could have been a (pseudo-hierarchical folder)[#pseudo-hierarchical-folders] such as ``images/blog`` as well.h;j± hDhEhFhdhH}r’ (hJ]hK]hL]hM]hP]uhRMãhShhT]r“ (h]XNote that the value of r” …r• }r– (h:XNote that the value of h;j ubh˜)r— }r˜ (h:X``$remotePath``hH}r™ (hJ]hK]hL]hM]hP]uh;j hT]rš h]X $remotePathr› …rœ }r (h:Uh;j— ubahFh ubh]XV could have been a (pseudo-hierarchical folder)[#pseudo-hierarchical-folders] such as rž …rŸ }r  (h:XV could have been a (pseudo-hierarchical folder)[#pseudo-hierarchical-folders] such as h;j ubh˜)r¡ }r¢ (h:X``images/blog``hH}r£ (hJ]hK]hL]hM]hP]uh;j hT]r¤ h]X images/blogr¥ …r¦ }r§ (h:Uh;j¡ ubahFh ubh]X as well.r¨ …r© }rª (h:X as well.h;j ubeubeubh<)r« }r¬ (h:Uh;jëhDhEhFhGhH}r­ (hJ]hK]hL]hM]r® Ulist-objects-in-a-containerr¯ ahP]r° h)auhRMèhShhT]r± (hV)r² }r³ (h:XList Objects in a Containerr´ h;j« hDhEhFhZhH}rµ (hJ]hK]hL]hM]hP]uhRMèhShhT]r¶ h]XList Objects in a Containerr· …r¸ }r¹ (h:j´ h;j² ubaubha)rº }r» (h:XYou can list all the objects stored in a container. An instance of ``OpenCloud\Common\Collection\PaginatedIterator`` is returned.h;j« hDhEhFhdhH}r¼ (hJ]hK]hL]hM]hP]uhRMêhShhT]r½ (h]XCYou can list all the objects stored in a container. An instance of r¾ …r¿ }rÀ (h:XCYou can list all the objects stored in a container. An instance of h;jº ubh˜)rÁ }r (h:X1``OpenCloud\Common\Collection\PaginatedIterator``hH}rà (hJ]hK]hL]hM]hP]uh;jº hT]rÄ h]X-OpenCloud\Common\Collection\PaginatedIteratorrÅ …rÆ }rÇ (h:Uh;jÁ ubahFh ubh]X is returned.rÈ …rÉ }rÊ (h:X is returned.h;jº ubeubhÌ)rË }rÌ (h:XŠ$objects = $container->objectList(); foreach ($objects as $object) { /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ }h;j« hDhEhFháhH}rÍ (hÐhÑhM]hL]hJ]hK]rÎ (hÓXphprÏ ehP]uhRMóhShhT]rÐ hÖ)rÑ }rÒ (h:XŠ$objects = $container->objectList(); foreach ($objects as $object) { /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ }hH}rÓ (hJ]hK]rÔ UotherrÕ ahL]hM]hP]uh;jË hT]rÖ h]XŠ$objects = $container->objectList(); foreach ($objects as $object) { /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ }r× …rØ }rÙ (h:Uh;jÑ ubahFhàubaubha)rÚ }rÛ (h:X^[ `Get the executable PHP script for this example `__ ]h;j« hDhEhFhdhH}rÜ (hJ]hK]hL]hM]hP]uhRMôhShhT]rÝ (h]X[ rÞ …rß }rà (h:X[ h;jÚ ubj¨)rá }râ (h:XZ`Get the executable PHP script for this example `__hH}rã (UnameX.Get the executable PHP script for this examplejÝX%/samples/ObjectStore/list-objects.phphM]hL]hJ]hK]hP]uh;jÚ hT]rä h]X.Get the executable PHP script for this examplerå …ræ }rç (h:Uh;já ubahFj±ubh]X ]rè …ré }rê (h:X ]h;jÚ ubeubha)rë }rì (h:XYYou can list only those objects in the container whose names start with a certain prefix.rí h;j« hDhEhFhdhH}rî (hJ]hK]hL]hM]hP]uhRM÷hShhT]rï h]XYYou can list only those objects in the container whose names start with a certain prefix.rð …rñ }rò (h:jí h;jë ubaubhÌ)ró }rô (h:XX$options = array( 'prefix' => 'php' ); $objects = $container->objectList($options);h;j« hDhEhFháhH}rõ (hÐhÑhM]hL]hJ]hK]rö (hÓXphpr÷ ehP]uhRMhShhT]rø hÖ)rù }rú (h:XX$options = array( 'prefix' => 'php' ); $objects = $container->objectList($options);hH}rû (hJ]hK]rü Uotherrý ahL]hM]hP]uh;jó hT]rþ h]XX$options = array( 'prefix' => 'php' ); $objects = $container->objectList($options);rÿ …r }r (h:Uh;jù ubahFhàubaubha)r }r (h:Xj[ `Get the executable PHP script for this example `__ ]h;j« hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMhShhT]r (h]X[ r …r }r (h:X[ h;j ubj¨)r }r (h:Xf`Get the executable PHP script for this example `__hH}r (UnameX.Get the executable PHP script for this examplejÝX1/samples/ObjectStore/list-objects-with-prefix.phphM]hL]hJ]hK]hP]uh;j hT]r h]X.Get the executable PHP script for this exampler …r }r (h:Uh;j ubahFj±ubh]X ]r …r }r (h:X ]h;j ubeubha)r }r (h:XIn general, the ``objectList()`` method described above takes an optional parameter (``$options`` in the example above). This parameter is an associative array of various options. Here is a complete listing of keys that can be specified in the ``$options`` array:h;j« hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMhShhT]r (h]XIn general, the r …r }r (h:XIn general, the h;j ubh˜)r }r (h:X``objectList()``hH}r (hJ]hK]hL]hM]hP]uh;j hT]r h]X objectList()r …r }r (h:Uh;j ubahFh ubh]X5 method described above takes an optional parameter (r! …r" }r# (h:X5 method described above takes an optional parameter (h;j ubh˜)r$ }r% (h:X ``$options``hH}r& (hJ]hK]hL]hM]hP]uh;j hT]r' h]X$optionsr( …r) }r* (h:Uh;j$ ubahFh ubh]X“ in the example above). This parameter is an associative array of various options. Here is a complete listing of keys that can be specified in the r+ …r, }r- (h:X“ in the example above). This parameter is an associative array of various options. Here is a complete listing of keys that can be specified in the h;j ubh˜)r. }r/ (h:X ``$options``hH}r0 (hJ]hK]hL]hM]hP]uh;j hT]r1 h]X$optionsr2 …r3 }r4 (h:Uh;j. ubahFh ubh]X array:r5 …r6 }r7 (h:X array:h;j ubeubj˜)r8 }r9 (h:Uh;j« hDhEhFj›hH}r: (hJ]hK]hL]hM]hP]uhRNhShhT]r; jž)r< }r= (h:UhH}r> (hM]hL]hJ]hK]hP]UcolsKuh;j8 hT]r? (j£)r@ }rA (h:UhH}rB (hM]hL]hJ]hK]hP]UcolwidthKuh;j< hT]hFj§ubj£)rC }rD (h:UhH}rE (hM]hL]hJ]hK]hP]UcolwidthKMuh;j< hT]hFj§ubj£)rF }rG (h:UhH}rH (hM]hL]hJ]hK]hP]UcolwidthK uh;j< hT]hFj§ubj£)rI }rJ (h:UhH}rK (hM]hL]hJ]hK]hP]UcolwidthK uh;j< hT]hFj§ubj£)rL }rM (h:UhH}rN (hM]hL]hJ]hK]hP]UcolwidthKuh;j< hT]hFj§ubj£)rO }rP (h:UhH}rQ (hM]hL]hJ]hK]hP]UcolwidthKuh;j< hT]hFj§ubj·)rR }rS (h:UhH}rT (hJ]hK]hL]hM]hP]uh;j< hT]rU j¼)rV }rW (h:UhH}rX (hJ]hK]hL]hM]hP]uh;jR hT]rY (jÁ)rZ }r[ (h:UhH}r\ (hJ]hK]hL]hM]hP]uh;jV hT]r] ha)r^ }r_ (h:XKey namer` h;jZ hDhEhFhdhH}ra (hJ]hK]hL]hM]hP]uhRM hT]rb h]XKey namerc …rd }re (h:j` h;j^ ubaubahFjÎubjÁ)rf }rg (h:UhH}rh (hJ]hK]hL]hM]hP]uh;jV hT]ri ha)rj }rk (h:X Descriptionrl h;jf hDhEhFhdhH}rm (hJ]hK]hL]hM]hP]uhRM hT]rn h]X Descriptionro …rp }rq (h:jl h;jj ubaubahFjÎubjÁ)rr }rs (h:UhH}rt (hJ]hK]hL]hM]hP]uh;jV hT]ru ha)rv }rw (h:X Data Typerx h;jr hDhEhFhdhH}ry (hJ]hK]hL]hM]hP]uhRM hT]rz h]X Data Typer{ …r| }r} (h:jx h;jv ubaubahFjÎubjÁ)r~ }r (h:UhH}r€ (hJ]hK]hL]hM]hP]uh;jV hT]r ha)r‚ }rƒ (h:X Required?r„ h;j~ hDhEhFhdhH}r… (hJ]hK]hL]hM]hP]uhRM hT]r† h]X Required?r‡ …rˆ }r‰ (h:j„ h;j‚ ubaubahFjÎubjÁ)rŠ }r‹ (h:UhH}rŒ (hJ]hK]hL]hM]hP]uh;jV hT]r ha)rŽ }r (h:X Default Valuer h;jŠ hDhEhFhdhH}r‘ (hJ]hK]hL]hM]hP]uhRM hT]r’ h]X Default Valuer“ …r” }r• (h:j h;jŽ ubaubahFjÎubjÁ)r– }r— (h:UhH}r˜ (hJ]hK]hL]hM]hP]uh;jV hT]r™ ha)rš }r› (h:XExamplerœ h;j– hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRM hT]rž h]XExamplerŸ …r  }r¡ (h:jœ h;jš ubaubahFjÎubehFj ubahFj ubj )r¢ }r£ (h:UhH}r¤ (hJ]hK]hL]hM]hP]uh;j< hT]r¥ (j¼)r¦ }r§ (h:UhH}r¨ (hJ]hK]hL]hM]hP]uh;j¢ hT]r© (jÁ)rª }r« (h:UhH}r¬ (hJ]hK]hL]hM]hP]uh;j¦ hT]r­ ha)r® }r¯ (h:X ``prefix``r° h;jª hDhEhFhdhH}r± (hJ]hK]hL]hM]hP]uhRM hT]r² h˜)r³ }r´ (h:j° hH}rµ (hJ]hK]hL]hM]hP]uh;j® hT]r¶ h]Xprefixr· …r¸ }r¹ (h:Uh;j³ ubahFh ubaubahFjÎubjÁ)rº }r» (h:UhH}r¼ (hJ]hK]hL]hM]hP]uh;j¦ hT]r½ ha)r¾ }r¿ (h:XFGiven a string x, limits the results to object names beginning with x.rÀ h;jº hDhEhFhdhH}rÁ (hJ]hK]hL]hM]hP]uhRM hT]r h]XFGiven a string x, limits the results to object names beginning with x.rà …rÄ }rÅ (h:jÀ h;j¾ ubaubahFjÎubjÁ)rÆ }rÇ (h:UhH}rÈ (hJ]hK]hL]hM]hP]uh;j¦ hT]rÉ ha)rÊ }rË (h:XStringrÌ h;jÆ hDhEhFhdhH}rÍ (hJ]hK]hL]hM]hP]uhRM hT]rÎ h]XStringrÏ …rÐ }rÑ (h:jÌ h;jÊ ubaubahFjÎubjÁ)rÒ }rÓ (h:UhH}rÔ (hJ]hK]hL]hM]hP]uh;j¦ hT]rÕ ha)rÖ }r× (h:XNorØ h;jÒ hDhEhFhdhH}rÙ (hJ]hK]hL]hM]hP]uhRM hT]rÚ h]XNorÛ …rÜ }rÝ (h:jØ h;jÖ ubaubahFjÎubjÁ)rÞ }rß (h:UhH}rà (hJ]hK]hL]hM]hP]uh;j¦ hT]hFjÎubjÁ)rá }râ (h:UhH}rã (hJ]hK]hL]hM]hP]uh;j¦ hT]rä ha)rå }ræ (h:X``php``rç h;já hDhEhFhdhH}rè (hJ]hK]hL]hM]hP]uhRM hT]ré h˜)rê }rë (h:jç hH}rì (hJ]hK]hL]hM]hP]uh;jå hT]rí h]Xphprî …rï }rð (h:Uh;jê ubahFh ubaubahFjÎubehFj ubj¼)rñ }rò (h:UhH}ró (hJ]hK]hL]hM]hP]uh;j¢ hT]rô (jÁ)rõ }rö (h:UhH}r÷ (hJ]hK]hL]hM]hP]uh;jñ hT]rø ha)rù }rú (h:X ``limit``rû h;jõ hDhEhFhdhH}rü (hJ]hK]hL]hM]hP]uhRMhT]rý h˜)rþ }rÿ (h:jû hH}r (hJ]hK]hL]hM]hP]uh;jù hT]r h]Xlimitr …r }r (h:Uh;jþ ubahFh ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jñ hT]r ha)r }r (h:XEGiven an integer n, limits the number of results to at most n values.r h;j hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMhT]r h]XEGiven an integer n, limits the number of results to at most n values.r …r }r (h:j h;j ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jñ hT]r ha)r }r (h:XIntegerr h;j hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMhT]r h]XIntegerr …r }r (h:j h;j ubaubahFjÎubjÁ)r }r (h:UhH}r (hJ]hK]hL]hM]hP]uh;jñ hT]r ha)r! }r" (h:XNor# h;j hDhEhFhdhH}r$ (hJ]hK]hL]hM]hP]uhRMhT]r% h]XNor& …r' }r( (h:j# h;j! ubaubahFjÎubjÁ)r) }r* (h:UhH}r+ (hJ]hK]hL]hM]hP]uh;jñ hT]hFjÎubjÁ)r, }r- (h:UhH}r. (hJ]hK]hL]hM]hP]uh;jñ hT]r/ ha)r0 }r1 (h:X10r2 h;j, hDhEhFhdhH}r3 (hJ]hK]hL]hM]hP]uhRMhT]r4 h]X10r5 …r6 }r7 (h:j2 h;j0 ubaubahFjÎubehFj ubj¼)r8 }r9 (h:UhH}r: (hJ]hK]hL]hM]hP]uh;j¢ hT]r; (jÁ)r< }r= (h:UhH}r> (hJ]hK]hL]hM]hP]uh;j8 hT]r? ha)r@ }rA (h:X ``marker``rB h;j< hDhEhFhdhH}rC (hJ]hK]hL]hM]hP]uhRMhT]rD h˜)rE }rF (h:jB hH}rG (hJ]hK]hL]hM]hP]uh;j@ hT]rH h]XmarkerrI …rJ }rK (h:Uh;jE ubahFh ubaubahFjÎubjÁ)rL }rM (h:UhH}rN (hJ]hK]hL]hM]hP]uh;j8 hT]rO ha)rP }rQ (h:XIGiven a string x, returns object names greater than the specified marker.rR h;jL hDhEhFhdhH}rS (hJ]hK]hL]hM]hP]uhRMhT]rT h]XIGiven a string x, returns object names greater than the specified marker.rU …rV }rW (h:jR h;jP ubaubahFjÎubjÁ)rX }rY (h:UhH}rZ (hJ]hK]hL]hM]hP]uh;j8 hT]r[ ha)r\ }r] (h:XStringr^ h;jX hDhEhFhdhH}r_ (hJ]hK]hL]hM]hP]uhRMhT]r` h]XStringra …rb }rc (h:j^ h;j\ ubaubahFjÎubjÁ)rd }re (h:UhH}rf (hJ]hK]hL]hM]hP]uh;j8 hT]rg ha)rh }ri (h:XNorj h;jd hDhEhFhdhH}rk (hJ]hK]hL]hM]hP]uhRMhT]rl h]XNorm …rn }ro (h:jj h;jh ubaubahFjÎubjÁ)rp }rq (h:UhH}rr (hJ]hK]hL]hM]hP]uh;j8 hT]hFjÎubjÁ)rs }rt (h:UhH}ru (hJ]hK]hL]hM]hP]uh;j8 hT]rv ha)rw }rx (h:X``php-elephant.jpg``ry h;js hDhEhFhdhH}rz (hJ]hK]hL]hM]hP]uhRMhT]r{ h˜)r| }r} (h:jy hH}r~ (hJ]hK]hL]hM]hP]uh;jw hT]r h]Xphp-elephant.jpgr€ …r }r‚ (h:Uh;j| ubahFh ubaubahFjÎubehFj ubj¼)rƒ }r„ (h:UhH}r… (hJ]hK]hL]hM]hP]uh;j¢ hT]r† (jÁ)r‡ }rˆ (h:UhH}r‰ (hJ]hK]hL]hM]hP]uh;jƒ hT]rŠ ha)r‹ }rŒ (h:X``end_marker``r h;j‡ hDhEhFhdhH}rŽ (hJ]hK]hL]hM]hP]uhRMhT]r h˜)r }r‘ (h:j hH}r’ (hJ]hK]hL]hM]hP]uh;j‹ hT]r“ h]X end_markerr” …r• }r– (h:Uh;j ubahFh ubaubahFjÎubjÁ)r— }r˜ (h:UhH}r™ (hJ]hK]hL]hM]hP]uh;jƒ hT]rš ha)r› }rœ (h:XFGiven a string x, returns object names less than the specified marker.r h;j— hDhEhFhdhH}rž (hJ]hK]hL]hM]hP]uhRMhT]rŸ h]XFGiven a string x, returns object names less than the specified marker.r  …r¡ }r¢ (h:j h;j› ubaubahFjÎubjÁ)r£ }r¤ (h:UhH}r¥ (hJ]hK]hL]hM]hP]uh;jƒ hT]r¦ ha)r§ }r¨ (h:XStringr© h;j£ hDhEhFhdhH}rª (hJ]hK]hL]hM]hP]uhRMhT]r« h]XStringr¬ …r­ }r® (h:j© h;j§ ubaubahFjÎubjÁ)r¯ }r° (h:UhH}r± (hJ]hK]hL]hM]hP]uh;jƒ hT]r² ha)r³ }r´ (h:XNorµ h;j¯ hDhEhFhdhH}r¶ (hJ]hK]hL]hM]hP]uhRMhT]r· h]XNor¸ …r¹ }rº (h:jµ h;j³ ubaubahFjÎubjÁ)r» }r¼ (h:UhH}r½ (hJ]hK]hL]hM]hP]uh;jƒ hT]hFjÎubjÁ)r¾ }r¿ (h:UhH}rÀ (hJ]hK]hL]hM]hP]uh;jƒ hT]rÁ ha)r }rà (h:X``python-snakes.jpg``rÄ h;j¾ hDhEhFhdhH}rÅ (hJ]hK]hL]hM]hP]uhRMhT]rÆ h˜)rÇ }rÈ (h:jÄ hH}rÉ (hJ]hK]hL]hM]hP]uh;j hT]rÊ h]Xpython-snakes.jpgrË …rÌ }rÍ (h:Uh;jÇ ubahFh ubaubahFjÎubehFj ubehFj¯ ubehFj° ubaubeubh<)rÎ }rÏ (h:Uh;jëhDhEhFhGhH}rÐ (hJ]hK]hL]hM]rÑ Uretrieve-objectrÒ ahP]rÓ h0auhRMhShhT]rÔ (hV)rÕ }rÖ (h:XRetrieve Objectr× h;jÎ hDhEhFhZhH}rØ (hJ]hK]hL]hM]hP]uhRMhShhT]rÙ h]XRetrieve ObjectrÚ …rÛ }rÜ (h:j× h;jÕ ubaubha)rÝ }rÞ (h:XSYou can retrieve an object and its metadata, given the object's container and name.rß h;jÎ hDhEhFhdhH}rà (hJ]hK]hL]hM]hP]uhRMhShhT]rá h]XSYou can retrieve an object and its metadata, given the object's container and name.râ …rã }rä (h:jß h;jÝ ubaubhÌ)rå }ræ (h:XÃ$objectName = 'php-elephant.jpg'; $object = $container->getObject($objectName); /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ $objectContent = $object->getContent(); /** @var $objectContent Guzzle\Http\EntityBody **/ // Write object content to file on local filesystem. $objectContent->rewind(); $stream = $objectContent->getStream(); $localFilename = tempnam("/tmp", 'php-opencloud-'); file_put_contents($localFilename, $stream);h;jÎ hDhEhFháhH}rç (hÐhÑhM]hL]hJ]hK]rè (hÓXphpré ehP]uhRM,hShhT]rê hÖ)rë }rì (h:XÃ$objectName = 'php-elephant.jpg'; $object = $container->getObject($objectName); /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ $objectContent = $object->getContent(); /** @var $objectContent Guzzle\Http\EntityBody **/ // Write object content to file on local filesystem. $objectContent->rewind(); $stream = $objectContent->getStream(); $localFilename = tempnam("/tmp", 'php-opencloud-'); file_put_contents($localFilename, $stream);hH}rí (hJ]hK]rî Uotherrï ahL]hM]hP]uh;jå hT]rð h]XÃ$objectName = 'php-elephant.jpg'; $object = $container->getObject($objectName); /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/ $objectContent = $object->getContent(); /** @var $objectContent Guzzle\Http\EntityBody **/ // Write object content to file on local filesystem. $objectContent->rewind(); $stream = $objectContent->getStream(); $localFilename = tempnam("/tmp", 'php-opencloud-'); file_put_contents($localFilename, $stream);rñ …rò }ró (h:Uh;jë ubahFhàubaubha)rô }rõ (h:X\[ `Get the executable PHP script for this example `__ ]h;jÎ hDhEhFhdhH}rö (hJ]hK]hL]hM]hP]uhRM-hShhT]r÷ (h]X[ rø …rù }rú (h:X[ h;jô ubj¨)rû }rü (h:XX`Get the executable PHP script for this example `__hH}rý (UnameX.Get the executable PHP script for this examplejÝX#/samples/ObjectStore/get-object.phphM]hL]hJ]hK]hP]uh;jô hT]rþ h]X.Get the executable PHP script for this examplerÿ …r}r(h:Uh;jû ubahFj±ubh]X ]r…r}r(h:X ]h;jô ubeubha)r}r(h:X(In the example above, ``$object`` is the object named ``php-elephant.jpg`` in the container represented by ``$container``. Further, ``$objectContent`` represents the contents of the object. It is of type ```Guzzle\Http\EntityBody`` `__.h;jÎ hDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM0hShhT]r(h]XIn the example above, r …r }r (h:XIn the example above, h;jubh˜)r }r (h:X ``$object``hH}r(hJ]hK]hL]hM]hP]uh;jhT]rh]X$objectr…r}r(h:Uh;j ubahFh ubh]X is the object named r…r}r(h:X is the object named h;jubh˜)r}r(h:X``php-elephant.jpg``hH}r(hJ]hK]hL]hM]hP]uh;jhT]rh]Xphp-elephant.jpgr…r}r(h:Uh;jubahFh ubh]X! in the container represented by r…r}r(h:X! in the container represented by h;jubh˜)r }r!(h:X``$container``hH}r"(hJ]hK]hL]hM]hP]uh;jhT]r#h]X $containerr$…r%}r&(h:Uh;j ubahFh ubh]X . Further, r'…r(}r)(h:X . Further, h;jubh˜)r*}r+(h:X``$objectContent``hH}r,(hJ]hK]hL]hM]hP]uh;jhT]r-h]X$objectContentr.…r/}r0(h:Uh;j*ubahFh ubh]X6 represents the contents of the object. It is of type r1…r2}r3(h:X6 represents the contents of the object. It is of type h;jubh˜)r4}r5(h:X```Guzzle\Http\EntityBody``hH}r6(hJ]hK]hL]hM]hP]uh;jhT]r7h]X`Guzzle\Http\EntityBodyr8…r9}r:(h:Uh;j4ubahFh ubh]X }r?(h:X:http://api.guzzlephp.org/class-Guzzle.Http.EntityBody.htmlr@hH}rA(Urefurij@hM]hL]hJ]hK]hP]uh;jhT]rBh]X:http://api.guzzlephp.org/class-Guzzle.Http.EntityBody.htmlrC…rD}rE(h:Uh;j>ubahFj±ubh]X>`__.rF…rG}rH(h:X>`__.h;jubeubeubh<)rI}rJ(h:Uh;jëhDhEhFhGhH}rK(hJ]hK]hL]hM]rLUretrieve-object-metadatarMahP]rNhauhRM7hShhT]rO(hV)rP}rQ(h:XRetrieve Object MetadatarRh;jIhDhEhFhZhH}rS(hJ]hK]hL]hM]hP]uhRM7hShhT]rTh]XRetrieve Object MetadatarU…rV}rW(h:jRh;jPubaubha)rX}rY(h:XKYou can retrieve just an object's metadata without retrieving its contents.rZh;jIhDhEhFhdhH}r[(hJ]hK]hL]hM]hP]uhRM9hShhT]r\h]XKYou can retrieve just an object's metadata without retrieving its contents.r]…r^}r_(h:jZh;jXubaubhÌ)r`}ra(h:X¹$objectName = 'php-elephant.jpg'; $object = $container->getPartialObject($objectName); $objectMetadata = $object->getMetadata(); /** @var $objectMetadata \OpenCloud\Common\Metadata **/h;jIhDhEhFháhH}rb(hÐhÑhM]hL]hJ]hK]rc(hÓXphprdehP]uhRMChShhT]rehÖ)rf}rg(h:X¹$objectName = 'php-elephant.jpg'; $object = $container->getPartialObject($objectName); $objectMetadata = $object->getMetadata(); /** @var $objectMetadata \OpenCloud\Common\Metadata **/hH}rh(hJ]hK]riUotherrjahL]hM]hP]uh;j`hT]rkh]X¹$objectName = 'php-elephant.jpg'; $object = $container->getPartialObject($objectName); $objectMetadata = $object->getMetadata(); /** @var $objectMetadata \OpenCloud\Common\Metadata **/rl…rm}rn(h:Uh;jfubahFhàubaubha)ro}rp(h:Xe[ `Get the executable PHP script for this example `__ ]h;jIhDhEhFhdhH}rq(hJ]hK]hL]hM]hP]uhRMDhShhT]rr(h]X[ rs…rt}ru(h:X[ h;joubj¨)rv}rw(h:Xa`Get the executable PHP script for this example `__hH}rx(UnameX.Get the executable PHP script for this examplejÝX,/samples/ObjectStore/get-object-metadata.phphM]hL]hJ]hK]hP]uh;johT]ryh]X.Get the executable PHP script for this examplerz…r{}r|(h:Uh;jvubahFj±ubh]X ]r}…r~}r(h:X ]h;joubeubha)r€}r(h:XìIn the example above, while ``$object`` is an instance of ``OpenCloud\ObjectStore\Resource\DataObject``, that instance is only partially populated. Specifically, only properties of the instance relating to object metadata are populated.h;jIhDhEhFhdhH}r‚(hJ]hK]hL]hM]hP]uhRMGhShhT]rƒ(h]XIn the example above, while r„…r…}r†(h:XIn the example above, while h;j€ubh˜)r‡}rˆ(h:X ``$object``hH}r‰(hJ]hK]hL]hM]hP]uh;j€hT]rŠh]X$objectr‹…rŒ}r(h:Uh;j‡ubahFh ubh]X is an instance of rŽ…r}r(h:X is an instance of h;j€ubh˜)r‘}r’(h:X-``OpenCloud\ObjectStore\Resource\DataObject``hH}r“(hJ]hK]hL]hM]hP]uh;j€hT]r”h]X)OpenCloud\ObjectStore\Resource\DataObjectr•…r–}r—(h:Uh;j‘ubahFh ubh]X…, that instance is only partially populated. Specifically, only properties of the instance relating to object metadata are populated.r˜…r™}rš(h:X…, that instance is only partially populated. Specifically, only properties of the instance relating to object metadata are populated.h;j€ubeubeubh<)r›}rœ(h:Uh;jëhDhEhFhGhH}r(hJ]hK]hL]hM]ržUtemporary-urlsrŸahP]r hauhRMMhShhT]r¡(hV)r¢}r£(h:XTemporary URLsr¤h;j›hDhEhFhZhH}r¥(hJ]hK]hL]hM]hP]uhRMMhShhT]r¦h]XTemporary URLsr§…r¨}r©(h:j¤h;j¢ubaubha)rª}r«(h:XöThe Temporary URL feature allows you to create limited-time Internet addresses that allow you to grant limited access to your Object Store account. Using this feature, you can allow others to retrieve or place objects in your Object Store account for a specified amount of time. Access to the temporary URL is independent of whether or not your account is `CDN-enabled <#cdn-containers>`__. Even if you do not CDN-enable a container, you can still grant temporary public access through a temporary URL.h;j›hDhEhFhdhH}r¬(hJ]hK]hL]hM]hP]uhRMOhShhT]r­(h]XdThe Temporary URL feature allows you to create limited-time Internet addresses that allow you to grant limited access to your Object Store account. Using this feature, you can allow others to retrieve or place objects in your Object Store account for a specified amount of time. Access to the temporary URL is independent of whether or not your account is r®…r¯}r°(h:XdThe Temporary URL feature allows you to create limited-time Internet addresses that allow you to grant limited access to your Object Store account. Using this feature, you can allow others to retrieve or place objects in your Object Store account for a specified amount of time. Access to the temporary URL is independent of whether or not your account is h;jªubj¨)r±}r²(h:X!`CDN-enabled <#cdn-containers>`__hH}r³(UnameX CDN-enabledjÝX#cdn-containershM]hL]hJ]hK]hP]uh;jªhT]r´h]X CDN-enabledrµ…r¶}r·(h:Uh;j±ubahFj±ubh]Xq. Even if you do not CDN-enable a container, you can still grant temporary public access through a temporary URL.r¸…r¹}rº(h:Xq. Even if you do not CDN-enable a container, you can still grant temporary public access through a temporary URL.h;jªubeubha)r»}r¼(h:X·First, you must set the temporary URL secret on your account. This is a one-time operation; you only need to perform it the very first time you wish to use the temporary URLs feature.r½h;j›hDhEhFhdhH}r¾(hJ]hK]hL]hM]hP]uhRMXhShhT]r¿h]X·First, you must set the temporary URL secret on your account. This is a one-time operation; you only need to perform it the very first time you wish to use the temporary URLs feature.rÀ…rÁ}rÂ(h:j½h;j»ubaubhÌ)rÃ}rÄ(h:X$account->setTempUrlSecret();h;j›hDhEhFháhH}rÅ(hÐhÑhM]hL]hJ]hK]rÆ(hÓXphprÇehP]uhRM_hShhT]rÈhÖ)rÉ}rÊ(h:X$account->setTempUrlSecret();hH}rË(hJ]hK]rÌUotherrÍahL]hM]hP]uh;jÃhT]rÎh]X$account->setTempUrlSecret();rÏ…rÐ}rÑ(h:Uh;jÉubahFhàubaubha)rÒ}rÓ(h:Xm[ `Get the executable PHP script for this example `__ ]h;j›hDhEhFhdhH}rÔ(hJ]hK]hL]hM]hP]uhRM`hShhT]rÕ(h]X[ rÖ…r×}rØ(h:X[ h;jÒubj¨)rÙ}rÚ(h:Xi`Get the executable PHP script for this example `__hH}rÛ(UnameX.Get the executable PHP script for this examplejÝX4/samples/ObjectStore/set-account-temp-url-secret.phphM]hL]hJ]hK]hP]uh;jÒhT]rÜh]X.Get the executable PHP script for this examplerÝ…rÞ}rß(h:Uh;jÙubahFj±ubh]X ]rà…rá}râ(h:X ]h;jÒubeubha)rã}rä(h:X¼Note that this operation is carried out on ``$account``, which is an instance of ``OpenCloud\ObjectStore\Resource\Account``, a class representing `your object store account <#accounts>`__.h;j›hDhEhFhdhH}rå(hJ]hK]hL]hM]hP]uhRMchShhT]ræ(h]X+Note that this operation is carried out on rç…rè}ré(h:X+Note that this operation is carried out on h;jãubh˜)rê}rë(h:X ``$account``hH}rì(hJ]hK]hL]hM]hP]uh;jãhT]ríh]X$accountrî…rï}rð(h:Uh;jêubahFh ubh]X, which is an instance of rñ…rò}ró(h:X, which is an instance of h;jãubh˜)rô}rõ(h:X*``OpenCloud\ObjectStore\Resource\Account``hH}rö(hJ]hK]hL]hM]hP]uh;jãhT]r÷h]X&OpenCloud\ObjectStore\Resource\Accountrø…rù}rú(h:Uh;jôubahFh ubh]X, a class representing rû…rü}rý(h:X, a class representing h;jãubj¨)rþ}rÿ(h:X)`your object store account <#accounts>`__hH}r(UnameXyour object store accountjÝX #accountshM]hL]hJ]hK]hP]uh;jãhT]rh]Xyour object store accountr…r}r(h:Uh;jþubahFj±ubh]X.…r}r(h:X.h;jãubeubha)r}r(h:XÏThe above operation will generate a random secret and set it on your account. Instead of a random secret, if you wish to provide a secret, you can supply it as a parameter to the ``setTempUrlSecret`` method.h;j›hDhEhFhdhH}r (hJ]hK]hL]hM]hP]uhRMghShhT]r (h]X³The above operation will generate a random secret and set it on your account. Instead of a random secret, if you wish to provide a secret, you can supply it as a parameter to the r …r }r (h:X³The above operation will generate a random secret and set it on your account. Instead of a random secret, if you wish to provide a secret, you can supply it as a parameter to the h;jubh˜)r}r(h:X``setTempUrlSecret``hH}r(hJ]hK]hL]hM]hP]uh;jhT]rh]XsetTempUrlSecretr…r}r(h:Uh;jubahFh ubh]X method.r…r}r(h:X method.h;jubeubhÌ)r}r(h:X3$account->setTempUrlSecret('');h;j›hDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]r(hÓXphprehP]uhRMnhShhT]rhÖ)r}r(h:X3$account->setTempUrlSecret('');hH}r (hJ]hK]r!Uotherr"ahL]hM]hP]uh;jhT]r#h]X3$account->setTempUrlSecret('');r$…r%}r&(h:Uh;jubahFhàubaubha)r'}r((h:Xw[ `Get the executable PHP script for this example `__ ]h;j›hDhEhFhdhH}r)(hJ]hK]hL]hM]hP]uhRMohShhT]r*(h]X[ r+…r,}r-(h:X[ h;j'ubj¨)r.}r/(h:Xs`Get the executable PHP script for this example `__hH}r0(UnameX.Get the executable PHP script for this examplejÝX>/samples/ObjectStore/set-account-temp-url-secret-specified.phphM]hL]hJ]hK]hP]uh;j'hT]r1h]X.Get the executable PHP script for this exampler2…r3}r4(h:Uh;j.ubahFj±ubh]X ]r5…r6}r7(h:X ]h;j'ubeubha)r8}r9(h:XOnce a temporary URL secret has been set on your account, you can generate a temporary URL for any object in your Object Store.r:h;j›hDhEhFhdhH}r;(hJ]hK]hL]hM]hP]uhRMshShhT]r<h]XOnce a temporary URL secret has been set on your account, you can generate a temporary URL for any object in your Object Store.r=…r>}r?(h:j:h;j8ubaubhÌ)r@}rA(h:X¤$expirationTimeInSeconds = 3600; // one hour from now $httpMethodAllowed = 'GET'; $tempUrl = $object->getTemporaryUrl($expirationTimeInSeconds, $httpMethodAllowed);h;j›hDhEhFháhH}rB(hÐhÑhM]hL]hJ]hK]rC(hÓXphprDehP]uhRM{hShhT]rEhÖ)rF}rG(h:X¤$expirationTimeInSeconds = 3600; // one hour from now $httpMethodAllowed = 'GET'; $tempUrl = $object->getTemporaryUrl($expirationTimeInSeconds, $httpMethodAllowed);hH}rH(hJ]hK]rIUotherrJahL]hM]hP]uh;j@hT]rKh]X¤$expirationTimeInSeconds = 3600; // one hour from now $httpMethodAllowed = 'GET'; $tempUrl = $object->getTemporaryUrl($expirationTimeInSeconds, $httpMethodAllowed);rL…rM}rN(h:Uh;jFubahFhàubaubha)rO}rP(h:Xj[ `Get the executable PHP script for this example `__ ]h;j›hDhEhFhdhH}rQ(hJ]hK]hL]hM]hP]uhRM|hShhT]rR(h]X[ rS…rT}rU(h:X[ h;jOubj¨)rV}rW(h:Xf`Get the executable PHP script for this example `__hH}rX(UnameX.Get the executable PHP script for this examplejÝX1/samples/ObjectStore/get-object-temporary-url.phphM]hL]hJ]hK]hP]uh;jOhT]rYh]X.Get the executable PHP script for this examplerZ…r[}r\(h:Uh;jVubahFj±ubh]X ]r]…r^}r_(h:X ]h;jOubeubha)r`}ra(h:X˜In the example above, a temporary URL for the object is generated. This temporary URL will provide public access to the object for an hour (3600 seconds), as specified by the ``$expirationTimeInSeconds`` variable. Further, only GET HTTP methods will be allowed on this URL, as specified by the ``$httpMethodAllowed`` variable. The other value allowed for the ``$httpMethodAllowed`` variable would be ``PUT``.h;j›hDhEhFhdhH}rb(hJ]hK]hL]hM]hP]uhRMhShhT]rc(h]X¯In the example above, a temporary URL for the object is generated. This temporary URL will provide public access to the object for an hour (3600 seconds), as specified by the rd…re}rf(h:X¯In the example above, a temporary URL for the object is generated. This temporary URL will provide public access to the object for an hour (3600 seconds), as specified by the h;j`ubh˜)rg}rh(h:X``$expirationTimeInSeconds``hH}ri(hJ]hK]hL]hM]hP]uh;j`hT]rjh]X$expirationTimeInSecondsrk…rl}rm(h:Uh;jgubahFh ubh]X[ variable. Further, only GET HTTP methods will be allowed on this URL, as specified by the rn…ro}rp(h:X[ variable. Further, only GET HTTP methods will be allowed on this URL, as specified by the h;j`ubh˜)rq}rr(h:X``$httpMethodAllowed``hH}rs(hJ]hK]hL]hM]hP]uh;j`hT]rth]X$httpMethodAllowedru…rv}rw(h:Uh;jqubahFh ubh]X+ variable. The other value allowed for the rx…ry}rz(h:X+ variable. The other value allowed for the h;j`ubh˜)r{}r|(h:X``$httpMethodAllowed``hH}r}(hJ]hK]hL]hM]hP]uh;j`hT]r~h]X$httpMethodAllowedr…r€}r(h:Uh;j{ubahFh ubh]X variable would be r‚…rƒ}r„(h:X variable would be h;j`ubh˜)r…}r†(h:X``PUT``hH}r‡(hJ]hK]hL]hM]hP]uh;j`hT]rˆh]XPUTr‰…rŠ}r‹(h:Uh;j…ubahFh ubh]X.…rŒ}r(h:X.h;j`ubeubha)rŽ}r(h:XQYou can also retrieve the temporary URL secret that has been set on your account.rh;j›hDhEhFhdhH}r‘(hJ]hK]hL]hM]hP]uhRM†hShhT]r’h]XQYou can also retrieve the temporary URL secret that has been set on your account.r“…r”}r•(h:jh;jŽubaubhÌ)r–}r—(h:X.$tempUrlSecret = $account->getTempUrlSecret();h;j›hDhEhFháhH}r˜(hÐhÑhM]hL]hJ]hK]r™(hÓXphpršehP]uhRMŒhShhT]r›hÖ)rœ}r(h:X.$tempUrlSecret = $account->getTempUrlSecret();hH}rž(hJ]hK]rŸUotherr ahL]hM]hP]uh;j–hT]r¡h]X.$tempUrlSecret = $account->getTempUrlSecret();r¢…r£}r¤(h:Uh;jœubahFhàubaubha)r¥}r¦(h:Xm[ `Get the executable PHP script for this example `__ ]h;j›hDhEhFhdhH}r§(hJ]hK]hL]hM]hP]uhRMhShhT]r¨(h]X[ r©…rª}r«(h:X[ h;j¥ubj¨)r¬}r­(h:Xi`Get the executable PHP script for this example `__hH}r®(UnameX.Get the executable PHP script for this examplejÝX4/samples/ObjectStore/get-account-temp-url-secret.phphM]hL]hJ]hK]hP]uh;j¥hT]r¯h]X.Get the executable PHP script for this exampler°…r±}r²(h:Uh;j¬ubahFj±ubh]X ]r³…r´}rµ(h:X ]h;j¥ubeubeubh<)r¶}r·(h:Uh;jëhDhEhFhGhH}r¸(hJ]hK]hL]hM]r¹U update-objectrºahP]r»h$auhRM‘hShhT]r¼(hV)r½}r¾(h:X Update Objectr¿h;j¶hDhEhFhZhH}rÀ(hJ]hK]hL]hM]hP]uhRM‘hShhT]rÁh]X Update ObjectrÂ…rÃ}rÄ(h:j¿h;j½ubaubha)rÅ}rÆ(h:X×You can update an object's contents (as opposed to `updating its metadata <#update-object-metadata>`__) by simply re-\ `uploading the object <#upload-object>`__ to its container using the same object name as before.h;j¶hDhEhFhdhH}rÇ(hJ]hK]hL]hM]hP]uhRM“hShhT]rÈ(h]X3You can update an object's contents (as opposed to rÉ…rÊ}rË(h:X3You can update an object's contents (as opposed to h;jÅubj¨)rÌ}rÍ(h:X3`updating its metadata <#update-object-metadata>`__hH}rÎ(UnameXupdating its metadatajÝX#update-object-metadatahM]hL]hJ]hK]hP]uh;jÅhT]rÏh]Xupdating its metadatarÐ…rÑ}rÒ(h:Uh;jÌubahFj±ubh]X) by simply re-rÓ…rÔ}rÕ(h:X) by simply re-\ h;jÅubj¨)rÖ}r×(h:X)`uploading the object <#upload-object>`__hH}rØ(UnameXuploading the objectjÝX#upload-objecthM]hL]hJ]hK]hP]uh;jÅhT]rÙh]Xuploading the objectrÚ…rÛ}rÜ(h:Uh;jÖubahFj±ubh]X7 to its container using the same object name as before.rÝ…rÞ}rß(h:X7 to its container using the same object name as before.h;jÅubeubeubh<)rà}rá(h:Uh;jëhDhEhFhGhH}râ(hJ]hK]hL]hM]rãUupdate-object-metadataräahP]råhauhRM™hShhT]ræ(hV)rç}rè(h:XUpdate Object Metadataréh;jàhDhEhFhZhH}rê(hJ]hK]hL]hM]hP]uhRM™hShhT]rëh]XUpdate Object Metadatarì…rí}rî(h:jéh;jçubaubha)rï}rð(h:XNYou can update an object's metadata after it has been uploaded to a container.rñh;jàhDhEhFhdhH}rò(hJ]hK]hL]hM]hP]uhRM›hShhT]róh]XNYou can update an object's metadata after it has been uploaded to a container.rô…rõ}rö(h:jñh;jïubaubhÌ)r÷}rø(h:X;$object->saveMetadata(array( 'author' => 'John Doe' ));h;jàhDhEhFháhH}rù(hÐhÑhM]hL]hJ]hK]rú(hÓXphprûehP]uhRM£hShhT]rühÖ)rý}rþ(h:X;$object->saveMetadata(array( 'author' => 'John Doe' ));hH}rÿ(hJ]hK]rUotherrahL]hM]hP]uh;j÷hT]rh]X;$object->saveMetadata(array( 'author' => 'John Doe' ));r…r}r(h:Uh;jýubahFhàubaubha)r}r(h:Xh[ `Get the executable PHP script for this example `__ ]h;jàhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM¤hShhT]r (h]X[ r …r }r (h:X[ h;jubj¨)r }r(h:Xd`Get the executable PHP script for this example `__hH}r(UnameX.Get the executable PHP script for this examplejÝX//samples/ObjectStore/update-object-metadata.phphM]hL]hJ]hK]hP]uh;jhT]rh]X.Get the executable PHP script for this exampler…r}r(h:Uh;j ubahFj±ubh]X ]r…r}r(h:X ]h;jubeubeubh<)r}r(h:Uh;jëhDhEhFhGhH}r(hJ]hK]hL]hM]rU copy-objectrahP]rh auhRM¨hShhT]r(hV)r}r(h:X Copy Objectr h;jhDhEhFhZhH}r!(hJ]hK]hL]hM]hP]uhRM¨hShhT]r"h]X Copy Objectr#…r$}r%(h:j h;jubaubha)r&}r'(h:XhYou can copy an object from one container to another, provided the destination container already exists.r(h;jhDhEhFhdhH}r)(hJ]hK]hL]hM]hP]uhRMªhShhT]r*h]XhYou can copy an object from one container to another, provided the destination container already exists.r+…r,}r-(h:j(h;j&ubaubhÌ)r.}r/(h:X$$object->copy('logos_copy/php.jpg');h;jhDhEhFháhH}r0(hÐhÑhM]hL]hJ]hK]r1(hÓXphpr2ehP]uhRM°hShhT]r3hÖ)r4}r5(h:X$$object->copy('logos_copy/php.jpg');hH}r6(hJ]hK]r7Uotherr8ahL]hM]hP]uh;j.hT]r9h]X$$object->copy('logos_copy/php.jpg');r:…r;}r<(h:Uh;j4ubahFhàubaubha)r=}r>(h:X][ `Get the executable PHP script for this example `__ ]h;jhDhEhFhdhH}r?(hJ]hK]hL]hM]hP]uhRM±hShhT]r@(h]X[ rA…rB}rC(h:X[ h;j=ubj¨)rD}rE(h:XY`Get the executable PHP script for this example `__hH}rF(UnameX.Get the executable PHP script for this examplejÝX$/samples/ObjectStore/copy-object.phphM]hL]hJ]hK]hP]uh;j=hT]rGh]X.Get the executable PHP script for this examplerH…rI}rJ(h:Uh;jDubahFj±ubh]X ]rK…rL}rM(h:X ]h;j=ubeubha)rN}rO(h:X±In the example above, both the name of the destination container (``logos_copy``)and the name of the destination object (``php.jpg``) have to be specified, separated by a ``/``.h;jhDhEhFhdhH}rP(hJ]hK]hL]hM]hP]uhRM´hShhT]rQ(h]XBIn the example above, both the name of the destination container (rR…rS}rT(h:XBIn the example above, both the name of the destination container (h;jNubh˜)rU}rV(h:X``logos_copy``hH}rW(hJ]hK]hL]hM]hP]uh;jNhT]rXh]X logos_copyrY…rZ}r[(h:Uh;jUubahFh ubh]X))and the name of the destination object (r\…r]}r^(h:X))and the name of the destination object (h;jNubh˜)r_}r`(h:X ``php.jpg``hH}ra(hJ]hK]hL]hM]hP]uh;jNhT]rbh]Xphp.jpgrc…rd}re(h:Uh;j_ubahFh ubh]X') have to be specified, separated by a rf…rg}rh(h:X') have to be specified, separated by a h;jNubh˜)ri}rj(h:X``/``hH}rk(hJ]hK]hL]hM]hP]uh;jNhT]rlh]X/…rm}rn(h:Uh;jiubahFh ubh]X.…ro}rp(h:X.h;jNubeubeubh<)rq}rr(h:Uh;jëhDhEhFhGhH}rs(hJ]hK]hL]hM]rtU delete-objectruahP]rvhauhRM¹hShhT]rw(hV)rx}ry(h:X Delete Objectrzh;jqhDhEhFhZhH}r{(hJ]hK]hL]hM]hP]uhRM¹hShhT]r|h]X Delete Objectr}…r~}r(h:jzh;jxubaubha)r€}r(h:X5When you no longer need an object, you can delete it.r‚h;jqhDhEhFhdhH}rƒ(hJ]hK]hL]hM]hP]uhRM»hShhT]r„h]X5When you no longer need an object, you can delete it.r……r†}r‡(h:j‚h;j€ubaubhÌ)rˆ}r‰(h:X$object->delete();h;jqhDhEhFháhH}rŠ(hÐhÑhM]hL]hJ]hK]r‹(hÓXphprŒehP]uhRMÀhShhT]rhÖ)rŽ}r(h:X$object->delete();hH}r(hJ]hK]r‘Uotherr’ahL]hM]hP]uh;jˆhT]r“h]X$object->delete();r”…r•}r–(h:Uh;jŽubahFhàubaubha)r—}r˜(h:X_[ `Get the executable PHP script for this example `__ ]h;jqhDhEhFhdhH}r™(hJ]hK]hL]hM]hP]uhRMÁhShhT]rš(h]X[ r›…rœ}r(h:X[ h;j—ubj¨)rž}rŸ(h:X[`Get the executable PHP script for this example `__hH}r (UnameX.Get the executable PHP script for this examplejÝX&/samples/ObjectStore/delete-object.phphM]hL]hJ]hK]hP]uh;j—hT]r¡h]X.Get the executable PHP script for this exampler¢…r£}r¤(h:Uh;jžubahFj±ubh]X ]r¥…r¦}r§(h:X ]h;j—ubeubeubh<)r¨}r©(h:Uh;jëhDhEhFhGhH}rª(hJ]hK]hL]hM]r«U bulk-deleter¬ahP]r­hauhRMÅhShhT]r®(hV)r¯}r°(h:X Bulk Deleter±h;j¨hDhEhFhZhH}r²(hJ]hK]hL]hM]hP]uhRMÅhShhT]r³h]X Bulk Deleter´…rµ}r¶(h:j±h;j¯ubaubha)r·}r¸(h:XqWhile you can delete individual objects as shown above, you can also delete objects and empty containers in bulk.r¹h;j¨hDhEhFhdhH}rº(hJ]hK]hL]hM]hP]uhRMÇhShhT]r»h]XqWhile you can delete individual objects as shown above, you can also delete objects and empty containers in bulk.r¼…r½}r¾(h:j¹h;j·ubaubhÌ)r¿}rÀ(h:X‚$objectStoreService->bulkDelete(array( 'logos/php-elephant.png', 'logos/python-snakes.png', 'some_empty_container' ));h;j¨hDhEhFháhH}rÁ(hÐhÑhM]hL]hJ]hK]rÂ(hÓXphprÃehP]uhRMÑhShhT]rÄhÖ)rÅ}rÆ(h:X‚$objectStoreService->bulkDelete(array( 'logos/php-elephant.png', 'logos/python-snakes.png', 'some_empty_container' ));hH}rÇ(hJ]hK]rÈUotherrÉahL]hM]hP]uh;j¿hT]rÊh]X‚$objectStoreService->bulkDelete(array( 'logos/php-elephant.png', 'logos/python-snakes.png', 'some_empty_container' ));rË…rÌ}rÍ(h:Uh;jÅubahFhàubaubha)rÎ}rÏ(h:X][ `Get the executable PHP script for this example `__ ]h;j¨hDhEhFhdhH}rÐ(hJ]hK]hL]hM]hP]uhRMÒhShhT]rÑ(h]X[ rÒ…rÓ}rÔ(h:X[ h;jÎubj¨)rÕ}rÖ(h:XY`Get the executable PHP script for this example `__hH}r×(UnameX.Get the executable PHP script for this examplejÝX$/samples/ObjectStore/bulk-delete.phphM]hL]hJ]hK]hP]uh;jÎhT]rØh]X.Get the executable PHP script for this examplerÙ…rÚ}rÛ(h:Uh;jÕubahFj±ubh]X ]rÜ…rÝ}rÞ(h:X ]h;jÎubeubha)rß}rà(h:XÑIn the example above, two objects (``some_container/object_a.png``, ``some_other_container/object_z.png``) and one empty container (``some_empty_container``) are all being deleted in bulk via a single command.h;j¨hDhEhFhdhH}rá(hJ]hK]hL]hM]hP]uhRMÕhShhT]râ(h]X#In the example above, two objects (rã…rä}rå(h:X#In the example above, two objects (h;jßubh˜)ræ}rç(h:X``some_container/object_a.png``hH}rè(hJ]hK]hL]hM]hP]uh;jßhT]réh]Xsome_container/object_a.pngrê…rë}rì(h:Uh;jæubahFh ubh]X, rí…rî}rï(h:X, h;jßubh˜)rð}rñ(h:X%``some_other_container/object_z.png``hH}rò(hJ]hK]hL]hM]hP]uh;jßhT]róh]X!some_other_container/object_z.pngrô…rõ}rö(h:Uh;jðubahFh ubh]X) and one empty container (r÷…rø}rù(h:X) and one empty container (h;jßubh˜)rú}rû(h:X``some_empty_container``hH}rü(hJ]hK]hL]hM]hP]uh;jßhT]rýh]Xsome_empty_containerrþ…rÿ}r(h:Uh;júubahFh ubh]X5) are all being deleted in bulk via a single command.r…r}r(h:X5) are all being deleted in bulk via a single command.h;jßubeubeubeubh<)r}r(h:Uh;hBhDhEhFhGhH}r(hJ]hK]hL]hM]rUcdn-containersrahP]r h%auhRMÛhShhT]r (hV)r }r (h:XCDN Containersr h;jhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRMÛhShhT]rh]XCDN Containersr…r}r(h:j h;j ubaubha)r}r(h:X¦Note: The functionality described in this section is available only on the Rackspace cloud. It will not work as described when working with a vanilla OpenStack cloud.rh;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMÝhShhT]rh]X¦Note: The functionality described in this section is available only on the Rackspace cloud. It will not work as described when working with a vanilla OpenStack cloud.r…r}r(h:jh;jubaubha)r}r(h:X§Any container can be converted to a CDN-enabled container. When this is done, the objects within the container can be accessed from anywhere on the Internet via a URL.rh;jhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMáhShhT]rh]X§Any container can be converted to a CDN-enabled container. When this is done, the objects within the container can be accessed from anywhere on the Internet via a URL.r …r!}r"(h:jh;jubaubh<)r#}r$(h:Uh;jhDhEhFhGhH}r%(hJ]hK]hL]hM]r&Uenable-cdn-containerr'ahP]r(h auhRMæhShhT]r)(hV)r*}r+(h:XEnable CDN Containerr,h;j#hDhEhFhZhH}r-(hJ]hK]hL]hM]hP]uhRMæhShhT]r.h]XEnable CDN Containerr/…r0}r1(h:j,h;j*ubaubha)r2}r3(h:XjTo take advantage of CDN capabilities for a container and its objects, you must CDN-enable that container.r4h;j#hDhEhFhdhH}r5(hJ]hK]hL]hM]hP]uhRMèhShhT]r6h]XjTo take advantage of CDN capabilities for a container and its objects, you must CDN-enable that container.r7…r8}r9(h:j4h;j2ubaubhÌ)r:}r;(h:X$container->enableCdn();h;j#hDhEhFháhH}r<(hÐhÑhM]hL]hJ]hK]r=(hÓXphpr>ehP]uhRMîhShhT]r?hÖ)r@}rA(h:X$container->enableCdn();hH}rB(hJ]hK]rCUotherrDahL]hM]hP]uh;j:hT]rEh]X$container->enableCdn();rF…rG}rH(h:Uh;j@ubahFhàubaubha)rI}rJ(h:Xf[ `Get the executable PHP script for this example `__ ]h;j#hDhEhFhdhH}rK(hJ]hK]hL]hM]hP]uhRMïhShhT]rL(h]X[ rM…rN}rO(h:X[ h;jIubj¨)rP}rQ(h:Xb`Get the executable PHP script for this example `__hH}rR(UnameX.Get the executable PHP script for this examplejÝX-/samples/ObjectStore/enable-container-cdn.phphM]hL]hJ]hK]hP]uh;jIhT]rSh]X.Get the executable PHP script for this examplerT…rU}rV(h:Uh;jPubahFj±ubh]X ]rW…rX}rY(h:X ]h;jIubeubeubh<)rZ}r[(h:Uh;jhDhEhFhGhH}r\(hJ]hK]hL]hM]r]U public-urlsr^ahP]r_h'auhRMóhShhT]r`(hV)ra}rb(h:X Public URLsrch;jZhDhEhFhZhH}rd(hJ]hK]hL]hM]hP]uhRMóhShhT]reh]X Public URLsrf…rg}rh(h:jch;jaubaubha)ri}rj(h:X,Once you have CDN-enabled a container, you can retrieve a publicly-accessible URL for any of its objects. There are four types of publicly-accessible URLs for each object. Each type of URL is meant for a different purpose. The sections below describe each of these URL types and how to retrieve them.rkh;jZhDhEhFhdhH}rl(hJ]hK]hL]hM]hP]uhRMõhShhT]rmh]X,Once you have CDN-enabled a container, you can retrieve a publicly-accessible URL for any of its objects. There are four types of publicly-accessible URLs for each object. Each type of URL is meant for a different purpose. The sections below describe each of these URL types and how to retrieve them.rn…ro}rp(h:jkh;jiubaubh<)rq}rr(h:Uh;jZhDhEhFhGhH}rs(hJ]hK]hL]hM]rtUhttp-urlruahP]rvhauhRMühShhT]rw(hV)rx}ry(h:XHTTP URLrzh;jqhDhEhFhZhH}r{(hJ]hK]hL]hM]hP]uhRMühShhT]r|h]XHTTP URLr}…r~}r(h:jzh;jxubaubha)r€}r(h:X<You can use this type of URL to access the object over HTTP.r‚h;jqhDhEhFhdhH}rƒ(hJ]hK]hL]hM]hP]uhRMþhShhT]r„h]X<You can use this type of URL to access the object over HTTP.r……r†}r‡(h:j‚h;j€ubaubhÌ)rˆ}r‰(h:X#$httpUrl = $object->getPublicUrl();h;jqhDhEhFháhH}rŠ(hÐhÑhM]hL]hJ]hK]hP]uhRMhShhT]r‹h]X#$httpUrl = $object->getPublicUrl();rŒ…r}rŽ(h:Uh;jˆubaubha)r}r(h:Xi[ `Get the executable PHP script for this example `__ ]h;jqhDhEhFhdhH}r‘(hJ]hK]hL]hM]hP]uhRMhShhT]r’(h]X[ r“…r”}r•(h:X[ h;jubj¨)r–}r—(h:Xe`Get the executable PHP script for this example `__hH}r˜(UnameX.Get the executable PHP script for this examplejÝX0/samples/ObjectStore/get-cdn-object-http-url.phphM]hL]hJ]hK]hP]uh;jhT]r™h]X.Get the executable PHP script for this examplerš…r›}rœ(h:Uh;j–ubahFj±ubh]X ]r…rž}rŸ(h:X ]h;jubeubeubh<)r }r¡(h:Uh;jZhDhEhFhGhH}r¢(hJ]hK]hL]hM]r£Usecure-http-urlr¤ahP]r¥h auhRMhShhT]r¦(hV)r§}r¨(h:XSecure HTTP URLr©h;j hDhEhFhZhH}rª(hJ]hK]hL]hM]hP]uhRMhShhT]r«h]XSecure HTTP URLr¬…r­}r®(h:j©h;j§ubaubha)r¯}r°(h:XFYou can use this type of URL to access the object over HTTP + TLS/SSL.r±h;j hDhEhFhdhH}r²(hJ]hK]hL]hM]hP]uhRM hShhT]r³h]XFYou can use this type of URL to access the object over HTTP + TLS/SSL.r´…rµ}r¶(h:j±h;j¯ubaubhÌ)r·}r¸(h:X^use OpenCloud\ObjectStore\Constants\UrlType; $httpsUrl = $object->getPublicUrl(UrlType::SSL);h;j hDhEhFháhH}r¹(hÐhÑhM]hL]hJ]hK]hP]uhRMhShhT]rºh]X^use OpenCloud\ObjectStore\Constants\UrlType; $httpsUrl = $object->getPublicUrl(UrlType::SSL);r»…r¼}r½(h:Uh;j·ubaubha)r¾}r¿(h:Xj[ `Get the executable PHP script for this example `__ ]h;j hDhEhFhdhH}rÀ(hJ]hK]hL]hM]hP]uhRMhShhT]rÁ(h]X[ rÂ…rÃ}rÄ(h:X[ h;j¾ubj¨)rÅ}rÆ(h:Xf`Get the executable PHP script for this example `__hH}rÇ(UnameX.Get the executable PHP script for this examplejÝX1/samples/ObjectStore/get-cdn-object-https-url.phphM]hL]hJ]hK]hP]uh;j¾hT]rÈh]X.Get the executable PHP script for this examplerÉ…rÊ}rË(h:Uh;jÅubahFj±ubh]X ]rÌ…rÍ}rÎ(h:X ]h;j¾ubeubeubh<)rÏ}rÐ(h:Uh;jZhDhEhFhGhH}rÑ(hJ]hK]hL]hM]rÒU streaming-urlrÓahP]rÔhauhRMhShhT]rÕ(hV)rÖ}r×(h:X Streaming URLrØh;jÏhDhEhFhZhH}rÙ(hJ]hK]hL]hM]hP]uhRMhShhT]rÚh]X Streaming URLrÛ…rÜ}rÝ(h:jØh;jÖubaubha)rÞ}rß(h:XdYou can use this type of URL to stream a video or audio object using Adobe's HTTP Dynamic Streaming.ràh;jÏhDhEhFhdhH}rá(hJ]hK]hL]hM]hP]uhRMhShhT]râh]XdYou can use this type of URL to stream a video or audio object using Adobe's HTTP Dynamic Streaming.rã…rä}rå(h:jàh;jÞubaubhÌ)ræ}rç(h:Xhuse OpenCloud\ObjectStore\Constants\UrlType; $streamingUrl = $object->getPublicUrl(UrlType::STREAMING);h;jÏhDhEhFháhH}rè(hÐhÑhM]hL]hJ]hK]hP]uhRMhShhT]réh]Xhuse OpenCloud\ObjectStore\Constants\UrlType; $streamingUrl = $object->getPublicUrl(UrlType::STREAMING);rê…rë}rì(h:Uh;jæubaubha)rí}rî(h:Xn[ `Get the executable PHP script for this example `__ ]h;jÏhDhEhFhdhH}rï(hJ]hK]hL]hM]hP]uhRM!hShhT]rð(h]X[ rñ…rò}ró(h:X[ h;jíubj¨)rô}rõ(h:Xj`Get the executable PHP script for this example `__hH}rö(UnameX.Get the executable PHP script for this examplejÝX5/samples/ObjectStore/get-cdn-object-streaming-url.phphM]hL]hJ]hK]hP]uh;jíhT]r÷h]X.Get the executable PHP script for this examplerø…rù}rú(h:Uh;jôubahFj±ubh]X ]rû…rü}rý(h:X ]h;jíubeubeubh<)rþ}rÿ(h:Uh;jZhDhEhFhGhH}r(hJ]hK]hL]hM]rUios-streaming-urlrahP]rh(auhRM%hShhT]r(hV)r}r(h:XIOS Streaming URLrh;jþhDhEhFhZhH}r(hJ]hK]hL]hM]hP]uhRM%hShhT]r h]XIOS Streaming URLr …r }r (h:jh;jubaubha)r }r(h:XQYou can use this type of URL to stream an audio or video object to an iOS device.rh;jþhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM'hShhT]rh]XQYou can use this type of URL to stream an audio or video object to an iOS device.r…r}r(h:jh;j ubaubhÌ)r}r(h:Xouse OpenCloud\ObjectStore\Constants\UrlType; $iosStreamingUrl = $object->getPublicUrl(UrlType::IOS_STREAMING);h;jþhDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]hP]uhRM,hShhT]rh]Xouse OpenCloud\ObjectStore\Constants\UrlType; $iosStreamingUrl = $object->getPublicUrl(UrlType::IOS_STREAMING);r…r}r(h:Uh;jubaubha)r}r(h:Xr[ `Get the executable PHP script for this example `__ ]h;jþhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRM0hShhT]r(h]X[ r …r!}r"(h:X[ h;jubj¨)r#}r$(h:Xn`Get the executable PHP script for this example `__hH}r%(UnameX.Get the executable PHP script for this examplejÝX9/samples/ObjectStore/get-cdn-object-ios-streaming-url.phphM]hL]hJ]hK]hP]uh;jhT]r&h]X.Get the executable PHP script for this exampler'…r(}r)(h:Uh;j#ubahFj±ubh]X ]r*…r+}r,(h:X ]h;jubeubeubeubh<)r-}r.(h:Uh;jhDhEhFhGhH}r/(hJ]hK]hL]hM]r0Uupdate-cdn-container-ttlr1ahP]r2h auhRM4hShhT]r3(hV)r4}r5(h:XUpdate CDN Container TTLr6h;j-hDhEhFhZhH}r7(hJ]hK]hL]hM]hP]uhRM4hShhT]r8h]XUpdate CDN Container TTLr9…r:}r;(h:j6h;j4ubaubha)r<}r=(h:X2You can update the TTL of a CDN-enabled container.r>h;j-hDhEhFhdhH}r?(hJ]hK]hL]hM]hP]uhRM6hShhT]r@h]X2You can update the TTL of a CDN-enabled container.rA…rB}rC(h:j>h;j<ubaubhÌ)rD}rE(h:XS$cdnContainer = $container->getCdn(); $cdnContainer->setTtl();h;j-hDhEhFháhH}rF(hÐhÑhM]hL]hJ]hK]rG(hÓXphprHehP]uhRM<hShhT]rIhÖ)rJ}rK(h:XS$cdnContainer = $container->getCdn(); $cdnContainer->setTtl();hH}rL(hJ]hK]rMUotherrNahL]hM]hP]uh;jDhT]rOh]XS$cdnContainer = $container->getCdn(); $cdnContainer->setTtl();rP…rQ}rR(h:Uh;jJubahFhàubaubha)rS}rT(h:Xg[ `Get the executable PHP script for this example `__ ]h;j-hDhEhFhdhH}rU(hJ]hK]hL]hM]hP]uhRM=hShhT]rV(h]X[ rW…rX}rY(h:X[ h;jSubj¨)rZ}r[(h:Xc`Get the executable PHP script for this example `__hH}r\(UnameX.Get the executable PHP script for this examplejÝX./samples/ObjectStore/set-cdn-container-ttl.phphM]hL]hJ]hK]hP]uh;jShT]r]h]X.Get the executable PHP script for this exampler^…r_}r`(h:Uh;jZubahFj±ubh]X ]ra…rb}rc(h:X ]h;jSubeubeubh<)rd}re(h:Uh;jhDhEhFhGhH}rf(hJ]hK]hL]hM]rgUdisable-cdn-containerrhahP]rihauhRMAhShhT]rj(hV)rk}rl(h:XDisable CDN Containerrmh;jdhDhEhFhZhH}rn(hJ]hK]hL]hM]hP]uhRMAhShhT]roh]XDisable CDN Containerrp…rq}rr(h:jmh;jkubaubha)rs}rt(h:XMIf you no longer need CDN capabilities for a container, you can disable them.ruh;jdhDhEhFhdhH}rv(hJ]hK]hL]hM]hP]uhRMChShhT]rwh]XMIf you no longer need CDN capabilities for a container, you can disable them.rx…ry}rz(h:juh;jsubaubhÌ)r{}r|(h:X$container->disableCdn();h;jdhDhEhFháhH}r}(hÐhÑhM]hL]hJ]hK]r~(hÓXphprehP]uhRMIhShhT]r€hÖ)r}r‚(h:X$container->disableCdn();hH}rƒ(hJ]hK]r„Uotherr…ahL]hM]hP]uh;j{hT]r†h]X$container->disableCdn();r‡…rˆ}r‰(h:Uh;jubahFhàubaubha)rŠ}r‹(h:Xg[ `Get the executable PHP script for this example `__ ]h;jdhDhEhFhdhH}rŒ(hJ]hK]hL]hM]hP]uhRMJhShhT]r(h]X[ rŽ…r}r(h:X[ h;jŠubj¨)r‘}r’(h:Xc`Get the executable PHP script for this example `__hH}r“(UnameX.Get the executable PHP script for this examplejÝX./samples/ObjectStore/disable-container-cdn.phphM]hL]hJ]hK]hP]uh;jŠhT]r”h]X.Get the executable PHP script for this exampler•…r–}r—(h:Uh;j‘ubahFj±ubh]X ]r˜…r™}rš(h:X ]h;jŠubeubeubeubh@eubhDhEhFhGhH}r›(hJ]hK]hL]hM]rœUaccountsrahP]ržh auhRMNhShhT]rŸ(hV)r }r¡(h:XAccountsr¢h;h@hDhEhFhZhH}r£(hJ]hK]hL]hM]hP]uhRMNhShhT]r¤h]XAccountsr¥…r¦}r§(h:j¢h;j ubaubha)r¨}r©(h:XiAn **account** defines a namespace for **containers**. An account can have zero or more containers in it.h;h@hDhEhFhdhH}rª(hJ]hK]hL]hM]hP]uhRMPhShhT]r«(h]XAn r¬…r­}r®(h:XAn h;j¨ubhg)r¯}r°(h:X **account**hH}r±(hJ]hK]hL]hM]hP]uh;j¨hT]r²h]Xaccountr³…r´}rµ(h:Uh;j¯ubahFhoubh]X defines a namespace for r¶…r·}r¸(h:X defines a namespace for h;j¨ubhg)r¹}rº(h:X**containers**hH}r»(hJ]hK]hL]hM]hP]uh;j¨hT]r¼h]X containersr½…r¾}r¿(h:Uh;j¹ubahFhoubh]X4. An account can have zero or more containers in it.rÀ…rÁ}rÂ(h:X4. An account can have zero or more containers in it.h;j¨ubeubh<)rÃ}rÄ(h:Uh;h@hDhEhFhGhH}rÅ(hJ]hK]hL]hM]rÆUretrieve-accountrÇahP]rÈhauhRMThShhT]rÉ(hV)rÊ}rË(h:XRetrieve AccountrÌh;jÃhDhEhFhZhH}rÍ(hJ]hK]hL]hM]hP]uhRMThShhT]rÎh]XRetrieve AccountrÏ…rÐ}rÑ(h:jÌh;jÊubaubha)rÒ}rÓ(h:XEYou must retrieve the account before performing any operations on it.rÔh;jÃhDhEhFhdhH}rÕ(hJ]hK]hL]hM]hP]uhRMVhShhT]rÖh]XEYou must retrieve the account before performing any operations on it.r×…rØ}rÙ(h:jÔh;jÒubaubhÌ)rÚ}rÛ(h:X-$account = $objectStoreService->getAccount();h;jÃhDhEhFháhH}rÜ(hÐhÑhM]hL]hJ]hK]rÝ(hÓXphprÞehP]uhRM[hShhT]rßhÖ)rà}rá(h:X-$account = $objectStoreService->getAccount();hH}râ(hJ]hK]rãUotherräahL]hM]hP]uh;jÚhT]råh]X-$account = $objectStoreService->getAccount();ræ…rç}rè(h:Uh;jàubahFhàubaubeubh<)ré}rê(h:Uh;h@hDhEhFhGhH}rë(hJ]hK]hL]hM]rìUget-container-countríahP]rîh,auhRM]hShhT]rï(hV)rð}rñ(h:XGet Container Countròh;jéhDhEhFhZhH}ró(hJ]hK]hL]hM]hP]uhRM]hShhT]rôh]XGet Container Countrõ…rö}r÷(h:jòh;jðubaubha)rø}rù(h:XAYou can quickly find out how many containers are in your account.rúh;jéhDhEhFhdhH}rû(hJ]hK]hL]hM]hP]uhRM_hShhT]rüh]XAYou can quickly find out how many containers are in your account.rý…rþ}rÿ(h:júh;jøubaubhÌ)r}r(h:X7$accountContainerCount = $account->getContainerCount();h;jéhDhEhFháhH}r(hÐhÑhM]hL]hJ]hK]r(hÓXphprehP]uhRMdhShhT]rhÖ)r}r(h:X7$accountContainerCount = $account->getContainerCount();hH}r(hJ]hK]r Uotherr ahL]hM]hP]uh;jhT]r h]X7$accountContainerCount = $account->getContainerCount();r …r }r(h:Uh;jubahFhàubaubha)r}r(h:Xm[ `Get the executable PHP script for this example `__ ]h;jéhDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMehShhT]r(h]X[ r…r}r(h:X[ h;jubj¨)r}r(h:Xi`Get the executable PHP script for this example `__hH}r(UnameX.Get the executable PHP script for this examplejÝX4/samples/ObjectStore/get-account-container-count.phphM]hL]hJ]hK]hP]uh;jhT]rh]X.Get the executable PHP script for this exampler…r}r(h:Uh;jubahFj±ubh]X ]r…r}r(h:X ]h;jubeubeubh=h<)r }r!(h:Uh?Kh;h@hDhEhFhGhH}r"(hJ]r#j²ahK]hL]hM]r$Uid2r%ahP]uhRMxhShhT]r&(hV)r'}r((h:XGet Bytes Usedr)h;j hDhEhFhZhH}r*(hJ]hK]hL]hM]hP]uhRMxhShhT]r+h]XGet Bytes Usedr,…r-}r.(h:j)h;j'ubaubha)r/}r0(h:XBYou can quickly find out the space used by your account, in bytes.r1h;j hDhEhFhdhH}r2(hJ]hK]hL]hM]hP]uhRMzhShhT]r3h]XBYou can quickly find out the space used by your account, in bytes.r4…r5}r6(h:j1h;j/ubaubhÌ)r7}r8(h:X/$accountSizeInBytes = $account->getBytesUsed();h;j hDhEhFháhH}r9(hÐhÑhM]hL]hJ]hK]r:(hÓXphpr;ehP]uhRMhShhT]r<hÖ)r=}r>(h:X/$accountSizeInBytes = $account->getBytesUsed();hH}r?(hJ]hK]r@UotherrAahL]hM]hP]uh;j7hT]rBh]X/$accountSizeInBytes = $account->getBytesUsed();rC…rD}rE(h:Uh;j=ubahFhàubaubha)rF}rG(h:Xh[ `Get the executable PHP script for this example `__ ]h;j hDhEhFhdhH}rH(hJ]hK]hL]hM]hP]uhRM€hShhT]rI(h]X[ rJ…rK}rL(h:X[ h;jFubj¨)rM}rN(h:Xd`Get the executable PHP script for this example `__hH}rO(UnameX.Get the executable PHP script for this examplejÝX//samples/ObjectStore/get-account-bytes-used.phphM]hL]hJ]hK]hP]uh;jFhT]rPh]X.Get the executable PHP script for this examplerQ…rR}rS(h:Uh;jMubahFj±ubh]X ]rT…rU}rV(h:X ]h;jFubeubha)rW}rX(h:X€In the example above, ``$accountSizeInBytes`` will contain the space used, in bytes, by the account represented by ``$account``.h;j hDhEhFhdhH}rY(hJ]hK]hL]hM]hP]uhRMƒhShhT]rZ(h]XIn the example above, r[…r\}r](h:XIn the example above, h;jWubh˜)r^}r_(h:X``$accountSizeInBytes``hH}r`(hJ]hK]hL]hM]hP]uh;jWhT]rah]X$accountSizeInBytesrb…rc}rd(h:Uh;j^ubahFh ubh]XF will contain the space used, in bytes, by the account represented by re…rf}rg(h:XF will contain the space used, in bytes, by the account represented by h;jWubh˜)rh}ri(h:X ``$account``hH}rj(hJ]hK]hL]hM]hP]uh;jWhT]rkh]X$accountrl…rm}rn(h:Uh;jhubahFh ubh]X.…ro}rp(h:X.h;jWubeubeubeubhDhEhFhGhH}rq(hJ]rrj`ahK]hL]hM]rsUid1rtahP]uhRMihShhT]ru(hV)rv}rw(h:XGet Object Countrxh;h=hDhEhFhZhH}ry(hJ]hK]hL]hM]hP]uhRMihShhT]rzh]XGet Object Countr{…r|}r}(h:jxh;jvubaubha)r~}r(h:X>You can quickly find out how many objects are in your account.r€h;h=hDhEhFhdhH}r(hJ]hK]hL]hM]hP]uhRMkhShhT]r‚h]X>You can quickly find out how many objects are in your account.rƒ…r„}r…(h:j€h;j~ubaubhÌ)r†}r‡(h:X1$accountObjectCount = $account->getObjectCount();h;h=hDhEhFháhH}rˆ(hÐhÑhM]hL]hJ]hK]r‰(hÓXphprŠehP]uhRMphShhT]r‹hÖ)rŒ}r(h:X1$accountObjectCount = $account->getObjectCount();hH}rŽ(hJ]hK]rUotherrahL]hM]hP]uh;j†hT]r‘h]X1$accountObjectCount = $account->getObjectCount();r’…r“}r”(h:Uh;jŒubahFhàubaubha)r•}r–(h:Xj[ `Get the executable PHP script for this example `__ ]h;h=hDhEhFhdhH}r—(hJ]hK]hL]hM]hP]uhRMqhShhT]r˜(h]X[ r™…rš}r›(h:X[ h;j•ubj¨)rœ}r(h:Xf`Get the executable PHP script for this example `__hH}rž(UnameX.Get the executable PHP script for this examplejÝX1/samples/ObjectStore/get-account-object-count.phphM]hL]hJ]hK]hP]uh;j•hT]rŸh]X.Get the executable PHP script for this exampler …r¡}r¢(h:Uh;jœubahFj±ubh]X ]r£…r¤}r¥(h:X ]h;j•ubeubha)r¦}r§(h:X|In the example above, ``$accountObjectCount`` will contain the number of objects in the account represented by ``$account``.h;h=hDhEhFhdhH}r¨(hJ]hK]hL]hM]hP]uhRMthShhT]r©(h]XIn the example above, rª…r«}r¬(h:XIn the example above, h;j¦ubh˜)r­}r®(h:X``$accountObjectCount``hH}r¯(hJ]hK]hL]hM]hP]uh;j¦hT]r°h]X$accountObjectCountr±…r²}r³(h:Uh;j­ubahFh ubh]XB will contain the number of objects in the account represented by r´…rµ}r¶(h:XB will contain the number of objects in the account represented by h;j¦ubh˜)r·}r¸(h:X ``$account``hH}r¹(hJ]hK]hL]hM]hP]uh;j¦hT]rºh]X$accountr»…r¼}r½(h:Uh;j·ubahFh ubh]X.…r¾}r¿(h:X.h;j¦ubeubeubhDhEhFUsystem_messagerÀhH}rÁ(hJ]UlevelKhM]hL]rÂjtaUsourcehEhK]hP]UlineMiUtypeUINFOrÃuhRMihShhT]rÄha)rÅ}rÆ(h:UhH}rÇ(hJ]hK]hL]hM]hP]uh;h8hT]rÈh]X3Duplicate implicit target name: "get object count".rÉ…rÊ}rË(h:Uh;jÅubahFhdubaubh7)rÌ}rÍ(h:Uh;j hDhEhFjÀhH}rÎ(hJ]UlevelKhM]hL]rÏj%aUsourcehEhK]hP]UlineMxUtypejÃuhRMxhShhT]rÐha)rÑ}rÒ(h:UhH}rÓ(hJ]hK]hL]hM]hP]uh;jÌhT]rÔh]X1Duplicate implicit target name: "get bytes used".rÕ…rÖ}r×(h:Uh;jÑubahFhdubaubeUcurrent_sourcerØNU decorationrÙNUautofootnote_startrÚKUnameidsrÛ}rÜ(hjÇhjéhj h j1h j'h j¤h j h jhhOhj”hjuhj:hj¸hNhj×hj¬hjhhjhj¹hjŸhjµ hjÓhjähjKhjuhjMh jh!Nh"jïh#jh$jºh%jh&jih'j^h(jh)j¯ h*j)h+hwh,jíh-h†h.j h/jQh0jÒ h1jh2jJuhT]rÝhBah:UU transformerrÞNU footnote_refsrß}ràUrefnamesrá}râUsymbol_footnotesrã]räUautofootnote_refsrå]ræUsymbol_footnote_refsrç]rèU citationsré]rêhShU current_linerëNUtransform_messagesrì]ríUreporterrîNUid_startrïKU autofootnotesrð]rñU citation_refsrò}róUindirect_targetsrô]rõUsettingsrö(cdocutils.frontend Values r÷orø}rù(Ufootnote_backlinksrúKUrecord_dependenciesrûNU rfc_base_urlrüUhttp://tools.ietf.org/html/rýU tracebackrþˆUpep_referencesrÿNUstrip_commentsrNU toc_backlinksrjÎU language_coderUenrU datestamprNU report_levelrKU _destinationrNU halt_levelrKU strip_classesrNhZNUerror_encoding_error_handlerr Ubackslashreplacer Udebugr NUembed_stylesheetr ‰Uoutput_encoding_error_handlerr UstrictrU sectnum_xformrKUdump_transformsrNU docinfo_xformrKUwarning_streamrNUpep_file_url_templaterUpep-%04drUexit_status_levelrKUconfigrNUstrict_visitorrNUcloak_email_addressesrˆUtrim_footnote_reference_spacer‰UenvrNUdump_pseudo_xmlrNUexpose_internalsrNUsectsubtitle_xformr‰U source_linkrNUrfc_referencesrNUoutput_encodingr Uutf-8r!U source_urlr"NUinput_encodingr#U utf-8-sigr$U_disable_configr%NU id_prefixr&UU tab_widthr'KUerror_encodingr(UUTF-8r)U_sourcer*hEUgettext_compactr+ˆU generatorr,NUdump_internalsr-NU smart_quotesr.‰U pep_base_urlr/Uhttp://www.python.org/dev/peps/r0Usyntax_highlightr1Ulongr2Uinput_encoding_error_handlerr3jUauto_id_prefixr4Uidr5Udoctitle_xformr6‰Ustrip_elements_with_classesr7NU _config_filesr8]Ufile_insertion_enabledr9ˆU raw_enabledr:KU dump_settingsr;NubUsymbol_footnote_startr<KUidsr=}r>(j jœjjjujqjÇjÃjQjMj¯ j« jäjàjh@j'j#j¤j jj}j:j6jjj´j®jíjéj×jÓj%j jth=jijeh†h‚j)j%jKjGj¬j¨jjþj jj¹jµjïjëjjjjhOhBjJjFjŸj›j^jZjMjIhwhsj1j-jºj¶jéjåjÒ jÎ jµ j± j”jjbj\j jjhjdj¸j´jujqjÓjÏuUsubstitution_namesr?}r@hFhShH}rA(hJ]hM]hL]UsourcehEhK]hP]uU footnotesrB]rCUrefidsrD}rEub.