使用 Amazon SDK for Ruby - 版本 3 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

使用 Amazon SDK for Ruby - 版本 3

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

Ruby API 组织

使用 Amazon SDK for Ruby 创建 Amazon S3 应用程序时,必须安装适用于 Ruby 的开发工具包 Gem。有关更多信息,请参阅适用于 Ruby Amazon 的开发工具包 – 版本 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 的 Amazon 开发工具包 API 的更多信息,请转到适用于 Ruby 的 Amazon 开发工具包 – 版本 2

测试 Ruby 脚本示例

开始使用 Ruby 脚本示例的最简单方式是安装最新的Amazon SDK for Ruby gem。有关安装或更新至最新 Gem 的信息,请转到适用于 Ruby 的 Amazon 开发工具包 – 版本 3。以下任务将指导您完成 Ruby 脚本示例的创建和测试过程 (假设已安装Amazon SDK for Ruby)。

1

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

2

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

#!/usr/bin/env ruby require 'rubygems' require 'aws-sdk-s3'

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

3

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

4

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

5

运行脚本。使用 验证对存储桶和对象进行的更改Amazon Web Services Management Console 有关 Amazon Web Services Management Console 的更多信息,请转到 https://aws.amazon.com/console/

Ruby 示例

以下链接包含的示例可帮助您开始使用适用于 Ruby 的 SDK(版本 3):