GetCnameToken - Récupérer un jeton CNAME existant - Object Storage Service

L'opération GetCnameToken récupère un jeton CNAME existant. Utilisez le paramètre wildcard pour indiquer si vous souhaitez obtenir le jeton associé à un CNAME exact ou à un CNAME générique (wildcard).

Notes d'utilisation

Pour un Agentic Bucket, le paramètre wildcard est obligatoire : la valeur wildcard=true permet de récupérer le jeton d'un CNAME générique, tandis que wildcard=false récupère celui d'un CNAME exact. Pour un bucket standard, l'omission de ce paramètre entraîne l'application de la valeur par défaut false.
Pour obtenir le jeton d'un CNAME générique, définissez le paramètre cname avec le nom de domaine de base, sans le préfixe *. (par exemple, example.com).

Syntaxe de la requête

GET /?cname&comp=token&cname=example.com&wildcard=true HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

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

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

cname

String

Oui

example.com

Nom de domaine cible. Pour un CNAME exact, indiquez le nom de domaine complet (par exemple, console.example.com). Pour un CNAME générique, spécifiez le nom de domaine de base sans le préfixe *. (par exemple, example.com).

wildcard

String

Bucket standard : Non

Agentic Bucket : Oui

true

Indique s'il faut récupérer le jeton pour un CNAME générique. Valeurs possibles :

true : récupère le jeton d'un CNAME générique.
false : récupère le jeton d'un CNAME exact.

Ce paramètre est requis pour un Agentic Bucket ; vous devez le définir explicitement sur true ou false. Pour un bucket standard, sa valeur par défaut est false en cas d'omission.

En-têtes de réponse

Cette opération renvoie uniquement les en-têtes de réponse communs. Pour plus de détails, reportez-vous à la section En-têtes HTTP communs.

Éléments de réponse

Élément	Type	Exemple	Description
CnameToken	Container	N/A	Conteneur stockant le jeton CNAME. Nœuds parents : aucun Nœuds enfants : Bucket, Cname, Token et ExpireTime
Bucket	String	examplebucket	Nom du bucket auquel le CNAME est mappé. Nœud parent : CnameToken Nœuds enfants : aucun
Cname	String	example.com	Nom du CNAME mappé. Nœud parent : CnameToken Nœuds enfants : aucun
Token	String	be1d49d863dea9ffeff3df7d6455****	Jeton CNAME renvoyé par OSS. Nœud parent : CnameToken Nœuds enfants : aucun
ExpireTime	String	Wed, 23 Feb 2022 21:16:37 GMT	Date d'expiration du jeton CNAME. Nœud parent : CnameToken Nœuds enfants : aucun

Exemples

Exemples de requêtes

Interroger le jeton CNAME d'un CNAME exact pour un bucket standard

GET /?cname&comp=token&cname=example.com 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

Interroger le jeton CNAME d'un CNAME générique pour un Agentic Bucket

GET /?cname&comp=token&cname=example.com&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

Exemples de réponses

Le jeton CNAME a été récupéré avec succès.

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CnameToken>
  <Bucket>myab-$uid-$region-ab-apsr</Bucket>
  <Cname>example.com</Cname>
  <Token>be1d49d863dea9ffeff3df7d6455****</Token>
  <ExpireTime>Fri, 01 Aug 2026 03:00:00 GMT</ExpireTime>
</CnameToken>

Le jeton CNAME n'a pas été créé ou a expiré.

HTTP/1.1 404 Not Found
x-oss-request-id: 5C1B138A109F4E405B2D
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchCnameToken</Code>
  <Message>The specified cname token does not exist.</Message>
  <RequestId>6215FE05DA0E27393F005F0E</RequestId>
  <HostId>myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com</HostId>
  <Bucket>myab-$uid-$region-ab-apsr</Bucket>
  <Cname>example.com</Cname>
</Error>

Kits SDK OSS

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

ossutil

Pour connaître la commande ossutil correspondant à l'opération GetCnameToken, consultez la documentation relative à get-cname-token.

Codes d'erreur

Code d'erreur	Code d'état HTTP	Description
InvalidArgument	400	Les causes possibles de cette erreur sont les suivantes : Le CNAME à interroger n'a pas été spécifié ou son format est incorrect. L'élément Domain contient des caractères non valides, tels que le littéral générique `*.example.com`. Le paramètre `wildcard` n'est pas indiqué pour un Agentic Bucket, ou sa valeur est invalide.
NoSuchCnameToken	404	Aucun jeton n'a été créé pour ce CNAME, ou le jeton a expiré.
MethodNotAllowed	405	La fonctionnalité CNAME n'est pas activée pour le type de bucket ciblé.