归档或冷归档类型的文件需要解冻(Restore)之后才能读取。本文介绍如何解冻归档和冷归档文件。
注意 非归档或冷归档类型的文件,请勿调用RestoreObject方法。
归档及冷归档类型的详细说明请参见存储类型介绍。解冻文件的详情请参见RestoreObject。
解冻归档文件
归档类型的Object在执行解冻前后的状态变换过程如下:
- 归档类型的Object初始时处于冷冻状态。
- 提交一次解冻请求后,Object处于解冻中的状态,完成解冻任务通常需要1分钟。
- 服务端完成解冻任务后,Object进入解冻状态,此时您可以读取Object。解冻状态默认持续24小时,24小时内再次调用RestoreObject接口则解冻状态会自动延长24小时。对于同份归档文件,一次解冻流程内可有效调用7次RestoreObject接口达到最长7天的解冻持续时间。
- 解冻状态结束后,Object再次返回到冷冻状态。
以下代码用于解冻归档文件:
<?php if (is_file(__DIR__ . '/../autoload.php')) { require_once __DIR__ . '/../autoload.php'; } if (is_file(__DIR__ . '/../vendor/autoload.php')) { require_once __DIR__ . '/../vendor/autoload.php'; } use OSS\OssClient; use OSS\Core\OssException; // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "http://oss-cn-hangzhou.aliyuncs.com"; $bucket= "<yourBucketName>"; $object = "<yourObjectName>"; try { $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint); $ossClient->restoreObject($bucket, $object); } catch (OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
解冻冷归档文件
冷归档类型的Object在执行解冻前后的状态变换过程如下:
- 冷归档类型的Object初始时处于冷冻状态。
- 提交一次解冻请求后,Object处于解冻中的状态。不同优先级的首字节取回时间如下:
- 高优先级(Expedited):表示1小时内完成解冻。
- 标准(Standard):表示2~5小时内完成解冻。如果不传入JobParameters节点,则默认为Standard。
- 批量(Bulk):表示5~12小时内完成解冻。
- 服务端完成解冻任务后,Object进入解冻状态,此时您可以读取Object。您可以指定解冻的天数,最短是1天,最长是7天。
- 解冻状态结束后,Object再次返回到冷冻状态。
以下代码用于解冻冷归档文件:
<?php if (is_file(__DIR__ . '/../autoload.php')) { require_once __DIR__ . '/../autoload.php'; } if (is_file(__DIR__ . '/../vendor/autoload.php')) { require_once __DIR__ . '/../vendor/autoload.php'; } use OSS\OssClient; use OSS\Core\OssException; use OSS\Model\RestoreConfig; // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; $bucket= "<yourBucketName>"; $object= "<yourObjectName>"; $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false); // 此处以设置解冻天数为5天,优先级为Standard为例。 $config = new RestoreConfig(5, "Standard"); $options = array( OssClient::OSS_RESTORE_CONFIG => $config ); try { // 解冻文件。 $ossClient->restoreObject($bucket, $object, $options); } catch (OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");