Todos os produtos
Search
Central de documentação

Object Storage Service:Excluir o registro CNAME mapeado a um bucket

Última atualização: Jul 03, 2026

Exclui um registro CNAME mapeado a um bucket.

Sintaxe da solicitação

POST /?cname&comp=delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

A operação RestoreObject usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

BucketCnameConfiguration

Container

Sim

N/A

Contêiner do registro CNAME.

Nós pai: nenhum

Nós filho: Cname

Cname

Container

Sim

N/A

Contêiner das informações de CNAME.

Nós pai: BucketCnameConfiguration

Nós filho: Domain

Domain

String

Sim

example.com

Nome de domínio personalizado.

Nós pai: Cname

Nós filho: nenhum

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

Exemplos

  • Exemplo de solicitação

    POST /?cname&comp=delete 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
    
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D
    Date: Mon, 26 Jul 2021 13:08:38 GMT
    Content-Length: 118
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS

SDKs do OSS

Os seguintes SDKs do OSS oferecem suporte à operação DeleteCname:

ossutil

Para ver o comando do ossutil correspondente ao DeleteCname, consulte exclua-cname.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AccessDenied

403

Você não tem as permissões necessárias para chamar a operação DeleteCname. Somente o proprietário do bucket e usuários do RAM com a permissão oss:DeleteCname podem excluir registros CNAME mapeados ao bucket.

NoSuchCname

404

Não há registro CNAME mapeado ao bucket.