更新时间:2024-12-03 GMT+08:00

下载归档存储对象

开发过程中,您有任何问题可以在github上提交issue

如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持二类,见下表:

选项

说明

OBS C SDK对应值

快速恢复

恢复耗时1~5分钟。

OBS_TIER_EXPEDITED

标准恢复

恢复耗时3~5小时。默认值。

OBS_TIER_STANDARD

重复恢复归档存储数据时在延长恢复有效期的同时,也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长,并且收取延长时间段产生的标准存储副本费用。

您可以通过restore_object恢复归档存储对象。以下代码展示了如何下载归档存储对象:

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

object_info

obs_object_info *

必选

对象名和版本号,非多版本对象,version设置为0。

days

char *

必选

恢复对象的保存时间。

tier

obs_tier

可选

恢复选项,可以为:obs_tier.OBS_TIER_EXPEDITED,obs_tier.OBS_TIER_STANDARD。

handler

obs_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

static void test_restore_object()
{
    // 定义对象信息
    obs_object_info object_info;
    memset(&object_info, 0, sizeof(obs_object_info));
    object_info.key = "<object key>";
    object_info.version_id = "<object version ID>";
    obs_status ret_status = OBS_STATUS_BUTT;
    // 创建并初始化option
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";

    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
    // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
    option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
    option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");
    // 设置响应回调函数 
    obs_response_handler handler =
    { 
      &response_properties_callback, &response_complete_callback
    };
    // 恢复对象
    obs_tier tier = OBS_TIER_EXPEDITED;
    restore_object(&option, &object_info, "<stored time>",tier,&handler, &ret_status);
    if (OBS_STATUS_OK == ret_status) 
    {
        printf("restore object successfully. \n");
    }
    else
    {
        printf("restore object faied(%s).\n", obs_get_status_name(ret_status));
        return;
    }
    // 下载对象回调数据
    get_object_callback_data data;
    data.ret_status = OBS_STATUS_BUTT;
    data.outfile = write_to_file("<file path>");
    // 设置响应回调函数
    obs_get_object_handler getobjectHandler =
    { 
        { &response_properties_callback, &get_object_complete_callback},
        &get_object_data_callback
    };
    // 下载对象
    get_object(&option,&object_info, 0,0,&getobjectHandler,&data);
    fclose(data.outfile);
    if (OBS_STATUS_OK == data.ret_status) {
        printf("get object successfully. \n");
    }
    else
    {
        printf("get object faied(%s).\n", obs_get_status_name(data.ret_status));
    }
}
  • object_info.key中指定的对象必须是归档存储类型,否则调用该接口会报错。
  • "<恢复对象的保存时间>"指定恢复对象保存的时间,取值范围是1~30。