设置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 提供了 Java APIAmazon Web Services(Amazon)。使用 SDK,您可以构建使用的 Java 应用程序Amazon S3、Amazon EC2、DynamoDB以及其他.

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

概览

向发出请求Amazon使用Amazon SDK for Java,您需要以下信息:

  • ActiveAmazon 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. 如果您没有 VPCIAM用户设置,单击创建新用户创建一个。

  4. SELECTIAM您将用来访问的用户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值的证书值your_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 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 Windows 上的 config\ config

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

[default] region = your_aws_region

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

  • 设置 AWS_REGION 环境变量。

在 Linux、macOS 或 Unix 上,使用 export

export AWS_REGION=your_aws_region

在 Windows 上,请使用 set

set AWS_REGION=your_aws_region

其中your_aws_region是理想的Amazon Web Services 区域名称.

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

安装 Java 和生成工具

您的开发环境需要以下组件:

后续步骤

有了Amazon Web Services 账户并设置开发环境,使用您首选的构建工具创建 Java 项目。CheckMaven 的材料清单 (BOM)Amazon SDK for Java来自 Maven Central 的 2.x,以查看最新版本。在中使用该版本号<dependencyManagement>下面的。然后为你将在应用程序中使用的服务添加依赖关系。

示例 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.17.261</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 项目.