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:
- 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.
- 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] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- Deleting objects in batches
obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- Deleting a single object
- In Linux or macOS
- Deleting a single object
./obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- Deleting objects in batches
./obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- Deleting a single object
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 Start at 2024-09-25 04:48:10.1147483 +0000 UTC Delete object [key] in the bucket [bucket-test] successfully, cost [152], request id [0000016979E1D2B2860BB5181229C72C]
- 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 Start at 2024-09-30 08:46:55.5335644 +0000 UTC [===============================================] 100.00% 21s Succeed count: 1313 Failed count: 0 Task id: 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 Start at 2024-09-30 08:49:09.5602115 +0000 UTC [===============================================] 100.00% 21s Succeed count: 10 Failed count: 0 Task id: 79ab59ec-7e00-4f22-8c88-465faa834125
Parameter Description
Parameter |
Optional or Mandatory |
Description |
---|---|---|
bucket |
Mandatory |
The bucket name |
key |
Mandatory for deleting a single object. Optional for deleting objects in batches. |
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 file when deleting an object. |
f |
Optional (additional parameter) |
Runs in force mode. |
versionId |
Optional for deleting a single object (additional parameter) |
The 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) |
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) |
The folder that stores the result files. After the command is executed, result files (possibly success and failure files) will be created in the specified folder. The default value is .obsutil_output, a subfolder in the user's home directory where obsutil commands are executed.
NOTE:
|
config |
Optional (additional parameter) |
The user-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, 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 |
Response
Refer to Response for uploading an object.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot