Help Center> Object Storage Service> FAQs> How Do I Use Fragment Management?> How Do I Manage Fragments?
View PDF

How Do I Manage Fragments?

Fragments on OBS consume storage spaces that are charged according to price rates of storage space.

If fragments are generated due to interruptions or failures of multipart upload tasks, you can resume such tasks so that fragments will be cleared, or you can directly clear the fragments to save storage space.

Clearing Fragments by Resuming Interrupted or Failed Multipart Upload Tasks

On OBS, you can manage tasks. If a multipart upload task is interrupted or fails, you can use the following methods to resume the task. Once the task completes, fragments will be cleared.
Table 1 Methods for clearing fragments

Method

Operation Guide

OBS Browser+

OBS Browser+ provides a GUI-based task management page. You can click the upload task that generates the fragments and run the task. Once it completes, fragments are cleared.

obsutil

obsutil records failed tasks based on the result list. You can resume the failed upload task based on the task ID, which can eliminate fragments as well.

For details, see Resuming a Failed Upload Task.

OBS SDK

OBS SDK provides the resumable upload function by recording the upload progress. You can read the recorded progress and continue upload an interrupted or failed multipart upload task.

For details, see section "Resuming an Upload Task" in the SDK Reference.

Deleting Fragments Directly

If fragments are no longer needed, you can delete them in the following ways to save storage space:

The progress of an upload task may get lost if its fragment is deleted. Therefore, make sure the fragment is not needed before deleting it.

Table 2 Methods for deleting fragments

Tool

Method

OBS Console

On OBS Console, fragments of a bucket are listed in a table. You can delete all fragments in the bucket by clicking the button for deleting all, or you can delete selected ones.

For details, see Managing Fragments.

OBS Browser+

OBS Browser+ provides the fragment detection function. You can check whether fragments exist in a bucket and delete all fragments in a batch or only delete selected ones.

obsutil

With obsutil, you can delete the failed or interrupted multipart upload task to delete fragments generated by the task. If a bucket has more than one multipart upload tasks, you need to delete all the multipart upload tasks to delete all fragments in the bucket.

For details, see Deleting a Multipart Upload Task.

OBS API

You can delete fragments from a bucket through the following procedure:

  1. Use the Listing Initialized Multipart Tasks in a Bucket operation to list all the multipart upload tasks and obtain their UploadId.
  2. Use the Canceling a Multipart Upload Task operation to cancel the multipart upload tasks. Then all fragments generated by the tasks can be deleted.

OBS SDK

With OBS SDK, fragments are generated when parts of a multipart task are not merged. You can cancel the task to delete generated fragments. The procedure is as follows:

  1. Use the ObsClient.listMultipartUploads interface to list all multipart upload tasks and obtain their UploadId.
  2. Use the ObsClient.abortMultipartUpload interface to cancel the multipart upload task so that the generated fragments will be cleared.