You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by za...@apache.org on 2015/03/11 19:00:57 UTC

jclouds-labs-openstack git commit: Improves the autoscale docs.

Repository: jclouds-labs-openstack
Updated Branches:
  refs/heads/master 4cf1a990d -> eeceb98b7


Improves the autoscale docs.


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/eeceb98b
Tree: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/tree/eeceb98b
Diff: http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/diff/eeceb98b

Branch: refs/heads/master
Commit: eeceb98b740f0cc9ee231faa99916ad7321d7800
Parents: 4cf1a99
Author: Zack Shoylev <za...@rackspace.com>
Authored: Tue Mar 10 16:44:28 2015 -0500
Committer: Zack Shoylev <za...@rackspace.com>
Committed: Wed Mar 11 12:59:16 2015 -0500

----------------------------------------------------------------------
 .../v1/domain/CreateScalingPolicy.java          | 11 +++
 .../rackspace/autoscale/v1/domain/Group.java    | 22 ++---
 .../autoscale/v1/domain/GroupConfiguration.java | 52 ++++++++----
 .../v1/domain/LaunchConfiguration.java          | 89 ++++++++++++++++----
 .../autoscale/v1/domain/LoadBalancer.java       | 13 ++-
 .../autoscale/v1/domain/Personality.java        | 10 ++-
 .../autoscale/v1/domain/ScalingPolicy.java      | 10 +--
 7 files changed, 155 insertions(+), 52 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/CreateScalingPolicy.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/CreateScalingPolicy.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/CreateScalingPolicy.java
