恢复对象（restore）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

恢复对象（restore）

最近更新时间：2024.12.16 17:18:21首次发布时间：2024.12.16 17:18:21

您可以通过 restore 命令恢复对象。

注意事项

恢复归档存储文件时会产生数据取回费用。恢复冷归档或深度冷归档的文件时会产生数据取回费用和请求次数费用。详细说明，请参见数据取回费用和请求次数费用。
归档存储、冷归档和深度冷归档文件恢复完成后会生成一份副本文件供您临时读取。副本为标准存储类型，有效期内将按照标准存储类型计费，详细说明，请参见临时存储容量费用。

命令语法

Linux/macOS

Windows

恢复指定对象

./tosutil restore tos://bucket/key [-f] [-versionId=xxx] [-d=1] [-tier=xxx] [-fr] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量恢复指定前缀对象

./tosutil restore tos://bucket/[prefix] -r [-f] [-j=1] [-v] [-d=1] [-tier=xxx] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

恢复指定对象

tosutil restore tos://bucket/key [-f] [-versionId=xxx] [-d=1] [-tier=xxx] [-fr] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量恢复指定前缀对象

tosutil restore tos://bucket/[prefix] -r [-f] [-j=1] [-v] [-d=1] [-tier=xxx] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	桶名。
key	String	对象名。
prefix	String	批量恢复对象操作时的对象名前缀。
-r	Bools	执行批量恢复指定前缀对象的操作。
-j	Integer	批量恢复对象时的最大并发数，默认为配置文件中的 defaultJobs。
-v	Bools	按指定的对象名前缀批量恢复多版本对象。
-f	Bools	强制操作，不进行询问提示。
-versionId	String	对象的版本。如果不设置，则默认恢复最新版本。
-d	Integer	对象副本有效期，默认为 1 天。对象恢复完成后会生成一份副本文件供您临时读取，到期后，自动删除副本文件。单位是天。
-tier	Enum	恢复优先级，支持取值 `Standard`、`Expedited`、`Bulk`，默认为 `Standard` 。不同类型的对象可选的恢复优先级不同，说明如下：归档存储对象的恢复优先级只能为 `Standard`，表示归档存储对象在 1 分钟内完成恢复。冷归档对象的恢复优先级取值说明如下： `Expedited`：快速取回，1～5 分钟内完成恢复。 `Standard`：标准取回，2～5 小时内完成恢复。 `Bulk`：批量取回，5～12 小时内完成恢复。深度冷归档对象的恢复优先级取值说明如下： `Standard`：标准取回，12 小时内完成恢复。 `Bulk`：批量取回，48 小时内完成恢复。
-fr	Bools	在恢复单个对象时生成恢复结果文件。
-o	String	生成结果清单文件的文件夹，默认为配置文件中的 `defaultOutputDir`。

使用示例

恢复指定对象

以下命令用于恢复 bucketname 桶中 image 对象，设置副本有效期为 2 天，恢复优先级为 Standard。

命令

./tosutil restore tos://bucketname/image -d=2 -tier=Standard

Start at 2024-12-11 07:01:03.718647 +0000 UTC

Restore object [image] in the bucket [bucketname] successfully, cost [326], request id [b108015938af3609675938af-baa4376-1tLGiV-RO-cs-tos-front-azc-4]

批量恢复指定前缀对象

以下命令用于批量恢复前缀为 Ar 的对象，设置副本有效期为 2 天，恢复优先级为 Standard。

命令

./tosutil restore tos://bucketname/Ar -r -d=2 -tier=Standard

Start at 2024-12-11 07:05:02.002142 +0000 UTC

[--------------------------------------------------] 100.00% tps:0.00 3/3 139ms
Succeed count is:   3         Failed count is:    0         
Metrics [max cost:89 ms, min cost:35 ms, average cost:62.33 ms, average tps:20.83]

Task id is: 3dea6c5c-b78e-11ef-b734-8a8ce1fde7d0