受支持的 REST API 操作 - Amazon Snowball
受支持的 Snowball REST API 操作支持的 S3 REST API 操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

受支持的 REST API 操作

在下文中，您可以找到可与 Snowball 结合使用的 REST API 操作。

受支持的 Snowball REST API 操作

HESnowball

描述

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

您不能将此操作与Amazon上的开发工具包Amazon 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>

受支持的 Amazon S3 REST API 操作

在下文中，您将了解使用 Amazon S3 Adapter for Snowball 时可使用的 Amazon S3 API 操作的列表。此列表包括有关 API 操作如何与 Amazon S3 配合使用的信息的链接。此列表还列出了 Amazon S3 API 操作与 Snowball API 操作之间的所有行为差异。Snowball 返回的所有回复都声明是Server如同AWSSnowball，如以下示例所示。

HTTP/1.1 200 OK
x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80
x-amz-request-id: 32FE2CEB32F5EE25
Date: Fri, 08 2016 21:34:56 GMT
Server: AWSSnowball

  • GET Bucket (List Objects) version 1– 在此 GET 操作实现中，具有以下特征：

    • 不支持分页。

    • 不支持标记。

    • 不支持分隔符。

    • 在返回列表时，未对列表进行排序。

    • 仅支持版本 1。不支持 GET Bucket (List Objects) 版本 2。

    • Snowball 适配器未针对大型列表操作进行优化。例如，您可能有这样一个案例：每个文件夹中有 100 多万个对象，您希望在将这些对象传送到设备后列出这些对象。在这种情况下，建议您为您的任务订购 Snowball Edge。

  • GET 服务

  • HEAD 存储桶

  • HEAD Object

  • GET Object— 使用以下方法将对象上传到 Snowball 时GET Object，除非使用分段上传的方法上传对象，否则不会生成实体标签 (ETag)。ETag 是该对象的哈希。ETag 仅反映对对象的内容的更改，而不反映对对象的元数据的更改。ETag 可能是该对象数据的 MD5 摘要，也可能不是。有关 ETAG 的更多信息，请参阅常用响应标头中的《Amazon Service API 参考》。

  • PUT Object— 使用以下方法将对象上传到 Snowball 时PUT Object，除非使用分段上传的方法上传对象，否则不会生成 ETag。

  • DELETE Object

  • 开始分段上传— 在实施此操作时，针对 Snowball 中已有的对象发起分段上传请求，会首先删除该对象，然后将其分段复制到 Snowball 中。

  • 列出分段上传

  • 上传分段

  • 完成分段上传

  • 中止分段上传

注意

不支持此处未列出的任何 Amazon S3 REST API 操作。将任何不受支持的 REST API 操作与 Snowball Edge 结合使用会返回错误消息，说明不支持此操作。