You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by na...@apache.org on 2015/03/20 10:24:59 UTC
jclouds git commit: Deprecate Nova API for volumes in favour of
Cinder API for volumes
Repository: jclouds
Updated Branches:
refs/heads/master b54c788e7 -> fdb2cfe56
Deprecate Nova API for volumes in favour of Cinder API for volumes
Project: http://git-wip-us.apache.org/repos/asf/jclouds/repo
Commit: http://git-wip-us.apache.org/repos/asf/jclouds/commit/fdb2cfe5
Tree: http://git-wip-us.apache.org/repos/asf/jclouds/tree/fdb2cfe5
Diff: http://git-wip-us.apache.org/repos/asf/jclouds/diff/fdb2cfe5
Branch: refs/heads/master
Commit: fdb2cfe567b81c2f1089f3a94f538133d724b137
Parents: b54c788
Author: Everett Toews <ev...@rackspace.com>
Authored: Wed Mar 18 17:34:10 2015 -0500
Committer: Ignasi Barrera <na...@apache.org>
Committed: Fri Mar 20 10:08:07 2015 +0100
----------------------------------------------------------------------
.../nova/v2_0/extensions/VolumeApi.java | 32 ++++++++++++++++++++
.../v2_0/extensions/VolumeAttachmentApi.java | 15 ++-------
2 files changed, 34 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/jclouds/blob/fdb2cfe5/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeApi.java b/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeApi.java
index 4e80d5b..16b01f5 100644
--- a/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeApi.java
+++ b/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeApi.java
@@ -48,7 +48,11 @@ import com.google.common.collect.FluentIterable;
/**
* Provides access to the OpenStack Compute (Nova) Volume extension API.
+ *
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi} or
+ * {@link org.jclouds.openstack.cinder.v1.features.VolumeApi} instead. To be removed in jclouds 2.0.
*/
+@Deprecated
@Beta
@Extension(of = ServiceType.COMPUTE, namespace = ExtensionNamespaces.VOLUMES)
@RequestFilters(AuthenticateRequest.class)
@@ -57,8 +61,11 @@ public interface VolumeApi {
/**
* Returns a summary list of snapshots.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi#list()} instead.
+ * To be removed in jclouds 2.0.
* @return the list of snapshots
*/
+ @Deprecated
@Named("volume:list")
@GET
@Path("/os-volumes")
@@ -69,8 +76,11 @@ public interface VolumeApi {
/**
* Returns a detailed list of volumes.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi#listInDetail()} instead.
+ * To be removed in jclouds 2.0.
* @return the list of volumes.
*/
+ @Deprecated
@Named("volume:list")
@GET
@Path("/os-volumes/detail")
@@ -81,8 +91,11 @@ public interface VolumeApi {
/**
* Return data about the given volume.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi#get(String)} instead.
+ * To be removed in jclouds 2.0.
* @return details of a specific snapshot.
*/
+ @Deprecated
@Named("volume:get")
@GET
@Path("/os-volumes/{id}")
@@ -94,8 +107,11 @@ public interface VolumeApi {
/**
* Creates a new Snapshot
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi#create(int, CreateVolumeOptions)} instead.
+ * To be removed in jclouds 2.0.
* @return the new Snapshot
*/
+ @Deprecated
@Named("volume:create")
@POST
@Path("/os-volumes")
@@ -107,8 +123,11 @@ public interface VolumeApi {
/**
* Delete a snapshot.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.VolumeApi#delete(String)} instead.
+ * To be removed in jclouds 2.0.
* @return true if successful
*/
+ @Deprecated
@Named("volume:delete")
@DELETE
@Path("/os-volumes/{volumeId}")
@@ -120,8 +139,11 @@ public interface VolumeApi {
/**
* Returns a summary list of snapshots.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.SnapshotApi#list()} instead.
+ * To be removed in jclouds 2.0.
* @return the list of snapshots
*/
+ @Deprecated
@Named("volume:listSnapshots")
@GET
@Path("/os-snapshots")
@@ -132,8 +154,11 @@ public interface VolumeApi {
/**
* Returns a summary list of snapshots.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.SnapshotApi#listInDetail()} instead.
+ * To be removed in jclouds 2.0.
* @return the list of snapshots
*/
+ @Deprecated
@Named("volume:listSnapshots")
@GET
@Path("/os-snapshots/detail")
@@ -144,8 +169,11 @@ public interface VolumeApi {
/**
* Return data about the given snapshot.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.SnapshotApi#get(String)} instead.
+ * To be removed in jclouds 2.0.
* @return details of a specific snapshot.
*/
+ @Deprecated
@Named("volume:getSnapshot")
@GET
@Path("/os-snapshots/{id}")
@@ -157,6 +185,8 @@ public interface VolumeApi {
/**
* Creates a new Snapshot.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.SnapshotApi#create(String, CreateVolumeSnapshotOptions)} instead.
+ * To be removed in jclouds 2.0.
* @return the new Snapshot
*/
@Named("volume:createSnapshot")
@@ -170,6 +200,8 @@ public interface VolumeApi {
/**
* Delete a snapshot.
*
+ * @deprecated Please use {@link org.jclouds.openstack.cinder.v1.features.SnapshotApi#delete(String)} instead.
+ * To be removed in jclouds 2.0.
* @return true if successful
*/
@Named("volume:deleteSnapshot")
http://git-wip-us.apache.org/repos/asf/jclouds/blob/fdb2cfe5/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeAttachmentApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeAttachmentApi.java b/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeAttachmentApi.java
index bc24036..f274651 100644
--- a/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeAttachmentApi.java
+++ b/apis/openstack-nova/src/main/java/org/jclouds/openstack/nova/v2_0/extensions/VolumeAttachmentApi.java
@@ -40,25 +40,14 @@ import org.jclouds.rest.annotations.RequestFilters;
import org.jclouds.rest.annotations.SelectJson;
import org.jclouds.rest.annotations.WrapWith;
-import com.google.common.annotations.Beta;
import com.google.common.collect.FluentIterable;
/**
* Provides access to the OpenStack Compute (Nova) Volume Attachments Extension API.
*
- * This API strictly handles attaching Volumes to Servers. To create and manage Volumes you need to use one of the
- * following APIs:
- *
- * 1. The Cinder API
- * If your OpenStack deployment is Folsom or later and it supports the Cinder block storage service, use this API.
- * @see org.jclouds.openstack.cinder.v1.features.VolumeApi
- *
- * 2. The nova-volume API
- * If your OpenStack deployment is Essex or earlier and it supports the nova-volume extension, use this API.
- * @see org.jclouds.openstack.nova.v2_0.extensions.VolumeApi
- *
+ * This API strictly handles attaching Volumes to Servers. To create and manage Volumes you need to use the Cinder API.
+ * @see org.jclouds.openstack.cinder.v1.features.VolumeApi
*/
-@Beta
@Extension(of = ServiceType.COMPUTE, namespace = ExtensionNamespaces.VOLUME_ATTACHMENTS)
@RequestFilters(AuthenticateRequest.class)
@Consumes(MediaType.APPLICATION_JSON)