全部產品
Search
文件中心

Object Storage Service:刪除對象標籤(Python SDK V2)

更新時間:Jul 31, 2025

本文介紹如何使用Python SDK V2刪除Object的標籤資訊。

注意事項

  • 本文範例程式碼以華東1(杭州)的地區IDcn-hangzhou為例,預設使用外網Endpoint,如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS地區和訪問網域名稱

  • 對象標籤使用一組索引值對(Key-Value)來標記對象。關於對象標籤的更多資訊,請參見開發指南中的對象標籤

  • 關於刪除對象標籤的更多資訊,請參見DeleteObjectTagging

  • 要刪除對象標籤,您必須具有oss:DeleteObjectTagging許可權。具體操作,請參見為RAM使用者授予自訂的權限原則

方法定義

delete_object_tagging(request: DeleteObjectTaggingRequest, **kwargs) → DeleteObjectTaggingResult

請求參數列表

參數名

類型

說明

request

DeleteObjectTaggingRequest

佈建要求參數,具體請參見DeleteObjectTaggingRequest

傳回值列表

類型

說明

DeleteObjectTaggingResult

傳回值,具體請參見DeleteObjectTaggingResult

關於刪除對象標籤方法的完整定義,請參見delete_object_tagging

範例程式碼

您可以使用以下代碼刪除儲存空間中的指定檔案的標籤資訊。

import argparse
import alibabacloud_oss_v2 as oss

# 建立一個命令列參數解析器
parser = argparse.ArgumentParser(description="delete object tagging sample")
# 添加命令列參數
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--key', help='The name of the object.', required=True)

def main():
    # 解析命令列參數
    args = parser.parse_args()

    # 從環境變數中載入OSS所需的認證資訊
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # 使用SDK提供的預設配置建立設定物件
    cfg = oss.config.load_default()

    # 設定憑據提供者
    cfg.credentials_provider = credentials_provider

    # 設定地區
    cfg.region = args.region

    # 如果提供了endpoint,則設定endpoint
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 使用上述配置建立OSS用戶端執行個體
    client = oss.Client(cfg)

    # 刪除指定對象的標籤
    result = client.delete_object_tagging(oss.DeleteObjectTaggingRequest(
        bucket=args.bucket,
        key=args.key,
    ))

    # 列印結果資訊
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
    )

# 當此指令碼被直接運行時,調用main函數
if __name__ == "__main__":
    main()

相關文檔