修改文件的 MIME 类型信息。

注意：

• 归档存储文件，只有解冻状态时可以修改MIME类型信息。

请求报文

请求语法

POST /chgm/<EncodedEntryURI>/mime/<EncodedMimeType>/x-qn-meta-<meta_key>/<EncodedMetaValue>/cond/<Encodedcond> HTTP/1.1
Host:           rs.qbox.me
Content-Type:   application/x-www-form-urlencoded
Authorization:  Qiniu <AccessToken>

EncodedEntryURI和EncodedMimeType的细节请参考EncodedEntryURI，而EncodedMimeType编码前的明文要设置新的mimeType。meta_key可以自定义，它可以由字母、数字、下划线、减号组成，且长度小于等于50，单个文件 meta_key 和 metavalue 总和大小不能超过 1024 字节，可以同时修改多个 meta 字段，metavalue 规则和 mimeType 相同。cond当前支持设置hash、mime、fsize、putTime条件，只有条件匹配才会执行修改操作，Encodedcond中的cond支持condKey1=condVal1&condKey2=condVal2格式。

访问权限

管理凭证方式。

头部信息

mimeType命名规则

• 目前所有的mimetype包括如下字符集：a-z, A-Z, 0-9, ., +, /, -。
• 因为mimetype日后还会增加，为保证兼容将增加如下字符;,=,,,_和空格。
• 目前mimetype最大长度为79, 为保证兼容将来限制最大长度为200。
• mimetype为空这里认为合法，因为如果为空后面会进一步检测并设置。
• mimetype可以包括空格，例如：text/plain; charset=iso-8859-1。
• 禁止转义，如%0A表示\n，所以禁止出现%。

响应报文

响应语法

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

头部信息

其它可能返回的头部信息，请参考HTTP扩展字段。

响应内容

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

• 如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    "error":   "<errMsg    string>"
}

响应状态码

示例

命令行示例

curl -i \
     -o - \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     -H 'Authorization: Qiniu bt500PzCG9tV0bccCOdnrmCHPXCPLieGSDEprB7M:4wG...' \
     -X POST \
     'http://rs.qbox.me/chgm/YnVja2V0OmtleQ==/x-qn-meta-meta_key/bWV0YV92YWx1ZQ==/cond/ZnNpemU9Ng=='

请求示例

POST /chgm/YnVja2V0OmtleQ==/x-qn-meta-meta_key/bWV0YV92YWx1ZQ==/cond/ZnNpemU9Ng==  HTTP/1.1
Host: rs.qbox.me
User-Agent: Go-http-client/1.1
Content-Length: 0
Authorization: Qiniu EmEtww5prO5pe8ts_mG.......1tXlEQ9hoG4:LuGCwpfK-rM=
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip

注意：要在Authorization头部的<AccessToken>前添加Qiniu和半角空格。

响应示例

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 23 Jun 2017 10:23:18 GMT
Content-Type: application/json
Content-Length: 0
Connection: keep-alive
X-Reqid: -nIAABnfaeIlucoU