AWS SDK for Java - docs.aws.amazon.com

1 AWS SDK for JavaDeveloper GuideAWS SDK for java : Developer GuideCopyright 2018 Amazon Web Services, Inc. and/or its affiliates. All rights SDK for java Developer GuideAmazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored SDK for java Developer GuideTable of ContentsAWS SDK for java Developer Guide .. 1 What's New in Version .. 1 Support for.

2 1 Additional Resources .. 1 Contributing to the Developer Preview.. 1 Eclipse IDE Support .. 2 Developing AWS Applications for Android .. 2 Getting Started .. 3 Sign up for AWS and Create an IAM User .. 3 Set up the SDK.. 4 Prerequisites .. 4 Including the SDK in Your Project .. 4 Compiling the SDK.. 4 Installing a java Development Environment .. 5 Choosing a JVM.. 5 Set up AWS Credentials and Region .. 5 Setting AWS Credentials .. 5 Setting the AWS Region .. 6 Using the SDK with Apache Maven .. 7 Create a New Maven Package .. 7 Configure the SDK as a Maven Dependency .. 8 Build Your Project.

3 9 Using the SDK with Gradle.. 9 Using the SDK.. 11 Creating Service Clients .. 11 Obtaining a Client Builder.. 11 Using DefaultClient.. 12 Client Lifecycle .. 12 Working with AWS Credentials .. 12 Using the Default Credential Provider Chain .. 12 Specifying a Credential Provider or Provider Chain .. 14 Explicitly Specifying Credentials .. 15 More Info .. 15 AWS Region Selection .. 15 Choosing a Region .. 15 Choosing a Specific Endpoint.. 16 Automatically Determine the AWS Region from the Environment .. 16 Checking for Service Availability in an AWS Region .. 17 Client Configuration.. 17 HTTP Transport Configuration .. 17 Asynchronous Programming.

4 18 Non-streaming Operations .. 19 Streaming Operations .. 19 HTTP/2 Programming .. 21 Exception Handling .. 21 Why Unchecked Exceptions? .. 21 SdkServiceException (and Subclasses) .. 21 SdkClientException .. 22 Logging aws sdk for java Calls .. 22 Add the Log4J JAR .. 22 Log4j Configuration file.. 22 Setting the Classpath .. 23 Service-Specific Errors and Warnings .. 23 Request/Response Summary Logging .. 23iiiAWS SDK for java Developer GuideVerbose Wire Logging .. 24 Configure IAM Roles for Amazon EC2 (Advanced) .. 25 Default Provider Chain and Amazon EC2 Instance Profiles .. 25 Walkthrough: Using IAM roles for Amazon EC2 Instances.

5 25 Code Examples.. 27 Amazon S3 Examples (Developer Preview) .. 27 Bucket Operations .. 27 Object Operations .. 30 Amazon SQS Examples (Developer Preview) .. 33 Queue Operations.. 33 Message Operations.. 35 Amazon CloudWatch Examples .. 37 Getting Metrics from CloudWatch .. 37 Publishing Custom Metric Data.. 38 Working with CloudWatch Alarms .. 39 Using Alarm Actions in CloudWatch .. 42 Sending Events to CloudWatch .. 43 Amazon DynamoDB Examples .. 45 Working with Tables in DynamoDB .. 45 Working with Items in DynamoDB .. 51 Amazon EC2 Examples (Developer Preview) .. 54 Managing Amazon EC2 Instances .. 54 Using Elastic IP Addresses in Amazon EC2.

6 58 Using Regions and Availability Zones .. 60 Working with Amazon EC2 Key Pairs .. 61 Working with Security Groups in Amazon EC2 .. 63 AWS Identity and Access Management (IAM) Examples (Developer Preview) .. 66 Managing IAM Access Keys .. 66 Managing IAM Users.. 70 Using IAM Account Aliases .. 72 Working with IAM Policies .. 74 Working with IAM Server Certificates .. 77 Amazon Kinesis Examples .. 80 Subscribing to Amazon Kinesis Data Streams .. 81 Pagination Examples .. 85 Synchronous Pagination .. 86 Asynchronous Pagination .. 87 Document History .. 91ivAWS SDK for java Developer GuideWhat's New in Version SDK for java DeveloperGuideThe aws sdk for java provides a java API for Amazon Web Services.

7 Using the SDK, you can easilybuild java applications that work with Amazon S3, Amazon EC2, DynamoDB, and more. We regularlyadd support for new services to the aws sdk for java . For a list of changes and features in a particularversion, view the change 's New in Version aws sdk for java is a major rewrite of the version code base. It's built on top of java 8 andadds several frequently requested features. These include support for non-blocking I/O and the ability toplug in a different HTTP implementation at run time. For more information see the AWS the asynchronous clients for Amazon Kinesis, Amazon DynamoDB and AmazonCloudWatch modules in version are production ready and can be used in productionenvironments.

8 All other modules are preview releases and are not recommended for for are not dropping support for the versions of the aws sdk for java currently. As we get closer tothe final production release, we will share a detailed plan for continued support, similar to how werolled out major versions of other AWS ResourcesIn addition to this guide, the following are valuable online resources for aws sdk for java developers: aws sdk for java Reference aws sdk for java Reference Developer Preview java developer blog java developer forums GitHub: Documentation source SDK source @awsforjava (Twitter)Contributing to the Developer PreviewDevelopers can also contribute feedback through the following channels:1 aws sdk for java Developer GuideEclipse IDE Support Submit issues on GitHub.

9 Submit documentation issues Submit SDK issues Join an informal chat about SDK on the aws sdk for java channel Submit feedback anonymously to This email is monitored bythe aws sdk for java team. Submit pull requests in the documentation or SDK source GitHub repositories to contribute to the IDE SupportThe AWS Toolkit for Eclipse doesn't currently support the aws sdk for java To use the AWS Toolkitfor Eclipse with the aws sdk for java , you should use Maven tools in Eclipse to add a dependency onthe AWS Applications for AndroidIf you're an Android developer, Amazon Web Services publishes an SDK made specifically for Androiddevelopment: the AWS Mobile SDK for Android.

10 See the AWS Mobile SDK for Android Developer Guidefor the complete SDK for java Developer GuideSign up for AWS and Create an IAM UserGetting Started with AWS SDK forJava Developer PreviewThis section provides information about how to install, set up, and use the AWS SDK for Sign up for AWS and Create an IAM User (p. 3) Set Up the aws sdk for java Developer Preview (p. 4) Set Up AWS Credentials and Region for Development (p. 5) Using the SDK with Apache Maven (p. 7) Using the SDK with Gradle (p. 9)Sign up for AWS and Create an IAM UserTo use the aws sdk for java to access Amazon Web Services (AWS), you need an AWS account and AWScredentials. To increase the security of your AWS account, we recommend that you use an IAM user toprovide access credentials instead of using your AWS account an overview of IAM user and why they are important for the security of your account, seeAWS Security Credentials in the Amazon Web Services General sign up for and click Sign the on-screen instructions.