本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
受支持的 REST API 操作
接下来,您可以找到可在 Amazon Snowball Edge 设备和 Amazon S3 上使用的 REST API 操作。
Snowball Edge 设备支持的 REST API 操作
HEAD Snowball Edge
描述
目前,只有一个 Snowball Edge REST API 操作,它可用于返回特定设备的状态信息。此操作返回 Snowball Edge 的状态。此状态包括 Amazon Web Services Support 可用于故障排除的信息。
您不能将此操作与 S Amazon DK 或. 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>
Amazon S3 Adapter 支持的 REST API 操作
在下文中,您可以找到使用 Amazon S3 Adapter 时可使用的 Amazon S3 REST API 操作的列表。此列表包括有关 API 操作如何与 Amazon S3 配合使用的信息的链接。该列表还涵盖了 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
Amazon S3 REST API 调用需要 SigV4 签名。如果您使用 Amazon CLI 或 Amazon SDK 进行这些 API 调用,则会为您处理 Sigv4 签名。否则,您需要实施自己的 SigV4 签名解决方案。有关更多信息,请参阅 Amazon 简单存储服务用户指南中的对请求进行身份验证(Amazon 签名版本 4)。
-
GET 存储桶(列出对象)版本 1:支持。但是,在 GET 操作的实施中,不支持以下内容:
-
分页
-
标记
-
分隔符
-
在返回列表时,未对列表进行排序
仅支持版本 1。不支持 GET 存储桶(列出对象)版本 2。
-
-
GET 对象:是指从 Snow 设备的 S3 存储桶中下载的对象。
-
PUT 对象-使用将对象上传到 Amazon Snowball Edge 设备时
PUT Object
,会生成 ETag。ETag 是该对象的哈希。ETag 仅反映对对象的内容的更改,而不反映对对象的元数据的更改。ETag 可能是该对象数据的 MD5 摘要,也可能不是。有关 ETag 的更多信息,请参阅《Amazon Simple Storage Service API 参考》中的常用响应标头。
-
启动分段上传-在此实现中,为 Amazon Snowball Edge 设备上已有的对象启动分段上传请求会首先删除该对象。然后,它会将其分部分复制到 Amazon Snowball Edge 设备上。
注意
不支持此处未列出的任何 Amazon S3 Adapter REST API 操作。将任何不受支持的 REST API 操作与 Snowball Edge 结合使用会返回错误消息,说明不支持此操作。