DeleteCname - Object Storage Service - Centro de documentación de Alibaba Cloud

DeleteCname desasigna un nombre de dominio personalizado (CNAME) de un bucket. Esta operación es idempotente: si el CNAME especificado no está asignado al bucket, devuelve HTTP 200 sin ningún error. Para un Agentic Bucket, debe usar el parámetro wildcard para especificar explícitamente si desea desasignar un CNAME exacto o un CNAME comodín.

Notas de uso

Cuando llama a DeleteCname en un Agentic Bucket, el parámetro wildcard es obligatorio: wildcard=true desasigna un CNAME comodín y wildcard=false desasigna un CNAME exacto.
Para desasignar un CNAME exacto de un bucket estándar, llame a esta operación exactamente igual que las operaciones CNAME existentes de OSS. No se requieren parámetros nuevos.

Sintaxis de la solicitud

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

El parámetro wildcard distingue el tipo de CNAME que se va a desasignar. Este parámetro es obligatorio para un Agentic Bucket. Establézcalo explícitamente en true o false. En un bucket estándar, si omite este parámetro, el valor predeterminado es false.

Encabezados de la solicitud

Esta operación solo utiliza los encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP headers.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

wildcard

String

Bucket estándar: No

Agentic Bucket: Sí

true

Indica si se desasigna un CNAME comodín. Valores válidos:

true: desasigna un CNAME comodín.
false: desasigna un CNAME exacto.

Este parámetro es obligatorio para un Agentic Bucket. Establézcalo explícitamente en true o false. En un bucket estándar, si omite este parámetro, el valor predeterminado es false.

El parámetro wildcard toma valores distintos según el tipo de bucket:

Tipo de bucket	Parámetro omitido	wildcard=false	wildcard=true
Bucket estándar	Desasigna un CNAME exacto.	Desasigna un CNAME exacto.	—
Agentic Bucket	No permitido	Desasigna un CNAME exacto del Agentic Bucket.	Desasigna un CNAME comodín.

Nota

En un Agentic Bucket, el mismo nombre de dominio base puede tener un CNAME exacto y un CNAME comodín asignados al mismo tiempo. Especifique el parámetro wildcard de forma explícita para identificar qué CNAME se va a desasignar.

Elementos de la solicitud

Elemento	Tipo	Obligatorio	Ejemplo	Descripción
BucketCnameConfiguration	Container	Sí	N/A	Contenedor que almacena la configuración de CNAME. Nodos principales: ninguno Nodos secundarios: Cname
Cname	Container	Sí	N/A	Contenedor que almacena la información de CNAME. Nodos principales: BucketCnameConfiguration Nodos secundarios: Domain
Domain	String	Sí	example.com	Nombre de dominio personalizado. Para desasignar un CNAME exacto, establezca este elemento con el nombre de dominio completo, como console.example.com. Para desasignar un CNAME comodín, establezca este elemento con el nombre de dominio base sin el prefijo `*.`, como example.com. Nodos principales: Cname Nodos secundarios: ninguno

Encabezados de la respuesta

Esta operación solo devuelve los encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP headers.

Ejemplos

Ejemplos de solicitudes

Desasignar un CNAME exacto de un bucket estándar

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>

Desasignar un CNAME comodín de un 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>

Desasignar un CNAME exacto de un 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>

Ejemplo de respuesta

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

SDK de OSS

A continuación se muestran los SDK de OSS que admiten la operación DeleteCname:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación DeleteCname, consulte delete-cname.

Códigos de error

Código de error	Código de estado HTTP	Descripción
InvalidArgument	400	A continuación se muestran las posibles causas de este error: El elemento Domain contiene caracteres no válidos, como el literal comodín `*.example.com`.
MalformedXML	400	El formato del cuerpo de la solicitud no es válido.
AccessDenied	403	No tiene los permisos necesarios para llamar a la operación DeleteCname. Solo el propietario del bucket y los usuarios con el permiso `oss:DeleteCname` pueden desasignar los CNAME asignados al bucket actual.
MethodNotAllowed	405	La función CNAME no está habilitada para el tipo de bucket de destino.