tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageSDK DocumentationSDK for FlutterObject OperationsDeleting Objects
Deleting Objects
Download PDF
Last updated: 2024-02-02 14:40:45
Deleting Objects
Last updated: 2024-02-02 14:40:45
Download PDF

Overview

This document provides an overview of APIs and SDK code samples for deleting an object.
API
Operation
Description
Deleting a single object
Deletes a specified object from a bucket

Deleting a Single Object

Feature description

This API is used to delete a specified object.

Sample code

// Bucket name in the format of `BucketName-APPID` (`APPID` is required), which can be viewed in the COS console at https://console.cloud.tencent.com/cos5/bucket.
String bucket = "examplebucket-1250000000";
// Location identifier of the object in the bucket, i.e., the object key
String cosPath = "exampleobject";
// Bucket region abbreviation. For example, "ap-guangzhou" is the abbreviation of the Guangzhou region
String region = "COS_REGION";
try {
  await Cos().getDefaultService().deleteObject(
      bucket, cosPath,
      region: region
  );
} catch (e) {
  // An exception will be reported in case of failure. Process the business logic accordingly.
  print(e);
}

Parameter description

Parameter
Description
Type
Required
bucket
Bucket name in the format of BucketName-APPID. For more information, see Bucket Overview.
String
Yes
cosPath
Object key, which uniquely identifies an object in a bucket. For example, if an object's access endpoint is examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/doc/picture.jpg, its key is doc/picture.jpg.
String
Yes
versionId
ID of the object version to be deleted
String
No

Response description

Success: No value is returned.
Failure: An error occurs (such as authentication failure), with a CosXmlClientException or CosXmlServiceException exception reported. For more information, see Troubleshooting.

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon