全部產品
Search
文件中心

Object Storage Service:create-cname-token

更新時間:Sep 18, 2026

create-cname-token用於建立網域名稱所有權驗證所需的CnameToken。

注意事項

阿里雲帳號預設擁有建立網域名稱所有權驗證所需的CnameToken的許可權。如果您需要通過RAM使用者或者STS的方式進行建立,您必須擁有oss:CreateCnameToken許可權。具體操作,請參見為RAM使用者授予自訂的權限原則。

命令格式

ossutil api create-cname-token --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。

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

  • --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所有權驗證所需的CnameToken。

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

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

    命令樣本如下:

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

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

    命令樣本如下:

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

    ossutil api create-cname-token --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  1. 為Agentic Bucketmyab-$uid-$region-ab-apsr建立泛網域名稱CNAME基礎網域名稱example.com所有權驗證所需的CnameToken。

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

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