116
Object接口 > 资源删除

删除指定资源。如果资源不存在,则返回错误码612。

请求报文

请求地址:

rs.qiniu.com

  • 请求语法
POST /delete/<EncodedEntryURI> HTTP/1.1
Host: rs.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <AccessToken>
  • 访问权限

管理凭证方式。

  • 头部信息
头部名称必填说明
Authorization该参数应严格按照管理凭证格式进行填充,否则会返回401错误码
一个合法的Authorization值应类似于:QBox QNJi_bYJlmO5LeY08FfoNj9w_r7…

响应报文

  • 响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
  • 头部信息
头部名称必填说明
Content-Type正常情况下该值将被设为application/json,表示返回JSON格式的文本信息。
  • 响应内容

如果请求成功,不返回任何内容。

如果请求失败,返回包含如下内容的JSON字符串

{
"error": "<errMsg string>",
}
字段名称必填说明
error与HTTP状态码对应的消息文本
  • 响应状态码
HTTP状态码含义
200删成功
400请求报文格式错误
401管理凭证无效
599服务端操作失败
612待删除资源不存在

请求示例:

POST /delete/bmV3ZG9jczpmaW5kX21hbi50eHQ= HTTP/1.1
User-Agent: curl/7.30.0
Host: rs.qbox.me
Accept: */*
Authorization: QBox u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...

响应示例:

HTTP/1.1 200 OK
Server: nginx/1.0.8
Date: Thu, 05 Dec 2013 06:55:29 GMT
Content-Type: application/json
Connection: keep-alive
Content-Length: 0
X-Reqid: wxIAAD3btw-v3TwT

代码示例

function deleteFile($accessKey, $secretKey,$bucket,$key)
{
    $authObj = new Auth($accessKey, $secretKey);
    $http = new Http();
    $entry = "{$bucket}:{$key}";//格式:空间名:文件名
    $encodedEntryURI = $authObj->base64_urlSafeEncode($entry);
    $url = "http://rs.qiniu.com/delete/{$encodedEntryURI}";
    $headers = $authObj->getHeaders($url);
    $result = $http->send($url,'POST',[],$headers);
    return $result;
}
$accessKey = 'xxx';
$secretKey = 'xxx';
$bucket = '123_1';//存储空间名称,要求在互站云对象存储范围内唯一,由3~63个字符组成,支持小写字母、短划线-和数字,且必须以小写字母或数字开头和结尾
$key = '123.png';//文件名
echo changeMime($accessKey,$secretKey,$bucket,$key);

这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!