批量操作意指在单一请求中执行多次获取元信息、移动、复制、删除和解冻操作,极大提高资源管理效率。 其中,解冻操作仅针对归档存储文件有效。
请求报文
请求语法
POST /batch HTTP/1.1
Host: rs.qbox.me
Content-Type: application/x-www-form-urlencoded
Authorization: Qiniu
op=&op=&...
注意:要在 Authorization 头部的前添加 Qiniu 和半角空格。其中op=是单一资源管理指令(如:/stat/,/delete/)。
EncodeEntryURI、EncodedEntryURISrc 与 EncodedEntryURIDest 的细节请参考EncodedEntryURI。
访问权限
头部信息
头部名称
必填
说明
Content-Type
是
固定为 application/x-www-form-urlencoded
Authorization
是
该参数应严格按照管理凭证格式进行填充,否则会返回401错误码
一个合法的 Authorization 值应类似于:Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...
请求内容
#批量获取元信息
op=/stat/&op=/stat/&...
#批量复制资源
op=/copy//&op=/copy//&.../force/
#批量移动资源
op=/move//&op=/move//&.../force/
#批量删除资源
op=/delete/&op=/delete/&...
#批量解冻资源
op=/restoreAr//freezeAfterDays/&...
#混合多种操作
op=/stat/&op=/copy///force/&op=/move///force/ &op=/delete/&op=/restoreAr//freezeAfterDays/&...
说明:copy 和 move 操作需为每个资源指定force参数。
响应报文
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
头部信息
头部名称
必填
说明
Content-Type
是
正常情况下该值将被设为application/json,表示返回JSON格式的文本信息。
其它可能返回的头部信息,请参考HTTP扩展字段。
响应内容
#批量获取元信息
[
{ "code": , "data": },
{ "code": , "data": },
{ "code": , "data": { "error": "" } },
...
]
#批量复制资源
[
{ "code": },
{ "code": },
{ "code": , "data": { "error": "" } },
...
]
#批量移动资源
[
{ "code": },
{ "code": },
{ "code": , "data": { "error": "" } },
...
]
#批量删除资源
[
{ "code": },
{ "code": },
{ "code": , "data": { "error": "" } },
...
]
#批量解冻资源
[
{ "code": },
{ "code": },
{ "code": , "data": { "error": "" } },
...
]
#混合多种操作
[
{ "code": , "data": },
{ "code": },
{ "code": },
{ "code": },
{ "code": , "data": { "error": "" } },
...
]
响应状态码
HTTP状态码
含义
200
所有请求操作都已成功完成
298
部分或所有请求操作失败(出错信息参看上述响应内容)
400
请求报文格式错误
401
管理凭证无效
403
禁止操作
当非归档存储类型 Object 调用此接口时,返回403 Fobbiden {"error": "operation not allowed for archive"}
599
服务端操作失败
如遇599错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。