Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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

使用 Amazon S3 开发应用程序时,您可以使用 AWS 开发工具包。AWS 开发工具包包装了底层 REST API,可以简化您的编程任务。还提供了移动开发工具包,以便使用 AWS 构建连接的移动应用程序。本部分提供使用 AWS 开发工具包开发 Amazon S3 应用程序的概述。本节还描述了如何测试本指南中提供的 AWS 开发工具包代码示例。

除了 AWS 开发工具包外,AWS Explorer 也适用于 Visual Studio 和 Eclipse for Java IDE。在此情况下,可以将开发工具包和 Explorer 捆绑在一起来作为 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 Command Line Interface (CLI) 是用于管理您的 AWS 服务的统一工具,包括 Amazon S3。有关下载 AWS CLI 的信息,请转到 AWS Command Line Interface

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

在 亚太地区(孟买)、亚太区域(首尔)、欧洲(法兰克福)、欧洲 (伦敦) 和 中国(北京) 区域中,Amazon S3 仅支持签名版本 4。在所有其他区域,Amazon S3 同时支持签名版本 4 和签名版本 2。

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

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

对于默认配置,运行以下命令。

Copy
$ aws configure set default.s3.signature_version s3v4

对于自定义配置,运行以下命令。

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

在您的代码中添加以下内容。

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

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

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

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

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

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

Copy
<?php $s3 = \Aws\S3\S3Client::factory(array('signature' => 'v4'));
Ruby 开发工具包

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

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

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

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

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

Copy
AWSConfigs.S3UseSignatureVersion4 = true;

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

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