Repository: jclouds-labs-openstack Updated Branches: refs/heads/1.7.x 4230b6bb0 -> d0f88e95a
Better explanation of Beta APIs Project: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/repo Commit: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/commit/d0f88e95 Tree: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/tree/d0f88e95 Diff: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/diff/d0f88e95 Branch: refs/heads/1.7.x Commit: d0f88e95adfc0e2d860615bad0088922aefa1c37 Parents: 4230b6b Author: Everett Toews <[email protected]> Authored: Thu Apr 3 17:17:55 2014 -0500 Committer: Everett Toews <[email protected]> Committed: Thu Apr 3 17:34:41 2014 -0500 ---------------------------------------------------------------------- README.md | 12 +++++++++--- openstack-swift/README.md | 5 ++++- .../java/org/jclouds/openstack/swift/v1/SwiftApi.java | 6 +++++- .../jclouds/openstack/swift/v1/features/AccountApi.java | 4 ++++ .../jclouds/openstack/swift/v1/features/BulkApi.java | 6 +++++- .../openstack/swift/v1/features/ContainerApi.java | 6 +++++- .../jclouds/openstack/swift/v1/features/ObjectApi.java | 6 +++++- .../swift/v1/features/StaticLargeObjectApi.java | 6 +++++- rackspace-cloudfiles-uk/README.md | 4 +++- rackspace-cloudfiles-us/README.md | 4 +++- rackspace-cloudfiles/README.md | 4 +++- 11 files changed, 51 insertions(+), 12 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index af43803..2698b33 100644 --- a/README.md +++ b/README.md @@ -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,13 +12,19 @@ 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-autoscale-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 http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/README.md ---------------------------------------------------------------------- diff --git a/openstack-swift/README.md b/openstack-swift/README.md index c30eb1e..59bd846 100644 --- a/openstack-swift/README.md +++ b/openstack-swift/README.md @@ -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. + http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java index 3e48b2c..c403521 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/SwiftApi.java @@ -40,7 +40,11 @@ import com.google.inject.Provides; * <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 http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java index 57f9ef0..9646ab6 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/AccountApi.java @@ -45,6 +45,10 @@ import org.jclouds.rest.annotations.ResponseParser; * <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 * http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java index ba5825e..9953955 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/BulkApi.java @@ -45,7 +45,11 @@ import com.google.common.base.Joiner; /** * 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 */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java index e698e2f..fdaa73b 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ContainerApi.java @@ -52,7 +52,11 @@ import com.google.common.collect.FluentIterable; /** * 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 http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java index 97c38b0..ee96f22 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/ObjectApi.java @@ -58,7 +58,11 @@ import org.jclouds.rest.annotations.ResponseParser; /** * 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 */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java ---------------------------------------------------------------------- diff --git a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java index b077be3..47cdb86 100644 --- a/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java +++ b/openstack-swift/src/main/java/org/jclouds/openstack/swift/v1/features/StaticLargeObjectApi.java @@ -42,7 +42,11 @@ import org.jclouds.rest.binders.BindToJsonPayload; /** * 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 */ http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/rackspace-cloudfiles-uk/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles-uk/README.md b/rackspace-cloudfiles-uk/README.md index 52ea6ec..71d04bb 100644 --- a/rackspace-cloudfiles-uk/README.md +++ b/rackspace-cloudfiles-uk/README.md @@ -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. http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/rackspace-cloudfiles-us/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles-us/README.md b/rackspace-cloudfiles-us/README.md index 25ded8c..9bd50c2 100644 --- a/rackspace-cloudfiles-us/README.md +++ b/rackspace-cloudfiles-us/README.md @@ -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. http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/d0f88e95/rackspace-cloudfiles/README.md ---------------------------------------------------------------------- diff --git a/rackspace-cloudfiles/README.md b/rackspace-cloudfiles/README.md index 1142323..3da83d2 100644 --- a/rackspace-cloudfiles/README.md +++ b/rackspace-cloudfiles/README.md @@ -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.
