Delete a CNAME record that is mapped to an OSS bucket. - Object Storage Service

Remarques d'utilisation

Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour supprimer un nom de domaine personnalisé associé à un bucket. L'autorisation oss:DeleteCname est requise pour supprimer un enregistrement CNAME en tant qu'utilisateur RAM ou via STS. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

Syntaxe de la commande

ossutil api delete-cname --bucket value --cname-configuration value --wildcard=value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--cname-configuration

string

Conteneur de configuration CNAME.

--wildcard

bool

Indique s'il faut supprimer un enregistrement CNAME pour un domaine générique. Valeurs valides : true et false. Pour un Agentic Bucket, vous devez définir explicitement ce paramètre sur true ou false. Pour un bucket standard, ce paramètre est facultatif et sa valeur par défaut est false.

Remarque

La commande delete-cname correspond à l'opération API DeleteCname. Pour plus d'informations sur les paramètres, consultez la rubrique DeleteCname.
L'option --wildcard est un nouveau paramètre dédié aux opérations CNAME pour les domaines génériques. Assurez-vous que votre version d'ossutil prend en charge ce paramètre.

--cname-configuration

L'option --cname-configuration accepte les formats XML et JSON. Si la valeur contient le préfixe file://, la configuration est lue depuis un fichier.

Syntaxe XML :

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
  </Cname>
</BucketCnameConfiguration>

Syntaxe JSON :

{
  "Cname": {
    "Domain": "string"
  }
}

Remarque

Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez la rubrique Options de ligne de commande globales.

Exemples

Supprimez le nom de domaine personnalisé example.com associé au bucket examplebucket.

Utilisez un fichier de configuration XML. Le contenu du fichier cname-configuration.xml est le suivant :

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Exemple de commande :

ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml

Utilisez un fichier de configuration JSON. Le contenu du fichier cname-configuration.json est le suivant :

{
  "Cname": {
    "Domain": "example.com"
  }
}

Exemple de commande :

ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json

Utilisez des paramètres de configuration JSON. Exemple de commande :

ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"

Supprimez l'enregistrement CNAME générique pour le domaine example.com (sans le préfixe *.) de l'Agentic Bucket my-uid-region-ab-apsr.
- Utilisez des paramètres de configuration JSON. Exemple de commande :
```
ossutil api delete-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard=true
```