Help Center/ Object Storage Service/ SDK Reference/ C/ Versioning Management/ Restoring a Specific Archive Object Version
Updated on 2024-12-03 GMT+08:00

Restoring a Specific Archive Object Version

If you have any questions during development, post them on the Issues page of GitHub.

You can call restore_object to restore an Archive object version by specifying obs_object_info .version_id. Sample code is as follows:

static void test_restore_object_version()
{
    // Create and initialize object information.
    obs_object_info object_info;
    memset(&object_info, 0, sizeof(obs_object_info));
    object_info.key =key;
    object_info.version_id = versionid;
    obs_status ret_status = OBS_STATUS_BUTT;
    // Create and initialize option.
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";

    // Hard-coded or plaintext AK/SK are risky. For security purposes, encrypt your AK/SK and store them in the configuration file or environment variables. In this example, the AK/SK are stored in environment variables for identity authentication. Before running this example, configure environment variables ACCESS_KEY_ID and SECRET_ACCESS_KEY.
    // Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/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_tier tier = OBS_TIER_EXPEDITED;
    // Set response callback function.
    obs_response_handler handler =
    { 
      &response_properties_callback,
      &response_complete_callback
    };
    // Restore a specific Archive object version.
    restore_object(&option, &object_info, days,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));
    }
}

To prolong the validity period of the Archive data restored, you can repeatedly restore the Archive data, but you will be billed for each restore. After a second restore, the validity period of Standard object copies will be prolonged, and you need to pay for storing these copies during the prolonged period.