manta api

Authentication

有几个访问方法。 验证对服务的请求的主要方法是使用TLS上的HTTP签名。

在大多数情况下，您只需使用SSH私钥对HTTP Date标头的小写日期：和值进行签名; 这样做可以让你创建交互式shell函数（见下文）。 所有的请求都需要一个HTTP授权头，其中的scheme是签名。

PutDirectory (PUT /:login/stor/[:directory]/:directory)

Joyent Manta存储服务中的PutDirectory是一个幂等的创建或更新操作。 您的私有名称空间从/：login / stor开始，然后您可以在其下创建任何嵌套的目录或对象集。

要放置一个目录，只需将HTTP Request-URI设置为你要更新的路径，并将Content-Type HTTP header设置为application / json;type=directory。 没有请求或响应主体。 成功返回204的HTTP状态码。

manta /$MANTA_USER/stor/foo \
    -X PUT \
    -H 'content-type: application/json; type=directory'

---------------------------------------------------------------------

ListDirectory (GET /:login/stor/:directory)

列出目录的内容。 成功之后，您将收到\ n分离的JSON对象流，其中每个对象表示一个目录条目。content-type将是application / x-json-stream;type=directory。 
每个对象都有一个类型字段，表示该条目是一个目录还是一个对象。 例如（为清楚起见，添加了新的行）：

{
    "name": "1c1bf695-230d-490e-aec7-3b11dff8ef32",
    "type": "directory",
    "mtime": "2012-09-11T20:28:30Z"
}

{
    "name": "695d5de6-45f4-4156-b6b7-3a8d4af89391",
    "etag": "bdf0aa96e3bb87148be084252a059736",
    "size": 44,
    "type": "object",
    "mtime": "2012-09-11T20:28:31Z"
}

类型字段表示每个记录的“schema”; 唯一的类型是当前的对象和目录。 两者都有一个名称（文件名），类型（已经描述）和mtime，这是上次更新时间的ISO8601时间戳。 
此外，对象类型的记录具有一个大小（content-length）和etag（对于有条件的请求）。您将返回256个条目（您可以通过在查询字符串上设置限制参数选择更少或更多）。 
您可以使用标记查询参数选择从哪里开始下一个列表。 您将得到result-set-size header中的记录总数。 服务按字母顺序列出对象（UTF-8归类）。
Query Parameters:
limit: limits the number of records to come back (default and max is 1000)
marker: key name at which to start the next listing
返回
JSON对象流，每个孩子一个记录。

manta /$MANTA_USER/stor/

DeleteDirectory (DELETE /:login/stor/:directory)

删除一个目录。 该目录必须是空的。 这个请求没有响应数据。 成功时返回HTTP 204;

manta /$MANTA_USER/stor/foo -X DELETE

PutObject (PUT /:login/stor/[:directory]/:object)

　　创建或覆盖一个对象。 您可以像在传统文件系统上一样指定对象的路径，并且父级必须是目录。 该服务将不会解释您的数据。

具体来说，这意味着你的数据被视为一个不透明的字节流，你将会收到你上传的内容。 成功时返回HTTP 204。

　　默认情况下，该服务将在两个不同数据中心的两台物理服务器上存储数据的两个副本; 请注意，每个物理服务器都配置了RAID-Z，

因此磁盘驱动器故障不会影响您的耐用性或可用性。 您可以使用durability-level header增加（或减少）对象的副本数量。

　　您应该始终指定一个Content-Type header，它将被存储并返回（HTTP content-negotiation将被处理）。 如果你没有指定，默认是application / octet-stream。

您应该指定一个Content-MD5 header; 如果你这样做, 服务将验证上传的内容匹配header的值。 即使你不包括一个，成功的回应将包括一个computed-md5 header。

这是Manta在摄取对象时计算的MD5校验和。

　　如果您使用HTTP条件请求语义（例如，If-Match或If-Modified-Since），则该服务能够为您提供测试/设置语义。跨源资源共享CORS headers 被保存在适当的位置;

通过发送access-control-allow-origin中的值列表来支持预先发送的请求。默认情况下，该服务将存储您的对象的2个副本; 这可以通过durability-level header来改变。

　　请注意，如果您使用的是“流传输上传”（传输编码分块），则要么控制服务中的默认对象大小（5Gb），要么通过覆盖 HTTP header max-content-length来“猜测”对象的大小 。

无论哪种方式，该服务将跟踪_actually_发送和记录的字节数。 随后的GET请求将返回实际的长度。 如果您不是流媒体，只需设置内容长度（正常情况下）即可。

　　最后，你可以用自己的对象存储自定义headers（例如 "tags"），前缀为m-。 因此，例如，包含头文件m-local-user：foo和一个对象将允许你跟踪创建此对象的应用的某个本地用户。

您最多可以使用4 Kb的header数据。

manta /$MANTA_USER/stor/foo.json -X PUT -H 'content-type: application/json' \
        -d '{"hello": "world"}'

PutMetadata (PUT /:login/stor/[:directory]/:object?metadata=true)

PutMetadata允许您覆盖已经存在的对象的HTTP标头，而不用改变数据。 请注意，这是一个幂等的“替换”操作，所以您必须指定要在每个请求上存储的完整HTTP标头集合。

您不能更改“关键”标题：

• Content-Length
• Content-MD5
• Durability-Level

manta /$MANTA_USER/stor/foo.json?metadata=true -X PUT \
        -H 'content-type: application/json'

GetObject (GET /:login/stor/[:directory]/:object)

从服务中检索一个对象。 一旦成功，HTTP 200将与您的内容和元数据（HTTP标头）一起返回。

manta /$MANTA_USER/stor/foo.json

DeleteObject (DELETE /:login/stor/[:directory]/:object)

从服务中删除一个对象。 成功时返回HTTP 204。

manta /$MANTA_USER/stor/foo.json -X DELETE