ListCname - 对象存储 OSS

调用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	域名所处状态。取值为： Enabled：：启用该域名。 Disabled：禁用该域名。父节点：Cname 子节点：无
Certificate	容器	不涉及	证书信息的容器。父节点：Cname 子节点：Type、CertId、Status、CreationDate、Fingerprint、ValidStartDate和ValidEndDate
Type	字符串	CAS	证书来源。取值为： CAS：证书中心。 Upload：旧版证书托管中用户自主上传的证书。父节点：Certificate 子节点：无
CertId	字符串	493****-cn-hangzhou	证书ID。父节点：Certificate 子节点：无
Status	字符串	Enabled	证书状态。取值如下： Enabled：使用证书。 Disabled：未使用证书。父节点：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拥有者以及被授予`oss:ListCname`权限的用户可以查询当前Bucket下绑定的所有Cname列表。
NoSuchCname	404	该Bucket未绑定Cname。