Release: AWS SDK for Java 1.2.13

Release Notes>Java>Release: AWS SDK for Java 1.2.13
This release introduces a new client in the SDK for Amazon Route 53, and also includes several API updates for Amazon S3, Amazon EC2, Elastic Load Balancing, and AWS CloudFormation, as well as bug fixes and improved use of enums throughout the SDK.

Details

Submitted By: Jason@AWS
Release Date: December 8, 2011 2:42 AM GMT
Latest Version: 1.2.13
Created On: December 8, 2011 2:42 AM GMT
Last Updated: December 8, 2011 2:42 AM GMT

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 toString() on the enum to get a string to pass into the service's API. The latest version of the AWS SDK for Java now also allows you to pass in the enum directly, in addition to the existing string based methods.

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

 

AWS Security Token Service 2011-06-15 Elastic Load Balancing 2011-11-15

 

©2013, Amazon Web Services, Inc. or its affiliates. All rights reserved.