Amazon Simple Storage Service
开发人员指南 (API 版本 2006-03-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

使用 AWS 开发工具包、CLI 和 Explorer

使用 Amazon S3 开发应用程序时,您可以使用 AWS 开发工具包。AWS 开发工具包包装了底层 REST API,可以简化您的编程任务。还提供 AWS 移动开发工具包和 AWS Amplify JavaScript 库,用于使用 AWS 构建互连移动和 Web 应用程序。

本部分提供使用 AWS 开发工具包开发 Amazon S3 应用程序的概述。本节还描述了如何测试本指南中提供的 AWS 开发工具包代码示例。

除了 AWS 开发工具包外,AWS Explorer 也适用于 Visual Studio 和 Eclipse for Java IDE。在此情况下,可以将开发工具包和 Explorer 捆绑在一起来作为 AWS 工具包。

您也可以使用 AWS 命令行界面 (AWS CLI) 来管理 Amazon S3 存储桶和对象。

AWS Toolkit for Eclipse

AWS Toolkit for Eclipse 包含AWS SDK for Java和 AWS Explorer for Eclipse。AWS Explorer for Eclipse 是适用于 Eclipse for Java IDE 的开源插件,能够让开发人员更为轻松地使用 AWS 开发、调试和部署 Java 应用程序。易于使用的 GUI 使您可以访问和管理您的 AWS 基础设施,包括 Amazon S3。在 Eclipse for Java IDE 环境中,您可以在开发应用程序的同时,执行常见的操作 (例如管理您的存储桶和对象,以及设置 IAM 策略)。有关设置说明,请参阅设置工具包。有关使用 Explorer 的示例,请参阅如何访问 AWS Explorer

AWS Toolkit for Visual Studio

AWS Explorer for Visual Studio 是针对 Microsoft Visual Studio 的扩展,使开发人员能够更容易地使用 Amazon Web Services 来开发、调试和部署 .NET 应用程序。易于使用的 GUI 使您可以访问和管理您的 AWS 基础设施,包括 Amazon S3。在 Visual Studio 环境中,您可以在开发应用程序的同时,执行常见的操作 (例如管理您的存储桶和对象,或设置 IAM 策略)。有关设置说明,请转至设置 AWS Toolkit for Visual Studio。有关通过 Explorer 使用 Amazon S3 的示例,请参阅从 AWS Explorer 使用 Amazon S3

AWS 开发工具包

您只能下载开发工具包。有关下载开发工具包库的信息,请参阅示例代码库

AWS CLI

AWS CLI 是用于管理您的 AWS 服务 (包括 Amazon S3) 的统一工具。有关下载 AWS CLI 的信息,请参阅 AWS Command Line Interface

在请求身份验证中指定签名版本

Amazon S3 在大多数 AWS 区域中只支持签名版本 4。不过,在某些较旧的 AWS 区域中,Amazon S3 同时支持签名版本 4 和签名版本 2。有关所有 Amazon S3 区域的列表以及这些区域支持的签名版本,请参阅 AWS 一般参考中的区域和终端节点

对于所有 AWS 区域,默认情况下,AWS 开发工具包使用签名版本 4 对请求进行身份验证。如果使用 2016 年 5 月之前发布的 AWS 开发工具包,您可能需要请求签名版本 4,如下表所示:

开发工具包 请求使用签名版本 4 进行请求身份验证
AWS CLI

对于默认配置文件,运行以下命令:

$ aws configure set default.s3.signature_version s3v4

对于自定义配置文件,运行以下命令:

$ aws configure set profile.your_profile_name.s3.signature_version s3v4
Java 软件开发工具包

在代码中添加以下内容:

System.setProperty(SDKGlobalConfiguration.ENABLE_S3_SIGV4_SYSTEM_PROPERTY, "true");

或者在命令行中指定以下内容:

-Dcom.amazonaws.services.s3.enableV4
JavaScript 开发工具包

在构建客户端时,将 signatureVersion 参数设置为 v4

var s3 = new AWS.S3({signatureVersion: 'v4'});
PHP 开发工具包

在构建 Amazon S3 服务客户端时,将 signature 参数设置为 v4

<?php $s3 = new S3Client(['signature' => 'v4']);
Ruby 开发工具包

Ruby 开发工具包 – 版本 1:在构建客户端时,将 :s3_signature_version 参数设置为 :v4

s3 = AWS::S3::Client.new(:s3_signature_version => :v4)

Ruby 开发工具包 – 版本 3:在构建客户端时,将 signature_version 参数设置为 v4

s3 = Aws::S3::Client.new(signature_version: 'v4')
.NET 开发工具包

在创建 Amazon S3 客户端之前将以下内容添加到代码中:

AWSConfigs.S3UseSignatureVersion4 = true;

或将以下内容添加到配置文件中:

<appSettings> <add key="AWS.S3.UseSignatureVersion4" value="true" /> </appSettings>