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.

2013-02-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

1.1. Authentication HTTP Request
1.2. Authentication HTTP Response
2.1. Storage Account Services HTTP Request
2.2. List Containers HTTP Request
2.3. List Containers HTTP Response
2.4. Get Containers Details HTTP and JSON Request
2.5. Get Containers Details HTTP and JSON Response
2.6. Containers Details HTTP and XML Request
2.7. Containers Details HTTP and XML Response
2.8. List Large Number of Containers
2.9. Get Account Metadata HTTP Request
2.10. Get Account Metadata HTTP Response
2.11. Update Account Metadata HTTP Request
2.12. Update Account Metadata HTTP Response
2.13. View Account Metadata HTTP Request
2.14. View Account Metadata HTTP Response
2.15. Delete Account Metadata HTTP Request
2.16. Storage Container Services HTTP Request
2.17. List Objects HTTP Request
2.18. List Objects HTTP Response
2.19. Get Objects Details HTTP and JSON Request
2.20. Get Objects Details HTTP and JSON Response
2.21. Objects Details Request: XML
2.22. Objects Details Request: XML
2.23. List Large Number of Objects
2.24. List Pseudo-Hierarchical Folders/Directories Request
2.25. Create Container HTTP Request
2.26. Create Container HTTP Response
2.27. Container Create Container with Metadata HTTP Request
2.28. Create Container with Metadata HTTP Response
2.29. Delete Container HTTP Request
2.30. Delete Container HTTP Response
2.31. Get Container Metadata HTTP Request
2.32. Get Container Metadata HTTP Response
2.33. Update Container Metadata HTTP Request
2.34. Update Container Metadata HTTP Response
2.35. View Container Metadata HTTP Request
2.36. View Container Metadata HTTP Response
2.37. Delete Container Metadata HTTP Request
2.38. Make Container Publicly Readable
2.39. Set Site Index File
2.40. Enable File Listing
2.41. Enable CSS for File Listing
2.42. Set Error Pages for Static Website Request
2.43. Get Object Details HTTP Request
2.44. Get Object Details HTTP Response
2.45. Create or Update Object HTTP Request
2.46. Create or Update Object HTTP Response
2.47. Upload Segment of Large Object HTTP Request
2.48. Upload Segment of Large Object HTTP Response
2.49. Upload Next Segment of Large Object HTTP Request
2.50. Upload Next Segment of Large Object HTTP Response
2.51. Upload Manifest HTTP Request
2.52. Upload Manifest HTTP Response
2.53. Upload Unspecified Quantity of Content HTTP Request
2.54. Upload Unspecified Quantity of Content HTTP Response
2.55. Assign CORS Header HTTP Request
2.56. Content-Encoding Header HTTP Request
2.57. Content-Disposition Header HTTP Request
2.58. Delete Object at HTTP Request
2.59. Delete Object after HTTP Request
2.60. Object Versioning with cURL
2.61. Object Copy Method 1
2.62. Object Copy Method 2
2.63. Object Delete HTTP Request
2.64. Object Delete HTTP Response
2.65. Get Object Metadata HTTP Request
2.66. Get Object Metadata HTTP Response
2.67. Update Object Metadata HTTP Request
2.68. Update Object Metadata HTTP Response
3.1. cURL Authenticate
3.2. cURL Get Storage Space
3.3. cURL List Storage Container
3.4. cURL Create Storage Container
3.5. cURL List Storage Container After a Creation
3.6. cURL List Storage Container (long list)
3.7. cURL List Storage Container with Paging (first page)
3.8. cURL List Storage Container with Paging (later pages)
3.9. cURL List Storage Container (JSON output)
3.10. cURL List Storage Container (XML output)
3.11. cURL List Container Metadata
3.12. cURL Delete Storage Container
3.13. cURL List Containers After a Delete
3.14. cURL List Container Showing Lack of ACL
3.15. cURL Setting an ACL on a Container
3.16. cURL List Container Showing with an ACL
3.17. Sample File Listing
3.18. Creating and Uploading an Object to a Container
3.19. cURL List Container Showing Newly Uploaded Object
3.20. cURL List Container Showing Multiple Newly Uploaded Objects
3.21. cURL List Objects (first page)
3.22. cURL List Objects with Paging (later pages)
3.23. Removing Local Copies
3.24. cURL Retrieve an Object
3.25. cURL Server-side Copy an Object
3.26. cURL Confirming the Server-side Copy an Object
3.27. cURL Delete an Object
3.28. cURL Confirming the Delete an Object
3.29. cURL Set Object Metadata
3.30. cURL Reading Object Metadata
3.31. cURL Create New Container for Folders
3.32. cURL Listing the New Container
3.33. cURL Upload an Object with a Prefix
3.34. cURL Upload a Different Object with a Different Prefix
3.35. cURL Listing a Container with Object Prefix
3.36. cURL Listing a Container with a Path
3.37. cURL Listing a Container with a Delimiter

Legal notices