Revision 6fe32fb6 docs/pithos-api-guide.rst

b/docs/pithos-api-guide.rst
27 27 
=========================  ================================
28 28 
Revision                   Description
29 29 
=========================  ================================
30 
0.13 (Mar 27, 2013)        Restrict public object listing only to the owner.
31 
                           Do not propagate public URL information in shared objects.
30 32 
0.13 (Jan 21, 2013)        Proxy identity management services
31 33 
\                          UUID to displayname translation
32 34 
0.9 (Feb 17, 2012)         Change permissions model.
......
367 369 
marker                  Return containers with name lexicographically after marker
368 370 
format                  Optional extended reply type (can be ``json`` or ``xml``)
369 371 
shared                  Show only shared containers (no value parameter)
370 
public                  Show only public containers (no value parameter)
372 
public                  Show only public containers (no value parameter / avalaible only for owner requests)
371 373 
until                   Optional timestamp
372 374 
======================  =========================
373 375 

  		





  ......




  542
  544
  
    
path                    Assume ``prefix=path`` and ``delimiter=/``


  		





  543
  545
  
    
format                  Optional extended reply type (can be ``json`` or ``xml``)


  		





  544
  546
  
    
meta                    Return objects that satisfy the key queries in the specified comma separated list (use ``<key>``, ``!<key>`` for existence queries, ``<key><op><value>`` for value queries, where ``<op>`` can be one of ``=``, ``!=``, ``<=``, ``>=``, ``<``, ``>``)


  		





  545
  
  
    
shared                  Show only shared objects (no value parameter)


  		





  546
  
  
    
public                  Show only public containers (no value parameter)


  		





  
  547
  
    
shared                  Show only objects (no value parameter)


  		





  
  548
  
    
public                  Show only public objects (no value parameter / avalaible only for owner reqeusts)


  		





  547
  549
  
    
until                   Optional timestamp


  		





  548
  550
  
    
======================  ===================================


  		





  549
  551
  
    

  		





  ......




  1136
  1138
  
    

  		





  1137
  1139
  
    
A user may ``GET`` another account or container. The result will include a limited reply, containing only the allowed containers or objects respectively. A top-level request with an authentication token, will return a list of allowed accounts, so the user can easily find out which other users share objects. The ``X-Object-Allowed-To`` header lists the actions allowed on an object, if it does not belong to the requesting user.


  		





  1138
  1140
  
    

  		





  
  1141
  
    
Shared objects that are also public do not expose the ``X-Object-Public`` meta information.


  		





  
  1142
  
    

  		





  1139
  1143
  
    
Objects that are marked as public, via the ``X-Object-Public`` meta, are also available at the corresponding URI returned for ``HEAD`` or ``GET``. Requests for public objects do not need to include an ``X-Auth-Token``. Pithos will ignore request parameters and only include the following headers in the reply (all ``X-Object-*`` meta is hidden):


  		





  1140
  1144
  
    

  		





  1141
  1145
  
    
==========================  ===============================


  		












Also available in:
  Unified diff