全部產品
Search
文件中心

Object Storage Service:DeleteObjectTagging

更新時間:Jun 19, 2024

調用DeleteObjectTagging介面刪除指定對象(Object)的標籤(Tagging)資訊。

版本控制

調用DeleteObjectTagging介面時,預設只能刪除Object目前的版本的標籤資訊。您可以通過指定versionId參數來刪除指定Object版本的標籤資訊。如果Object的對應版本為刪除標記(Delete Marker),則OSS將返回404 Not Found。

請求文法

DELETE /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

  • 未開啟版本控制

    在未開啟版本控制的情況下,通過DELETE請求刪除了儲存空間bucketname中對象objectname已有的標籤資訊,OSS解析此請求後刪除此對象中的所有標籤。

    請求樣本

    DELETE /objectname?tagging
    Host: BucketName.oss-cn-hangzhou.aliyuncs.com
    Date: Tue, 09 Apr 2019 03:00:33 GMT
    Authorization: OSS qn6q**************:77Dv****************

    返回樣本

    204 (No Content)
    content‐length: 0
    server: AliyunOSS
    x‐oss‐request‐id: 5CAC0AD16D0232E2051B****
    date: Tue, 09 Apr 2019 03:00:33 GMT
  • 已啟用版本控制

    在啟用版本控制的情況下,通過DELETE請求刪除儲存空間bucketname中對象objectname已有的標籤資訊,刪除時指定了對象版本號碼(即請求樣本中的versionId),OSS解析此請求後刪除此版本對象中的所有標籤。

    請求樣本

    DELETE /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
    Host: BucketName.oss-cn-hangzhou.aliyuncs.com
    Date: Wed, 24 Jun 2020 09:01:09 GMT
    Authorization: OSS qn6q**************:77Dv****************

    返回樣本

    204 (No Content)
    content-length: 0
    server: AliyunOSS
    x-oss-request-id: 5EF3165525D95C3338E8****
    date: Wed, 24 Jun 2020 09:01:09 GMT
    x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

SDK

DeleteObjectTagging介面對應的各語言SDK樣本如下:

錯誤碼

錯誤碼

HTTP狀態代碼

描述

FileAlreadyExists

409

Bucket開啟階層命名空間後,當您要在該Bucket中刪除某個Object的標籤資訊時,如果設定的Object為目錄,則返回該錯誤。