Snow 系列裝置上支援的 Amazon S3 REST API 動作 - AWS Snowball Edge 開發者指南

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 裝置傳回的所有回應宣告ServerAWSSnowball,如下列範例所示。

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)

注意

不支援此處未RESTAPI列出的任何 Amazon S3 適配器動作。對 Snowball Edge 使用任何不受支援的動RESTAPI作會傳回錯誤訊息,指出該動作不受支援。