調用ListCname介面用於查詢某個儲存空間(Bucket)下綁定的所有的自訂網域名(Cname)列表。
請求文法
GET /?cname HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Tues, 11 May 2022 11:39:12 GMT
Authorization: OSS qn6q**************:77Dv****************
要求標頭
此介面僅包含公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)。
回應標頭
此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)。
響應元素
名稱 | 類型 | 樣本值 | 說明 |
ListCnameResult | 容器 | 不涉及 | 查詢Cname資訊列表的容器。 父節點:無 子節點:Bucket、Owner和Cname |
Bucket | 字串 | examplebucket | 待擷取已綁定Cname列表的Bucket名稱。 父節點:ListCnameResult 子節點:無 |
Owner | 字串 | testowner | Bucket Owner名稱。 父節點:ListCnameResult 子節點:無 |
Cname | 容器 | 不涉及 | Cname資訊列表的容器。 父節點:ListCnameResult 子節點:Domain、LastModified、Status和Certificate |
Domain | 字串 | example.com | 自訂網域名。 父節點:Cname 子節點:無 |
LastModified | 字串 | 2021-09-15T02:35:07.000Z | 綁定自訂網域名的時間。 父節點:Cname 子節點:無 |
Status | 字串 | Enabled | 網域名稱所處狀態。取值為:
父節點:Cname 子節點:無 |
Certificate | 容器 | 不涉及 | 認證資訊的容器。 父節點:Cname 子節點:Type、CertId、Status、CreationDate、Fingerprint、ValidStartDate和ValidEndDate |
Type | 字串 | CAS | 認證來源。取值為:
父節點:Certificate 子節點:無 |
CertId | 字串 | 493****-cn-hangzhou | 認證ID。 父節點:Certificate 子節點:無 |
Status | 字串 | Enabled | 認證狀態。取值如下:
父節點:Certificate 子節點:無 |
CreationDate | 字串 | Wed, 15 Sep 2021 02:35:06 GMT | 認證綁定時間。 父節點:Certificate 子節點:無 |
Fingerprint | 字串 | DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E:**:** | 認證簽名。 父節點:Certificate 子節點:無 |
ValidStartDate | 字串 | Wed, 12 Apr 2023 10:14:51 GMT | 認證有效期間起始時間。 父節點:Certificate 子節點:無 |
ValidEndDate | 字串 | Mon, 4 May 2048 10:14:51 GMT | 認證有效期間終止時間。 父節點:Certificate 子節點:無 |
樣本
請求樣本
GET /?cname HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Type: application/xml Content-Length: 186 Date: Tues, 11 May 2022 11:39:12 GMT Authorization: OSS qn6q**************:77Dv****************
返回樣本
content-length: 1855 x-oss-console-auth: success server: AliyunOSS x-oss-server-time: 7 connection: keep-alive x-oss-request-id: 614169F1AE63BD37355CA12B date: Tues, 11 May 2022 11:39:12 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <ListCnameResult> <Bucket>targetbucket</Bucket> <Owner>testowner</Owner> <Cname> <Domain>example.com</Domain> <LastModified>2021-09-15T02:35:07.000Z</LastModified> <Status>Enabled</Status> <Certificate> <Type>CAS</Type> <CertId>493****-cn-hangzhou</CertId> <Status>Enabled</Status> <CreationDate>Wed, 15 Sep 2021 02:35:06 GMT</CreationDate> <Fingerprint>DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E:**:**</Fingerprint> <ValidStartDate>Wed, 12 Apr 2023 10:14:51 GMT</ValidStartDate> <ValidEndDate>Mon, 4 May 2048 10:14:51 GMT</ValidEndDate> </Certificate> </Cname> <Cname> <Domain>example.org</Domain> <LastModified>2021-09-15T02:34:58.000Z</LastModified> <Status>Enabled</Status> </Cname> <Cname> <Domain>example.edu</Domain> <LastModified>2021-09-15T02:50:34.000Z</LastModified> <Status>Enabled</Status> </Cname> </ListCnameResult>
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
AccessDenied | 403 | 沒有調用ListCname介面的許可權。僅Bucket擁有者以及被授予 |
NoSuchCname | 404 | 該Bucket未綁定Cname。 |