ListCname - Object Storage Service

Memeriksa semua Record CNAME yang dipetakan ke sebuah bucket.

Sintaks permintaan

GET /?cname HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Kamis, 17 April 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

Semua header dalam permintaan ListCname merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header respons

Semua header dalam respons terhadap permintaan ListCname merupakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListCnameResult	Container	N/A	Kontainer yang digunakan untuk memeriksa informasi tentang semua Record CNAME. Node induk: tidak ada Node anak: Bucket, Owner, dan Cname
Bucket	String	examplebucket	Nama bucket tempat Record CNAME yang ingin Anda periksa dipetakan. Node induk: ListCnameResult Node anak: tidak ada
Owner	String	testowner	Nama pemilik bucket. Node induk: ListCnameResult Node anak: tidak ada
Cname	Container	N/A	Kontainer yang digunakan untuk menyimpan informasi tentang semua Record CNAME. Node induk: ListCnameResult Node anak: Domain, LastModified, Status, dan Certificate
Domain	String	example.com	Nama domain kustom. Node induk: Cname Node anak: tidak ada
LastModified	String	2021-09-15T02:35:07.000Z	Waktu ketika nama domain kustom dipetakan. Node induk: Cname Node anak: tidak ada
Status	String	Enabled	Status nama domain. Nilai valid: Enabled:: Nama domain diaktifkan. Disabled: Nama domain dinonaktifkan. Node induk: Cname Node anak: tidak ada
Certificate	Container	N/A	Kontainer tempat informasi sertifikat disimpan. Node induk: Cname Node anak: Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate, dan ValidEndDate
Type	String	CAS	Sumber sertifikat. Nilai valid: CAS: Sertifikat yang diperoleh menggunakan SSL Certificates Service. Upload: Sertifikat yang diunggah oleh pengguna ke versi sebelumnya dari layanan hosting sertifikat. 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 valid: Enabled: Sertifikat digunakan. Disabled: Sertifikat tidak digunakan. Node induk: Certificate Node anak: tidak ada
CreationDate	String	Rabu, 15 Sep 2021 02:35:06 GMT	Waktu ketika 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::	Tanda tangan sertifikat. Node induk: Certificate Node anak: tidak ada
ValidStartDate	String	Rabu, 12 Apr 2023 10:14:51 GMT	Waktu ketika sertifikat mulai berlaku. Node induk: Certificate Node anak: tidak ada
ValidEndDate	String	Senin, 4 Mei 2048 10:14:51 GMT	Waktu ketika sertifikat kedaluwarsa. Node induk: Certificate Node anak: tidak ada

Contoh

Contoh Permintaan

GET /?cname HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Selasa, 11 Mei 2022 11:39:12 GMT
Authorization: OSS qn6q**************:77Dv****************

Contoh Respons

content-length: 1855
x-oss-console-auth: success
server: AliyunOSS
x-oss-server-time: 7
connection: keep-alive
x-oss-request-id: 614169F1AE63BD37355CA12B
date: Selasa, 11 Mei 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>Rabu, 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>Rabu, 12 Apr 2023 10:14:51 GMT</ValidStartDate>
      <ValidEndDate>Senin, 4 Mei 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 SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil ListCname:

ossutil

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

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
AccessDenied	403	Pesan kesalahan dikembalikan karena Anda tidak memiliki izin untuk memanggil operasi ListCname. Hanya pemilik bucket dan pengguna RAM yang diberikan izin `oss:ListCname` yang dapat memeriksa semua Record CNAME yang dipetakan ke bucket.
NoSuchCname	404	Pesan kesalahan dikembalikan karena tidak ada Record CNAME yang dipetakan ke bucket.