116
Object接口 > 修改文件状态

修改文件的存储状态,即禁用状态和启用状态间的的互相转换。

状态解释

处于禁用状态的文件将只能通过签发 Token 的方式访问 下载凭证

请求报文

  • 请求语法
POST /chstatus/<EncodedEntry>/status/<status> HTTP/1.1
Host: rs.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <AccessToken>

注:status 值为数字,0表示启用;1表示禁用。

  • 访问权限

管理凭证方式

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

响应报文响应报文

  • 响应语法
  • 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管理凭证无效
612目标资源不存在
599服务端操作失败

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

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