全部產品
Search

搜尋本產品

    Object Storage Service：ListCname

    文件中心

    Object Storage Service：ListCname

    更新時間：Sep 11, 2026

    調用ListCname介面用於查詢某個儲存空間（Bucket）下綁定的所有的自訂網域名（Cname）列表。對於Agentic Bucket，響應中可能同時包含精確CNAME和泛網域名稱CNAME條目，泛網域名稱CNAME條目通過IsWildCard節點標識。

    注意事項

    • 響應中，精確CNAME條目不額外輸出IsWildCard節點，以保持與舊版SDK的相容；泛網域名稱CNAME條目輸出IsWildCard節點（值為true），其Domain為不含*.首碼的泛網域名稱基礎域。

    • Agentic Bucket的響應中可能同時包含精確CNAME和泛網域名稱CNAME條目；普通Bucket的響應格式保持不變。

    請求文法

    GET /?cname HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Thu, 17 Apr 2025 15:39:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    要求標頭

    此介面僅包含公用要求標頭。更多資訊，請參見公用HTTP頭定義。

    回應標頭

    此介面僅涉及公用回應標頭。更多資訊，請參見公用HTTP頭定義。

    響應元素

    名稱

    類型

    樣本值

    說明

    ListCnameResult

    容器

    不涉及

    查詢Cname資訊列表的容器。

    父節點：無

    子節點：Bucket、Owner和Cname

    Bucket

    字串

    examplebucket

    待擷取已綁定Cname列表的Bucket名稱。

    父節點：ListCnameResult

    子節點：無

    Owner

    字串

    testowner

    Bucket Owner名稱。

    父節點：ListCnameResult

    子節點：無

    Cname

    容器

    不涉及

    Cname資訊列表的容器。

    父節點：ListCnameResult

    子節點：Domain、LastModified、Status、IsWildCard和Certificate

    Domain

    字串

    example.com

    自訂網域名。泛網域名稱CNAME條目中，該值為不含*.首碼的泛網域名稱基礎域，例如example.com。

    父節點：Cname

    子節點：無

    LastModified

    字串

    2021-09-15T02:35:07.000Z

    綁定自訂網域名的時間。

    父節點：Cname

    子節點：無

    Status

    字串

    Enabled

    網域名稱所處狀態。取值為：

    • Enabled：啟用該網域名稱。

    • Disabled：禁用該網域名稱。

    父節點：Cname

    子節點：無

    IsWildCard

    布爾值

    true

    是否為泛網域名稱CNAME條目。僅泛網域名稱CNAME條目輸出該節點，取值為true；精確CNAME條目不輸出該節點，以保持與舊版SDK的相容。

    父節點：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****************

    • 返回樣本

      • 普通Bucket響應樣本

        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>
</ListCnameResult>

      • Agentic Bucket響應樣本（可能同時包含精確和泛網域名稱CNAME條目）

        content-length: 1024
x-oss-console-auth: success
server: AliyunOSS
x-oss-server-time: 7
connection: keep-alive
x-oss-request-id: 614169F1AE63BD37355CA12C
date: Tues, 11 May 2022 11:39:12 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>myab-$uid-$region-ab-apsr</Bucket>
  <Owner>1234567890123456</Owner>
  <Cname>
    <Domain>console.example.com</Domain>
    <LastModified>2025-04-17T02:35:07.000Z</LastModified>
    <Status>Enabled</Status>
  </Cname>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2025-04-17T02:50:34.000Z</LastModified>
    <Status>Enabled</Status>
    <IsWildCard>true</IsWildCard>
  </Cname>
</ListCnameResult>

    SDK

    本介面對應的各語言SDK如下：

    命令列工具ossutil

    ListCname介面所對應的ossutil命令，請參見list-cname。

    錯誤碼

    錯誤碼

    HTTP狀態代碼

    描述

    AccessDenied

    403

    沒有調用ListCname介面的許可權。僅Bucket擁有者以及被授予oss:ListCname許可權的使用者可以查詢當前Bucket下綁定的所有Cname列表。

    NoSuchCname

    404

    該Bucket未綁定Cname。

    MethodNotAllowed

    405

    目標Bucket類型未開通CNAME能力。