Updated on 2024-02-29 GMT+08:00

Deleting an Object

Function

  • You can use this command to delete a specified object.
  • You can also use this command to delete objects in batches based on a specified object name prefix.

    The delete operation cannot be undone.

Important Notes

In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, deleting directories from parallel file systems may fail due to timeout. To address this problem, you are advised to delete directories in either of the following ways:

  1. On the Hadoop client that has OBSA, an OBS client plugin, embedded, run the hadoop fs - rmr obs://{Name of a parallel file system}/{Directory name} command.
  2. Configure a lifecycle rule for directories so that they can be deleted in background based on the preset lifecycle rule.

Command Line Structure

  • In Windows
    • Deleting a single object
      obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] 
    • Deleting objects in batches
      obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] 
  • In Linux or macOS
    • Deleting a single object
      ./obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] 
    • Deleting objects in batches
      ./obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] 

Examples

  • Take the Windows OS as an example. Run the obsutil rm obs://bucket-test/key -f command to delete a single object named key in bucket bucket-test.
    obsutil rm obs://bucket-test/key -f
    
    Delete object [key] in the bucket [bucket-test] successfully!
  • Take the Windows OS as an example. Run the obsutil rm obs://bucket-test -r -f command to delete all objects in bucket bucket-test.
    obsutil rm obs://bucket-test -r -f
    
    [===============================================] 100.00% 21s
    Succeed count is:   1313      Failed count is:    0
    Task id is: 95936984-f81a-441a-bba0-1fd8254d9241
  • Take the Windows OS as an example. Run the obsutil rm obs://bucket-test/key -r -f command to delete all objects and folders prefixed with key in bucket bucket-test.
    obsutil rm obs://bucket-test/key -r -f
    
    [===============================================] 100.00% 21s
    Succeed count is:   10      Failed count is:    0
    Task id is: 79ab59ec-7e00-4f22-8c88-465faa834125

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

Bucket name

key

Mandatory for deleting a single object.

Optional for deleting objects in batches.

Indicates the name of the object to be deleted, or the name prefix of the objects to be deleted in batches.

NOTE:

If this parameter is left blank when deleting objects in batches, all objects in the bucket are deleted.

fr

Optional for deleting a single object (additional parameter)

Generates an operation result list when deleting an object.

f

Optional (additional parameter)

Runs in force mode.

versionId

Optional for deleting a single object (additional parameter)

Version ID of the object to be deleted.

r

Mandatory for deleting objects in batches (additional parameter)

Deletes objects in batches based on a specified object name prefix.

CAUTION:

When you batch delete objects, all objects with the specified prefix will be deleted.

j

Optional for deleting objects in batches (additional parameter)

Indicates the maximum number of concurrent tasks for deleting objects in batches. The default value is the value of defaultJobs in the configuration file.

NOTE:

The value is ensured to be greater than or equal to 1.

v

Optional for deleting objects in batches (additional parameter)

Deletes versions of an object and the delete markers in batches based on a specified object name prefix.

o

Optional (additional parameter)

Indicates the folder where operation result lists reside. After the command is executed, result lists (possibly including success and failure files) are generated in the folder. The default value is .obsutil_output, the subfolder in the home directory of the user who executes obsutil commands.

NOTE:
  • The naming rule for result lists is as follows: rm_{succeed | failed}_report_time_TaskId.txt
  • By default, the maximum size of a single result list is 30 MB and the maximum number of result lists that can be retained is 1024. You can set the maximum size and number by configuring recordMaxLogSize and recordBackups in the configuration file.
  • If there are multiple folders and files and you need to confirm the detailed error information about a failed task, refer to the failure list rm_failed_report_time_TaskId.txt in the result list folder and the log files in the log path.

config

Optional (additional parameter)

User-defined configuration file for executing a command. For details about parameters that can be configured, see Parameter Description.

Response

Refer to Response for uploading an object.