本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Snow 系列裝置上支援的 Amazon S3 REST API 動作
接下來,您可以找到可以與 AWS Snowball Edge 裝置和 Amazon S3 搭配使用的RESTAPI動作。
Snowball 邊緣裝置支援的RESTAPI動作
HEADSnowball 邊緣操作
目前只有一個 Snowball Edge REST API 作業,您可以使用它來傳回特定裝置的狀態資訊。此作業會傳回 Snowball 邊緣裝置的狀態。此狀態包括可用於疑難排解目的 AWS Support 的的資訊。
您無法搭配 AWS SDKs或使用此作業 AWS CLI。我們建議您使用curl
或用HTTP戶端。不需要簽署請求,即可進行此操作。
請求
在下列範例中,Snowball 邊緣裝置的 IP 位址為 192.0.2.0
。 將此值取代為實際裝置的 IP 位址。
curl -X HEAD http://
192.0.2.0
:8080
回應
<Status xsi:schemaLocation="http://s3.amazonaws.com/doc/2006-03-01/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <snowballIp>127.0.0.1</snowballIp> <snowballPort>8080</snowballPort> <snowballId>
device-id
</snowballId> <totalSpaceInBytes>499055067136</totalSpaceInBytes> <freeSpaceInBytes>108367699968</freeSpaceInBytes> <jobId>job-id
</jobId> <snowballServerVersion>1.0.1</snowballServerVersion> <snowballServerBuild>DevBuild</snowballServerBuild> <snowballClientVersion>Version 1.0</snowballClientVersion> <snowballRoundTripLatencyInMillis>33</snowballRoundTripLatencyInMillis> </Status>
Snowball 邊緣裝置上 Amazon S3 介面卡支援的RESTAPI動作
接下來,您可以找到支援使用 Amazon S3 轉接器的 Amazon S3 REST API 動作清單。此清單包含動作如何與 Amazon S3 搭配運API作的相關資訊連結。此清單也涵蓋 Amazon S3 API 動作與 AWS Snowball Edge 裝置對應項目之間的任何行為差異。從 AWS Snowball Edge 裝置傳回的所有回應宣告Server
為AWSSnowball
,如下列範例所示。
HTTP/1.1 201 OK x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80 x-amz-request-id: 32FE2CEB32F5EE25 Date: Fri, 08 2016 21:34:56 GMT Server: AWSSnowball
Amazon S3 REST API 呼叫需要簽署 SIGv4。如果您使用 AWS CLI 或 AWS SDK來進行這些API呼叫,則會為您處理 Sigv4 簽署。否則,您需要實作自己的 SigV4 簽署解決方案。如需詳細資訊,請參閱 Amazon 簡單儲存服務使用者指南中的驗證請求 (AWS 簽名版本 4)。
-
GET值區(列表對象)版本 1 — 支持。但是,在此作業的實GET作中,不支援下列項目:
-
分頁
-
標記
-
分隔符號
-
當返回列表時,列表沒有排序
只支援第 1 版。GET不支援值區 (清單物件) 版本 2。
-
-
GET對象-是來自 Snow 設備 S3 存儲桶DOWNLOAD的對象。
-
PUT物件 — 使用將物件上載至 AWS Snowball Edge 裝置時
PUT Object
,ETag會產生。ETag是物件的雜湊。只會ETag反映物件內容的變更,而不會反映其中繼資料。ETag可能是或可能不是物件資料的MD5摘要。如需詳細資訊ETags,請參閱 Amazon 簡單儲存服務API參考中的常見回應標頭。
-
啟動多部分上傳 — 在此實作中,針對已存在於 AWS Snowball Edge 裝置上的物件啟動多部分上載請求會先刪除該物件。然後,它將其部分複製到 AWS Snowball Edge 設備。
注意
不支援此處未RESTAPI列出的任何 Amazon S3 適配器動作。對 Snowball Edge 使用任何不受支援的動RESTAPI作會傳回錯誤訊息,指出該動作不受支援。