restore-object_对象存储(OSS)-阿里云帮助中心

restore-object用于解冻归档类型（Archive）或冷归档（Cold Archive）的文件（Object）。

注意事项

阿里云账号默认拥有解冻文件的权限。如果您需要通过RAM用户或者STS的方式进行解冻，您必须拥有oss:RestoreObject权限。具体操作，请参见为RAM用户授权自定义的权限策略。
restore-object只针对归档或冷归档类型的Object，不适用于标准类型和低频访问类型的Object。
对于归档类型或者冷归档类型的Object，如果需要读取Object，请提前解冻。归档类型的Object解冻有分钟级延迟，冷归档类型的Object解冻有数小时延迟。

命令格式

ossutil api restore-object --bucket value --key value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--key	string	Object的完整路径。
--restore-request	string	解冻请求信息。
--version-id	string	请求解冻的Obejct的版本号。

说明

restore-object命令对应API接口RestoreObject。关于API中的具体参数含义，请参见RestoreObject。

--restore-request

--restore-request配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

XML语法：

<RestoreRequest>
  <Days>integer</Days>
  <JobParameters>
    <Tier>string</Tier>
  </JobParameters>
</RestoreRequest>

JSON语法：

{
  "Days": integer,
  "JobParameters": {
    "Tier": "string"
  }
}

说明

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

解冻存储空间examplebucket中的exampleobject。

使用XML配置文件，restore-request.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Standard</Tier>
  </JobParameters>
</RestoreRequest>

命令示例如下：

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

使用JSON配置文件，restore-request.json内容如下：

{
  "RestoreRequest": {
    "Days": "2",
    "JobParameters": {
      "Tier": "Standard"
    }
  }
}

命令示例如下：

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

使用JSON配置参数，命令示例如下：

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request "{\"RestoreRequest\":{\"Days\":\"2\",\"JobParameters\":{\"Tier\":\"Standard\"}}}"