设置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 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 账户

  • 网络 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用户指南. 访问时,请使用此账户而不是根账户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 和私有访问密钥(包含访问密钥 ID 和私有访问密钥)作为凭证。您应该将您的凭据设置为访问的默认凭证Amazon使用您的应用程序。

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

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

设置默认凭据的最常用方法和Amazon Web Services 区域是使用共享的configcredentials文件。您还可以使用环境变量、使用 Java 系统属性或者为在上运行的应用程序设置默认凭据和 RegionAmazon 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值的凭据值你的 _access_key_id你的 _secret_access_key.

  • 设置 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 EC2有关其工作方式的详细探讨,请参阅 Linux 实例的用户指南。

  • 设置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

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

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

[default] region = your_aws_region

替代你想要的Amazon Web Services 区域(例如,“us-east-1”)你的 _aws_ 地区.

  • 设置 AWS_REGION 环境变量。

在 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 项目.