Delete Objects

The following SDK methods will allow you to perform delete operations in Stratus. The Bucket reference used in the below code snippet is the component instance.

Parameters Used

Delete a Single Object

Using this SDK method, you can delete a particular object by passing the object name to the delete_object() method.

    

        
copy
        

            

        
    
    

         delete_res = bucket.delete_object("sam/out/sample.txt")
print(delete_res)
    

Delete a Specific Version of an Object after a Specific Time

Ensure you provide the versionId of the object if you enabled Versioning for your bucket.

You can also schedule your delete operation using the ttl variable. For example, if you provide the value of ttl as 100, the delete operation will only occur after 100 seconds. Always ensure that the value of ttl is greater than equal to 60 seconds.

    

        
copy
        

            

        
    
    

         delete_res = bucket.delete_object("sam/out/sample.txt", 'version_id', ttl=300)
print(delete_res)
    

Delete Multiple Objects

Using this SDK method, you can delete multiple objects by passing the names of the objects that need to be deleted as an array.

Ensure you provide the versionId of the object if you enabled Versioning for your bucket. You can also schedule your delete operation using the ttl variable. For example, if you provide the value of ttl as 100, the delete operation will only occur after 100 seconds. Always ensure that the value of ttl is greater than equal to 60 seconds.

    

        
copy
        

            

        
    
    

           delete_objects_res = bucket.delete_objects([
            {
                'key' : "sam/out/sample.txt",
                'version_id':'01hj6ackcxpha9151n7mj0cq6g'
            },
            {
                'key' :"sam/out/sample1.txt",
                'version_id':'01hj68v1tmb33wa7zchb1vtbjn'
            }],ttl=300)
   print(delete_objects_res)

    

Example Response for Delete Operation

    

        
copy
        

            

        
    
    

         {'message': 'Object Deletion successful.'}
    

Truncate Bucket

Using this SDK method you will be able to essentially every single object present in the bucket.

    

        
copy
        

            

        
    
    

         # delete all the objects in the bucket
truncate_res = bucket.truncate()
print(truncate_res)

    

Delete a Path in the Bucket

Using this SDK, you will be able to delete all the objects present in a path.

You need to pass the complete path to the delete_path() method.

    

        
copy
        

            

        
    
    

         path_res = bucket.delete_path("sam/")
print(path_res)
    

Example Response

    

        
copy
        

            

        
    
    

         {
    "path": "sam/",
    "message": "Path deletion scheduled"
}