DeleteCname - Lepaskan pemetaan nama domain kustom dari bucket - Object Storage Service

DeleteCname melepas pemetaan nama domain kustom (CNAME) dari sebuah bucket. Operasi ini bersifat idempoten: jika CNAME yang ditentukan tidak dipetakan ke bucket tersebut, operasi tetap mengembalikan HTTP 200 tanpa error. Untuk Agentic Bucket, Anda harus menggunakan parameter wildcard untuk secara eksplisit menentukan apakah akan melepas pemetaan CNAME eksak atau CNAME wildcard.

Catatan penggunaan

Saat memanggil DeleteCname pada Agentic Bucket, parameter wildcard wajib digunakan: wildcard=true melepas pemetaan CNAME wildcard, sedangkan wildcard=false melepas pemetaan CNAME eksak.
Untuk melepas pemetaan CNAME eksak dari bucket standar, panggil operasi ini dengan cara yang sama seperti operasi CNAME OSS yang sudah ada. Tidak diperlukan parameter tambahan.

Sintaksis permintaan

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>

Catatan

Parameter wildcard membedakan jenis CNAME yang akan dilepas pemetaannya. Untuk Agentic Bucket, parameter ini wajib digunakan dan nilainya harus secara eksplisit ditetapkan sebagai true atau false. Untuk bucket standar, jika parameter ini dihilangkan, nilainya secara default adalah false.

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header HTTP umum.

Parameter permintaan

Parameter

Tipe

Wajib

Contoh

Deskripsi

wildcard

String

Bucket standar: Tidak

Agentic Bucket: Ya

true

Menentukan apakah akan melepas pemetaan CNAME wildcard. Nilai yang valid:

true: melepas pemetaan CNAME wildcard.
false: melepas pemetaan CNAME eksak.

Untuk Agentic Bucket, parameter ini wajib digunakan. Tetapkan nilainya secara eksplisit menjadi true atau false. Untuk bucket standar, jika Anda menghilangkan parameter ini, nilainya secara default bernilai false.

Nilai parameter wildcard berbeda tergantung tipe bucket:

Tipe bucket	Parameter dihilangkan	wildcard=false	wildcard=true
Bucket standar	Melepas pemetaan CNAME eksak.	Melepas pemetaan CNAME eksak.	—
Agentic Bucket	Tidak diizinkan	Melepas pemetaan CNAME eksak dari Agentic Bucket.	Melepas pemetaan CNAME wildcard.

Catatan

Untuk Agentic Bucket, nama domain dasar yang sama dapat memiliki CNAME eksak dan CNAME wildcard yang dipetakan secara bersamaan. Tentukan parameter wildcard secara eksplisit untuk mengidentifikasi CNAME mana yang akan dilepas pemetaannya.

Elemen permintaan

Elemen	Tipe	Wajib	Contoh	Deskripsi
BucketCnameConfiguration	Kontainer	Ya	N/A	Kontainer yang menyimpan konfigurasi CNAME. Node induk: tidak ada Node anak: Cname
Cname	Kontainer	Ya	N/A	Kontainer yang menyimpan informasi CNAME. Node induk: BucketCnameConfiguration Node anak: Domain
Domain	String	Ya	example.com	Nama domain kustom. Untuk melepas pemetaan CNAME eksak, atur elemen ini ke nama domain lengkap, seperti console.example.com. Untuk melepas pemetaan CNAME wildcard, atur elemen ini ke nama domain dasar tanpa awalan `*.`, seperti example.com. Node induk: Cname Node anak: tidak ada

Header respons

Operasi ini hanya mengembalikan header respons umum. Untuk informasi lebih lanjut, lihat Header HTTP umum.

Contoh

Contoh permintaan

Lepaskan pemetaan CNAME eksak dari bucket standar

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>

Lepaskan pemetaan CNAME wildcard dari Agentic Bucket

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>

Lepaskan pemetaan CNAME eksak dari Agentic Bucket

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>

Contoh respons

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 SDKs

OSS SDK berikut mendukung operasi DeleteCname:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi DeleteCname, lihat delete-cname.

Kode error

Kode error	Kode status HTTP	Deskripsi
InvalidArgument	400	Penyebab error ini antara lain: Elemen Domain berisi karakter yang tidak valid, seperti literal wildcard `*.example.com`.
MalformedXML	400	Format badan permintaan tidak valid.
AccessDenied	403	Anda tidak memiliki izin untuk memanggil operasi DeleteCname. Hanya Pemilik bucket dan pengguna yang diberikan izin `oss:DeleteCname` yang dapat melepas pemetaan CNAME yang dipetakan ke bucket saat ini.
MethodNotAllowed	405	Fitur CNAME tidak diaktifkan untuk tipe bucket target.