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

A operação DeleteCname desfaz 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, use obrigatoriamente o parâmetro wildcard para especificar explicitamente se deseja desfazer o mapeamento de um CNAME exato ou de um CNAME curinga.

Observações de uso

Ao chamar a operação DeleteCname em um Agentic Bucket, o parâmetro wildcard é obrigatório: wildcard=true desfaz o mapeamento de um CNAME curinga, enquanto wildcard=false desfaz o mapeamento de um CNAME exato.
Para desfazer 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 desmapeado. Para um Agentic Bucket, esse parâmetro é obrigatório. Defina-o explicitamente como true ou false. Em buckets padrão, caso você omita esse parâmetro, o valor padrão será false.

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 desfazer o mapeamento de um CNAME curinga. Valores válidos:

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

Para um Agentic Bucket, este parâmetro é obrigatório. Defina-o explicitamente como true ou false. Em buckets padrão, se você omitir este parâmetro, o valor padrão será false.

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

Tipo de bucket	Parâmetro omitido	wildcard=false	wildcard=true
Bucket padrão	Desfaz o mapeamento de um CNAME exato.	Desfaz o mapeamento de um CNAME exato.	—
Agentic Bucket	Não permitido	Desfaz o mapeamento de um CNAME exato do Agentic Bucket.	Desfaz 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 ser desmapeado.

Elementos da solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
BucketCnameConfiguration	Container	Sim	N/A	O container que armazena a configuração de CNAME. Nós pai: nenhum Nós filho: Cname
Cname	Container	Sim	N/A	O container que armazena as informações de CNAME. Nós pai: BucketCnameConfiguration Nós filho: Domain
Domain	String	Sim	example.com	O nome de domínio personalizado. Para desfazer o mapeamento de um CNAME exato, defina este elemento com o nome de domínio completo, como console.example.com. Para desfazer 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ção

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

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

Desfazer 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 do 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	As possíveis causas deste erro incluem: 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ão para chamar a operação DeleteCname. Apenas o proprietário do bucket e usuários com a permissão `oss:DeleteCname` concedida podem desfazer os mapeamentos de CNAME associados ao bucket atual.
MethodNotAllowed	405	O recurso de CNAME não está ativado para o tipo de bucket de destino.