帮助与文档

全部文档
帮助与文档 > 对象存储 > API > Object接口 > 修改文件状态

修改文件状态

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

    状态解释

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

    请求报文

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

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

    • 访问权限

    管理凭证方式

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

    响应报文响应报文

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

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

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

    1. {
    2. "error": "<errMsg string>"
    3. }
    字段名称 必填 说明
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 更改成功
    400 请求报文格式错误
    解析失败,返回400 Bad Request {“error”:”invalid argument”}
    不符合UTF-8编码,返回400 Bad Request {“error”:”key must be utf8 encoding”}
    当文件当前状态和设置的状态已经一致,返回{“error”:”already enabled”}或{“error”:”already disabled”}
    401 管理凭证无效
    612 目标资源不存在
    599 服务端操作失败

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

    提交成功!非常感谢您的反馈,我们会继续努力做到更好!更多建议 非常抱歉未能帮助到您。为了给您提供更好的服务,我们很需要您进一步的反馈信息:

    在文档使用中是否遇到以下问题:

    更多建议