Amazon S3 到 Google Cloud Storage 遷移方案

本頁面介紹使用API 傳送請求的使用者如何從Amazon Simple Storage Service (Amazon S3) 完整轉移到Cloud Storage。

如果您希望快速開始使用雲端存儲，您可以選擇簡單的遷移，只需對您目前在Amazon S3 中使用的工具和庫進行幾項簡單的更改即可。

從Amazon S3 遷移到Cloud Storage

若要從Amazon S3 完整遷移到Cloud Storage，您需要完成以下步驟：

將現有的 x-amz-* 標頭更改為相應的 x-goog-* 標頭。
將AWS 存取控制清單(ACL) XML 變更為對應的Cloud Storage ACL XML（請參閱建立和管理存取控制清單）。
在請求中設定 x-goog-project-id 標頭。
根據您的OAuth 2.0 驗證 Authorization 中所述，完成相關設定以使用OAuth 2.0 驗證。

Authorization: Bearer OAUTH2_TOKEN

OAuth 2.0 依賴SSL 維護安全性，不要求應用直接進行加密簽名，更容易實現。

存取權限控制

本節介紹了一些存取控制範例，這些範例可協助您從Amazon S3 移至Cloud Storage。

在Cloud Storage 中，您可以透過多種方法將ACL 應用於儲存桶和物件（請參閱建立和管理存取控制清單）。

以 acl 查詢字串參數，您可以針對特定範圍套用ACL。
x-goog-acl 標頭請求頭，可讓您套用預先定義的ACL（有時稱為預設ACL）。

使用ACL 查詢字串參數

您可以在Cloud Storage 請求中使用查詢字串參數，並與Amazon S3 請求 acl 時的此參數對應。

以下範例展示如何向Amazon S3 發出使用acl 查詢字串參數的PUT 請求。ACL 將在請求內文中傳送的XML 文件中定義。PUT 請求會更改名為europe/france/paris.jpg 的物件的ACL，該物件位於名為my-travel-maps 的儲存桶中。ACL 會授予jane@gmail.com FULL_CONTROL 權限。

PUT europe/france/paris.jpg?acl HTTP/1.1
Host: my-travel-maps.s3.amazonaws.com
Date: Wed, 06 Nov 2013 19:28:18 GMT
Content-Length: 598
Content-Type: application/xml
Authorization: AWS4-HMAC-SHA256 Credential=AWS-ACCESS-KEY/20131106/us-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;date;host, Signature=4c45f2567996256796a eb9f4cc91c33a1c45fg

<?xml version='1.0' encoding='utf-8'?>
<AccessControlPolicy>
<Owner>
<ID>5a6557ba40f7c86496ffceae789fcd888abc1b62a7149873a0fe12c0f60a7d95</ID>
<DisplayName>ownerEmail@example.com</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>fd447671d60b979f78ee6fcec7b22afc80e6b26a4db16eed01afb8064047949b</ID>
<DisplayName>jane@gmail.com</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>

以下是向Cloud Storage 發出的相同請求：

PUT europe/france/paris.jpg?acl HTTP/1.1
Host: my-travel-maps.storage.googleapis.com
Date: Wed, 06 Nov 2013 19:37:33 GMT
Content-Length: 268
Content-Type: application/xml
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version='1.0' encoding='utf-8'?>
<AccessControlList>
<Entries>
<Entry>
<Permission>FULL_CONTROL</Permission>
<Scope type="UserByEmail">
<EmailAddress>jane@gmail.com</EmailAddress>
</Scope>
</Entry>
</Entries>
</AccessControlList>

請注意，Cloud Storage 不需要在ACL XML 文件中包含<Owner/> 元素。如需了解詳情，請參閱儲存桶和物件所有權。

您也可以結合使用acl 查詢字串參數和GET 方法來檢索儲存桶和物件ACL。ACL 會在附加於回應正文的XML 文件中說明。您必須具有FULL_CONTROL 權限才能在物件或儲存桶上套用或檢索ACL。

透過擴充請求標頭應用ACL

您可以在Cloud Storage 請求中使用x-goog-acl 標頭，將預先定義的ACL 應用於儲存桶和對象，此程序與在Amazon S3 請求中使用x-amz-acl 標頭的方式完全相同。在建立或上傳儲存桶或物件時，通常使用x-goog-acl (x-amz-acl) 標頭將預先定義的ACL 應用於儲存桶或物件。Cloud Storage 預定義ACL 類似Amazon S3 預設ACL，其中包含 private、public-read、public-read-write 以及其他權限設定。如需查看Cloud Storage 預先定義ACL 的列表，請參閱預定義 ACL。

以下範例顯示了一個PUT 物件請求，該請求將public-read ACL 套用於名為europe/france/paris.jpg 的對象，而該物件正在上傳到Amazon S3 中名為my-travel-maps 的儲存桶。

PUT europe/france/paris.jpg HTTP/1.1
Host: my-travel-maps.s3.amazonaws.com
Date: Wed, 06 Nov 2013 20:48:42 GMT
Content-Length: 888814
Content-Type: image/jpg
x-amz-acl: public-read
Authorization: AWS4-HMAC-SHA256 Credential=AWS-ACCESS-KEY/20131106/us-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;date;host, Signature=808150c37d 9fd5835aa62fd62ab

<888814 bytes in entity body>

以下是向Cloud Storage 發出的相同請求：

PUT europe/france/paris.jpg HTTP/1.1
Host: my-travel-maps.storage.googleapis.com
Date: Wed, 06 Nov 2013 20:49:57 GMT
Content-Length: 888814
Content-Type: image/jpg
x-goog-acl: public-read
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<888814 bytes in entity body>

