Download
Download the latest AWS SDK for Java
New Features
| Change | Description |
|---|---|
| Amazon Route 53 |
The AWS SDK for Java now supports Amazon Route 53. With the Amazon Route 53 Java client in the SDK, you can easily access your Amazon Route 53 resources and manage your Amazon Route 53 hosted zones. Using the Amazon Route 53 Java client is easy. Here's a short example showing how to create an Amazon Route 53 hosted zone:
AmazonRoute53 route53 = new AmazonRoute53Client(myAwsCredentials);
route53.createHostedZone(new CreateHostedZoneRequest()
.withName("myDomainName.com")
.withCallerReference(callerReference)
.withHostedZoneConfig(new HostedZoneConfig()
.withComment("my first Route 53 hosted zone!")));
|
| Amazon EC2 Instance Status |
Instance Status provides information about two types of scheduled events for one or more instances in the running state - scheduled reboot and scheduled retirement. When Amazon EC2 determines that an instance must be rebooted, the instance's status will return one of two event codes: system-reboot or instance-reboot. When Amazon EC2 determines that an instance must be shut down, the instance's status will return an event code called instance-retirement. You can easily access this additional information about your Amazon EC2 instances' status by using the new DescribeInstanceStatus operation in the Amazon EC2 API.
AmazonEC2 ec2 = new AmazonEC2Client(myAwsCredentials);
System.out.println(ec2.describeInstanceStatus(new DescribeInstanceStatusRequest()
.withInstanceIds(testInstance.getInstanceId())));
For more information, see the Amazon EC2 Instance Status release notes. |
| Amazon EC2 Reserved Instance Options |
Starting with the 2011-11-01 API version, AWS expanded its offering of Amazon EC2 Reserved Instances to address a range of projected instance use. There are three types of Reserved Instances based on customer utilization levels: Heavy Utilization, Medium Utilization, and Light Utilization. You determine the type of the Reserved Instances offerings by including the optional offeringType parameter when calling DescribeReservedInstancesOfferings. The Medium Utilization offering type is equivalent to the Reserved Instance offering available before API version 2011-11-01. If you are using tools that predate the 2011-11-01 API version, DescribeReservedInstancesOfferings will only list information about the Medium Utilization Reserved Instance offering type. For more information, see the Amazon EC2 Reserved Instances Options release notes. |
| Amazon EC2 Virtual Private Gateway Support |
The VpnConnection type returned by the CreateVpnConnection and DescribeVpnConnection operations has been extended to include information about virtual private gateways for the instance. This can be accessed using the new VgwTelemetry member which returns a collection of VpnTunnelTelemetry instances containing the gateway information. For more information, please visit the Amazon Elastic Compute Cloud (Amazon EC2) page. |
| Elastic Load Balancing in Amazon VPC |
You can now use Elastic Load Balancing with Amazon Virtual Private Cloud (VPC). The same easy-to-use features of Elastic Load Balancing are available in VPC, such as SSL termination, health checks, sticky sessions, and CloudWatch monitoring. In addition to these features, when you provision an Elastic Load Balancer for your VPC, you can now assign security groups to your Elastic Load Balancer. To learn more, please visit the Elastic Load Balancing and Amazon Virtual Private Cloud (Amazon VPC) pages. |
| AWS CloudFormation Cost Estimator |
The estimated monthly cost of a template can now be viewed using the new EstimateTemplateCost operation. The return value is a URL to an AWS Simply Monthly Calculator with the query string set to the resources required to run the template:
String templateText = "{...template...}";
AWSCloudFormation cloudformation = new AWSCloudFormationClient(myAwsCredentials);
System.out.println(cloudformation.estimateTemplateCost(
new EstimateTemplateCostRequest().withTemplateBody(templateText)));
For more information, visit the AWS CloudFormation page. |
| Better Enum Support |
The AWS SDK for Java has had enums for many types in various service APIs (for example,
Amazon EC2's InstanceType).
You could always call |
| Amazon S3 Multi Object Delete |
The Amazon S3 client in the AWS SDK for Java now allows you to delete multiple Amazon S3 objects using a single request.
DeleteObjectsRequest request = new DeleteObjectsRequest(bucketName);
request.getKeys().add(new KeyVersion("myFirstObjectToDelete"));
request.getKeys().add(new KeyVersion("mySecondObjectToDelete"));
AmazonS3 s3 = new AmazonS3Client(myAwsCredentials);
s3.deleteObjects(request);
|
| Amazon S3 Read Integrity Checksums |
The Amazon S3 client in the AWS SDK for Java now attempts to validate data integrity when you download data from Amazon S3. Amazon S3 computes a checksum for your data on the service side, and on the client side, your data's InputStream is wrapped with an InputStream that computes a client side checksum as data is read from the InputStream. Once all data is read from the InputStream and the checksum is complete, the result is compared to the server side checksum, and if they don't match up the SDK will throw an exception to warn you about potential data corruption. |
| Amazon Elastic Map Reduce StepFactory Utility Update |
The Amazon Elastic Map Reduce StepFactory utility class has been updated to support Hive version 0.7.1. This update also allows users to specify arbitrary version numbers for the newInstallHiveStep method, in addition to the convenient Hive version enums, so that as new Hive versions are supported developers can easily use them without having to update to the latest SDK version. |
Resolved Issues
| Amazon EC2 Updates |
InstanceType now includes an enum value for the new Cluster Compute Eight Extra Large (cc2.8xlarge). AvailabilityZone now includes a list of AvailabilityZoneMessages to give users extra information about the status and health of availatiblity zones. |
| AWS SDK for Java POM Update |
The Maven POM file for the AWS SDK for Java has been updated so that JavaMail is an optional dependency. |
Supported API Versions
This release of the SDK supports the following API versions:
| Service | API Version |
|---|---|
| Amazon CloudFront | 2010-11-01 |
| Amazon CloudWatch | 2010-08-01 |
| Amazon Elastic Compute Cloud (EC2) | 2011-11-01 |
| Amazon Elastic MapReduce | 2009-03-31 |
| Amazon ElastiCache | 2011-07-15 |
| Amazon Relational Database Service (RDS) | 2011-04-01 |
| Amazon Route 53 | 2011-05-05 |
| Amazon Simple Email Service (SES) | 2010-12-01 |
| Amazon Simple Notification Service (SNS) | 2010-03-31 |
| Amazon Simple Queue Service | 2011-10-01 |
| Amazon Simple Storage Service (S3) | 2006-03-01 |
| Amazon SimpleDB | 2009-04-15 |
| Auto Scaling | 2011-01-01 |
| AWS Cloud Formation | 2010-05-15 |
| AWS Elastic Beanstalk | 2010-12-01 |
| AWS Identity and Access Management | 2010-05-08 |
| AWS Import/Export | 2010-06-01 |
| AWS Security Token Service | 2011-06-15 |
| Elastic Load Balancing | 2011-11-15 |