全部產品
Search
文件中心

Object Storage Service:ListCname

更新時間:Jun 08, 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。