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

Notes d'utilisation

Dans la réponse, une entrée CNAME exacte n'inclut pas l'élément IsWildCard, ce qui garantit la compatibilité avec les versions antérieures des SDK OSS. Une entrée CNAME avec joker inclut l'élément IsWildCard défini sur true, et sa valeur Domain correspond au nom de domaine de base sans le préfixe *..
La réponse d'un Agentic Bucket peut contenir à la fois des entrées CNAME exactes et des entrées CNAME avec joker. Le format de réponse pour un bucket standard reste inchangé.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

En-têtes de réponse

Cette opération renvoie uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de réponse

Élément	Type	Exemple	Description
ListCnameResult	Conteneur	N/A	Conteneur stockant les informations relatives aux CNAME interrogés. Nœuds parents : aucun Nœuds enfants : Bucket, Owner et Cname
Bucket	Chaîne	examplebucket	Nom du bucket dont les CNAME sont interrogés. Nœuds parents : ListCnameResult Nœuds enfants : aucun
Owner	Chaîne	testowner	Nom du propriétaire du bucket. Nœuds parents : ListCnameResult Nœuds enfants : aucun
Cname	Conteneur	N/A	Conteneur stockant les informations relatives au CNAME. Nœuds parents : ListCnameResult Nœuds enfants : Domain, LastModified, Status, IsWildCard et Certificate
Domain	Chaîne	example.com	Nom de domaine personnalisé. Pour une entrée CNAME avec joker, cette valeur correspond au nom de domaine de base sans le préfixe `*.`, par exemple example.com. Nœuds parents : Cname Nœuds enfants : aucun
LastModified	Chaîne	2021-09-15T02:35:07.000Z	Date et heure de mappage du nom de domaine personnalisé. Nœuds parents : Cname Nœuds enfants : aucun
Status	Chaîne	Enabled	État du nom de domaine. Valeurs possibles : Enabled : le nom de domaine est activé. Disabled : le nom de domaine est désactivé. Nœuds parents : Cname Nœuds enfants : aucun
IsWildCard	Booléen	true	Indique si l'entrée est un CNAME avec joker. Seule une entrée CNAME avec joker inclut cet élément, et sa valeur est true. Une entrée CNAME exacte n'inclut pas cet élément, ce qui garantit la compatibilité avec les versions antérieures des SDK OSS. Nœuds parents : Cname Nœuds enfants : aucun
Certificate	Conteneur	N/A	Conteneur stockant les informations relatives au certificat. Nœuds parents : Cname Nœuds enfants : Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate et ValidEndDate
Type	Chaîne	CAS	Source du certificat. Valeurs possibles : CAS : le certificat est obtenu via le service Certificate Management Service. Upload : le certificat a été téléchargé par l'utilisateur vers une version antérieure du service d'hébergement de certificats. Nœuds parents : Certificate Nœuds enfants : aucun
CertId	Chaîne	493****-cn-hangzhou	ID du certificat. Nœuds parents : Certificate Nœuds enfants : aucun
Status	Chaîne	Enabled	État du certificat. Valeurs possibles : Enabled : le certificat est utilisé. Disabled : le certificat n'est pas utilisé. Nœuds parents : Certificate Nœuds enfants : aucun
CreationDate	Chaîne	Wed, 15 Sep 2021 02:35:06 GMT	Date et heure de liaison du certificat. Nœuds parents : Certificate Nœuds enfants : aucun
Fingerprint	Chaîne	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E::	Empreinte digitale du certificat. Nœuds parents : Certificate Nœuds enfants : aucun
ValidStartDate	Chaîne	Wed, 12 Apr 2023 10:14:51 GMT	Date et heure d'entrée en vigueur du certificat. Nœuds parents : Certificate Nœuds enfants : aucun
ValidEndDate	Chaîne	Mon, 4 May 2048 10:14:51 GMT	Date et heure d'expiration du certificat. Nœuds parents : Certificate Nœuds enfants : aucun

Exemples

Exemple de requête

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

Exemples de réponses

Exemple de réponse pour un bucket standard

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>

Exemple de réponse pour un Agentic Bucket, pouvant contenir à la fois des entrées CNAME exactes et des entrées CNAME avec joker

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>

SDK OSS

Les SDK OSS suivants prennent en charge l'opération ListCname :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération ListCname, consultez la section list-cname.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

AccessDenied

403

Vous ne disposez pas des autorisations nécessaires pour appeler l'opération ListCname. Seul le propriétaire du bucket et les utilisateurs auxquels l'autorisation oss:ListCname a été accordée peuvent interroger tous les CNAME mappés au bucket actuel.

NoSuchCname

404

Aucun CNAME n'est mappé au bucket.

MethodNotAllowed

405

La fonctionnalité CNAME n'est pas activée pour le type de bucket cible.