使用适用于 Ruby 的 AWS 开发工具包(版本 3) - Amazon Simple Storage Service

使用适用于 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):