支持的 REST API 操作 - Amazon Snowball Edge 开发人员指南
Snowball Edge 设备支持的 REST API 操作亚马逊 S3 适配器支持的 REST API 操作支持 Snow Family 设备上兼容亚马逊 S3 的存储的 REST API 操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

支持的 REST API 操作

接下来，您可以找到可以与之配合使用的 REST API 操作Amazon Snowball Edge设备和亚马逊 S3。

Snowball Edge 设备支持的 REST API 操作

HEAD 雪球边缘

描述

目前，只有一个 Snowball Edge REST API 操作，你可以用它来返回特定设备的状态信息。此操作返回 Snowball Edge 的状态。此状态包括可供使用的信息Amazon Web Services Support用于故障排除。

您不能将此操作与Amazon软件开发工具包或Amazon CLI。建议您使用 curl 或 HTTP 客户端。对于此操作，请求无需经过签名。

请求

在以下示例中，Snowball Edge 的 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>

亚马逊 S3 适配器支持的 REST API 操作

下面，您可以找到支持使用亚马逊 S3 适配器的 Amazon S3 REST API 操作列表。该列表包含指向有关 API 操作如何与 Amazon S3 配合使用的信息的链接。该列表还涵盖了 Amazon S3 API 操作和 Amazon S3 API 操作之间的任何行为差异Amazon Snowball Edge设备对应物。所有回复都来自Amazon 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

亚马逊 S3 REST API 调用需要 Sigv4 签名。如果你使用的是Amazon CLI或者一个AmazonSDK 为了进行这些 API 调用，Sigv4 签名将由你处理。否则，您需要实施自己的 SigV4 签名解决方案。有关更多信息，请参阅对请求进行身份验证 (Amazon签名版 (4)在《亚马逊简单存储服务用户指南》。

注意

不支持此处未列出的任何 Amazon S3 适配器 REST API 操作。在 Snowball Edge 上使用任何不支持的 REST API 操作都会返回一条错误消息，指出不支持该操作。

支持 Snow Family 设备上兼容亚马逊 S3 的存储的 REST API 操作

以下列表显示了 Snow Family 设备上与 Amazon S3 兼容的存储支持的 API 操作，包括指向中亚马逊 S3 的相关操作的链接Amazon Web Services 区域。

支持的存储桶 API 操作：

支持的对象 API 操作：