ListCname - Object Storage Service - Centro de documentación de Alibaba Cloud

La operación ListCname consulta todos los nombres de dominio personalizados (CNAME) asignados a un bucket. En el caso de un Agentic Bucket, la respuesta puede contener entradas CNAME exactas y entradas CNAME con comodín. El elemento IsWildCard identifica las entradas CNAME con comodín.

Notas de uso

En la respuesta, una entrada CNAME exacta no incluye el elemento IsWildCard. Esto mantiene la compatibilidad de la respuesta con versiones anteriores de los SDK de OSS. Una entrada CNAME con comodín sí incluye el elemento IsWildCard con el valor true, y su valor Domain corresponde al nombre de dominio base sin el prefijo *..
La respuesta de un Agentic Bucket puede contener entradas CNAME exactas y entradas CNAME con comodín. El formato de respuesta de un bucket estándar permanece sin cambios.

Sintaxis de la solicitud

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

Encabezados de la solicitud

Esta operación usa únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP headers.

Encabezados de la respuesta

Esta operación devuelve únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP headers.

Elementos de la respuesta

Elemento	Tipo	Ejemplo	Descripción
ListCnameResult	Contenedor	Ninguna	Contenedor que almacena la información de CNAME consultada. Nodos principales: ninguno Nodos secundarios: Bucket, Owner y Cname
Bucket	String	examplebucket	Nombre del bucket cuyos CNAME se consultan. Nodos principales: ListCnameResult Nodos secundarios: ninguno
Owner	String	testowner	Nombre del propietario del bucket. Nodos principales: ListCnameResult Nodos secundarios: ninguno
Cname	Contenedor	Ninguna	Contenedor que almacena la información del CNAME. Nodos principales: ListCnameResult Nodos secundarios: Domain, LastModified, Status, IsWildCard y Certificate
Domain	String	example.com	Nombre de dominio personalizado. Para una entrada CNAME con comodín, este valor es el nombre de dominio base sin el prefijo `*.`, como example.com. Nodos principales: Cname Nodos secundarios: ninguno
LastModified	String	2021-09-15T02:35:07.000Z	Hora en la que se asignó el nombre de dominio personalizado. Nodos principales: Cname Nodos secundarios: ninguno
Status	String	Enabled	Estado del nombre de dominio. Valores válidos: Enabled: el nombre de dominio está habilitado. Disabled: el nombre de dominio está deshabilitado. Nodos principales: Cname Nodos secundarios: ninguno
IsWildCard	Boolean	true	Indica si la entrada es un CNAME con comodín. Solo las entradas CNAME con comodín incluyen este elemento, y su valor es true. Las entradas CNAME exactas no lo incluyen, lo cual mantiene la compatibilidad de la respuesta con versiones anteriores de los SDK de OSS. Nodos principales: Cname Nodos secundarios: ninguno
Certificate	Contenedor	Ninguna	Contenedor que almacena la información del certificado. Nodos principales: Cname Nodos secundarios: Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate y ValidEndDate
Type	String	CAS	Origen del certificado. Valores válidos: CAS: el certificado se obtuvo de Certificate Management Service. Upload: el usuario cargó el certificado en una versión anterior del servicio de hosting de certificados. Nodos principales: Certificate Nodos secundarios: ninguno
CertId	String	493****-cn-hangzhou	ID del certificado. Nodos principales: Certificate Nodos secundarios: ninguno
Status	String	Enabled	Estado del certificado. Valores válidos: Enabled: el certificado está en uso. Disabled: el certificado no está en uso. Nodos principales: Certificate Nodos secundarios: ninguno
CreationDate	String	Wed, 15 Sep 2021 02:35:06 GMT	Hora en la que se vinculó el certificado. Nodos principales: Certificate Nodos secundarios: ninguno
Fingerprint	String	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E::	Huella digital del certificado. Nodos principales: Certificate Nodos secundarios: ninguno
ValidStartDate	String	Wed, 12 Apr 2023 10:14:51 GMT	Hora en la que el certificado entra en vigor. Nodos principales: Certificate Nodos secundarios: ninguno
ValidEndDate	String	Mon, 4 May 2048 10:14:51 GMT	Hora en la que el certificado caduca. Nodos principales: Certificate Nodos secundarios: ninguno

Ejemplos

Solicitud de ejemplo

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

Respuestas de ejemplo

Respuesta de ejemplo para un bucket estándar

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>

Respuesta de ejemplo para un Agentic Bucket, que puede contener entradas CNAME exactas y entradas CNAME con comodín

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 de OSS

A continuación se muestran los SDK de OSS compatibles con la operación ListCname:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación ListCname, consulte list-cname.

Códigos de error

Código de error	Código de estado HTTP	Descripción
AccessDenied	403	No cuenta con los permisos necesarios para invocar la operación ListCname. Solo el propietario del bucket y los usuarios con el permiso `oss:ListCname` pueden consultar todos los CNAME asignados al bucket actual.
NoSuchCname	404	No hay ningún CNAME asignado al bucket.
MethodNotAllowed	405	La función de CNAME no está habilitada para el tipo de bucket de destino.