History

Andrew Gaul 8b94febfeb Throw consistent exception on invalid range read Previously S3, Swift, and local blobstores threw a generic IllegalArgumentException for this uncommon error. Instead consistently throw HttpResponseException.		2017-11-10 21:39:47 -08:00
..
src	Throw consistent exception on invalid range read	2017-11-10 21:39:47 -08:00
README.md	Better explanation of Beta APIs	2014-04-03 17:33:22 -05:00
pom.xml	Make auto service optional	2017-08-30 12:23:49 -07:00

README.md

Rackspace Cloud Files

The new Rackspace Cloud Files multi-region based service API.

This new "rackspace-cloudfiles" API supercedes the jclouds "cloudfiles" API, which will eventually be deprecated.

With this multi-region support, each BlobStore can be isolated to a specific region:

 RegionScopedBlobStoreContext ctx = 
 	contextBuilder.buildView(RegionScopedBlobStoreContext.class);

 Set<String> regionIds = ctx.configuredRegions();

 // isolated to a specific region
 BlobStore dfwBlobStore = ctx.blobStoreInRegion("DFW");
 BlobStore iadBlobStore = ctx.blobStoreInRegion("IAD");

Production ready? Beta

This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later.