Object Storage Service:Restore objects (Android SDK)

Prerequisites

Before you begin, ensure that you have:

• An OSSClient instance initialized. See Initialization for setup options, including a custom domain name and Security Token Service (STS)

Restore an object

The following example restores exampleobject.txt from the examplebucket bucket. The object's storage class is Archive, Cold Archive, or Deep Cold Archive.

asyncRestoreObject submits the restore request asynchronously. When the request is accepted, OSS returns HTTP 202 and begins restoring the object in the background.

// Build the restore request
RestoreObjectRequest restore = new RestoreObjectRequest();
// Specify the bucket name. Example: examplebucket.
restore.setBucketName("examplebucket");
// Specify the full path of the object. Do not include the bucket name. Example: exampleobject.txt.
restore.setObjectKey("exampleobject.txt");

// Submit the restore request asynchronously
OSSAsyncTask task = oss.asyncRestoreObject(restore, new OSSCompletedCallback<RestoreObjectRequest,
        RestoreObjectResult>() {
    @Override
    public void onSuccess(RestoreObjectRequest request, RestoreObjectResult result) {
        // HTTP 202: restore request accepted. The object is not yet readable.
        Log.i("info", "code::"+result.getStatusCode());
    }

    @Override
    public void onFailure(RestoreObjectRequest request, ClientException clientException,
                          ServiceException serviceException) {
        Log.e("errorMessage", "error: "+serviceException.getRawMessage());
    }
});

task.waitUntilFinished();

What's next

• For the complete sample code, see RestoreObjectTest on GitHub.

• For the RestoreObject API reference, see RestoreObject.

• For OSSClient initialization options, see Initialization.