Revision 81f947fd docs/source/devguide.rst

b/docs/source/devguide.rst
25 25 
=========================  ================================
26 26 
Revision                   Description
27 27 
=========================  ================================
28 
0.5 (July 14, 2011)        Object update from another object's data.
28 
0.5 (July 16, 2011)        Object update from another object's data.
29 29 
\                          Support object truncate.
30 30 
\                          Create object using a standard HTML form.
31 
\                          Purge container/object history.
31 32 
0.4 (July 01, 2011)        Object permissions and account groups.
32 33 
\                          Control versioning behavior and container quotas with container policy directives.
33 34 
\                          Support updating/deleting individual metadata with ``POST``.
......
55 56 
* Container level: ``https://hostname/v1/<account>/<container>``
56 57 
* Object level: ``https://hostname/v1/<account>/<container>/<object>``
57 58 

  		





  58
  
  
    
All requests must include an ``X-Auth-Token``. The process of obtaining the token is still to be determined (**TBD**).


  		





  
  59
  
    
All requests must include an ``X-Auth-Token`` - as a header, or a parameter. The process of obtaining the token is still to be determined (**TBD**).


  		





  59
  60
  
    

  		





  60
  61
  
    
The allowable request operations and respective return codes per level are presented in the remainder of this chapter. Common to all requests are the following return codes.


  		





  61
  62
  
    

  		





  ......




  400
  401
  
    
DELETE


  		





  401
  402
  
    
""""""


  		





  402
  403
  
    

  		





  403
  
  
    
No request parameters/headers.


  		





  
  404
  
    
======================  ===================================


  		





  
  405
  
    
Request Parameter Name  Value


  		





  
  406
  
    
======================  ===================================


  		





  
  407
  
    
until                   Optional timestamp


  		





  
  408
  
    
======================  ===================================


  		





  
  409
  
    

  		





  
  410
  
    
If ``until`` is defined, the container is "purged" up to that time (the history of all objects up to then is deleted).


  		





  404
  411
  
    

  		





  405
  412
  
    
No reply content/headers.


  		





  406
  413
  
    

  		





  ......




  763
  770
  
    
DELETE


  		





  764
  771
  
    
""""""


  		





  765
  772
  
    

  		





  766
  
  
    
No request parameters/headers.


  		





  
  773
  
    
======================  ===================================


  		





  
  774
  
    
Request Parameter Name  Value


  		





  
  775
  
    
======================  ===================================


  		





  
  776
  
    
until                   Optional timestamp


  		





  
  777
  
    
======================  ===================================


  		





  
  778
  
    

  		





  
  779
  
    
If ``until`` is defined, the object is "purged" up to that time (the history up to then is deleted).


  		





  767
  780
  
    

  		





  768
  781
  
    
No reply content/headers.


  		





  769
  782
  
    

  		





  ......




  818
  831
  
    
* Support for prefix-based inheritance when enforcing permissions. Parent object carrying the authorization directives is reported in ``X-Object-Shared-By``.


  		





  819
  832
  
    
* Large object support with ``X-Object-Manifest``.


  		





  820
  833
  
    
* Trace the user that created/modified an object with ``X-Object-Modified-By``.


  		





  
  834
  
    
* Purge container/object history with the ``until`` parameter in ``DELETE``.


  		





  821
  835
  
    

  		





  822
  836
  
    
Clarifications/suggestions:


  		





  823
  837
  
    

  		












Also available in:
  Unified diff