ListCname - Consulta os nomes de domínio personalizados mapeados para um bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

A operação ListCname consulta todos os nomes de domínio personalizados (CNAMEs) mapeados para um bucket. Para um Agentic Bucket, a resposta pode conter entradas de CNAME exato e curinga. O elemento IsWildCard identifica as entradas de CNAME curinga.

Observações de uso

Na resposta, uma entrada de CNAME exato não inclui o elemento IsWildCard, o que mantém a compatibilidade com versões anteriores dos SDKs do OSS. Uma entrada de CNAME curinga inclui o elemento IsWildCard definido como true, e seu valor de Domain corresponde ao nome de domínio base, sem o prefixo *..
A resposta para um Agentic Bucket pode conter entradas de CNAME exato e curinga. O formato de resposta para um bucket padrão permanece inalterado.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Common HTTP headers.

Cabeçalhos da resposta

Esta operação retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common HTTP headers.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
ListCnameResult	Container	N/A	Contêiner que armazena as informações de CNAME consultadas. Nós pai: nenhum Nós filho: Bucket, Owner e Cname
Bucket	String	examplebucket	Nome do bucket cujos CNAMEs foram consultados. Nós pai: ListCnameResult Nós filho: nenhum
Owner	String	testowner	Nome do proprietário do bucket. Nós pai: ListCnameResult Nós filho: nenhum
Cname	Container	N/A	Contêiner que armazena as informações do CNAME. Nós pai: ListCnameResult Nós filho: Domain, LastModified, Status, IsWildCard e Certificate
Domain	String	example.com	Nome de domínio personalizado. Para uma entrada de CNAME curinga, este valor é o nome de domínio base sem o prefixo `*.`, como example.com. Nós pai: Cname Nós filho: nenhum
LastModified	String	2021-09-15T02:35:07.000Z	Momento em que o nome de domínio personalizado foi mapeado. Nós pai: Cname Nós filho: nenhum
Status	String	Enabled	Estado do nome de domínio. Valores válidos: Enabled: O nome de domínio está ativado. Disabled: O nome de domínio está desativado. Nós pai: Cname Nós filho: nenhum
IsWildCard	Boolean	true	Indica se a entrada é um CNAME curinga. Apenas entradas de CNAME curinga incluem este elemento, com valor true. Entradas de CNAME exato não incluem este elemento, o que garante compatibilidade com versões anteriores dos SDKs do OSS. Nós pai: Cname Nós filho: nenhum
Certificate	Container	N/A	Contêiner que armazena as informações do certificado. Nós pai: Cname Nós filho: Type, CertId, Status, CreationDate, Fingerprint, ValidStartDate e ValidEndDate
Type	String	CAS	Origem do certificado. Valores válidos: CAS: Certificado obtido do Certificate Management Service. Upload: Certificado enviado pelo usuário para uma versão anterior do service de hospedagem de certificados. Nós pai: Certificate Nós filho: nenhum
CertId	String	493****-cn-hangzhou	ID do certificado. Nós pai: Certificate Nós filho: nenhum
Status	String	Enabled	Estado do certificado. Valores válidos: Enabled: O certificado está em uso. Disabled: O certificado não está em uso. Nós pai: Certificate Nós filho: nenhum
CreationDate	String	Wed, 15 Sep 2021 02:35:06 GMT	Momento em que o certificado foi vinculado. Nós pai: Certificate Nós filho: nenhum
Fingerprint	String	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E::	Impressão digital do certificado. Nós pai: Certificate Nós filho: nenhum
ValidStartDate	String	Wed, 12 Apr 2023 10:14:51 GMT	Momento em que o certificado entra em vigor. Nós pai: Certificate Nós filho: nenhum
ValidEndDate	String	Mon, 4 May 2048 10:14:51 GMT	Momento em que o certificado expira. Nós pai: Certificate Nós filho: nenhum

Exemplos

Exemplo de solicitação

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

Exemplos de resposta

Resposta de exemplo para um bucket padrão

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>

Resposta de exemplo para um Agentic Bucket, que pode conter entradas de CNAME exato e curinga

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>

SDKs do OSS

Os seguintes SDKs do OSS suportam a operação ListCname:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação ListCname, consulte list-cname.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
AccessDenied	403	Você não tem permissão para chamar a operação ListCname. Somente o proprietário do bucket e usuários com a permissão `oss:ListCname` concedida podem consultar todos os CNAMEs mapeados para o bucket atual.
NoSuchCname	404	Nenhum CNAME está mapeado para o bucket.
MethodNotAllowed	405	O recurso de CNAME não está ativado para o tipo de bucket de destino.