全部產品
Search
文件中心

Object Storage Service:delete-cname

更新時間:Sep 05, 2026

delete-cname用於刪除某個儲存空間(Bucket)已綁定的Cname。

注意事項

阿里雲帳號預設擁有刪除某個Bucket已綁定自訂網域名的許可權。如果您需要通過RAM使用者或者STS的方式進行刪除,您必須擁有oss:DeleteCname許可權。具體操作,請參見為RAM使用者授予自訂的權限原則。

命令格式

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

參數

類型

說明

--bucket

string

Bucket名稱。

--cname-configuration

string

Cname配置的容器。

--wildcard

string

是否刪除泛網域名稱CNAME,取值為true或false。對於Agentic Bucket,必須顯式指定true或false,不允許預設;普通Bucket可選,預設為false。

說明
  • delete-cname命令對應API介面DeleteCname。關於API中的具體參數含義,請參見DeleteCname。

  • --wildcard選項為泛網域名稱CNAME相關的新增參數,請確保您使用的ossutil版本已支援該參數。

--cname-configuration

--cname-configuration配置選項既支援XML文法也支援JSON文法,當選項值包含file://首碼時,表示從檔案中讀取配置。

  • XML文法:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • JSON文法:

    {
      "Cname": {
        "Domain": "string"
      }
    }
說明

關於支援的全域命令列選項,請參見支援的全域命令列選項。

使用樣本

  1. 為儲存空間examplebucket刪除已綁定的自訂網域名example.com。

  • 使用XML設定檔,cname-configuration.xml內容如下:

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

命令樣本如下:

ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml
  • 使用JSON設定檔,cname-configuration.json 內容如下:

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

    命令樣本如下:

    ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
  • 使用JSON配置參數,命令樣本如下:

    ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  1. 刪除Agentic Bucketmy-uid-region-ab-apsr已綁定的泛網域名稱CNAMEexample.com(泛網域名稱基礎域,不含*.首碼)。

  • 使用JSON配置參數,命令樣本如下:

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