DeleteMultipleObjects
DeleteMultipleObjects接口用于删除同一个存储空间(Bucket)中的多个文件(Object)。
说明 DeleteMultipleObjects接口一次最多允许删除1000个文件。
请求语法
POST /?delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: ContentLength
Content-MD5: MD5Value
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<Delete>
<Quiet>true</Quiet>
<Object>
<Key>key</Key>
</Object>
…
</Delete>
请求头
OSS会根据以下请求头验证收到的消息体,消息体正确才会执行删除操作。
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Encoding-type | 字符串 | 否 |
Key使用UTF-8字符。如果Key中包含XML 1.0标准不支持的控制字符,您可以通过指定encoding-type对返回结果中的Key进行编码。 默认值:无 可选值:url |
Content-Length | 字符串 | 是 |
用于描述HTTP消息体的传输长度。 OSS会根据此请求头验证收到的消息体,消息体正确才会执行删除操作。 |
Content-MD5 | 字符串 | 是 |
Content-MD5是一串由MD5算法生成的值,该请求头用于检查消息内容是否与发送时一致。上传了Content-MD5请求头后,OSS会计算消息体的Content-MD5并检查一致性。 说明 将DeleteMultipleObjects的请求消息体经过MD5加密后得到一个128位字节数组。然后将该字节数组用base64算法编码,编码后得到的字符串即Content-MD5字段内容。
|
请求元素
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Delete | 容器 | 是 |
保存DeleteMultipleObjects请求的容器。 子节点:一个或多个Object元素,Quiet元素 父节点: None |
Object | 容器 | 是 |
保存一个Object信息的容器。 子节点:Key 父节点:Delete |
Key | 字符串 | 是 |
被删除Object的名字。 父节点:Object |
Quiet | 枚举字符串 | 是 |
打开简单响应模式的开关。 DeleteMultipleObjects提供以下两种消息返回模式:
有效值:true(开启简单模式)、false(开启详细模式) 默认值:false 父节点:Delete |
响应元素
名称 | 类型 | 描述 |
---|---|---|
Deleted | 容器 |
保存被成功删除的Object的容器。 子节点:Key 父节点:DeleteResult |
DeleteResult | 容器 |
保存DeleteMultipleObjects请求结果的容器。 子节点:Deleted 父节点:None |
Key | 字符串 |
被删除Object的名字。 父节点:Deleted |
EncodingType | 字符串 |
返回结果中编码使用的类型。如果请求的参数中指定了encoding-type,则返回的结果会对Key进行编码。 父节点:容器 |
示例
- 关闭简单响应模式的请求示例
POST /?delete HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 29 Feb 2012 12:26:16 GMT Content-Length:151 Content-MD5: ohhnqLBJFiKkPSBO1eNaUA== Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:+z3gBfnFAxBcBDgx27Y/jEfb**** <?xml version="1.0" encoding="UTF-8"?> <Delete> <Quiet>false</Quiet> <Object> <Key>multipart.data</Key> </Object> <Object> <Key>test.jpg</Key> </Object> <Object> <Key>demo.jpg</Key> </Object> </Delete>
返回示例HTTP/1.1 200 OK x-oss-request-id: 78320852-7eee-b697-75e1-b6db0f4849e7 Date: Wed, 29 Feb 2012 12:26:16 GMT Content-Length: 244 Content-Type: application/xml Connection: keep-alive Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <DeleteResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”> <Deleted> <Key>multipart.data</Key> </Deleted> <Deleted> <Key>test.jpg</Key> </Deleted> <Deleted> <Key>demo.jpg</Key> </Deleted> </DeleteResult>
- 打开简单响应模式的请求示例
POST /?delete HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 29 Feb 2012 12:33:45 GMT Content-Length:151 Content-MD5: ohhnqLBJFiKkPSBO1eNaUA== Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:WuV0Jks8RyGSNQrBca64kEEx**** <?xml version="1.0" encoding="UTF-8"?> <Delete> <Quiet>true</Quiet> <Object> <Key>multipart.data</Key> </Object> <Object> <Key>test.jpg</Key> </Object> <Object> <Key>demo.jpg</Key> </Object> </Delete>
返回示例HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A64485981 Date: Wed, 29 Feb 2012 12:33:45 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
SDK
错误码
错误码 | HTTP 状态码 | 描述 |
---|---|---|
InvalidDigest | 400 | 上传了Content-MD5请求头后,OSS会计算消息体的Content-MD5并检查一致性,如果不一致会返回此错误码。 |
MalformedXML | 400 |
|
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论