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" } }
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
建立儲存空間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\"}}"
為Agentic Bucket
myab-$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