DeleteCname - Unmap a custom domain name from a bucket - Object Storage Service

DeleteCname, bir paketle eşleştirilmiş özel alan adını (CNAME) kaldırır. Bu işlem idempotenttir: Belirtilen CNAME pakete eşlenmemişse bile hata döndürmez ve HTTP 200 yanıtı verir. Agentic Bucket için tam bir CNAME'yi mi yoksa joker karakter içeren bir CNAME'yi mi kaldırmak istediğinizi açıkça belirtmek üzere wildcard parametresini kullanmanız gerekir.

Kullanım notları

Agentic Bucket üzerinde DeleteCname çağrısı yaptığınızda wildcard parametresi zorunludur: wildcard=true joker karakter içeren bir CNAME'yi kaldırırken wildcard=false tam eşleşen bir CNAME'yi kaldırır.
Standart bir paketten tam eşleşen bir CNAME'yi kaldırmak için bu işlemi mevcut OSS CNAME işlemleriyle aynı şekilde çağırın. Ek parametre gerekmez.

İstek sözdizimi

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>

Not

wildcard parametresi kaldırılacak CNAME türünü ayırt eder. Agentic Bucket için bu parametre zorunludur; true veya false olarak açıkça ayarlayın. Standart paketlerde bu parametre atlanırsa varsayılan değer false olur.

İstek üstbilgileri

Bu işlem yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Common HTTP headers.

İstek parametreleri

Parameter

Type

Required

Example

Description

wildcard

String

Standard bucket: No

Agentic Bucket: Yes

true

Joker karakter içeren bir CNAME'nin kaldırılıp kaldırılmayacağını belirtir. Geçerli değerler:

true: Joker karakter içeren bir CNAME'yi kaldırır.
false: Tam eşleşen bir CNAME'yi kaldırır.

Agentic Bucket için bu parametre zorunludur; true veya false olarak açıkça ayarlayın. Standart paketlerde bu parametre atlanırsa varsayılan değer false olur.

wildcard parametresi paket türüne göre farklı değerler alır:

Bucket type	Parameter omitted	wildcard=false	wildcard=true
Standard bucket	Tam eşleşen bir CNAME'yi kaldırır	Tam eşleşen bir CNAME'yi kaldırır	İzin verilmez
Agentic Bucket	İzin verilmez	Agentic Bucket'tan tam eşleşen bir CNAME'yi kaldırır	Joker karakter içeren bir CNAME'yi kaldırır

Not

Agentic Bucket'ta aynı temel alan adı için hem tam eşleşen hem de joker karakter içeren bir CNAME aynı anda eşlenebilir. Hangi CNAME'nin kaldırılacağını belirtmek için wildcard parametresini açıkça ayarlayın.

İstek öğeleri

Element	Type	Required	Example	Description
BucketCnameConfiguration	Container	Yes	N/A	CNAME yapılandırmasını depolayan kapsayıcı. Üst düğümler: yok Alt düğümler: Cname
Cname	Container	Yes	N/A	CNAME bilgilerini depolayan kapsayıcı. Üst düğümler: BucketCnameConfiguration Alt düğümler: Domain
Domain	String	Yes	example.com	Özel alan adı. Tam eşleşen bir CNAME'yi kaldırmak için bu öğeyi console.example.com gibi tam alan adına ayarlayın. Joker karakter içeren bir CNAME'yi kaldırmak için bu öğeyi `*.` ön eki olmadan example.com gibi temel alan adına ayarlayın. Üst düğümler: Cname Alt düğümler: yok

Yanıt üstbilgileri

Bu işlem yalnızca ortak yanıt üstbilgilerini döndürür. Daha fazla bilgi için bkz. Common HTTP headers.

Örnekler

Örnek istekler

Standart bir paketten tam eşleşen bir CNAME'yi kaldırma

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'tan joker karakter içeren bir CNAME'yi kaldırma

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'tan tam eşleşen bir CNAME'yi kaldırma

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>

Örnek yanıt

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

OSS SDK'leri

Aşağıdaki OSS SDK'leri DeleteCname işlemini destekler:

ossutil

DeleteCname işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. delete-cname.

Hata kodları

Error code	HTTP status code	Description
InvalidArgument	400	Olası neden: Domain öğesi `*.example.com` gibi joker karakter içeren geçersiz karakterler içeriyor.
MalformedXML	400	İstek gövdesinin biçimi geçersiz.
AccessDenied	403	DeleteCname işlemini çağırma izniniz yok. Yalnızca paket sahibi ve `oss:DeleteCname` izni verilen kullanıcılar mevcut pakete eşlenen CNAME'leri kaldırabilir.
MethodNotAllowed	405	Hedef paket türü için CNAME özelliği etkin değil.