调用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>
SDK
本接口对应的各语言SDK如下：
Java
Python
Go V2
Node.js
PHP
命令行工具ossutil
ListCname接口所对应的ossutil命令，请参见list-cname。
错误码
错误码 | HTTP状态码 | 描述 |
AccessDenied | 403 | 没有调用ListCname接口的权限。仅Bucket拥有者以及被授予 |
NoSuchCname | 404 | 该Bucket未绑定Cname。 |