现在,您可以使用Amazon S3转移经理(开发人员预览版)
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
设置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用户指南.
-
转至IAM控制台
(您可能需要登录到Amazon第一个)。 -
单击用户在侧边栏中查看您的IAM用户。
-
如果您没有任何东西IAM用户设置,单击创建新用户创建一个。
-
选择IAM用于访问的列表中的用户Amazon.
-
打开安全凭证选项卡,然后单击创建访问密钥。注意:对于任何给定的访问密钥最多可以有两个活动访问密钥。IAM用户。如果您的IAM用户已经有两个访问密钥,您将需要先删除其中的一个访问密钥,然后再创建新密钥。
-
在结果对话框中,单击下载凭据按钮将凭据文件下载到计算机,或者单击显示用户安全凭证要查看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 区域是使用共享的config
和credentials
文件。您还可以使用环境变量、使用 Java 系统属性或者为在上运行的应用程序设置默认凭据和 RegionAmazon EC2,使用ContainerCredentialsProvider
设置默认凭据
选择以下选项之一以设置默认凭据:
-
在中设置凭证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_ID
和AWS_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.accessKeyId
和aws.secretAccessKey
Java 系统属性。
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 和构建工具
您的开发环境需要以下条件:
-
Java 8 或更高版本。这些区域有:Amazon SDK for Java与结合使用Oracle Java SE 开发套件
还有开源 Java 开发工具包 (OpenJDK) 的发行版,例如Amazon Corretto 、Red Hat OpenJDK , 和采用 PenJDK . -
支持 Maven Central 的构建工具或 IDE,例如 Apache Maven、Gradle 或 IntelliJ。
-
有关如何安装和使用 Maven 的信息,请参阅http://maven.apache.org/
. -
有关如何安装和使用 Gradle 的信息,请参阅。https://gradle.org/
. -
有关如何安装和使用 IntelliJ IDEA 的信息,请参阅。https://www.jetbrains.com/idea/
.
-
后续步骤
有了您的后Amazon Web Services 账户并设置开发环境,使用首选的构建工具创建 Java 项目。导入用于的 Maven 材料清单 (BOM)Amazon SDK for Java2.x 来自 Maven 中心software.amazon.awssdk
. 然后为您将在应用程序中使用的服务添加依赖项。
例如 Mavenpom.xml
file:
<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.gradle
file:
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 项目.