Skip to content
Permalink
Browse files
Better explanation of Beta APIs
  • Loading branch information
Everett Toews committed Apr 3, 2014
1 parent 052e6cc commit ab188ef803fc002ceed86bd6d86c12dedde95069
Show file tree
Hide file tree
Showing 11 changed files with 51 additions and 14 deletions.
@@ -3,7 +3,7 @@ jclouds Labs OpenStack

Repository for developing OpenStack providers and APIs

Although this is a "labs" repository, some of the providers and APIs here are production ready. The reason they have not been merged into into jclouds core is because there isn't a suitable abstraction layer for them yet. Please review the README in each sub-directory to determine if the provider or API is production ready.
Although this is a "labs" repository, some of the providers and APIs here are production ready. The reason they have not been merged into into jclouds repository is because there isn't a suitable abstraction layer for them yet. Please review the README in each sub-directory to determine if the provider or API is production ready.

### Summary

@@ -12,16 +12,20 @@ Although this is a "labs" repository, some of the providers and APIs here are pr
| openstack-glance | API | No |
| openstack-marconi | API | No |
| openstack-neutron | API | Yes |
| openstack-swift | API | No |
| openstack-swift | API | Beta |
| rackspace-autoscale | API | No |
| rackspace-cloudfiles | API | No |
| rackspace-autoscale-us | Provider | No |
| rackspace-cloudfiles-uk | Provider | No |
| rackspace-cloudfiles-us | Provider | No |
| rackspace-cloudfiles-uk | Provider | Beta |
| rackspace-cloudfiles-us | Provider | Beta |
| rackspace-cloudqueues-us | Provider | No |

APIs new to jclouds are marked as Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. It is recommended you adopt this code sooner than later.

How long APIs are in Beta is variable but it will be at minimum one release.

License
-------
Copyright (C) 2009-2013 jclouds, Inc.
Copyright (C) 2009-2014 The Apache Software Foundation

Licensed under the Apache License, Version 2.0
@@ -4,4 +4,7 @@ OpenStack Swift
Swift is a distributed object storage system designed to scale from a single machine to thousands of servers.

Production ready?
No
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.

@@ -41,7 +41,11 @@
* <p/>
* OpenStack Object Storage is an object-based storage system that stores content and metadata
* as objects. You create, modify, and get objects and metadata using this API.
*
* <p/>
* 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.
*
* @author Adrian Cole
* @author Jeremy Daggett
* @author Zack Shoylev
@@ -47,6 +47,10 @@
* <p/>
* Account metadata prefixed with {@code X-Account-Meta-} will be converted
* appropriately using a binder/parser.
* <p/>
* 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.
*
* @author Jeremy Daggett
*
@@ -46,7 +46,11 @@

/**
* Provides access to the Swift Bulk API.
*
* <p/>
* 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.
*
* @author Adrian Cole
* @author Jeremy Daggett
*/
@@ -53,7 +53,11 @@

/**
* Provides access to the Swift Container API features.
*
* <p/>
* 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.
*
* @author Adrian Cole
* @author Zack Shoylev
* @author Jeremy Daggett
@@ -59,7 +59,11 @@

/**
* Provides access to the Swift Object API features.
*
* <p/>
* 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.
*
* @author Adrian Cole
* @author Jeremy Daggett
*/
@@ -44,7 +44,11 @@

/**
* Provides access to the Swift Static Large Object API features.
*
* <p/>
* 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.
*
* @author Adrian Cole
* @author Jeremy Daggett
*/
@@ -16,4 +16,6 @@ With this multi-region support, a BlobStore can be isolated to a specific region
BlobStore dfwBlobStore = ctx.blobStoreInRegion("LON");

Production ready?
No
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.
@@ -17,4 +17,6 @@ With this multi-region support, each BlobStore can be isolated to a specific reg
BlobStore iadBlobStore = ctx.blobStoreInRegion("IAD");

Production ready?
No
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.
@@ -17,4 +17,6 @@ With this multi-region support, each BlobStore can be isolated to a specific reg
BlobStore iadBlobStore = ctx.blobStoreInRegion("IAD");

Production ready?
No
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.

0 comments on commit ab188ef

Please sign in to comment.