帮助文档 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
帮助文档 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. 常用工具
  6. 命令行工具ossutil 2.0
  7. ossutil命令
  8. 高级命令
  9. unrestore(清理已解冻对象)

unrestore(清理已解冻对象)

  • 高级命令
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

本文为您介绍如何通过unrestore命令清理从归档状态或冷归档状态恢复的对象。使用unrestore命令后,恢复的对象将返回到冻结状态。

注意事项

阿里云账号默认拥有清理从归档状态或冷归档状态恢复的对象的权限。如果您需要通过RAM用户或者STS的方式进行清理,您必须拥有oss:CleanRestoredObject、oss:CleanRestoredObjectVersion权限。具体操作,请参见为RAM用户授权自定义的权限策略。

命令格式

ossutil unrestore oss://bucket[/prefix] [flags]

参数

类型

说明

--checkers

int

并行运行的检查器数量(默认值为16)

-d, --dirs

/

返回当前目录下的文件和子目录,而非递归显示所有子目录下的所有文件。

--encoding-type

string

输入的对象名或文件名的编码方式。取值:url。

--end-with

string

按字母排序,返回设定值之前的对象,包含设定值。

--exclude

stringArray

路径或文件名的排除规则。

--exclude-from

stringArray

从规则文件里读取排除规则。

--files-from

stringArray

从文件中读取源文件名列表,忽略空行或注释行。

--files-from-raw

stringArray

从文件中读取源文件名列表。

--filter

stringArray

路径或文件名过滤规则。

--filter-from

stringArray

从规则文件读取过滤规则。

-f, --force

/

强制操作,不进行询问提示。

--include

stringArray

路径或文件名的包含规则。

--include-from

stringArray

从规则文件里读取包含规则。

-j, --job

int

在多个文件之间的并发任务数量(默认值为3)

--limited-num

int

返回结果的最大个数。

--list-format

string

列表文件的格式,取值:plain、inventory。

--list-manifest-from

string

从文件中读取列表文件格式的描述信息,当列表文件格式为inventory时,需要设置该参数。

--list-objects

/

使用ListObjects接口列举对象。

--max-age

Duration

不传输任何比此更早的文件,默认是秒,或单位后缀形式 ms|s|m|h|d|w|M|y(默认值off)。

--max-mtime

Time

不传输任何比此更新的文件,UTC时间格式(默认值off)。

--max-size

SizeSuffix

限制传输的最大文件大小,默认是字节,或单位后缀形式B|K|M|G|T|P,1K(KiB)=1024B。

--metadata-exclude

stringArray

对象元数据的排除规则。

--metadata-filter

stringArray

对象元数据过滤规则。

--metadata-filter-from

stringArray

从规则文件读取对象元数据过滤规则。

--metadata-include

stringArray

对象元数据的包含规则。

--min-age

Duration

不传输任何比此更新的文件,默认是秒,或单位后缀形式 ms|s|m|h|d|w|M|y(默认值off)。

--min-mtime

Time

不传输任何比此更早的文件,UTC时间格式(默认值off)。

--min-size

SizeSuffix

限制传输的最小文件大小,默认是字节,或单位后缀形式B|K|M|G|T|P,1K(KiB)=1024B。

--no-check-status

/

清理前不检查对象状态,在列表模式下生效。

--no-error-report

/

在批量操作期间不生成错误报告文件。

--no-progress

/

不显示进度。

--page-size

int

返回对象或文件的最大数(默认值1000),取值范围1~1000。

--output-dir

string

指定存放输出文件的目录,输出文件包含:批量操作过程中生成的错误报告文件(默认值"ossutil_output")

-r, --recursive

/

递归进行操作。当指定该选项时,命令会对存储空间下所有符合条件的对象进行操作,否则只对路径指定的对象进行操作。

--request-payer

string

请求的支付方式,如果为请求者付费模式,请设置该值。取值:requester。

--start-after

string

按字母排序,返回设定值之后的对象,不包含设定值。

--version-id

string

对象的版本标识。

说明

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

使用示例

  • 以下示例用于清理目标存储空间examplebucket中名为example.txt的从归档或冷归档状态恢复的对象。

    ossutil unrestore oss://examplebucket/example.txt
  • 以下示例用于清理目标存储空间examplebucket中dir目录下所有从归档或冷归档状态恢复的对象。

    ossutil unrestore oss://examplebucket/dir -r
  • 以下示例用于清理目标存储空间examplebucket名为example.txt且版本号为123的从归档或冷归档状态恢复的对象。

    ossutil unrestore oss://examplebucket/example.txt --version-id 123
  • 以下示例用于清理目标存储空间examplebucket中dir目录下前100个从归档或冷归档状态恢复的对象。

    ossutil unrestore oss://examplebucket/dir --limited-num 100 -r
  • 以下示例用于清理目标存储空间examplebucket中根目录dir下的子目录dir1和dir2内,创建时间在三天内的从归档或冷归档状态恢复的对象。

    ossutil unrestore oss://examplebucket/rootdir/rootdir --include "/dir1/**" --include "/dir2/**" --max-age 3d -r
  • 以下示例用于根据文件中列出的对象清理从归档或冷归档状态恢复的对象。

    说明

    list列表文件里的一行表示一个对象,且采用OSS路径格式,即oss://{bucket}/{key},如list.txt文件:

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil unrestore list://local-list.txt
  • 以下示例用于从列表里直接清理从归档或冷归档状态恢复的对象,不会检查 object 的状态。

    ossutil unrestore list://local-list.txt --no-check-status
  • 以下示例用于从清单文件里清理从归档或冷归档状态恢复的对象。

    说明

    执行清单任务后,会在清单结果中生成一个 csv.gz 和 manifest.json 文件。从清单文件里解冻对象需要用到这两个文件。

    ossutil unrestore list://ca8007fc-4123-493e-9a01-dd1511fb****.csv.gz --list-format inventory --list-manifest-from manifest.json
相关文章

append(追加上传) 2025-04-21 17:31

append命令用于在已上传的追加类型对象(Appendable Object)末尾直接追加内容。 注意事项 要追加上传,您必须具有oss:GetObject和

cat(输出文件内容) 2025-04-21 17:31

cat命令仅支持将存储空间(Bucket)内文件(Object)的内容输出到屏幕。 注意事项 要输出文件内容,您必须具有

cp(上传、下载和拷贝文件) 2025-04-21 17:31

通过使用 cp 命令,您可以高效地管理和迁移数据,该命令支持单个文件或批量文件的上传、下载和复制。 注意事项 执行上传、下载或拷贝操作前,请确保具有相应的权限,具体授权操作请参见为RAM用户授权自定义的权限策略

cp(上传文件) 2025-04-21 17:30

当您需要将本地文件、图片、视频等资源上传到OSS,或者需要上传大文件至OSS时,可以使用ossutil的cp命令。 注意事项 要上传文件,您必须具有

cp(下载文件) 2025-04-21 17:30

当您需要将已上传至OSS的文件、图片、视频等资源下载到本地时,可以使用ossutil的cp命令。 注意事项 要下载文件,您必须具有oss:GetObject</

cp(拷贝文件) 2025-04-21 17:30

拷贝文件(Object)是指在不改变文件内容的情况下,将同一地域下的源存储空间(Bucket)内的文件复制到目标Bucket,或者将文件复制到相同存储空间(Bucket)的其他目录。您可以通过ossutil的cp完成拷贝。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 博智数字服务平台.
闽ICP备08105208号-1