转换存储类型_API_Object Storage-文档中心

本接口旨在为开发者提供在Object Storage上转换文件存储类型的能力。

请求说明

要调用此接口，请发送以下格式的POST请求：

POST /converttype/{param1}/{storageType}
Host: {mgrDomain}
Authorization: {accessToken}

以下表格提供参数的必要信息和描述：

参数	必填	描述
`param1`	是	指定需要转换存储类型的文件。格式为`Urlsafe_Base64_Encode(bucket:key)`，其中`bucket`是存储空间的名称，`key`是文件名（包括路径）。例如，要转换存储空间`bucket1`中的文件`1.jpg`的存储类型，此参数应填为`YnVja2V0MToxLmpwZw==`，即`bucket1:1.jpg`的Url安全Base64编码形式。
`storageType`	是	指明目标存储类型。可选存储类型包括： Standard - 标准存储 IA - 低频访问存储 Archive - 归档存储
`mgrDomain`	是	管理域名。您可以在存储空间的概览中找到管理域名，格式通常为`*.v1.wcsapi.com`。
`accessToken`	是	也称为管理凭证，用于API调用中的身份验证。有关创建管理凭证的更多详细信息，请参阅管理凭证。

下面的示例展示了如何使用curl命令发起一个转换存储类型的请求：

curl -v -X POST "http://mgrDomain/converttype/aW1hZ2VzOkltYWdlLnBuZw==/Standard"

请求成功时，将返回：

{"code": 200, "message": "ok"}

若目标存储类型与原存储类型相同，或原文件为归档存储且未先解冻，则返回：

{"code": 403, "message": "Invalid Object State"}

若文件不存在，将返回：

{"code": 403, "message": "File Not Found"}

字段名称	是否必需	描述
code	是	有关HTTP请求响应代码，请参见 HTTP响应状态码。
message	是	请求提示信息。OK表示成功。