DeleteCname - Unmap a custom domain name from a bucket - Object Storage Service

L'opération DeleteCname dissocie un nom de domaine personnalisé (CNAME) d'un bucket. Cette opération est idempotente : si le CNAME spécifié n'est pas associé au bucket, elle renvoie tout de même un code HTTP 200 sans erreur. Pour un Agentic Bucket, vous devez utiliser le paramètre wildcard pour indiquer explicitement si vous souhaitez dissocier un CNAME exact ou un CNAME générique.

Notes d'utilisation

Lorsque vous appelez DeleteCname sur un Agentic Bucket, le paramètre wildcard est obligatoire : wildcard=true dissocie un CNAME générique, tandis que wildcard=false dissocie un CNAME exact.
Pour dissocier un CNAME exact d'un bucket standard, appelez cette opération exactement comme pour les opérations CNAME OSS existantes. Aucun nouveau paramètre n'est requis.

Syntaxe de la requête

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>

Remarque

Le paramètre wildcard permet de distinguer le type de CNAME à dissocier. Pour un Agentic Bucket, ce paramètre est obligatoire. Définissez-le explicitement sur true ou false. Pour un bucket standard, si vous omettez ce paramètre, sa valeur par défaut est false.

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

wildcard

String

Bucket standard : Non

Agentic Bucket : Oui

true

Indique s'il faut dissocier un CNAME générique. Valeurs valides :

true : dissocie un CNAME générique.
false : dissocie un CNAME exact.

Pour un Agentic Bucket, ce paramètre est obligatoire. Définissez-le explicitement sur true ou false. Pour un bucket standard, si vous omettez ce paramètre, sa valeur par défaut est false.

Le paramètre wildcard prend des valeurs différentes selon le type de bucket :

Type de bucket

Paramètre omis

wildcard=false

wildcard=true

Bucket standard

Dissocie un CNAME exact

Non autorisé

Agentic Bucket

Non autorisé

Dissocie un CNAME exact de l'Agentic Bucket

Dissocie un CNAME générique

Remarque

Pour un Agentic Bucket, le même nom de domaine de base peut avoir simultanément un CNAME exact et un CNAME générique associés. Spécifiez explicitement le paramètre wildcard pour identifier le CNAME à dissocier.

Éléments de requête

Élément	Type	Obligatoire	Exemple	Description
BucketCnameConfiguration	Container	Oui	N/A	Conteneur qui stocke la configuration du CNAME. Nœuds parents : aucun Nœuds enfants : Cname
Cname	Container	Oui	N/A	Conteneur qui stocke les informations du CNAME. Nœuds parents : BucketCnameConfiguration Nœuds enfants : Domain
Domain	String	Oui	example.com	Nom de domaine personnalisé. Pour dissocier un CNAME exact, définissez cet élément sur le nom de domaine complet, par exemple `console.example.com`. Pour dissocier un CNAME générique, définissez cet élément sur le nom de domaine de base sans le préfixe `*.`, par exemple `example.com`. Nœuds parents : Cname Nœuds enfants : aucun

En-têtes de réponse

Cette opération renvoie uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Exemples

Exemples de requêtes

Dissocier un CNAME exact d'un bucket standard

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>

Dissocier un CNAME générique d'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>

Dissocier un CNAME exact d'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>

Exemple de réponse

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 OSS

Les SDK OSS suivants prennent en charge l'opération DeleteCname :

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération DeleteCname, consultez la section delete-cname.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

InvalidArgument

400

Cause possible :

L'élément Domain contient des caractères non valides, tels que le littéral générique *.example.com.

MalformedXML

400

Le format du corps de la requête n'est pas valide.

AccessDenied

403

Vous ne disposez pas des autorisations nécessaires pour appeler l'opération DeleteCname. Seul le propriétaire du bucket et les utilisateurs auxquels l'autorisation oss:DeleteCname a été accordée peuvent dissocier les CNAME associés au bucket actuel.

MethodNotAllowed

405

La fonctionnalité CNAME n'est pas activée pour le type de bucket cible.