使用 AWS SDK for Ruby - 第 3 版

AWS SDK for Ruby 為 Amazon S3 儲存貯體和物件操作提供 API。針對物件操作，您可以使用 API 透過單一操作來上傳物件或分段上傳大型物件 (請參閱「使用分段上傳來上傳物件」)。不過，單一操作上傳的 API 也可以接受大型物件，因此可以管理分段上傳，進而減少您需要撰寫的指令碼數量。

Ruby API 組織

在使用 AWS SDK for Ruby 建立 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 的 AWS SDK API 的詳細資訊，請前往適用於 Ruby 的 AWS 開發套件 – 第 2 版。

測試 Ruby 指令碼範例

開始使用 Ruby 指令碼範例的最簡單方式是安裝最新之AWS SDK for Ruby 的 Gem。如需安裝或更新至最新 Gem 的資訊，請前往適用於 Ruby 的 AWS 開發套件 – 第 3 版。下列任務會引導您建立與測試 Ruby 指令碼範例，但假設您已安裝AWS SDK for Ruby。

1	若要存取 AWS，您必須為 Ruby 應用程式的軟體開發套件提供一組憑證。如需詳細資訊，請參閱設定適用於 Ruby 的 AWS 開發套件。
2	建立新的 Ruby 指令碼軟體開發套件，然後將下列各行新增至指令碼頂端。 #!/usr/bin/env ruby require 'rubygems' require 'aws-sdk-s3' 第一行是解譯器指示詞，而兩個 require 陳述式會將兩個必要 Gem 匯入至指令碼。
3	將程式碼從您所讀取的區段複製至指令碼。
4	提供任何必要資料，以更新程式碼。例如，如果上傳檔案，請提供檔案路徑與儲存貯體名稱。
5	執行指令碼。使用 AWS Management Console 驗證對儲存貯體與物件的變更。如需有關 AWS Management Console 的詳細資訊，請移至 https://aws.amazon.com/console/。

Ruby 範例

下列連結包含範例，可協助您開始使用適用於 Ruby 的軟體開發套件 - 第 3 版：

• 建立儲存貯體

• 上傳物件