批量操作意指在单一请求中执行多次获取元信息、移动、复制、删除和解冻操作，极大提高资源管理效率。 其中，解冻操作仅针对归档存储文件有效。

请求报文

请求语法

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响应头部)提交工单 给我们。