Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

现在，您可以使用Amazon S3转移经理（开发人员预览版）中的Amazon SDK for Java2.x 用于加速文件传输。试试一下然后告诉我们您的想法！顺便说一句，Amazon SDK for Java正在招聘团队软件开发工程师！

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

设置Amazon SDK for Java2.x

这些区域有：Amazon SDK for Java2.x 提供了 Java APIAmazon Web Services(Amazon)。使用此开发工具包，您可以构建使用的 Java 应用程序。Amazon S3、Amazon EC2、DynamoDB以及其他。

本节提供有关如何设置开发环境和项目以使用最新版本 (2.x) 的信息Amazon SDK for Java.

概览

向发出请求Amazon使用Amazon SDK for Java，您需要满足以下条件：

创建 账户

如果您没有Amazon Web Services 账户，访问这Amazon Web Services注册页然后按照屏幕上的提示创建和激活新账户。

有关更详细的说明，请参阅如何创建和激活新的Amazon Web Services 账户?.

激活新的之后Amazon Web Services 账户，请参阅中的说明操作创建您的第一个 IAM 管理员用户和组中的IAM用户指南. 访问时，请使用此账户而不是根账户Amazon Web Services Management Console. 有关更多信息，请参阅 。IAM 中的安全最佳实践] 在IAM用户指南.

创建 IAM 用户和程序化访问密钥

使用Amazon SDK for Java访问以查看Amazon服务，您需要一个Amazon Web Services 账户和Amazon凭证。为了提高你的安全性Amazon Web Services 账户，对于访问凭证，建议您使用IAM用户而不是你的Amazon Web Services 账户凭证。

有关为现有的访问密钥创建访问密钥的说明IAM用户，请参阅以编程方式访问中的IAM用户指南.

设置默认凭据和区域

向发出请求Amazon使用Amazon SDK for Java，您必须使用由以下方颁发的加密签名凭证Amazon. 与Amazon如开发工具包和工具包和工具Amazon SDK for Java，您可以使用包含访问密钥 ID 和私有访问密钥（包含访问密钥 ID 和私有访问密钥）作为凭证。您应该将您的凭据设置为访问的默认凭证Amazon使用您的应用程序。

如果您已有IAM已创建账户，请参阅创建IAM用户和程序化访问密钥了解有关创建编程访问密钥的说明。

您还应该设置默认值。Amazon Web Services 区域访问以查看Amazon使用您的应用程序。某些操作需要设置区域。为了获得最佳网络性能，您可以选择地理位置上靠近您或您的客户的地区。

设置默认凭据的最常用方法和Amazon Web Services 区域是使用共享的config和credentials文件。您还可以使用环境变量、使用 Java 系统属性或者为在上运行的应用程序设置默认凭据和 RegionAmazon EC2，使用ContainerCredentialsProvider要么InstanceProfileCredentialsProvider.

设置默认凭据

选择以下选项之一以设置默认凭据：

此文件应包含以下格式的行：

[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

替换您自己的Amazon值的凭据值你的 _access_key_id和你的 _secret_access_key.

要在 Linux、macOS 或 Unix 上设置这些变量，请使用 export ：

export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key

要在 Windows 上设置这些变量，请使用 set：

set AWS_ACCESS_KEY_ID=your_access_key_id
set AWS_SECRET_ACCESS_KEY=your_secret_access_key

java app.jar -Daws.accessKeyId=\
"your_access_key_id" \
-Daws.secretAccessKey=\
"your_secret_access_key"

设置默认区域

选择以下选项之一以设置默认区域：

此文件应包含以下格式的行：

[default]
region = your_aws_region

替代你想要的Amazon Web Services 区域（例如，“us-east-1”）你的 _aws_ 地区.

在 Linux、macOS 或 Unix 上，请使用 export ：

export AWS_REGION=your_aws_region

在 Windows 上，请使用 set：

set AWS_REGION=your_aws_region

其中你的 _aws_ 地区是想要的Amazon Web Services 区域名称。

有关设置凭证和区域的其他信息，请参阅。.aws/证件和.aws/config 文件、Amazon Web Services 区域, 和使用环境变量中的Amazon开发工具包和工具参考指南.

安装 Java 和构建工具

您的开发环境需要以下条件：

后续步骤

有了您的后Amazon Web Services 账户并设置开发环境，使用首选的构建工具创建 Java 项目。导入用于的 Maven 材料清单 (BOM)Amazon SDK for Java2.x 来自 Maven 中心、software.amazon.awssdk. 然后为您将在应用程序中使用的服务添加依赖项。

例如 Mavenpom.xmlfile:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 </properties>
 <groupId>com.example.myapp</groupId>
 <artifactId>myapp</artifactId>
 <packaging>jar</packaging>
 <version>1.0-SNAPSHOT</version>
 <name>myapp</name>
 <dependencyManagement>
  <dependencies>
   <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>bom</artifactId>
    <version>2.15.0</version>
    <type>pom</type>
    <scope>import</scope>
   </dependency>
  </dependencies>
 </dependencyManagement>
 <dependencies>
  <dependency>
   <groupId>junit</groupId>
   <artifactId>junit</artifactId>
   <version>3.8.1</version>
   <scope>test</scope>
  </dependency>
  <dependency>
   <groupId>software.amazon.awssdk</groupId>
   <artifactId>dynamodb</artifactId>
  </dependency>
  <dependency>
   <groupId>software.amazon.awssdk</groupId>
   <artifactId>iam</artifactId>
  </dependency>
  <dependency>
   <groupId>software.amazon.awssdk</groupId>
   <artifactId>kinesis</artifactId>
  </dependency>
  <dependency>
   <groupId>software.amazon.awssdk</groupId>
   <artifactId>s3</artifactId>
  </dependency>
 </dependencies>
 <build>
  <plugins>
   <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
     <source>8</source>
     <target>8</target>
    </configuration>
   </plugin>
  </plugins>
 </build>
</project>

示例build.gradlefile:

group 'com.example.myapp'
version '1.0'

apply plugin: 'java'

sourceCompatibility = 1.8

repositories {
 mavenCentral()
}

dependencies {
 implementation platform('software.amazon.awssdk:bom:2.15.0')
 implementation 'software.amazon.awssdk:dynamodb'
 implementation 'software.amazon.awssdk:iam'
 implementation 'software.amazon.awssdk:kinesis'
 implementation 'software.amazon.awssdk:s3'
 testImplementation group: 'junit', name: 'junit', version: '4.11'
}

有关更多信息，请参阅 。设置 Apache Maven 项目要么设置 Gradle 项目.