ListCname - Query the custom domain names mapped to a bucket - Object Storage Service

Kullanım notları

Yanıtta tam CNAME girişi IsWildCard öğesini içermez; bu sayede yanıt daha eski OSS SDK sürümleriyle uyumlu kalır. Joker karakterli CNAME girişi ise true olarak ayarlanmış IsWildCard öğesini içerir ve Domain değeri *. ön eki olmadan temel alan adıdır.
Agentic Bucket için yanıt hem tam CNAME hem de joker karakterli CNAME girdileri içerebilir. Standart paket için yanıt biçimi değişmemiştir.

İstek sözdizimi

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

İstek üstbilgileri

Bu işlem yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Yanıt üstbilgileri

Bu işlem yalnızca ortak yanıt üstbilgilerini döndürür. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Yanıt öğeleri

Öğe	Tür	Örnek	Açıklama
ListCnameResult	Konteyner	Uygulanamaz	Sorgulanan CNAME bilgilerini depolayan konteyner. Üst düğümler: yok Alt düğümler: Bucket, Owner ve Cname
Bucket	Dize	examplebucket	CNAME'leri sorgulanan paketin adı. Üst düğümler: ListCnameResult Alt düğümler: yok
Owner	Dize	testowner	Paket sahibinin adı. Üst düğümler: ListCnameResult Alt düğümler: yok
Cname	Konteyner	Uygulanamaz	CNAME bilgilerini depolayan konteyner. Üst düğümler: ListCnameResult Alt düğümler: Domain, LastModified, Status, IsWildCard ve Certificate
Domain	Dize	example.com	Özel alan adı. Joker karakterli CNAME girişi için bu değer, example.com gibi `*.` ön eki olmadan temel alan adıdır. Üst düğümler: Cname Alt düğümler: yok
LastModified	Dize	2021-09-15T02:35:07.000Z	Özel alan adının eşlendiği zaman. Üst düğümler: Cname Alt düğümler: yok
Status	Dize	Enabled	Alan adının durumu. Geçerli değerler: Enabled: Alan adı etkin. Disabled: Alan adı devre dışı. Üst düğümler: Cname Alt düğümler: yok
IsWildCard	Boole	true	Girdinin joker karakterli CNAME olup olmadığını belirtir. Bu öğe yalnızca joker karakterli CNAME girdisinde bulunur ve değeri true'dur. Tam CNAME girişi bu öğeyi içermez; bu sayede yanıt daha eski OSS SDK sürümleriyle uyumlu kalır. Üst düğümler: Cname Alt düğümler: yok
Certificate	Konteyner	Uygulanamaz	Sertifika bilgilerini depolayan konteyner. Üst düğümler: Cname Alt düğümler: Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate ve ValidEndDate
Type	Dize	CAS	Sertifikanın kaynağı. Geçerli değerler: CAS: Sertifika Sertifika Yönetim Hizmeti'nden alınmıştır. Upload: Sertifika, sertifika barındırma hizmetinin önceki bir sürümüne kullanıcı tarafından yüklenmiştir. Üst düğümler: Certificate Alt düğümler: yok
CertId	Dize	493****-cn-hangzhou	Sertifikanın ID'si. Üst düğümler: Certificate Alt düğümler: yok
Status	Dize	Enabled	Sertifikanın durumu. Geçerli değerler: Enabled: Sertifika kullanımda. Disabled: Sertifika kullanımda değil. Üst düğümler: Certificate Alt düğümler: yok
CreationDate	Dize	Wed, 15 Sep 2021 02:35:06 GMT	Sertifikanın bağlandığı zaman. Üst düğümler: Certificate Alt düğümler: yok
Fingerprint	Dize	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E::	Sertifikanın parmak izi. Üst düğümler: Certificate Alt düğümler: yok
ValidStartDate	Dize	Wed, 12 Apr 2023 10:14:51 GMT	Sertifikanın geçerlilik başlangıç zamanı. Üst düğümler: Certificate Alt düğümler: yok
ValidEndDate	Dize	Mon, 4 May 2048 10:14:51 GMT	Sertifikanın sona erme zamanı. Üst düğümler: Certificate Alt düğümler: yok

Örnekler

Örnek istek

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

Örnek yanıtlar

Standart paket için örnek yanıt

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>

Hem tam CNAME hem de joker karakterli CNAME girdileri içerebilen Agentic Bucket için örnek yanıt

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 SDK'ları

Aşağıdaki OSS SDK'ları ListCname işlemini destekler:

ossutil

ListCname işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-cname.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
AccessDenied	403	ListCname işlemini çağırma izniniz yok. Mevcut pakete eşlenen tüm CNAME'leri yalnızca paket sahibi ve `oss:ListCname` izni verilen kullanıcılar sorgulayabilir.
NoSuchCname	404	Pakete eşlenen CNAME yok.
MethodNotAllowed	405	Hedef paket türü için CNAME özelliği etkinleştirilmemiş.