DELETE Bucket inventory

最后更新时间:2021-08-30 14:39:12

    功能描述

    DELETE Bucket inventory 用于删除存储桶中指定的清单任务,用户需提供待删除的清单任务的名称。
    有关清单的详细特性,请参见 清单功能概述

    注意:

    • 调用该请求时,请确保您有足够的权限对存储桶的清单任务进行操作。
    • 存储桶所有者默认拥有该权限,如您无该项权限,请先向存储桶所有者申请该项操作的权限。
    推荐使用 API Explorer
    点击调试
    API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

    请求

    请求示例

    DELETE /?inventory&id=inventory-configuration-id HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT Date
    Authorization: Auth String
    
    说明:

    请求参数

    调用 DELETE Bucket inventory 需要使用清单任务名称的参数。该参数格式如下:

    参数 描述 类型 必选
    id 清单任务的名称。缺省值:None
    合法字符:a-z,A-Z,0-9,-,_,.
    String

    请求头

    此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

    请求体

    该请求的请求体为空。

    响应

    响应头

    此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

    响应体

    该响应体返回为空。

    错误码

    此接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。

    实际案例

    请求

    下述请求示例展示了从存储桶examplebucket-1250000000中删除清单任务 list1。

    DELETE /?inventory&id=list1 HTTP/1.1
    Date: Mon, 28 Aug 2018 02:53:38 GMT
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1503901499;1503901859&q-key-time=1503901499;1503901859&q-header-list=host&q-url-param-list=inventory&q-signature=761f3f6449c6a11684464f4b09c6f292f0a4****
    Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
    

    响应

    上述请求后,COS 返回 204 No Content 的响应表明已成功删除了该存储桶内的清单任务 list1。

    HTTP/1.1 204 No Content 
    Server: tencent-cos
    Date: Mon, 28 Aug 2018 02:53:40 GMT
    x-cos-id-2:0dfafa/DAPDIFdafdsfDdfSFFfdfKKJdafasiuKJK2
    x-cos-request-id: NTlhM2I3M2JfMjQ4OGY3MGFfMWE1NF84****