調用DeleteCname介面刪除某個儲存空間Bucket已綁定的Cname - Object Storage Service

調用DeleteCname介面刪除某個儲存空間（Bucket）已綁定的Cname。該介面具有等冪性，若Bucket未綁定指定Cname，介面同樣返回HTTP 200，不返回錯誤。對於Agentic Bucket，需通過wildcard參數顯式指定刪除精確CNAME或泛網域名稱CNAME。

注意事項

在Agentic Bucket上調用DeleteCname時，wildcard參數必選：wildcard=true用於刪除泛網域名稱CNAME，wildcard=false用於刪除精確CNAME，不允許預設或為空白。
普通Bucket刪除精確CNAME的調用方式與既有OSS CNAME OpenAPI完全一致，無需引入任何新參數。

請求文法

POST /?cname&comp=delete&wildcard=true HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

說明

wildcard參數用於區分刪除的CNAME類別。對於Agentic Bucket，該參數必選，必須顯式傳true或false，不允許預設或為空白。普通Bucket該參數可選，預設為false（即精確CNAME）。

要求標頭

此介面僅包含公用要求標頭。更多資訊，請參見公用HTTP頭定義。

請求參數

名稱

類型

是否必選

樣本值

描述

wildcard

字串

普通Bucket：否

Agentic Bucket：是

true

是否刪除泛網域名稱CNAME。取值如下：

true：刪除泛網域名稱CNAME。
false：刪除精確CNAME。

對於Agentic Bucket，該參數必選，必須顯式傳true或false，不允許預設或為空白。普通Bucket該參數可選，預設為false。

各Bucket類型下wildcard參數的取值規則如下：

Bucket類型	參數預設	wildcard=false	wildcard=true
普通Bucket	刪除精確CNAME	刪除精確CNAME。	不允許
Agentic Bucket	不允許	刪除Agentic Bucket上的精確CNAME	刪除泛網域名稱CNAME

說明

Agentic Bucket的同一基礎域可能同時存在精確和泛網域名稱兩條綁定，因此必須顯式指定wildcard參數以明確刪除目標。

請求元素

名稱	類型	是否必選	樣本值	描述
BucketCnameConfiguration	容器	是	不涉及	Cname配置的容器。父節點：無子節點：Cname
Cname	容器	是	不涉及	Cname資訊的容器。父節點：BucketCnameConfiguration 子節點：Domain
Domain	字串	是	example.com	自訂網域名。刪除精確CNAME時傳入完整網域名稱，例如console.example.com；刪除泛網域名稱CNAME時傳入泛網域名稱基礎域（不含`*.`首碼），例如example.com。父節點：Cname 子節點：無

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用HTTP頭定義。

樣本

請求樣本

為普通Bucket刪除精確CNAME

POST /?cname&comp=delete HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Thu, 17 Apr 2025 15:39:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

為Agentic Bucket刪除泛網域名稱CNAME

POST /?cname&comp=delete&wildcard=true HTTP/1.1
Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Thu, 17 Apr 2025 15:39:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

為Agentic Bucket刪除精確CNAME

POST /?cname&comp=delete&wildcard=false HTTP/1.1
Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Thu, 17 Apr 2025 15:39:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<BucketCnameConfiguration>
  <Cname>
    <Domain>console.example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

本介面對應的各語言SDK如下：

命令列工具ossutil

DeleteCname介面所對應的ossutil命令，請參見delete-cname。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
InvalidArgument	400	返回此錯誤的可能原因如下： Domain傳入了非法字元，例如泛網域名稱字面量`*.example.com`。
MalformedXML	400	請求Body格式不合法。
AccessDenied	403	沒有調用DeleteCname介面的許可權。僅Bucket擁有者以及被授予`oss:DeleteCname`許可權的使用者可以刪除當前Bucket下已綁定的Cname。
MethodNotAllowed	405	目標Bucket類型未開通CNAME能力。