index ddb9e92..e6b8107 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/CreateScalingPolicy.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/CreateScalingPolicy.java
@@ -188,6 +188,7 @@ public class CreateScalingPolicy implements Comparable<CreateScalingPolicy> {
       protected Map<String, String> args;
 
       /**
+       * Required.
        * @param name The name of this ScalingPolicy.
        * @return The builder object.
        * @see CreateScalingPolicy#getName()
@@ -198,6 +199,9 @@ public class CreateScalingPolicy implements Comparable<CreateScalingPolicy> {
       }
 
       /**
+       * Required.
+       * The type of policy that will be executed for the current release, this value can be either webhook or schedule.
+       *
        * @param type The type for this ScalingPolicy.
        * @return The builder object.
        * @see ScalingPolicyType
@@ -209,6 +213,11 @@ public class CreateScalingPolicy implements Comparable<CreateScalingPolicy> {
       }
 
       /**
+       * Required.
+       * The cooldown period, in seconds, before this particular scaling policy can be executed again. The policy
+       * cooldown period does not affect the global scaling group cooldown. The minimum value for this parameter is
+       * 0 seconds, the maximum value is 86400 seconds (24 hrs).
+       *
        * @param cooldown The cooldown of this ScalingPolicy.
        * @return The builder object.
        * @see CreateScalingPolicy#getCooldown()
@@ -240,6 +249,7 @@ public class CreateScalingPolicy implements Comparable<CreateScalingPolicy> {
       }
 
       /**
+       * Optional.
        * @param cron This parameter specifies the recurring time when the policy will be executed as a cron entry.
        * For example, if this is parameter is set to "1 0 * * *",
        * the policy will be executed at one minute past midnight (00:01)
@@ -257,6 +267,7 @@ public class CreateScalingPolicy implements Comparable<CreateScalingPolicy> {
       }
 
       /**
+       * Optional.
        * @param at This parameter specifies the time at which this policy will be executed.
        * This property is mutually exclusive with the "cron" parameter.
        * You can either provide "cron" or "at" for a given policy, but not both.

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Group.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Group.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Group.java
index 27b1619..59bac88 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Group.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Group.java
@@ -42,7 +42,7 @@ public class Group {
       this.scalingPolicy = scalingPolicy;
       this.groupConfiguration = groupConfiguration;
       this.launchConfiguration = launchConfiguration;
-   }      
+   }
 
    /**
     * Unique group identifier, usually UUID
@@ -99,7 +99,7 @@ public class Group {
       if (this == obj) return true;
       if (obj == null || getClass() != obj.getClass()) return false;
       Group that = Group.class.cast(obj);
-      return Objects.equal(this.id, that.id) && 
+      return Objects.equal(this.id, that.id) &&
             Objects.equal(this.links, that.links) &&
             Objects.equal(this.scalingPolicy, that.scalingPolicy) &&
             Objects.equal(this.groupConfiguration, that.groupConfiguration) &&
@@ -120,11 +120,11 @@ public class Group {
       return string().toString();
    }
 
-   public static Builder builder() { 
+   public static Builder builder() {
       return new Builder();
    }
 
-   public Builder toBuilder() { 
+   public Builder toBuilder() {
       return new Builder().fromGroup(this);
    }
 
@@ -135,7 +135,7 @@ public class Group {
       protected GroupConfiguration groupConfiguration;
       protected LaunchConfiguration launchConfiguration;
 
-      /** 
+      /**
        * @param id The id of this Group.
        * @return The builder object.
        * @see Group#getId()
@@ -145,7 +145,7 @@ public class Group {
          return this;
       }
 
-      /** 
+      /**
        * @param links The links of this Group.
        * @return The builder object.
        * @see Group#getLinks()
@@ -155,17 +155,17 @@ public class Group {
          return this;
       }
 
-      /** 
+      /**
        * @param scalingPolicy The scaling policies list of this Group.
        * @return The builder object.
-       * @see Group#getScalingPolicy()
+       * @see Group#getScalingPolicies()
        */
       public Builder scalingPolicy(List<ScalingPolicy> scalingPolicy) {
          this.scalingPolicy = ImmutableList.copyOf(scalingPolicy);
          return this;
       }
 
-      /** 
+      /**
        * @param groupConfiguration The groupConfiguration of this Group.
        * @return The builder object.
        * @see Group#getGroupConfiguration()
@@ -175,7 +175,7 @@ public class Group {
          return this;
       }
 
-      /** 
+      /**
        * @param launchConfiguration The launchConfiguration of this Group.
        * @return The builder object.
        * @see Group#getLaunchConfiguration()
@@ -199,6 +199,6 @@ public class Group {
                .scalingPolicy(in.getScalingPolicies())
                .groupConfiguration(in.getGroupConfiguration())
                .launchConfiguration(in.getLaunchConfiguration());
-      }        
+      }
    }
 }

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/GroupConfiguration.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/GroupConfiguration.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/GroupConfiguration.java
index 484a03f..5bda01d 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/GroupConfiguration.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/GroupConfiguration.java
@@ -30,7 +30,7 @@ import com.google.common.collect.ImmutableMap;
 
 /**
  * Autoscale GroupConfiguration.
- * 
+ *
  * @see GroupApi#create(GroupConfiguration, LaunchConfiguration, java.util.List)
  */
 public class GroupConfiguration implements Comparable<GroupConfiguration>{
@@ -65,7 +65,7 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
     */
    public String getName() {
       return this.name;
-   }   
+   }
 
    /**
     * @return the cooldown for this GroupConfiguration.
@@ -109,7 +109,7 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
       if (this == obj) return true;
       if (obj == null || getClass() != obj.getClass()) return false;
       GroupConfiguration that = GroupConfiguration.class.cast(obj);
-      return Objects.equal(this.name, that.name) && 
+      return Objects.equal(this.name, that.name) &&
             Objects.equal(this.cooldown, that.cooldown) &&
             Objects.equal(this.minEntities, that.minEntities) &&
             Objects.equal(this.maxEntities, that.maxEntities) &&
@@ -130,11 +130,11 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
       return string().toString();
    }
 
-   public static Builder builder() { 
+   public static Builder builder() {
       return new Builder();
    }
 
-   public Builder toBuilder() { 
+   public Builder toBuilder() {
       return new Builder().fromGroupConfiguration(this);
    }
 
@@ -145,7 +145,10 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
       protected int maxEntities;
       protected Map<String, String> metadata;
 
-      /** 
+      /**
+       * Required.
+       * The name of the scaling group, does not need to be unique.
+       *
        * @param name The name of this GroupConfiguration.
        * @return The builder object.
        * @see GroupConfiguration#getName()
@@ -155,8 +158,12 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
          return this;
       }
 
-      /** 
-       * @param name The cooldown for this GroupConfiguration.
+      /**
+       * Required.
+       * The period of time, in seconds, that must pass before any scaling can occur after the previous scaling.
+       * Must be an integer between 0 and 86400 (24 hrs).
+       *
+       * @param cooldown The cooldown for this GroupConfiguration.
        * @return The builder object.
        * @see GroupConfiguration#getCooldown()
        */
@@ -165,8 +172,11 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
          return this;
       }
 
-      /** 
-       * @param name The cooldown for this GroupConfiguration.
+      /**
+       * Required.
+       * The minimum number of entities in the scaling group. This number must be an integer between 0 and 1000.
+       *
+       * @param minEntities The cooldown for this GroupConfiguration.
        * @return The builder object.
        * @see GroupConfiguration#getCooldown()
        */
@@ -175,8 +185,12 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
          return this;
       }
 
-      /** 
-       * @param name The maxEntities for this GroupConfiguration.
+      /**
+       * Optional.
+       * The maximum number of entities that are allowed in the scaling group. If unconfigured, defaults to 1000.
+       * If this parameter is provided it must be set to an integer between 0 and 1000.
+       *
+       * @param maxEntities The maxEntities for this GroupConfiguration.
        * @return The builder object.
        * @see GroupConfiguration#getCooldown()
        */
@@ -185,10 +199,15 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
          return this;
       }
 
-      /** 
-       * @param name The metadata for this GroupConfiguration.
+      /**
+       * Optional.
+       * This optional parameter specifies custom metadata for your group configuration. You can use the metadata
+       * parameter for customer automation, but it does not change any functionality in Auto Scale. There currently is
+       * no limitation on depth.
+       *
+       * @param metadata The metadata for this GroupConfiguration.
        * @return The builder object.
-       * @see GroupConfiguration#getDatabases()
+       * @see GroupConfiguration#getMetadata()
        */
       public Builder metadata(Map<String, String> metadata) {
          this.metadata = metadata;
@@ -196,7 +215,6 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
       }
 
       /**
-       * 
        * @return A new GroupConfiguration object.
        */
       public GroupConfiguration build() {
@@ -210,7 +228,7 @@ public class GroupConfiguration implements Comparable<GroupConfiguration>{
                .minEntities(in.getMinEntities())
                .maxEntities(in.getMaxEntities())
                .metadata(in.getMetadata());
-      }        
+      }
    }
 
    @Override

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LaunchConfiguration.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LaunchConfiguration.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LaunchConfiguration.java
index c6c6041..e781d4f 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LaunchConfiguration.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LaunchConfiguration.java
@@ -31,7 +31,10 @@ import com.google.common.collect.ImmutableMap;
 
 /**
  * Autoscale LaunchConfiguration.
- * 
+ * What to do when a new server is created. Its configuration includes information about the server image,
+ * the flavor of the server image, and to which cloud load balancer or RackConnectV3 load balancer pool to connect.
+ * The type parameter for launchConfiguration must be set to LAUNCH_SERVER
+ *
  * @see GroupApi#create(GroupConfiguration, LaunchConfiguration, List)
  */
 public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
@@ -130,7 +133,7 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
 
    /**
     * @return the server metadata for this LaunchConfiguration.
-    * @see LaunchConfiguration.Builder#serverMetadata(ImmutableMap)
+    * @see LaunchConfiguration.Builder#serverMetadata(Map)
     */
    public ImmutableMap<String, String> getServerMetadata() {
       return this.serverMetadata;
@@ -146,11 +149,11 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
       if (this == obj) return true;
       if (obj == null || getClass() != obj.getClass()) return false;
       LaunchConfiguration that = LaunchConfiguration.class.cast(obj);
-      return Objects.equal(this.loadBalancers, that.loadBalancers) && 
+      return Objects.equal(this.loadBalancers, that.loadBalancers) &&
             Objects.equal(this.type, that.type) &&
             Objects.equal(this.networks, that.networks) &&
             Objects.equal(this.personalities, that.personalities) &&
-            Objects.equal(this.serverName, that.serverName) &&      
+            Objects.equal(this.serverName, that.serverName) &&
             Objects.equal(this.serverImageRef, that.serverImageRef) &&
             Objects.equal(this.serverFlavorRef, that.serverFlavorRef) &&
             Objects.equal(this.serverDiskConfig, that.serverDiskConfig) &&
@@ -175,11 +178,11 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
       return string().toString();
    }
 
