9ce596a5a6
Fixes a number of technical issues with the api-ref section including: - Added missing headers - The header descriptions were made specific to whether they are used in requests or responses and the verb in question (example: Content-Length in object HEAD is the object size, not the response body length). - Added references to API features such as bulk delete. - Many typographical fixes (e.g., spaces in the middle of header names) - Restored xml and json account/container listing examples. The following areas were not updated and it is proposed to defer them to a subsequent update. This is because I don't have time or their merit is debatable: - ACLs (as used in a Keystone context) are not described. - Account create/delete is not described. - I left List Endpoints as-is. Change-Id: I315b4e550b7d10880fbc00fce9311127ba609c2d
47 lines
935 B
ReStructuredText
47 lines
935 B
ReStructuredText
.. -*- rst -*-
|
|
|
|
===============
|
|
Discoverability
|
|
===============
|
|
|
|
If configured, lists the activated capabilities for this version of
|
|
the OpenStack Object Storage API.
|
|
|
|
|
|
List activated capabilities
|
|
===========================
|
|
|
|
.. rest_method:: GET /info
|
|
|
|
Lists the activated capabilities for this version of the OpenStack Object Storage API.
|
|
|
|
Most of the information is "public" i.e. visible to all callers. However, some
|
|
configuration and capability items are reserved for the administrators of the
|
|
system. To access this data, the ``swiftinfo_sig`` and ``swiftinfo_expires``
|
|
query parameters must be added to the request.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- swiftinfo_sig: swiftinfo_sig
|
|
- swiftinfo_expires: swiftinfo_expires
|
|
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/capabilities-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|