tencent cloud

Feedback

Deleting Objects

Last updated: 2024-02-02 14:40:45

    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.tencentcloud.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.
    
    Contact Us

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

    Technical Support

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

    7x24 Phone Support