AWSConstants.java

/**
 *  This file is part of ElasticDroid.
 *
 * ElasticDroid is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.

 * ElasticDroid is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.

 * You should have received a copy of the GNU General Public License
 * along with ElasticDroid.  If not, see <http://www.gnu.org/licenses/>.
 * 
 * Authored by Siddhu Warrier on 14 Nov 2010
 */
package org.elasticdroid.utils;


/**
 * AWS constants. Stored in a separate file. 
 * @author Siddhu Warrier
 *
 * 14 Nov 2010
 */
public class AWSConstants {

	//endpoints
	/**
	 * AWS Endpoints. Add/change here if AWS changes/adds endpoints.
	 * @author Siddhu Warrier
	 */
	public class EndPoints {
		/** 
		 * End point for EC2 in the US East region
		 */
		public static final String EC2_US_EAST="ec2.us-east-1.amazonaws.com";
		/** 
		 * End point for EC2 in the US West region
		 */
		public static final String EC2_US_WEST="ec2.us-west-1.amazonaws.com";
		/** 
		 * End point for EC2 in the EU West region
		 */
		public static final String EC2_EU_WEST ="ec2.eu-west-1.amazonaws.com";
		/** 
		 * End point for EC2 in the APAC region
		 */
		public static final String EC2_APAC ="ec2.ap-southeast-1.amazonaws.com";
		
		/*----------------------------------------------------------------------*/
		/**
		 * End point for Cloudwatch in the EU West region
		 */
		public static final String CLOUDWATCH_EU_WEST = "monitoring.eu-west-1.amazonaws.com";
		/**
		 * End point for Cloudwatch in the US East region
		 */
		public static final String CLOUDWATCH_US_EAST = "monitoring.amazonaws.com";
		/**
		 * End point for Cloudwatch in the US West region
		 */
		public static final String CLOUDWATCH_US_WEST = "monitoring.us-west-1.amazonaws.com";
		/**
		 * End point for CloudWatch in the APAC region
		 */
		public static final String CLOUDWATCH_APAC="monitoring.ap-southeast-1.amazonaws.com";
		
		/**
		 * Get the endpoint for the {@link CloudWatchInput#region} stored in this 
		 * {@link CloudWatchInput} instance.
		 * @return String from {@link AWSConstants}
		 */
	}
	
	/**
	 * Constants holding information on instance state
	 * 
	 * Instance state is returned by {@link com.amazonaws.services.ec2.model.InstanceState} as a 16
	 * bit integer, the higher byte of which is used internally.
	 * 
	 *  We are concerned only of the lower byte value. Annoyingly, Amazon doesn't seem to have the same thing.
	 *  
	 *  These values are from the EC2 API reference dated 2010-08-31
	 *  {@link http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/}
	 * @author Siddhu Warrier
	 *
	 * 14 Nov 2010
	 */
	public class InstanceStateConstants {
		/**
		 * Instance is pending (starting up)
		 */
		public static final int PENDING = 0;
		/**
		 * Instance is running.
		 */
		public static final int RUNNING = 16;
		/**
		 * Instance is shutting down.
		 */
		public static final int SHUTTING_DOWN = 32;
		/**
		 * Instance is terminated. This means all data stored in the instance is lost.
		 * Note: There is no STOPPED option available to S3-backed AMIs.
		 * Therefore, for these AMIs, TERMINATED and RUNNING are the only steady states.
		 */
		public static final int TERMINATED = 48;
		/**
		 * Instance is stopping
		 */
		public static final int STOPPING = 64;
		/**
		 * Instance is stopped.
		 */
		public static final int STOPPED = 80;
	}
	
	/**
	 * Utility method to return the Cloudwatch endpoint for the region selected
	 * @param region Region selected
	 * @return The CloudWatch end point for the region selected.
	 */
	public static String getCloudWatchEndpoint(String region) {
		if (region.equals("eu-west-1")) {
			return EndPoints.CLOUDWATCH_EU_WEST;
		}
		else if (region.equals("us-east-1")) {
			return EndPoints.CLOUDWATCH_US_EAST;
		}
		else if (region.equals("us-west-1")) {
			return EndPoints.CLOUDWATCH_US_WEST;
		}		

		return EndPoints.CLOUDWATCH_APAC;
	}
	
	/**
	 * Utility method to return the endpoint for the region selected
	 * @param region Region selected
	 * @return The EC2 end point for the region selected.
	 */
	public static String getEC2Endpoint(String region) {
		if (region.equals("eu-west-1")) {
			return EndPoints.EC2_EU_WEST;
		}
		else if (region.equals("us-east-1")) {
			return EndPoints.EC2_US_EAST;
		}
		else if (region.equals("us-west-1")) {
			return EndPoints.EC2_US_WEST;
		}		

		return EndPoints.EC2_APAC;
	}
}