ListCname - Object Storage Service

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