ListCname
調(diào)用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)。
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請參見公共響應(yīng)頭(Common Response Headers)。
響應(yīng)元素
名稱 | 類型 | 示例值 | 說明 |
ListCnameResult | 容器 | 不涉及 | 查詢Cname信息列表的容器。 父節(jié)點:無 子節(jié)點:Bucket、Owner和Cname |
Bucket | 字符串 | examplebucket | 待獲取已綁定Cname列表的Bucket名稱。 父節(jié)點:ListCnameResult 子節(jié)點:無 |
Owner | 字符串 | testowner | Bucket Owner名稱。 父節(jié)點:ListCnameResult 子節(jié)點:無 |
Cname | 容器 | 不涉及 | Cname信息列表的容器。 父節(jié)點:ListCnameResult 子節(jié)點:Domain、LastModified、Status和Certificate |
Domain | 字符串 | example.com | 自定義域名。 父節(jié)點:Cname 子節(jié)點:無 |
LastModified | 字符串 | 2021-09-15T02:35:07.000Z | 綁定自定義域名的時間。 父節(jié)點:Cname 子節(jié)點:無 |
Status | 字符串 | Enabled | 域名所處狀態(tài)。取值為:
父節(jié)點:Cname 子節(jié)點:無 |
Certificate | 容器 | 不涉及 | 證書信息的容器。 父節(jié)點:Cname 子節(jié)點:Type、CertId、Status、CreationDate、Fingerprint、ValidStartDate和ValidEndDate |
Type | 字符串 | CAS | 證書來源。取值為:
父節(jié)點:Certificate 子節(jié)點:無 |
CertId | 字符串 | 493****-cn-hangzhou | 證書ID。 父節(jié)點:Certificate 子節(jié)點:無 |
Status | 字符串 | Enabled | 證書狀態(tài)。取值如下:
父節(jié)點:Certificate 子節(jié)點:無 |
CreationDate | 字符串 | Wed, 15 Sep 2021 02:35:06 GMT | 證書綁定時間。 父節(jié)點:Certificate 子節(jié)點:無 |
Fingerprint | 字符串 | DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E:**:** | 證書簽名。 父節(jié)點:Certificate 子節(jié)點:無 |
ValidStartDate | 字符串 | Wed, 12 Apr 2023 10:14:51 GMT | 證書有效期起始時間。 父節(jié)點:Certificate 子節(jié)點:無 |
ValidEndDate | 字符串 | Mon, 4 May 2048 10:14:51 GMT | 證書有效期終止時間。 父節(jié)點:Certificate 子節(jié)點:無 |
示例
請求示例
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狀態(tài)碼 | 描述 |
AccessDenied | 403 | 沒有調(diào)用ListCname接口的權(quán)限。僅Bucket擁有者以及被授予 |
NoSuchCname | 404 | 該Bucket未綁定Cname。 |