设置Amazon SDK for Java2.x - Amazon SDK for Java
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

现在,您可以使用 Amazon S3转移管理器(开发人员预览)中的Amazon SDK for Java2.x 用于加速文件传输。给它一个尝试,告诉我们您的想法

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

设置Amazon SDK for Java2.x

这些区域有:Amazon SDK for Java2.x 提供了用于Amazon Web Services(Amazon)。使用开发工具包,您可以构建使用Amazon S3、Amazon EC2、DynamoDB, 以及其他.

本节提供有关如何设置您的开发环境和项目以使用Amazon SDK for Java.

Overview

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

  • 一个活动 Amazon Web Services 账户

  • 网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon Identity and Access Management(IAM) 用户:

    • 编程访问密钥

    • 的权限Amazon您将使用应用程序访问的资源

  • 开发环境具有以下组件:

    • 您的访问密钥配置为Amazon

    • Java 8 或更高版本

    • 构建自动化工具

创建 账户

如果您没有 Amazon Web Services 账户 ,请访问的Amazon Web Services注册页并按照屏幕上的提示创建并激活新帐户。

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

激活新的 Amazon Web Services 账户 ,请参阅以下说明:创建您的首个 IAM 管理员用户和组中的 IAM用户指南. 使用此帐户而不是 root 帐户访问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用户以及它们对于帐户的安全性为何十分重要的信息,请参阅 Amazon安全凭证中的Amazon Web Services一般参考。

有关为现有的访问密钥创建访问密钥的说明IAM用户,请参阅方案访问中的 IAM用户指南.

  1. 转至 IAM控制台(您可能需要登录Amazon(第一个).

  2. 单击用户以查看您的IAM用户。

  3. 如果您没有任何IAM用户设置,请单击创建新用户以创建一个配置文件。

  4. 选择IAM用户将用来访问的列表Amazon.

  5. 打开安全凭证选项卡,然后单击创建访问密钥。注意:对于任何给定的最多可以有两个活动访问密钥IAM用户。如果您的IAM用户已经有两个访问密钥,您将需要先删除其中的一个访问密钥,然后再创建新密钥。

  6. 在结果对话框中,单击下载凭据按钮将凭据文件下载到您的计算机,或单击显示用户安全凭证查看IAM用户的访问密钥 ID 和秘密访问密钥(您可以复制并粘贴这些访问密钥)。

重要

在关闭该对话框之后,就无法获取密码访问密钥了。但是,您可以删除与它相关联的访问密钥 ID 并创建新密钥。

设置默认凭据和区域

要向发出请求,请求Amazon使用Amazon SDK for Java,则必须使用由Amazon. 与Amazon开发工具包和工具,如Amazon SDK for Java中,您可以将访问密钥 ID 和秘密访问密钥组成的编程访问密钥用作凭证。您应该将您的凭据设置为默认凭据,以便访问Amazon与您的应用程序。

如果您已经有一个IAM帐户已创建,请参阅创建IAM用户和编程访问密钥,了解有关创建编程访问密钥的说明。

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

最常用的方法来设置默认凭据和 Amazon Web Services 区域 是使用共享的configcredentials文件。您还可以使用环境变量、使用 Java 系统属性或对于运行在Amazon EC2, 使用ContainerCredentialsProvider或者InstanceProfileCredentialsProvider.

设置默认凭据

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

  • 在Amazon凭证配置文件,该配置文件位于:

    • ~/.aws/credentials (在 Linux、macOS 或 Unix) 上

    • Windows 上的 C:\Users\USERNAME\.aws\credentials

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

[default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key

替换您自己的Amazon值的凭据值您的访问密钥 ID您的 _ 秘密 _ 访问 _ 密钥.

  • 设置 AWS_ACCESS_KEY_IDAWS_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
  • 对于Amazon EC2实例,请指定IAM角色,然后为您的Amazon EC2实例对该角色的访问权限。请参阅 IAM适用于 的 角色Amazon EC2 中的Amazon EC2Linux 实例用户指南,有关其工作方式的详细探讨。

  • 设置aws.accessKeyIdaws.secretAccessKeyJava 系统属性。

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

设置默认区域

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

  • 设置 Amazon Web Services 区域 中的Amazon配置文件,该配置文件位于:

    • Linux、macOS 或 Unix 上的 ~/.aws/config

    • C:\Users\USERNAME\ .aws\ credentials

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

[default] region = your_aws_region

替换您想要的 Amazon Web Services 区域 (例如,“us-east-1”),以查看您的区域.

  • 设置 AWS_REGION 环境变量。

在 Linux、macOS 或 Unix 上,请使用 export

export AWS_REGION=your_aws_region

在 Windows 上,请使用 set

set AWS_REGION=your_aws_region

其中您的区域是所需的 Amazon Web Services 区域 名称。

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

安装 Java 和构建工具

您的开发环境需要满足以下条件:

后续步骤

一旦您拥有 Amazon Web Services 账户 和开发环境设置,请使用您首选的构建工具创建 Java 项目。导入Maven 材料清单 (BOM)Amazon SDK for Java2.x 来自马文中央software.amazon.awssdk. 然后为您将在应用程序中使用的服务添加依赖关系。

Maven 示例pom.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 项目.