Revision 4e5673a0 docs/source/devguide.rst

b/docs/source/devguide.rst
25 25
=========================  ================================
26 26
Revision                   Description
27 27
=========================  ================================
28
0.8 (Dec 2, 2011)          Update allowed versioning values.
28
0.8 (Dec 15, 2011)         Update allowed versioning values.
29 29
\                          Change policy/meta formatting in JSON/XML replies.
30 30
\                          Document that all non-ASCII characters in headers should be URL-encoded.
31
\                          Support metadata-based queries when listing objects at the container level.
31 32
0.7 (Nov 21, 2011)         Suggest upload/download methods using hashmaps.
32 33
\                          Propose syncing algorithm.
33 34
\                          Support cross-account object copy and move.
......
441 442
delimiter               Return objects up to the delimiter (discussion follows)
442 443
path                    Assume ``prefix=path`` and ``delimiter=/``
443 444
format                  Optional extended reply type (can be ``json`` or ``xml``)
444
meta                    Return objects having the specified meta keys (can be a comma separated list)
445
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 ``=``, ``!=``, ``<=``, ``>=``, ``<``, ``>``)
445 446
shared                  Show only shared objects (no value parameter)
446 447
until                   Optional timestamp
447 448
======================  ===================================
......
489 490

  
490 491
Extended replies may also include virtual directory markers in separate sections of the ``json`` or ``xml`` results.
491 492
Virtual directory markers are only included when ``delimiter`` is explicitly set. They correspond to the substrings up to and including the first occurrence of the delimiter.
492
In JSON results they appear as dictionaries with only a ``"subdir"`` key. In XML results they appear interleaved with ``<object>`` tags as ``<subdir name="..." />``.
493
In JSON results they appear as dictionaries with only a ``subdir`` key. In XML results they appear interleaved with ``<object>`` tags as ``<subdir name="..." />``.
493 494
In case there is an object with the same name as a virtual directory marker, the object will be returned.
494 495

  
495 496
Example ``format=json`` reply:

Also available in: Unified diff