This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:
- [x] This doc is inaccurate in this way: Account API does not document 'DELETE' verb, which is a valid request to delete an account
- [x] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.
If you have a troubleshooting or support issue, use the following resources:
- Ask OpenStack: http://ask.openstack.org
- The mailing list: http://lists.openstack.org
- IRC: 'openstack' channel on Freenode
-----------------------------------
Release: 2.14.1.dev142 on 'Fri Jul 7 02:07:14 2017, commit 63c4215'
SHA:
Source: https://git.openstack.org/cgit/openstack/swift/tree/api-ref/source/index.rst
URL: https://developer.openstack.org/api-ref/object-storage/
Originally, the reason for this is that delete account was something only an reseller-admin would do and that end users cannot/should not do -- and the api docs were aimed at end users. However, given that a) we documented create (aka PUT) account and b) reseller-admins need an API reference, I think the original thinking is invalid, so delete account should be documented.
I've seen people, playing with curl, delete their own account by forgetting to specify a container, so at the very least it would be a good place to warn users that delete account is a one-way operation and not easily recovered from -- and more importantly, you cannot simply create an account with the same name again; specifically in OpenStack context: delete account should only be done *after* the project/tenant has been deleted from Keystone.