Difference between revisions of "Swift/API"
< Swift
(→Features) |
|||
| Line 76: | Line 76: | ||
* ACLs are specifically '''not''' part of the 1.0 spec | * ACLs are specifically '''not''' part of the 1.0 spec | ||
| − | * | + | * "warts" like etags and the differences in setting metadata are defined as they exist today in the code (ie existing clients can't break) |
Revision as of 18:18, 13 May 2013
Contents
Swift API Definition
Goal: To define the v1.0 API spec for Swift.
We should try to not exclude existing clusters with a v1 definition. Later, after the v1 API is set, then we can discuss changes for v1.1 or v2.
Current v1 API docs
http://docs.openstack.org/api/openstack-object-storage/1.0/content/
Outstanding TODOs
- What do we do about middleware? (see below)
- Implement API versioning and discoverability (see http://lists.openstack.org/pipermail/openstack-dev/2013-May/008436.html)
- Update docs to reflect API changes
Middleware
| Middleware | In v1 API | Notes |
|---|---|---|
| account_quotas | no | [2] |
| acl | - | [1] |
| bulk | no | [2] |
| catch_errors | - | [1] |
| cname_lookup | no | [2] |
| container_quotas | no | [2] |
| crossdomain | no | [2] |
| domain_remap | no | [2] |
| formpost | no | [2] |
| healthcheck | yes | required |
| keystoneauth | yes | openstack |
| list_endpoints | no | [2] |
| memcache | - | [1] |
| name_check | no | [2] |
| proxy_logging | - | [1] |
| ratelimit | no | [2] |
| recon | - | [1] |
| slo | no | [2] |
| staticweb | no | [2] |
| tempauth | - | For testing |
| tempurl | no | [2] [3] |
notes
[1] Not part of the external API, therefore NA
[2] Not widely deployed
[3] torgomatic wants this in core since it's been around forever and it's just so damn useful for so many things
Features
- ACLs are specifically not part of the 1.0 spec
- "warts" like etags and the differences in setting metadata are defined as they exist today in the code (ie existing clients can't break)
