全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

快速开始

更新时间:2017-08-14 17:16:07

下面介绍如何使用OSS Ruby SDK来访问OSS服务,包括查看Bucket列表,查看文件列表,上传/下载文件和删除文件。为了方便使用,下面的操作都是在Ruby的交互式命令行irb中进行。

初始化Client

在命令行中输入并回车:

  1. irb

进入到Ruby的交互式命令行模式。接着通过require引入SDK的包:

  1. > require 'aliyun/oss'
  2. => true

注:在接下来的演示中,>符号后面的内容是用户输入的命令,=>后面的内容是程序返回的内容。

接下来创建Client:

  1. > client = Aliyun::OSS::Client.new(
  2. > endpoint: 'endpoint',
  3. > access_key_id: 'AccessKeyId',
  4. > access_key_secret: 'AccessKeySecret')
  5. => #<Aliyun::OSS::Client...

将其中的参数替换成您实际的endpoint,AccessKeyId和AccessKeySecret。

查看Bucket列表

通过以下命令查看Bucket列表:

  1. > buckets = client.list_buckets
  2. => #<Enumerator...
  3. > buckets.each { |b| puts b.name }
  4. => bucket-1
  5. => bucket-2
  6. => ...

如果Bucket列表为空,则可以用以下命令创建一个Bucket:

  1. > client.create_bucket('my-bucket')
  2. => true

注:

  1. Bucket的命名规范请查看OSS 基本概念
  2. Bucket名字不能与OSS服务中其他用户已有的Bucket重复,所以你需要选择一个独特的Bucket名字以避免创建失败。

查看文件列表

通过以下命令查看Bucket中的文件列表:

  1. > bucket = client.get_bucket('my-bucket')
  2. => #<Aliyun::OSS::Bucket...
  3. > objects = bucket.list_objects
  4. => #<Enumerator...
  5. > objects.each { |obj| puts obj.key }
  6. => object-1
  7. => object-2
  8. => ...

上传一个文件

通过以下命令向Bucket中上传一个文件:

  1. > bucket.put_object('my-object', :file => 'local-file')
  2. => true

其中local-file是需要上传的本地文件的路径。上传成功后,可以通过list_objects来查看:

  1. > objects = bucket.list_objects
  2. => #<Enumerator...
  3. > objects.each { |obj| puts obj.key }
  4. => my-object
  5. => ...

下载一个文件

通过以下命令从Bucket中下载一个文件:

  1. > bucket.get_object('my-object', :file => 'local-file')
  2. => #<Aliyun::OSS::Object...

其中local-file是文件保存的路径。下载成功后,可以打开文件查看其内容。

删除一个文件

通过以下命令从Bucket中删除一个文件:

  1. > bucket.delete_object('my-object')
  2. => true

删除文件后可以通过list_objects来查看文件确实已经被删除:

  1. > objects = bucket.list_objects
  2. => #<Enumerator...
  3. > objects.each { |obj| puts obj.key }
  4. => object-1
  5. => ...

了解更多

本文导读目录