OpenStack Object Storage Developer Guide

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

2012-03-22

Abstract

This document is intended for software developers interested in developing applications using the OpenStack™ Object Storage Application Programming Interface (API).

List of Examples

2.1. Authentication Request
2.2. Authentication Response
3.1. Storage Account HTTP Request: General Structure
3.2. Containers List Request
3.3. Containers List Response
3.4. Containers Details Request: JSON
3.5. Containers Details Response: JSON
3.6. Containers Details Request: XML
3.7. Containers Details Response: XML
3.8. List Large Number of Containers
3.9. Account Metadata Request
3.10. Account Metadata Response
3.11. Storage Container HTTP Request: General Structure
3.12. Objects List Request
3.13. Objects List Response
3.14. Objects Details Request: JSON
3.15. Objects Details Response: JSON
3.16. Objects Details Request: XML
3.17. Objects Details Request: XML
3.18. List Large Number of Objects
3.19. Pseudo-Hierarchical Folders/Directories
3.20. Container Create Request
3.21. Container Create Response
3.22. Container Create Request with Metadata
3.23. Container Create Response
3.24. Container Delete Request
3.25. Container Delete Response
3.26. Container Metadata Request
3.27. Container Metadata Response
3.28. Update Container Metadata Request
3.29. Update Container Metadata Response
3.30. View Container Metadata Request
3.31. View Container Metadata Response
3.32. Retrieve Object Request
3.33. Retrieve Object Response
3.34. Create/Update Object Request
3.35. Create/Update Object Response
3.36. Upload Segment of a Large Object
3.37. Upload Next Segment of the Large Object
3.38. Upload Manifest
3.39. Upload Unspecified Quantity of Content
3.40. Assign CORS Header
3.41. Content-Encoding Header Example
3.42. Content-Disposition Header Example
3.43. Delete At Example
3.44. Delete After Example
3.45. Object Delete Request
3.46. Object Delete Response
3.47. Object Metadata Request
3.48. Object Metadata Response
3.49. Update Object Metadata Request
3.50. Update Object Metadata Response
4.1. cURL Authenticate
4.2. cURL Get Storage Space
4.3. cURL List Storage Container
4.4. cURL Create Storage Container
4.5. cURL List Storage Container After a Creation
4.6. cURL List Storage Container (long list)
4.7. cURL List Storage Container with Paging (first page)
4.8. cURL List Storage Container with Paging (later pages)
4.9. cURL List Storage Container (JSON output)
4.10. cURL List Storage Container (XML output)
4.11. cURL List Container Metadata
4.12. cURL Delete Storage Container
4.13. cURL List Containers After a Delete
4.14. cURL List Container Showing Lack of ACL
4.15. cURL Setting an ACL on a Container
4.16. cURL List Container Showing with an ACL
4.17. Sample File Listing
4.18. Creating and Uploading an Object to a Container
4.19. cURL List Container Showing Newly Uploaded Object
4.20. cURL List Container Showing Multiple Newly Uploaded Objects
4.21. cURL List Objects (first page)
4.22. cURL List Objects with Paging (later pages)
4.23. Removing Local Copies
4.24. cURL Retrieve an Object
4.25. cURL Server-side Copy an Object
4.26. cURL Confirming the Server-side Copy an Object
4.27. cURL Delete an Object
4.28. cURL Confirming the Delete an Object
4.29. cURL Set Object Metadata
4.30. cURL Reading Object Metadata
4.31. cURL Create New Container for Folders
4.32. cURL Listing the New Container
4.33. cURL Upload an Object with a Prefix
4.34. cURL Upload a Different Object with a Different Prefix
4.35. cURL Listing a Container with Object Prefix
4.36. cURL Listing a Container with a Path
4.37. cURL Listing a Container with a Delimiter

Legal notices