bucket-cname(自定義域名)
您可以通過bucket-cname命令創(chuàng)建域名所有權(quán)驗(yàn)證所需的CnameToken以及管理Cname配置。
注意事項(xiàng)
要?jiǎng)?chuàng)建CnameToken,您必須具有
oss:CreateCnameToken
權(quán)限;要獲取CnameToken,您必須具有oss:GetCnameToken
權(quán)限;要添加Cname配置,您必須具有oss:PutCname
權(quán)限;要獲取Cname配置,您必須具有oss:ListCname
權(quán)限;要?jiǎng)h除Cname配置,您必須具有oss:DeleteCname
權(quán)限。具體操作,請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。從ossutil 1.6.16版本開始,命令行中Binary名稱支持直接使用ossutil,您無需根據(jù)系統(tǒng)刷新Binary名稱。如果您的ossutil版本低于1.6.16,則需要根據(jù)系統(tǒng)刷新Binary名稱。更多信息,請(qǐng)參見命令行工具ossutil命令參考。
創(chuàng)建CnameToken
僅ossutil1.7.13及以上版本支持創(chuàng)建CnameToken。
命令格式
ossutil bucket-cname --method put --item token oss://bucketname domainname
參數(shù)說明如下:
參數(shù)
說明
bucketname
填寫待綁定Cname配置的Bucket名稱。
domainname
填寫自定義域名。
使用示例
以下示例用于為examplebucket待綁定的自定義域名example.com創(chuàng)建CnameToken。
ossutil bucket-cname --method put --item token oss://examplebucket example.com
輸出結(jié)果如下:
<CnameToken> <Bucket>examplebucket</Bucket> <Cname>example.com</Cname> <Token>4db41c3ad0c4c4b690d4c17fb34e****</Token> <ExpireTime>Thu, 26 May 2022 19:14:12 GMT</ExpireTime> </CnameToken> 0.270654(s) elapsed
CnameToken創(chuàng)建完成后,您需要添加TXT記錄。具體步驟,請(qǐng)參見驗(yàn)證域名所有權(quán)。
查看CnameToken
命令格式
ossutil bucket-cname --method get --item token oss://bucketname domainname local_xml_file
使用示例
以下示例用于查看CnameToken,并輸出到屏幕。
ossutil bucket-cname --method get --item token oss://examplebucket example.com
輸出結(jié)果如下:
<CnameToken> <Bucket>examplebucket</Bucket> <Cname>example.com</Cname> <Token>fbf997e8a2d48cb2177ed25180ee****</Token> <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime> </CnameToken> 0.144356(s) elapsed
以下示例用于查看CnameToken,并保存到本地文件。
ossutil bucket-cname --method get --item token oss://examplebucket example.com local.xml
本地文件內(nèi)容如下:
<CnameToken> <Bucket>examplebucket</Bucket> <Cname>example.com</Cname> <Token>fbf997e8a2d48cb2177ed25180ee****</Token> <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime> </CnameToken>
添加Cname配置
添加Cname配置之前,您需要先創(chuàng)建CnameToken。具體步驟,請(qǐng)參見創(chuàng)建CnameToken。
命令格式
ossutil bucket-cname --method put oss://bucketname domainname
使用示例
以下示例用于為examplebucket添加Cname配置。
ossutil bucket-cname --method put oss://examplebucket example.com
以下輸出結(jié)果表明已成功添加Cname配置。
0.227834(s) elapsed
獲取Cname配置
命令格式
ossutil bucket-cname --method get oss://bucketname local_xml_file
使用示例
以下示例用于獲取examplebucket的Cname配置,并將配置結(jié)果直接輸出屏幕。
ossutil bucket-cname --method get oss://examplebucket
以下輸出結(jié)果表明已成功獲取Cname配置。Cname配置顯示examplebucket綁定了兩個(gè)自定義域名,分別為example.com和example.org,且域名處于已啟用(Enabled)狀態(tài)等信息。
<?xml version="1.0" encoding="UTF-8"?> <ListCnameResult> <Bucket>examplebucket</Bucket> <Owner>148562088256****</Owner> <Cname> <Domain>example.com</Domain> <LastModified>2021-08-26T07:25:12.000Z</LastModified> <Status>Enabled</Status> <IsPurgeCdnCache>true</IsPurgeCdnCache> </Cname> <Cname> <Domain>example.org</Domain> <LastModified>2021-08-26T07:25:26.000Z</LastModified> <Status>Enabled</Status> <IsPurgeCdnCache>true</IsPurgeCdnCache> </Cname> </ListCnameResult> 0.164039(s) elapsed
以下示例用于獲取examplebucket的Cname配置,并將配置結(jié)果輸出到本地文件。
ossutil bucket-cname --method get oss://examplebucket local.xml
有證書綁定的輸出結(jié)果如下:
<?xml version="1.0" encoding="UTF-8"?> <ListCnameResult> <Bucket>examplebucket</Bucket> <Owner>1506925210***</Owner> <Cname> <Domain>example.com</Domain> <LastModified>2023-02-27T10:38:13.000Z</LastModified> <Status>Enabled</Status> <IsPurgeCdnCache>false</IsPurgeCdnCache> <Certificate> <Type>CAS</Type> <CertId>927****-cn-hangzhou</CertId> <Status>Enabled</Status> <CreationDate>Mon, 27 Feb 2023 06:51:34 GMT</CreationDate> <Fingerprint>60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</Fingerprint> <ValidStartDate>Feb 10 00:00:00 2023 GMT</ValidStartDate> <ValidEndDate>Feb 10 23:59:59 2024 GMT</ValidEndDate> </Certificate> </Cname> </ListCnameResult>
無證書綁定的輸出結(jié)果如下:
<?xml version="1.0" encoding="UTF-8"?> <ListCnameResult> <Bucket>examplebucket</Bucket> <Owner>148562088256****</Owner> <Cname> <Domain>example.com</Domain> <LastModified>2021-08-26T07:25:12.000Z</LastModified> <Status>Enabled</Status> <IsPurgeCdnCache>true</IsPurgeCdnCache> </Cname> <Cname> <Domain>example.org</Domain> <LastModified>2021-08-26T07:25:26.000Z</LastModified> <Status>Enabled</Status> <IsPurgeCdnCache>true</IsPurgeCdnCache> </Cname> </ListCnameResult>
添加Cname域名并綁定域名證書
命令格式
ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file
使用示例
設(shè)置本地配置文件。
<?xml version="1.0" encoding="UTF-8"?> <BucketCnameConfiguration> <Cname> <Domain>example.com</Domain> <CertificateConfiguration> <CertId>493****-cn-hangzhou</CertId> <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate> <PrivateKey>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</PrivateKey> <PreviousCertId>493****-cn-hangzhou</PreviousCertId> <Force>true</Force> </CertificateConfiguration> </Cname> </BucketCnameConfiguration>
添加Cname域名并綁定域名證書。
ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml
解綁域名證書
命令格式
ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file
使用示例
設(shè)置本地配置文件。
<?xml version="1.0" encoding="UTF-8"?> <BucketCnameConfiguration> <Cname> <Domain>example.com</Domain> <CertificateConfiguration> <DeleteCertificate>True</DeleteCertificate> </CertificateConfiguration> </Cname> </BucketCnameConfiguration>
解綁域名證書。
ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml
刪除Cname配置
命令格式
ossutil bucket-cname --method delete oss://bucketname domainname
使用示例
以下示例用于刪除examplebucket的Cname配置。
ossutil bucket-cname --method delete oss://examplebucket example.com
以下輸出結(jié)果表明已成功刪除Cname配置。
0.227389(s) elapsed
通用選項(xiàng)
當(dāng)您需要通過命令行工具ossutil切換至另一個(gè)地域的Bucket時(shí),可以通過-e選項(xiàng)指定該Bucket所屬的Endpoint。當(dāng)您需要通過命令行工具ossutil切換至另一個(gè)阿里云賬號(hào)下的Bucket時(shí),可以通過-i選項(xiàng)指定該賬號(hào)的AccessKey ID,并通過-k選項(xiàng)指定該賬號(hào)的AccessKey Secret。
例如,您需要為另一個(gè)阿里云賬號(hào)下,華東1(杭州)地域下的testbucket添加Cname配置,命令如下:
ossutil bucket-cname --method put oss://testbucket example.org -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
關(guān)于此命令的其他通用選項(xiàng)的更多信息,請(qǐng)參見通用選項(xiàng)。