Help Center/Object Storage Service/obsutil/Auxiliary Commands/Deleting Part Records
Updated on 2025-08-22 GMT+08:00
View PDF

Deleting Part Records

Function

You can use this command to delete part records from a specified directory.

Command Line Structure

  • In Windows 
    obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • In Linux or macOS 
    ./obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

  • Take the Windows OS as an example. Run the obsutil clear -u command to delete the part records of multipart upload tasks in the default directory. 
    obsutil clear -u

Clear checkpoint files for uploading in folder [xxxxx]
Start at 2024-10-08 01:49:37.6541204 +0000 UTC
[==================================================================] 100.00% 0s
Succeed files is:   1         Failed files is:    0

Parameter Description

Parameter

Optional or Mandatory

Description

checkpoint_dir

Optional

The folder where the part records reside. The default value is .obsutil_checkpoint, the same subfolder where obsutil commands reside.

u

Optional (additional parameter)

Deletes the part records of all multipart upload tasks.

NOTE:

At the same time, the system attempts to delete the multipart upload tasks in the part records.

d

Optional (additional parameter)

Deletes the part records of all multipart download tasks.

NOTE:

At the same time, the system attempts to delete the fragments in the part records.

c

Optional (additional parameter)

Deletes the part records of all multipart copy tasks.

NOTE:

At the same time, the system attempts to delete the multipart copy tasks in the part records.

config

Optional (additional parameter)

The user-defined configuration file for executing a command. For details about parameters that can be configured, see Configuration Parameters.

e

Optional (additional parameter)

The endpoint

i

Optional (additional parameter)

The user's AK

k

Optional (additional parameter)

The user's SK

t

Optional (additional parameter)

The user's security token

You must configure at least one among the u, d and c parameters.

Parent topic:Auxiliary Commands