ListCname - Kueri nama domain kustom yang dipetakan ke bucket - Object Storage Service

ListCname melakukan kueri terhadap semua nama domain kustom (CNAME) yang dipetakan ke sebuah bucket. Untuk Agentic Bucket, respons dapat mencakup entri CNAME eksak maupun CNAME wildcard, dan elemen IsWildCard mengidentifikasi entri CNAME wildcard tersebut.

Catatan penggunaan

Dalam respons, entri CNAME eksak tidak menyertakan elemen IsWildCard, sehingga menjaga kompatibilitas respons dengan versi OSS SDK sebelumnya. Entri CNAME wildcard menyertakan elemen IsWildCard yang diatur ke true, dan nilai Domain-nya adalah nama domain dasar tanpa awalan *..
Respons untuk Agentic Bucket dapat mencakup entri CNAME eksak maupun CNAME wildcard. Format respons untuk bucket standar tetap tidak berubah.

Sintaksis permintaan

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

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Header HTTP umum.

Header respons

Operasi ini hanya mengembalikan header respons umum. Untuk informasi selengkapnya, lihat Header HTTP umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListCnameResult	Kontainer	N/A	Kontainer yang menyimpan informasi CNAME hasil kueri. Node induk: tidak ada Node anak: Bucket, Owner, dan Cname
Bucket	String	examplebucket	Nama bucket yang CNAME-nya dikueri. Node induk: ListCnameResult Node anak: tidak ada
Owner	String	testowner	Nama pemilik bucket. Node induk: ListCnameResult Node anak: tidak ada
Cname	Kontainer	N/A	Kontainer yang menyimpan informasi CNAME. Node induk: ListCnameResult Node anak: Domain, LastModified, Status, IsWildCard, dan Certificate
Domain	String	example.com	Nama domain kustom. Untuk entri CNAME wildcard, nilai ini adalah nama domain dasar tanpa awalan `*.`, seperti example.com. Node induk: Cname Node anak: tidak ada
LastModified	String	2021-09-15T02:35:07.000Z	Waktu saat nama domain kustom dipetakan. Node induk: Cname Node anak: tidak ada
Status	String	Enabled	Status nama domain. Nilai yang valid: Enabled: Nama domain diaktifkan. Disabled: Nama domain dinonaktifkan. Node induk: Cname Node anak: tidak ada
IsWildCard	Boolean	true	Menunjukkan apakah entri tersebut merupakan CNAME wildcard. Hanya entri CNAME wildcard yang menyertakan elemen ini, dan nilainya adalah true. Entri CNAME eksak tidak menyertakan elemen ini, sehingga menjaga kompatibilitas respons dengan versi OSS SDK sebelumnya. Node induk: Cname Node anak: tidak ada
Certificate	Kontainer	N/A	Kontainer yang menyimpan informasi sertifikat. Node induk: Cname Node anak: Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate, dan ValidEndDate
Type	String	CAS	Sumber sertifikat. Nilai yang valid: CAS: Sertifikat diperoleh dari Certificate Management Service. Upload: Sertifikat diunggah oleh pengguna ke versi layanan hosting sertifikat sebelumnya. Node induk: Certificate Node anak: tidak ada
CertId	String	493****-cn-hangzhou	ID sertifikat. Node induk: Certificate Node anak: tidak ada
Status	String	Enabled	Status sertifikat. Nilai yang valid: Enabled: Sertifikat sedang digunakan. Disabled: Sertifikat tidak digunakan. Node induk: Certificate Node anak: tidak ada
CreationDate	String	Wed, 15 Sep 2021 02:35:06 GMT	Waktu saat sertifikat diikat. Node induk: Certificate Node anak: tidak ada
Fingerprint	String	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E::	Sidik jari sertifikat. Node induk: Certificate Node anak: tidak ada
ValidStartDate	String	Wed, 12 Apr 2023 10:14:51 GMT	Waktu saat sertifikat mulai berlaku. Node induk: Certificate Node anak: tidak ada
ValidEndDate	String	Mon, 4 May 2048 10:14:51 GMT	Waktu saat sertifikat kedaluwarsa. Node induk: Certificate Node anak: tidak ada

Contoh

Permintaan contoh

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****************

Respons contoh

Respons contoh untuk bucket standar

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>

Respons contoh untuk Agentic Bucket, yang dapat mencakup entri CNAME eksak maupun CNAME wildcard

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>

OSS SDKs

OSS SDK berikut mendukung operasi ListCname:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListCname, lihat list-cname.

Kode error

Kode error	Kode status HTTP	Deskripsi
AccessDenied	403	Anda tidak memiliki izin untuk memanggil operasi ListCname. Hanya pemilik bucket dan pengguna yang diberikan izin `oss:ListCname` yang dapat melakukan kueri terhadap semua CNAME yang dipetakan ke bucket saat ini.
NoSuchCname	404	Tidak ada CNAME yang dipetakan ke bucket tersebut.
MethodNotAllowed	405	Fitur CNAME tidak diaktifkan untuk tipe bucket target.