restore 命令用于取回归档文件。
注意：
如需使用此命令，在您进行 授权策略 时，action 需要设置为
cos:HeadBucket，cos:GetBucket，cos:PostObjectRestore ，更多授权请参见 支持 CAM 的业务接口。命令格式
./coscli restore cos://<bucket-name>[/prefix/] [flag]
restore 命令包含以下参数：
参数格式 | 参数用途 | 示例 |
cos://<bucket-name> | 使用桶别名访问：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 |
说明
--include 和 --exclude 支持标准正则表达式的语法，您可以使用它来过滤出符合特定条件的文件。使用 zsh 时，您可能需要在 pattern 串的两端加上双引号。
./coscli restore cos://bucket1/example/ -r --include ".*\\.mp4$"
关于此命令的其他通用选项（例如切换存储桶、切换用户账号等），请参见 通用选项 文档。
关于取回归档文件的更多信息，请参见 POST Object restore 文档。
操作示例
以标准取回模式取回 bucket1桶内的归档文件
./coscli restore cos://bucket1/picture.jpg
以快速取回模式取回 bucket1桶内 picture 文件夹下的所有归档文件
./coscli restore cos://bucket1/picture/ -r --mode Expedited
