All Products
Search
Document Center

Object Storage Service:delete-cname

Last Updated:Sep 18, 2026

Menghapus nama domain kustom (rekaman CNAME) yang dipetakan ke bucket.

Catatan penggunaan

Secara default, Akun Alibaba Cloud memiliki izin untuk menghapus nama domain kustom yang dipetakan ke bucket. Untuk menghapus CNAME sebagai pengguna RAM atau menggunakan STS, diperlukan izin oss:DeleteCname. Untuk informasi selengkapnya, lihat Grant a custom policy.

Sintaksis perintah

ossutil api delete-cname --bucket value --cname-configuration value --wildcard value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--cname-configuration

string

Kontainer konfigurasi CNAME.

--wildcard

string

Menentukan apakah akan menghapus CNAME domain wildcard. Nilai yang valid: true dan false. Untuk Agentic Bucket, Anda harus secara eksplisit menyetel parameter ini ke true atau false. Untuk bucket standar, parameter ini opsional dan bernilai default false.

Catatan
  • Perintah delete-cname sesuai dengan operasi API DeleteCname. Untuk informasi lebih lanjut tentang parameter tersebut, lihat DeleteCname.

  • Opsi --wildcard adalah parameter baru untuk operasi CNAME domain wildcard. Pastikan versi ossutil Anda mendukung parameter ini.

--cname-configuration

Opsi --cname-configuration menerima format XML dan JSON. Jika nilainya diawali dengan file://, konfigurasi dibaca dari file.

  • Sintaksis XML:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • Sintaksis JSON:

    {
      "Cname": {
        "Domain": "string"
      }
    }
Catatan

Untuk informasi selengkapnya tentang opsi baris perintah global yang didukung, lihat Global command-line options.

Contoh

  1. Hapus nama domain kustom example.com yang dipetakan ke bucket examplebucket.

    • Gunakan file konfigurasi XML. Konten cname-configuration.xml adalah sebagai berikut:

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketCnameConfiguration>
        <Cname>
          <Domain>example.com</Domain>
        </Cname>
      </BucketCnameConfiguration>

      Contoh perintah:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml
    • Gunakan file konfigurasi JSON. Konten cname-configuration.json adalah sebagai berikut:

      {
        "Cname": {
          "Domain": "example.com"
        }
      }

      Contoh perintah:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
    • Gunakan parameter konfigurasi JSON langsung. Contoh perintah:

      ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  2. Hapus CNAME wildcard untuk domain example.com (tanpa awalan *.) dari bucket Agentic my-uid-region-ab-apsr.

    • Gunakan parameter konfigurasi JSON langsung. Contoh perintah:

      ossutil api delete-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard true