全部产品
Search
文档中心

对象存储 OSS:ListCname

更新时间:Apr 29, 2024

调用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。