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

使用 适用于 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 API 的 AWS 开发工具包的更多信息,请转到适用于 Ruby API 的 AWS 开发工具包参考

测试 Ruby 脚本示例

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

创建和测试 Ruby 脚本示例的常规过程

1

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

2

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

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

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

3

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

4

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

5

运行脚本。验证使用AWS 管理控制台对存储桶和对象进行的更改。有关 AWS 管理控制台的更多信息,请转到 http://amazonaws.cn/console/

Ruby 示例

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