QueryToken - - Centre de documentation Alibaba Cloud

Scénarios

Un serveur d’application appelle cette opération pour vérifier la validité d’un jeton. Pour en savoir plus, consultez la rubrique Présentation de l’authentification par jeton.

Limites

Un utilisateur peut envoyer jusqu’à 100 requêtes par seconde. Pour augmenter cette limite, rejoignez le groupe DingTalk 35228338 afin de contacter l’assistance technique ApsaraMQ forMQTT.

Remarque

Chaque appel réussi à l’opération

QueryToken

est comptabilisé comme une transaction de message par seconde (TPS). Cet appel est donc facturé. Pour en savoir plus, consultez la rubrique

Facturation

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Nous vous recommandons d’appeler cette opération dans OpenAPI Explorer par souci de simplicité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryToken	L’opération à effectuer. Définissez la valeur sur QueryToken.
Token	String	Oui	LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng==	Le jeton à interroger.
InstanceId	String	Oui	post-cn-0pp12gl****	L’ID de l’instance ApsaraMQ forMQTT. La valeur doit correspondre à l’ID d’instance utilisé par le client ApsaraMQ forMQTT. Vous pouvez obtenir l’ID d’instance sur la page Instance Details dans la console ApsaraMQ forMQTT.

Remarque

Pour en savoir plus sur les paramètres, consultez les rubriques

Paramètres communs

et

Endpoints

.

Paramètres de réponse

Paramètre

Type

Exemple

Description

TokenStatus

Boolean

true

Le statut du jeton interrogé. Valeurs possibles :

true : le jeton est valide.
false : le jeton n’est pas valide.

RequestId

String

5C8AADD0-6A95-436D-AFA0-3405CCE3****

L’ID de la requête. Ce paramètre est commun à toutes les requêtes. Chaque requête possède un ID unique.

Exemples

Exemples de requêtes

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=QueryToken
&InstanceId=post-cn-0pp12gl****
&RegionId=cn-hangzhou
&Token=LzMT+XLFl5s/YWJ/MlDz4t/Lq5HC1iGU1P28HAMaxYxn8aQbALNtml7QZKl9L9kPe6LqUb95tEVo+zUqOogs9+jZwDUSzsd4X4qaD3n2TrBEuMOqKkk1Xdrvu9VBQQvIYbz7MJWZDYC3DlW7gLEr33Cuj54iIhagtBi3epStJitsssWs7otY9zhKOSZxhr49G3d0bh35mwyP18EMvDas8UlzeSozsSrujNUqZXOGK0PEBSd+rWMGDJlCt6GFmJgm2JFY7PJwf/7OOSmUYIYFs5o/PuPpoTMF+hcVXMs+0yDukIMTOzG9m3t8k36PVrghFmnK6pC3Rt3mibjW****ng==
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryTokenResponse>
<RequestId>5C8AADD0-6A95-436D-AFA0-3405CCE3****</RequestId>
<TokenStatus>true</TokenStatus>
</QueryTokenResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "5C8AADD0-6A95-436D-AFA0-3405CCE3****",
  "TokenStatus" : true
}

Codes d’erreur

HttpCode	Code d’erreur	Message d’erreur	Description
400	CheckAccountInfoFailed	An error occurred while checking the account information by the STS token.	Échec de l’analyse des informations de compte du jeton Security Token Service (STS).
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	Échec de la vérification des autorisations de l’instance. Vérifiez la propriété et la politique d’autorisation de l’instance ApsaraMQ forMQTT.
400	ParameterCheckFailed	An error occurred while validating the parameters. The parameters may be missing or invalid.	Échec de la vérification du paramètre. Le paramètre est peut-être manquant ou non valide.
400	PermissionCheckFailed	An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.	Échec de la vérification des autorisations de ressource. Vérifiez les autorisations et les politiques d’autorisation de l’instance, du topic et de l’ID de groupe.
400	QueryTokenOverFlow	You have queried tokens too many times. Please try again later.	Interrogations de jetons trop fréquentes : le système a déclenché une limitation du débit. Réessayez ultérieurement.
400	InvalidParameter.%s	An error occurred while validating the parameter. The parameter may be missing or invalid.	Échec de la vérification du paramètre. Le paramètre est peut-être manquant ou non valide.
500	InternalError	An error occurred while processing your request. Try again later.	Erreur de service backend sur l’instance ApsaraMQ forMQTT. Réessayez.
500	SystemOverFlow	An error occurred while processing your request. Please try again.	Limitation du débit déclenchée. Réessayez.
404	ApiNotSupport	The specified API is not supported.	L’opération API n’est pas prise en charge.

Pour obtenir la liste des codes d’erreur, consultez la rubrique Codes d’erreur de service.