-   public static Builder builder() { 
+   public static Builder builder() {
       return new Builder();
    }
 
-   public Builder toBuilder() { 
+   public Builder toBuilder() {
       return new Builder().fromLaunchConfiguration(this);
    }
 
@@ -195,7 +198,11 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
       protected String serverDiskConfig;
       protected ImmutableMap<String, String> serverMetadata;
 
-      /** 
+      /**
+       * Optional.
+       * Details about one or more load balancers to add new servers to. All servers are added to these load balancers
+       * with the IP addresses of their ServiceNet network. All servers are enabled and equally weighted.
+       * Any new servers that are not connected to the ServiceNet network are not added to any load balancers.
        * @param loadBalancers The load balancers of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getLoadBalancers()
@@ -205,7 +212,9 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Required.
+       * The type of the launch configuration. Currently, this parameter must be set to launch_server.
        * @param type The type for this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getType()
@@ -215,7 +224,22 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Optional.
+       * The networks to which you want to attach the server.
+       * This attribute enables you to attach to an isolated network for your tenant ID, the public Internet network,
+       * and the private ServiceNet network.
+       * If you do not specify any networks, your server is attached to the public Internet and private
+       * ServiceNet networks.
+       * If you specify one or more networks, your server is attached to only the networks that you specify.
+       * If you want to attach to the private ServiceNet or public Internet networks, you must specify them explicitly.
+       * The UUID for the private ServiceNet is 11111111-1111-1111-1111-111111111111.
+       * The UUID for the public Internet is 00000000-0000-0000-0000-000000000000.
+       *
+       * You cannot attach a private network to an OnMetal server. Future generations of OnMetal servers will have
+       * this capability. Until then, use ServiceNet for internal traffic, and remember to secure your OnMetal
+       * server because ServiceNet is open to other Rackspace customers.
+       *
        * @param networks The networks of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getNetworks()
@@ -225,18 +249,32 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Optional.
+       * The file path and/or the content that you want to inject into a server image.
+       * For more information, see the Server Personality documentation for Rackspace Cloud Servers.
+       *
        * @param personalities The personalities of this LaunchConfiguration.
        * @return The builder object.
        * @see Personality
        * @see LaunchConfiguration#getPersonalities()
+       * @see <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.html">
+       *    Server Personality
+       *    </a>
        */
       public Builder personalities(List<Personality> personalities) {
          this.personalities = personalities;
          return this;
       }
 
-      /** 
+      /**
+       * Required.
+       * The server name.
+       * The name that you specify in a create request becomes the initial host name of the server.
+       * After the server is built, if you change the server name in the API or change the host name directly,
+       * the names are not kept in sync.
+       * Also, server names are not guaranteed to be unique.
+       *
        * @param serverName The serverName of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getServerName()
@@ -246,7 +284,9 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Required.
+       * The ID of the cloud server image, after which new server images are created.
        * @param serverImageRef The serverImageRef of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getServerImageRef()
@@ -256,7 +296,9 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Required.
+       * The flavor ID for the server. A flavor is a resource configuration for a server.
        * @param serverFlavorRef The serverFlavorRef of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getServerFlavorRef()
@@ -266,7 +308,20 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Optional.
+       * The disk configuration value. A server inherits the OS-DCF:diskConfig value from the image used to create it.
+       * If an image has OS-DCF:diskConfig value of MANUAL, you cannot create a server from that image with a
+       * OS-DCF:diskConfig value of AUTO.
+       * Valid values are:
+       * AUTO: The server is built with a single partition the size of the target flavor disk.
+       * The file system is automatically adjusted to fit the entire partition. This keeps things simple and automated.
+       * AUTO is valid only for images and servers with a single partition that use the EXT3 file system.
+       * This is the default setting for applicable Rackspace base images.
+       * MANUAL: The server is built using whatever partition scheme and file system is in the source image.
+       * If the target flavor disk is larger, the remaining disk space is left unpartitioned. This enables images to
+       * have non-EXT3 file systems, multiple partitions, and so on, and enables you to manage the disk configuration.
+       *
        * @param serverDiskConfig The serverDiskConfig of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getServerDiskConfig()
@@ -276,7 +331,9 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
          return this;
       }
 
-      /** 
+      /**
+       * Optional.
+       * Metadata key and value pairs. The maximum size of the metadata key and value is 255 bytes each.
        * @param serverMetadata The serverMetadata of this LaunchConfiguration.
        * @return The builder object.
        * @see LaunchConfiguration#getServerMetadata()
@@ -304,7 +361,7 @@ public class LaunchConfiguration implements Comparable<LaunchConfiguration>{
                .serverFlavorRef(in.getServerFlavorRef())
                .serverDiskConfig(in.getServerDiskConfig())
                .serverMetadata(in.getServerMetadata());
-      }        
+      }
    }
 
    @Override

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LoadBalancer.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LoadBalancer.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LoadBalancer.java
index 3ef6641..6bc4b58 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LoadBalancer.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/LoadBalancer.java
@@ -26,7 +26,7 @@ import com.google.gson.annotations.SerializedName;
 
 /**
  * Autoscale LoadBalancer. Part of the launch configuration.
- * 
+ *
  * @see LaunchConfiguration#getLoadBalancers()
  */
 public class LoadBalancer {
@@ -95,6 +95,11 @@ public class LoadBalancer {
       protected int id;
 
       /**
+       * Required.
+       * The port number of the service (on the new servers) to use for this particular load balancer. In most cases,
+       * this port number is 80. NOTE that when using RackConnectV3, instead of a cloud load balancer, leave this
+       * parameter empty.
+       *
        * @param port The port of this LoadBalancer.
        * @return The builder object.
        * @see LoadBalancer#getPort()
@@ -105,6 +110,12 @@ public class LoadBalancer {
       }
 
       /**
+       * Required.
+       * The ID of the cloud load balancer, or RackConnectV3 load balancer pool, to which new servers are added. For
+       * cloud load balancers set the ID as an integer, for RackConnectV3 set the UUID as a string. NOTE that when
+       * using RackConnectV3, this value is supplied to you by Rackspace Support after they configure your load
+       * balancer pool.
+       *
        * @param id The id of this LoadBalancer.
        * @return The builder object.
        * @see LoadBalancer#getId()

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Personality.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Personality.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Personality.java
index b1526d1..8eb52bd 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Personality.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/Personality.java
@@ -25,8 +25,16 @@ import com.google.common.base.Objects.ToStringHelper;
 
 /**
  * Autoscale Personality. Part of the launch configuration.
- * 
+ * You can inject data into the file system of the cloud server instance.
+ * For example, you might want to insert ssh keys, set configuration files,
+ * or store data that you want to retrieve from inside the instance.
+ * This feature provides a minimal amount of launch-time personalization.
+ * If you require significant customization, create a custom image.
+ *
  * @see LaunchConfiguration#getPersonalities()
+ * @see <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.html">
+ *    Server Personality
+ *    </a>
  */
 public class Personality {
    private final String path;

http://git-wip-us.apache.org/repos/asf/jclouds-labs-openstack/blob/eeceb98b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/ScalingPolicy.java
----------------------------------------------------------------------
diff --git a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/ScalingPolicy.java b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/ScalingPolicy.java
index e047040..76844a1 100644
--- a/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/ScalingPolicy.java
+++ b/rackspace-autoscale/src/main/java/org/jclouds/rackspace/autoscale/v1/domain/ScalingPolicy.java
@@ -30,7 +30,7 @@ import com.google.common.collect.ImmutableList;
 
 /**
  * Autoscale ScalingPolicyResponse. Extends ScalingPolicy with id and links.
- * 
+ *
  * @see Group#getScalingPolicies()
  */
 public class ScalingPolicy extends CreateScalingPolicy{
@@ -48,15 +48,13 @@ public class ScalingPolicy extends CreateScalingPolicy{
 
    /**
     * @return the unique id of this ScalingPolicy.
-    * @see ScalingPolicyResponse.Builder#id(String)
     */
    public String getId() {
       return this.id;
-   }   
+   }
 
    /**
     * @return the links to this ScalingPolicy.
-    * @see ScalingPolicyResponse.Builder#links(String)
     */
    public ImmutableList<Link> getLinks() {
       return this.links;
@@ -72,7 +70,7 @@ public class ScalingPolicy extends CreateScalingPolicy{
       if (this == obj) return true;
       if (obj == null || getClass() != obj.getClass()) return false;
       ScalingPolicy that = ScalingPolicy.class.cast(obj);
-      return Objects.equal(this.id, that.id) && 
+      return Objects.equal(this.id, that.id) &&
             Objects.equal(this.links, that.links) &&
             super.equals(obj);
    }
@@ -86,5 +84,5 @@ public class ScalingPolicy extends CreateScalingPolicy{
    @Override
    public String toString() {
       return string().toString();
-   }   
+   }
 }