文件解冻_API_Object Storage-文档中心

本接口可以解冻档存储类型的文件。解冻后，可以直接访问这些归档文件。

请求说明

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

POST /restore/{encodedEntry}/days/{duration}
Host: {mgrDomain}
Authorization: {accessToken}

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

参数	必填	描述
`param1`	是	需要解冻的文件，格式为`EncodeEntryURI(bucket:key)`，其中`bucket`是存储空间名称，`key`是文件名（包括路径）。例如，`YnVja2V0MToxLmpwZw==`表示`bucket1:1.jpg`的Url安全Base64编码形式。
`days`	是	解冻后文件的有效期，最小为1天。若格式不合法，返回400错误。
`mgrDomain`	是	管理域名，可在存储空间的概览中找到，格式通常为`*.v1.wcsapi.com`。
`accessToken`	是	也称为管理凭证，用于API调用中的身份验证。有关创建管理凭证的更多详细信息，请参阅管理凭证。

下面的示例展示了如何使用curl命令发起一个解冻归档文件的请求：

curl -v -X POST "http://{managementDomain}/restore/aW1hZ2VzOkltYWdlLnBuZw==/days/1"

成功调用：

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

若文件已是标准存储类型，将返回：

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

若文件正在解冻中，重复调用将返回：

{"code": 409, "message": "Restore Is InProgress"}

若文件不是归档类型，将返回：

{"code": 403, "message": "Unsupported Operation"}

若文件不存在，将返回：

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

其他失败情况，将返回：

{
    "code": "<httpCode int>",
    "message": "<errMsg string>"
}

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