restore 命令用于取回归档文件。
注意：如需使用此命令，在你进行 授权策略 时，action 需要设置为 cos:HeadBucket，cos:GetBucket，cos:PostObjectRestore ，更多授权请参见 支持 CAM 的业务接口。
一、命令格式
restore 命令包含以下参数：
| 参数格式 | 参数用途 | 示例 |
| cos://<bucket-name> | 指定需要访问的存储桶。支持使用 配置参数 中的桶别名，或桶名称进行访问。如使用桶名称访问，需要额外携带 endpoint flag | 使用桶别名访问：cos://example-alias使用桶名称访问：cos://examplebucket-1250000000 |
| /prefix/ | 可选参数。指定某一文件夹 | /picture/ |
restore 命令包含以下可选 flag：
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法 |
| 无 | –include | 包含特定模式的文件 |
| 无 | –exclude | 排除特定模式的文件 |
| -d | –days | 指定解冻对象所生成的临时文件的过期时间（默认为3天） |
| -m | –mode | 指定恢复模式（默认 Standard）若恢复的是归档存储类型数据，可选值为 Expedited、Standard、Bulk，分别对应快速取回模式、标准取回模式以及批量取回模式这三种模式若恢复的是深度归档存储类型数据，则可选值为 Standard、Bulk |
| -r | –recursive | 递归遍历文件夹 |
| 无 | –fail-output | 此选项决定是否启用回热失败时文件的错误输出（默认为true，开启）。如果启用，文件回热失败将被记录在指定目录内（如果没有指定，默认为./coscli_output）。如果禁用，只会将错误文件的数量输出到控制台 |
| 无 | –fail-output-path | 此选项用于指定记录回热失败文件的错误输出文件夹。通过提供自定义文件夹路径，你可以控制错误输出文件夹的位置和名称。如果未设置此选项，将使用默认的错误日志文件夹./coscli_output |
| 无 | –routines | 批量 restore 时的并发 worker 数，默认 3 |
注意：./coscli restore cos://bucket1/example/ -r –include ".*\\.mp4$"
二、以标准取回模式取回 bucket1桶内的归档文件
./coscli restore cos://bucket1/picture.jpg
三、以快速取回模式取回 bucket1桶内 picture 文件夹下的所有归档文件
./coscli restore cos://bucket1/picture/ -r –mode Expedited