OSS Ruby SDK 安装 创建联系 上传文件 删除文件 下载文件 查看文件列表

安装

您可以通过以下两种方式安装Ruby SDK。

• 方式一

  执行gem install aliyun-sdk 命令安装SDK。

  说明 如果无法访问https://rubygems.org，建议直接使用Ruby China社区维护的镜像源。

gem install aliyun-sdk --clear-sources --source https://gems.ruby-china.com 

依赖

• Ruby版本 >= 1.9.3
• 支持Ruby运行环境的Linux、Windows、OS X系统

初始化Client

在命令行中输入irb并回车。

在Ruby的交互式命令行模式下，输入require引入SDK包。

> require 'aliyun/oss'
=> true
			

接下来创建Client：

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

访问域名和数据中心 - 对象存储 OSS - 阿里云

查看endpoint access, assec key 需要增自己创建，在oss详情页面右侧列表页面点击进去创建即可，然后好好保管，不要泄露

公共云下OSS Region和Endpoint对照表

公共云下OSS各地域Endpoint如下：

查看Bucket列表

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

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

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

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

上传文件

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

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

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

> objects = bucket.list_objects
=> #<Enumerator...
> objects.each { |obj| puts obj.key }
=> my-object
=> ...
			

下载文件

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

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

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

删除文件

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

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

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

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

查看文件列表

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

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