您也可以使用x-goog-acl 標頭將預先定義ACL 套用至現有儲存桶或物件。如需執行此操作，請在請求中新增acl 查詢字串參數，但不要在請求中加入XML 文件。如果要從一個預先定義ACL 變更為另一個預先定義ACL，或要將自訂 ACL 更新為預定義ACL，建議您將預定義ACL 套用至現有物件或儲存桶。例如，以下PUT 物件請求可將預先定義ACL private 應用於my-travel-maps 儲存桶中的europe/france/paris.jpg 物件。

PUT europe/france/paris.jpg?acl HTTP/1.1
Host: my-travel-maps.storage.googleapis.com
Date: Wed, 06 Nov 2013 00:26:36 GMT
Content-Length: 0
x-goog-acl: private
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<empty entity body>

如需詳細了解如何管理ACL，請參閱建立和管理存取控制清單。

從Amazon S3 遷移到Cloud Storage 請求方法

如需在儲存桶中讀取和寫入數據，Cloud Storage 支援的標準HTTP 請求方法與Amazon S3 支援的請求方法相同。因此，您目前在Amazon S3 中使用的大多數工具和程式庫也將適用於 Cloud Storage。Cloud Storage 支援以下請求方法：

GET 服務請求。
PUT、GET、DELETE 等儲存桶請求。
GET、POST、PUT、HEAD 和DELETE等物件請求。

有關詳情，請參閱XML API 參考方法。請記住，當您向 Cloud Storage 傳送請求時，您需要視情況變更請求正文，使其使用適當的Cloud Storage 語法。例如，在為儲存桶建立生命週期配置時，請使用Cloud Storage 生命週期 XML，而不是使用Amazon S3 生命週期XML。

下面總結了Cloud Storage XML API 和Amazon S3 之間的一些差異：

Amazon S3 功能	Cloud Storage XML API 功能
在分段上傳中使用客戶提供的加密鍵時，最終請求不包括客戶提供的加密鍵。	在Cloud Storage XML API 中，分段上傳中的所有請求（包括最終請求）要求您提供相同的客戶提供的加密金鑰。存在此要求的原因是，Cloud Storage 在等待上傳完成時不會儲存您的加密金鑰訊息，但這項請求需要使用金鑰來計算已完成物件的校驗和。
在Amazon S3 中，V4 簽章可用於對使用分塊傳輸編碼的上傳進行驗證。	在Cloud Storage XML API 中，分塊傳輸編碼和V4 簽章目前無法同時使用。某些Amazon S3 工具預設使用分塊傳輸編碼以及簽章；您應該在此類情況下停用分塊傳輸編碼。
GET/POST 儲存桶查詢字串參數：「policy」- 使用Amazon S3 儲存桶政策。「notification」- 通知儲存桶事件。「requestPayment」- 設定請求和儲存桶資料下載費用的付款者。	替代方案：「policy」- 透過Cloud Storage ACL、專案團隊成員資格以及使用多個專案的能力，您可以應付眾多使用儲存桶政策的情境。「notification」- 使用gcloud CLI 或JSON API Pub/Sub 通知。「requestPayment」- 在Cloud Storage 中，requestPayment 的等效查詢字串參數為billing。
多物件刪除。 POST /?delete	使用Google Cloud 控制台可輕鬆移除多個物件。或者，也可以透過JSON API 發送大量請求，以減少客戶端發起的 HTTP 連線數。

從Amazon S3 遷移到Cloud Storage 標頭

Cloud Storage 可使用多個標準HTTP 標頭以及多個自訂（擴充）HTTP 標頭。如果您要從Amazon S3 轉換到Cloud Storage，您可以將自訂Amazon S3 標頭轉換為等效的Cloud Storage 自訂標頭或類似的功能，如下表所示。

對於大多數Amazon S3 標頭，您只需將 x-amz 替換為 x-goog 即可實現轉換：

Amazon S3 標頭	Cloud Storage 標頭
`x-amz-storage-class`	`x-goog-storage-class`
`x-amz-acl`	`x-goog-acl`
`x-amz-date`	`x-goog-date`
`x-amz-meta-*`	`x-goog-meta-*`
`x-amz-copy-source`	`x-goog-copy-source`
`x-amz-metadata-directive`	`x-goog-metadata-directive`
`x-amz-copy-source-if-match`	`x-goog-copy-source-if-match`
`x-amz-copy-source-if-none-match`	`x-goog-copy-source-if-none-match`
`x-amz-copy-source-if-unmodified-since`	`x-goog-copy-source-if-unmodified-since`
`x-amz-copy-source-if-modified-since`	`x-goog-copy-source-if-modified-since`

注意：雖然Amazon S3 沒有 x-goog-project-id 對應標頭，但Cloud Storage 接受用於簡單遷移的 x-amz-project-id。

對於少數Amazon S3 標頭，有的需要轉換為完全不同的雲儲存標頭，有的不適合雲端儲存：

Amazon S3 標頭	Cloud Storage 標頭
`x-amz-server-side-encryption`	不需要。
`x-amz-grant-*`	具有預先定義的ACL值的 `x-goog-acl`。
`x-amz-mfa`	使用 OAuth 2.0驗證。
`x-amz-website-redirect-location`, `x-amz-copy-source-range`	不適用

若要了解Cloud Storage 標頭，請參閱適用於XML API 的HTTP 標頭和查詢字符串參數。

後續步驟

規劃從Amazon S3 的遷移。
使用儲存傳輸服務將資料從外部來源轉移到雲端儲存（外部來源有Amazon S3 和Microsoft Azure Blob Storage 等）。
建立事件驅動型轉移作業，以使用Amazon S3 事件通知使Cloud Storage 儲存桶與Amazon S3 保持同步。