Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

使用 适用于 Ruby 的 AWS 开发工具包 - 版本 2

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

Ruby API 组织

使用适用于 Ruby 的 AWS 开发工具包创建 Amazon S3 应用程序时,必须安装 适用于 Ruby 的开发工具包 gem。有关更多信息,请参阅适用于 Ruby 的 AWS 开发工具包 - 版本 2。安装后,您可以访问包含以下密钥类的 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 开发工具包 - 版本 2。以下任务将指导您完成 Ruby 脚本示例的创建和测试过程 (假设已安装适用于 Ruby 的 AWS 开发工具包)。

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

1

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

2

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

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

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

3

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

4

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

5

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

Ruby 示例

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