Todos os produtos
Search

Este produto

    Object Storage Service:bucket-cname

    Central de documentação

    Object Storage Service:bucket-cname

    Última atualização: Sep 25, 2026

    Execute o comando bucket-cname para criar um token CNAME usado na verificação de propriedade dos domínios mapeados a um bucket e para gerenciar configurações CNAME.

    Observações de uso

    • Para criar um token CNAME, você deve ter a permissão oss:CreateCnameToken. Para consultar um token CNAME, é necessária a permissão oss:GetCnameToken. Para adicionar configurações CNAME, é necessária a permissão oss:PutCname. Para consultar configurações CNAME, é necessária a permissão oss:ListCname. Para excluir configurações CNAME, é necessária a permissão oss:DeleteCname. Para mais informações, consulte Grant a custom policy.

    • Para o ossutil 1.6.16 e versões posteriores, use ossutil diretamente como nome do binário na linha de comando, sem precisar ajustar o nome conforme o sistema operacional. Para versões anteriores ao ossutil 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte ossutil command reference.

    Criar um token CNAME

    Nota

    Somente o ossutil 1.7.13 e versões posteriores permitem criar um token CNAME.

    • Sintaxe do comando

      ossutil bucket-cname --method put --item token oss://bucketname domainname

      A tabela a seguir descreve os parâmetros do comando.

      Parâmetro

      Descrição

      bucketname

      O nome do bucket ao qual o domínio para o qual você deseja adicionar um registro CNAME está mapeado.

      domainname

      O domínio personalizado.

    • Exemplos

      O exemplo a seguir demonstra como criar um token CNAME para mapear o domínio personalizado example.com ao bucket examplebucket:

      ossutil bucket-cname --method put --item token oss://examplebucket example.com

      A seguinte saída é exibida:

      <CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>4db41c3ad0c4c4b690d4c17fb34e****</Token>
 <ExpireTime>Thu, 26 May 2022 19:14:12 GMT</ExpireTime>
</CnameToken>

0.270654(s) elapsed

      Após criar o token CNAME, adicione um registro TXT. Para mais informações, consulte Access OSS through a custom domain name.

    Consultar o token CNAME

    • Sintaxe do comando

      ossutil bucket-cname --method get --item token oss://bucketname  domainname local_xml_file

    • Exemplos

      • O exemplo a seguir demonstra como consultar e exibir o token CNAME:

        ossutil bucket-cname --method get --item token oss://examplebucket example.com

        A seguinte saída é exibida:

        <CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

0.144356(s) elapsed

      • O exemplo a seguir demonstra como consultar o token CNAME e armazená-lo em um arquivo local:

        ossutil bucket-cname --method get --item token oss://examplebucket example.com local.xml

        O arquivo local contém o seguinte conteúdo:

        <CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

    Adicionar configurações CNAME

    Importante

    Antes de adicionar configurações CNAME, crie um token CNAME. Para mais informações, consulte Create a CNAME token.

    • Sintaxe do comando

      ossutil bucket-cname --method put oss://bucketname domainname

    • Exemplos

      O exemplo a seguir demonstra como adicionar configurações CNAME ao bucket examplebucket:

      ossutil bucket-cname --method put oss://examplebucket example.com

      Se a saída a seguir for exibida, as configurações CNAME foram adicionadas:

      0.227834(s) elapsed

    Consultar configurações CNAME

    • Sintaxe do comando

      ossutil bucket-cname --method get oss://bucketname local_xml_file

    • Exemplos

      • O exemplo a seguir demonstra como consultar e exibir as configurações CNAME do bucket examplebucket:

        ossutil bucket-cname --method get oss://examplebucket

        Se a saída a seguir for exibida, as configurações CNAME do bucket foram consultadas. O resultado indica que os domínios example.com e example.org estão mapeados ao bucket examplebucket e encontram-se habilitados:

        <?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

0.164039(s) elapsed

      • O exemplo a seguir demonstra como consultar as configurações CNAME do bucket examplebucket e armazená-las em um arquivo local:

        ossutil bucket-cname --method get oss://examplebucket local.xml

        Se um certificado SSL estiver associado, a seguinte saída é exibida:

        <?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>1506925210***</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2023-02-27T10:38:13.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>false</IsPurgeCdnCache>
    <Certificate>
      <Type>CAS</Type>
      <CertId>927****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate>Mon, 27 Feb 2023 06:51:34 GMT</CreationDate>
      <Fingerprint>60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</Fingerprint>
      <ValidStartDate>Feb 10 00:00:00 2023 GMT</ValidStartDate>
      <ValidEndDate>Feb 10 23:59:59 2024 GMT</ValidEndDate>
    </Certificate>
  </Cname>
</ListCnameResult>

        Se nenhum certificado SSL estiver associado, a seguinte saída é exibida:

        <?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

    Adicionar um registro CNAME e associar um certificado SSL

    • Sintaxe do comando

      ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

    • Exemplos

      1. Especifique o arquivo de configuração local.

        <?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <CertId>493****-cn-hangzhou</CertId>
      <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
      <PrivateKey>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</PrivateKey>
      <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

      2. Adicione um registro CNAME aos registros DNS do domínio e associe um certificado SSL ao domínio.

        ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml

    Desassociar certificados SSL

    • Sintaxe do comando

      ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

    • Exemplos

      1. Especifique o arquivo de configuração local.

        <?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <DeleteCertificate>True</DeleteCertificate>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

      2. Desassocie o certificado SSL.

        ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml

    Excluir configurações CNAME

    • Sintaxe do comando

      ossutil bucket-cname --method delete oss://bucketname domainname

    • Exemplos

      O exemplo a seguir demonstra como excluir as configurações CNAME do bucket examplebucket:

      ossutil bucket-cname --method delete oss://examplebucket example.com

      Se a saída a seguir for exibida, as configurações CNAME foram excluídas:

      0.227389(s) elapsed

    Opções comuns

    Para acessar um bucket em uma região diferente, use -e para especificar o endpoint. Para acessar um bucket pertencente a outra conta da Alibaba Cloud, use -i para o AccessKey ID e -k para o AccessKey secret.

    Por exemplo, execute o comando a seguir para adicionar configurações CNAME a um bucket chamado testbucket localizado na região China (Hangzhou) e pertencente a outra conta da Alibaba Cloud:

    ossutil bucket-cname --method put oss://testbucket example.org -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

    Common options.