DeleteCname - Unmap a custom domain name from a bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

A operação DeleteCname remove o mapeamento de um nome de domínio personalizado (CNAME) de um bucket. Esta operação é idempotente: se o CNAME especificado não estiver mapeado ao bucket, ela ainda retorna HTTP 200 sem erros. Para um Agentic Bucket, você deve usar o parâmetro wildcard para especificar explicitamente se deseja remover o mapeamento de um CNAME exato ou de um CNAME curinga.

Notas de uso

Ao chamar a operação DeleteCname em um Agentic Bucket, o parâmetro wildcard é obrigatório: wildcard=true remove o mapeamento de um CNAME curinga, enquanto wildcard=false remove o mapeamento de um CNAME exato.
Para remover o mapeamento de um CNAME exato de um bucket padrão, chame esta operação exatamente da mesma forma que as operações de CNAME do OSS existentes. Nenhum novo parâmetro é necessário.

Sintaxe da solicitação

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

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Nota

O parâmetro wildcard distingue o tipo de CNAME a ser removido. Para um Agentic Bucket, esse parâmetro é obrigatório. Defina-o explicitamente como true ou false. Em um bucket padrão, caso você omita esse parâmetro, o valor assumirá false por padrão.

Cabeçalhos da solicitação

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

wildcard

String

Bucket padrão: Não

Agentic Bucket: Sim

true

Especifica se deve ser removido o mapeamento de um CNAME curinga. Valores válidos:

true: remove o mapeamento de um CNAME curinga.
false: remove o mapeamento de um CNAME exato.

Para um Agentic Bucket, este parâmetro é obrigatório. Defina-o explicitamente como true ou false. Em um bucket padrão, caso você omita este parâmetro, o valor assumirá false por padrão.

O parâmetro wildcard aceita valores diferentes para cada tipo de bucket:

Tipo de bucket	Parâmetro omitido	wildcard=false	wildcard=true
Bucket padrão	Remove o mapeamento de um CNAME exato	Remove o mapeamento de um CNAME exato	Não permitido
Agentic Bucket	Não permitido	Remove o mapeamento de um CNAME exato do Agentic Bucket	Remove o mapeamento de um CNAME curinga

Nota

Em um Agentic Bucket, o mesmo nome de domínio base pode ter um CNAME exato e um CNAME curinga mapeados simultaneamente. Especifique o parâmetro wildcard explicitamente para identificar qual CNAME deve ter seu mapeamento removido.

Elementos da solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
BucketCnameConfiguration	Container	Sim	N/A	O container que armazena a configuração do CNAME. Nós pai: nenhum Nós filho: Cname
Cname	Container	Sim	N/A	O container que armazena as informações do CNAME. Nós pai: BucketCnameConfiguration Nós filho: Domain
Domain	String	Sim	example.com	O nome de domínio personalizado. Para remover o mapeamento de um CNAME exato, defina este elemento com o nome de domínio completo, como console.example.com. Para remover o mapeamento de um CNAME curinga, defina este elemento com o nome de domínio base sem o prefixo `*.`, como example.com. Nós pai: Cname Nós filho: nenhum

Cabeçalhos da resposta

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

Exemplos

Exemplos de solicitações

Remover o mapeamento de um CNAME exato de um bucket padrã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>

Remover o mapeamento de um CNAME curinga de um Agentic Bucket

POST /?cname&comp=delete&wildcard=true HTTP/1.1
Host: myab-$uid-$region-ab-apsr.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>

Remover o mapeamento de um CNAME exato de um Agentic Bucket

POST /?cname&comp=delete&wildcard=false HTTP/1.1
Host: myab-$uid-$region-ab-apsr.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>console.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: 0
Connection: keep-alive
Server: AliyunOSS

SDKs do OSS

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

ossutil

Para obter informações sobre o comando ossutil correspondente à operação DeleteCname, consulte delete-cname.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
InvalidArgument	400	Causa possível: O elemento Domain contém caracteres inválidos, como o literal curinga `*.example.com`.
MalformedXML	400	O formato do corpo da solicitação é inválido.
AccessDenied	403	Você não tem permissões para chamar a operação DeleteCname. Apenas o proprietário do bucket e os usuários que receberam a permissão `oss:DeleteCname` podem remover o mapeamento dos CNAMEs associados ao bucket atual.
MethodNotAllowed	405	O recurso de CNAME não está ativado para o tipo de bucket de destino.