阿里雲團隊努力不懈,力求將最新的技術內容更快地以您最熟悉的語言呈現。本文由簡體中文內容自動轉碼而成,過程無人工干預。阿里雲不保證此自動轉碼的準確性、完整性及時效性。因轉碼造成的任何內容錯誤及因此可能帶來的損失,阿里雲概不負責,敬請見諒。本文内容請以簡體中文版本為準。
全部產品
Search
文件中心

快速開始

更新時間: Oct 30, 2018

下面介紹如何使用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. => ...

瞭解更多