取回归档文件
更新时间:2023-06-06
接口说明
RestoreObject用于取回归档存储文件,请求者必须有归档存储文件的读权限,并且归档存储文件处于冰冻状态。
注意:
- 如果使用软链接访问该接口,会根据软链接的目标文件的存储类型和状态进行处理。
- 如果使用软链接访问该接口且目标文件删除了,会返回Http 404,SymlinkTargetNotExist。
请求URI
POST /v1/{bucketName}/{objectKey}?restore
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
---|---|---|---|---|---|
bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
objectKey | String | 是 | object的名称 | "objectKey_example" | Path |
请求头参数
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
xBceRestoreDays | int | 否 | 示解冻后状态的持续时间,要求是数字,单位是天,取值大于0且不超过30即可。默认解冻持续天数是7天,最长30天。 | 7 |
x-bce-restore-tier | string | 否 | 解冻优先级。可取值范围如下: Expedited:加急取回,表示30min内完成取回 Standard:标准取回,表示2~5小时内完成取回 LowCost:延缓取回,表示12小时内完成取回 |
Expedited |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
请求示例
POST /v1/bucketName_example/objectKey_example?restore
<公共请求头>
x-bce-restore-days: 7
{ }
响应示例
HTTP/1.1 200 OK
<公共响应头>
{ }
错误码
请参考通用错误码