create-cname-token - Object Storage Service - Centre de documentation Alibaba Cloud

Remarque d'utilisation

Par défaut, un compte Alibaba Cloud dispose des permissions nécessaires pour créer un jeton CNAME afin de vérifier la propriété du nom de domaine. La permission oss:CreateCnameToken est requise pour créer un jeton CNAME en tant qu'utilisateur RAM ou via STS. Pour plus d'informations, consultez la rubrique Accorder une politique personnalisée.

Syntaxe de la commande

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

Paramètre

Type

Description

--bucket

string

Nom du bucket cible.

--cname-configuration

string

Conteneur de configuration CNAME.

--wildcard

bool

Indique si l'opération porte sur un CNAME de domaine générique (wildcard). 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 create-cname-token correspond à l'opération API CreateCnameToken. Pour plus d'informations sur les paramètres, consultez la rubrique CreateCnameToken.
L'option --wildcard sert aux opérations CNAME sur 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

Créez un jeton CNAME pour vérifier la propriété du nom de domaine personnalisé example.com mappé 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 create-cname-token --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 create-cname-token --bucket examplebucket --cname-configuration file://cname-configuration.json

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

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

Créez un jeton CNAME pour vérifier la propriété du domaine de base example.com d'un domaine générique associé à l'Agentic Bucket myab-$uid-$region-ab-apsr.

Utilisez des paramètres de configuration JSON. Exemple de commande :
```
ossutil api create-cname-token --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard=true
```