ListCname - Object Storage Service - Alibaba Cloud ドキュメントセンター

バケットにマッピングされているすべての CNAME レコードを照会します。

リクエスト構文

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

リクエストヘッダー

ListCname リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

ListCname リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

要素	タイプ	例	説明
ListCnameResult	コンテナー	該当なし	すべての CNAME レコードに関する情報を照会するために使用されるコンテナー。親ノード: なし子ノード: Bucket、Owner、および Cname
Bucket	文字列	examplebucket	照会する CNAME レコードがマッピングされているバケットの名前。親ノード: ListCnameResult 子ノード: なし
Owner	文字列	testowner	バケット所有者の名前。親ノード: 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: SSL 証明書サービスを使用して取得された証明書。 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>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、ListCname を呼び出すことができます。

ossutil

ListCname 操作に対応する ossutil コマンドについては、「list-cname」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
AccessDenied	403	ListCname 操作を呼び出す権限がないために返されるエラーメッセージ。バケット所有者と `oss:ListCname` 権限が付与されている RAM ユーザーのみが、バケットにマッピングされているすべての CNAME レコードを照会できます。
NoSuchCname	404	バケットに CNAME レコードがマッピングされていないために返されるエラーメッセージ。