Deleting Fragments

Scenarios

Fragments are the incomplete data in buckets. When data is uploaded to OBS using a multipart upload, there will be fragments generated if the multipart upload fails because of the following and other possible causes:

Frequent disconnections from the OBS server due to poor network conditions
Manual upload interruptions
Device failures
Sudden power outages

Fragments generated due to upload failures are stored in OBS. You can manually delete the fragments by following the instructions provided in this section. You can also continue the interrupted or failed multipart upload tasks to delete the fragments or configure a lifecycle rule to automatically delete the fragments periodically.

If there are fragments left in your bucket, your attempt to delete the bucket will fail. In such case, delete all of the fragments first.
The storage of fragments is billable. If expenditures are stilled generated even if there are no objects in your bucket, check whether there are fragments in it and delete them (if any).

Billing

You will be billed for storing fragments in OBS.

Ways to Delete Fragments

You can use OBS Console, APIs, SDKs, OBS Browser+, or obsutil to delete fragments.

Using OBS Console

In the navigation pane of OBS Console, choose Object Storage.
In the bucket list, click the bucket you want to operate. The Objects page is displayed.
Click Fragments, select the fragment that you want to delete, and click Delete on the right.

You can also select multiple fragments and click Delete above the fragment list to batch delete them.
Click OK to confirm the deletion.

Figure 1 Deleting fragments

Using APIs

You can use APIs to delete fragments from a bucket by doing as follows:

Use the API for listing the initiated multipart uploads in a bucket to list all the multipart uploads and obtain their upload IDs.
Use the API for aborting a multipart upload to abort the multipart uploads to delete all fragments.

Using SDKs

With an OBS SDK, fragments are generated only when a multipart upload is not completed. You can delete the fragments by aborting the multipart upload. The procedure is as follows:

Use the ObsClient.listMultipartUploads API to list all multipart uploads and obtain their upload IDs.
Use the ObsClient.abortMultipartUpload API to abort all of the listed multipart uploads to delete all fragments.

C: not supported

Using the GUI Tool - OBS Browser+

Log in to OBS Browser+.
Select the bucket you want and click Fragments.
In the Fragments window, select the unwanted fragments and click Delete above the list. You can also click Delete All above the list to delete all fragments. Click in the upper right corner to refresh the fragment list, as shown in Figure 2.

Figure 2 Fragment management
In the displayed Warning dialog box, confirm the delete information and click Yes.
Click Yes.

The Fragments window is displayed. You can close this window to go back to the OBS Browser+ homepage.

Using the CLI Tool - obsutil

With obsutil, you can delete fragments by deleting the corresponding multipart upload. If a bucket has more than one multipart uploads, you need to delete all the multipart uploads to delete all fragments in the bucket.

For details, see Deleting a Multipart Upload.

Related Operations

OBS allows you to manage tasks. If a multipart upload fails or is interrupted, you can resume it with the following tools. Once the upload is completed, fragments will disappear.

**Table 1** Tools for deleting fragments
Tool	Operation Guide
OBS Browser+	On OBS Browser+, run the upload task that generates the fragments. Once it completes, fragments are cleared. For details, see Managing Failed Tasks and Managing Suspended Tasks.
obsutil	With obsutil, you can resume a failed upload based on its task ID recorded in the result list. After the upload is completed, the fragments will disappear. For details, see Resuming a Failed Upload.
OBS SDKs	OBS SDKs provide resumable upload by recording the upload progress. You can read the recorded progress and resume an interrupted or failed multipart upload. For details, see the section about resumable upload in the SDK Reference.