使用适用于 Ruby 的 AWS 开发工具包（版本 3） - Amazon Simple Storage Service
Ruby API 组织测试 Ruby 脚本示例

使用适用于 Ruby 的 AWS 开发工具包（版本 3）

适用于 Ruby 的 AWS 开发工具包提供了适用于 Amazon S3 存储桶和对象操作的 API。对于对象操作，您可以使用 API 在单一操作中上传对象或分批上传大量对象 (请参阅使用适用于 Ruby 的 AWS 开发工具包进行分段上传)。但是，用于单个操作上传的 API 也可以接受大型对象，并在幕后为您管理分段上传，从而减少您需要编写的脚本数量。

Ruby API 组织

使用适用于 Ruby 的 AWS 开发工具包创建 Amazon S3 应用程序时，必须安装适用于 Ruby 开发工具包 Gem。有关更多信息，请参阅适用于 Ruby 的 AWS 开发工具包（版本 3）。安装后，您可以访问包含以下密钥类的 API：

  • Aws::S3::Resource — 表示适用于 Ruby 开发工具包的 Amazon S3 的接口并提供用于创建和枚举存储桶的方法。

    S3 类提供了用于访问现有存储桶或创建新存储桶的 #buckets 实例方法。

  • Aws::S3::Bucket — 表示 Amazon S3 存储桶。 

    Bucket 类提供了用于访问存储桶中对象的 #object(key) 和 #objects 方法，以及删除存储桶和返回有关存储桶的信息 (例如存储桶策略) 的方法。

  • Aws::S3::Object — 表示由其密钥识别的 Amazon S3 对象。

    Object 类提供了用于获取和设置对象的属性、指定用于存储对象的存储类，以及使用访问控制列表设置对象权限的方法。Object 类还具有用于删除、上传和复制对象的方法。分段上传对象时，此类将向您提供选项以指定上传的分段顺序和分段大小。

有关适用于 Ruby 的 AWS 开发工具包 API 的更多信息，请转到适用于 Ruby 的 AWS 开发工具包 - 版本 2。

测试 Ruby 脚本示例

开始使用 Ruby 脚本示例的最简单方式是安装最新版本的适用于 Ruby 的 AWS 开发工具包。有关安装或更新至最新 Gem 的信息，请转到适用于 Ruby 的 AWS 开发工具包（版本 3）。以下任务将引导您通过假定您已安装适用于 Ruby 的 AWS 开发工具包来创建和测试 Ruby 脚本示例。

1

要访问 AWS，您必须为适用于 Ruby 的开发工具包应用程序提供一组凭证。有关更多信息，请参阅配置适用于 Ruby 的 AWS 开发工具包。

2

创建新的适用于 Ruby 的开发工具包脚本并将以下各行添加到脚本顶部。

#!/usr/bin/env ruby

require 'rubygems'
require 'aws-sdk-s3'

第一行是解释程序指令，且两个 require 语句会将两个所需版本导入到您的脚本。

3

将代码从您正在阅读的部分复制到您的脚本。

4

 通过提供任意所需数据更新代码。例如，如果上传某个文件，则提供文件路径和存储桶名称。

5

运行脚本。通过使用 AWS 管理控制台验证对存储桶和数据元的更改。有关 AWS 管理控制台的更多信息，请转到 https://aws.amazon.com/console/。

Ruby 示例

以下链接包含的示例可帮助您开始使用适用于 Ruby 的 AWS 开发工具包（版本 3）：