Programmatic Access Via API
A standards-based API enables your applications to directly control your Cloud Files storage. The Rackspace Cloud Files API is a RESTful API, with support for all major bindings listed below.
API Features
- Enable your application to upload files programmatically
- Enable Cloud Files CDN integration on any container for public distribution
- Create Containers programmatically
- Retrieve lists of containers and files
API Operations for Storage & CDN Services
Storage Account Services
- List Containers
- Retrieve Account Metadata
Storage Container Services
- List Objects
- Create Container
- Delete Container
- Retrieve Container Metadata
Storage Object Services
- Retrieve Object
- Create/Update Object
- Copy Object
- Delete Object
- Retrieve Object Metadata
- Update Object Metadata
CDN Account Operations
- List CDN-Enabled Containers
CDN Container Services
- CDN-Enabled Container
- List CDN-Enabled Container Metadata
- Purge CDN-Enabled Containers or Objects
- Update CDN-Enabled Container Metadata
- CDN-Enabled Containers Served via SSL
Popular Code Examples
Upload File to Container
curl
-X PUT -T screenies/hello.jpg -D - \
-H "ETag: 805120e285a7ed28f74024422fe3594" \
-H "Content-Type: image/jpeg" \
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
-H "X-Object-Meta-Screenie: Hello World" \
https://storage.clouddrive.com/v1/CF_xer7_343/
images/hello.jpg
-H "ETag: 805120e285a7ed28f74024422fe3594" \
-H "Content-Type: image/jpeg" \
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
-H "X-Object-Meta-Screenie: Hello World" \
https://storage.clouddrive.com/v1/CF_xer7_343/
images/hello.jpg
HTTP/1.1 201 Created
Date: Thu, 09 July 2009 17:03:36 GMT
Server: Apache
Content-Length: 0
ETag: 805120e285a7ed28f74024422fe3594
Content-Type: text/plain
Date: Thu, 09 July 2009 17:03:36 GMT
Server: Apache
Content-Length: 0
ETag: 805120e285a7ed28f74024422fe3594
Content-Type: text/plain
List Container Storage
curl
-X HEAD -D - \
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
https://storage.clouddrive.com/v1/CF_xer7_343
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
https://storage.clouddrive.com/v1/CF_xer7_343
HTTP/1.1 204 No Content
Date: Thu, 09 July 2009 15:38:14 GMT
Server: Apache
X-Account-Container-Count: 22
X-Account-Bytes-Used: 9891628380
Content-Type: text/plain
Date: Thu, 09 July 2009 15:38:14 GMT
Server: Apache
X-Account-Container-Count: 22
X-Account-Bytes-Used: 9891628380
Content-Type: text/plain
CDN Enable Container
curl
-X PUT -D - \
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
-H "X-CDN-Enabled: True" \
-H "X-TTL: 259200"\
https://storage.clouddrive.com/v1/CF_xer7_343/images
-H "X-Auth-Token: fc81aaa6-98a1-9ab0-94ba-aba9a89aa9ae" \
-H "X-CDN-Enabled: True" \
-H "X-TTL: 259200"\
https://storage.clouddrive.com/v1/CF_xer7_343/images
HTTP/1.1 202 Accepted
Date: Thu, 06 Aug 2009 01:34:13 GMT
Server: Apache
X-CDN-URI: http://c10171.r71.cf0.rackcdn.com
X-CDN-SSL-URI: https://c10171.ssl.cf0.rackcdn.com
Content-Length: 0
Connection: close
Content-Type: text/plain; charset-UTF-8
Date: Thu, 06 Aug 2009 01:34:13 GMT
Server: Apache
X-CDN-URI: http://c10171.r71.cf0.rackcdn.com
X-CDN-SSL-URI: https://c10171.ssl.cf0.rackcdn.com
Content-Length: 0
Connection: close
Content-Type: text/plain; charset-UTF-8
Powered by the Cloud Files API
The Cloud Files Application Programming Interface (API) allows developers to build their own unique solutions on top of Rackspace's infrastructure. Below are three examples of the numerous applications that have been built using the Cloud Files API.
Lockerz (formerly Plixi)
Stay in control, with Cloud Files. Get started by creating a Rackspace Cloud account.
Sign Up Now