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

使用 IAM 角色授予对AWS开启的资源Amazon EC2

所有请求Amazon Web Services(AWS) 必须使用由AWS. 您可以使用IAM 角色方便地授予安全访问AWS来自你的资源Amazon EC2实例。

本主题介绍如何使用 IAM 角色操作上运行的 Java 开发工具包应用程序。Amazon EC2. 有关 IAM 实例的更多信息，请参阅适用于 的 IAM 角色Amazon EC2中的Amazon EC2适用于 Linux 实例的用户指南。

默认提供程序链和 EC2 实例配置文件

如果您的应用程序创建AWS客户端使用默认构造函数，则该客户端将使用默认凭证提供商链，按以下顺序操作：

这些区域有：凭证实例配置文仅当在上运行您的应用程序时，默认提供程序链中的步骤才可用。Amazon EC2但在使用时，将提供最大的易用性和最高安全性Amazon EC2实例。您还可以将 InstanceProfileCredentialsProvider 实例直接传递给客户端构造函数，这样无需执行整个默认提供程序链即可获取实例配置文件凭证。

例如：

AmazonS3 s3 = AmazonS3ClientBuilder.standard()
              .withCredentials(new InstanceProfileCredentialsProvider(false))
              .build();

使用此方法时，SDK 会临时检索AWS凭证具有相同权限的凭证与Amazon EC2实例在其实例配置文件中。尽管这些证书是临时的，最终会过期，InstanceProfileCredentialsProvider定期为您刷新它们，以便您获得的凭证可继续访问AWS.

如果客户端构造函数使用凭证提供程序链找不到凭证，它会引发 AmazonClientException。

演练：将 IAM 角色用于 EC2 实例

以下演练将介绍如何从中检索对象：Amazon S3使用 IAM 角色管理访问。

创建 IAM 角色

创建授予对 Amazon S3 的只读访问权的 IAM 角色。

启动 EC2 实例并指定您的 IAM 角色

你可以启动Amazon EC2使用 IAM 角色的实例Amazon EC2控制台或AWS SDK for Java.

创建您的应用程序

让我们来构建在 EC2 实例上运行的示例应用程序。首先，创建一个目录来用于保存教程文件 (例如，GetS3ObjectApp)。

然后，将 AWS SDK for Java 库复制到新创建的目录中。如果已将AWS SDK for Java下载到 ~/Downloads 目录中，可以使用以下命令进行复制：

cp -r ~/Downloads/aws-java-sdk-{1.7.5}/lib .
cp -r ~/Downloads/aws-java-sdk-{1.7.5}/third-party .

打开一个新文件，将其命名为 GetS3Object.java 并添加以下代码：

import java.io.*;

import com.amazonaws.auth.*;
import com.amazonaws.services.s3.*;
import com.amazonaws.services.s3.model.*;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;

public class GetS3Object {
  private static final String bucketName = "text-content";
  private static final String key = "text-object.txt";

  public static void main(String[] args) throws IOException
  {
    AmazonS3 s3Client = AmazonS3ClientBuilder.defaultClient();

    try {
      System.out.println("Downloading an object");
      S3Object s3object = s3Client.getObject(
          new GetObjectRequest(bucketName, key));
      displayTextInputStream(s3object.getObjectContent());
    }
    catch(AmazonServiceException ase) {
      System.err.println("Exception was thrown by the service");
    }
    catch(AmazonClientException ace) {
      System.err.println("Exception was thrown by the client");
    }
  }

  private static void displayTextInputStream(InputStream input) throws IOException
  {
    // Read one text line at a time and display.
    BufferedReader reader = new BufferedReader(new InputStreamReader(input));
    while(true)
    {
      String line = reader.readLine();
      if(line == null) break;
      System.out.println( "    " + line );
    }
    System.out.println();
  }
}

打开一个新文件，将其命名为 build.xml 并添加以下行：

<project name="Get {S3} Object" default="run" basedir=".">
  <path id="aws.java.sdk.classpath">
    <fileset dir="./lib" includes="**/*.jar"/>
    <fileset dir="./third-party" includes="**/*.jar"/>
    <pathelement location="lib"/>
    <pathelement location="."/>
  </path>

  <target name="build">
  <javac debug="true"
    includeantruntime="false"
    srcdir="."
    destdir="."
    classpathref="aws.java.sdk.classpath"/>
  </target>

  <target name="run" depends="build">
    <java classname="GetS3Object" classpathref="aws.java.sdk.classpath" fork="true"/>
  </target>
</project>

构建并运行修改后的程序。请注意，该程序中未存储凭证。因此，除非你有你的AWS已经指定凭证，代码会引发AmazonServiceException. 例如：

$ ant
Buildfile: /path/to/my/GetS3ObjectApp/build.xml

build:
  [javac] Compiling 1 source file to /path/to/my/GetS3ObjectApp

run:
   [java] Downloading an object
   [java] AmazonServiceException

BUILD SUCCESSFUL

传输已编译的程序到您的 EC2 实例

使用安全复制 (Amazon EC2 )，将程序连同 库传输到 AWS SDK for Java 实例。该命令序列与以下序列相似。

scp -p -i {my-key-pair}.pem GetS3Object.class ec2-user@{public_dns}:GetS3Object.class
scp -p -i {my-key-pair}.pem build.xml ec2-user@{public_dns}:build.xml
scp -r -p -i {my-key-pair}.pem lib ec2-user@{public_dns}:lib
scp -r -p -i {my-key-pair}.pem third-party ec2-user@{public_dns}:third-party

在上述命令中：

chmod -R u+rwx GetS3Object.class build.xml lib third-party

在 EC2 实例上运行示例程序

要运行程序，请连接到 Amazon EC2 实例。有关更多信息，请参阅 。连接到 Linux 实例中的Amazon EC2适用于 Linux 实例的用户指南。

如果 ant 在您的实例上不可用，请使用以下命令安装它：

sudo yum install ant

然后使用 ant 运行程序，如下所示：

ant run

该程序会将 Amazon S3 对象的内容写入命令窗口。