GetDeviceCredential - - Centre de documentation Alibaba Cloud

Limites

Vous pouvez appeler cette opération API jusqu'à 500 fois par seconde et par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limites de QPS.

Remarque

Les appels réussis à l'opération GetDeviceCredential sont facturés. Chaque appel réussi augmente le nombre de transactions par seconde (TPS) d'une unité. Pour plus d'informations, consultez la rubrique Facturation.

Débogage

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

Paramètres de la requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	GetDeviceCredential	L'opération à effectuer. Définissez la valeur sur GetDeviceCredential.
ClientId	String	Oui	GID_test@@@test	L'ID client de l'appareil dont vous souhaitez récupérer les identifiants d'accès.
InstanceId	String	Oui	post-cn-0pp12gl****	L'ID de l'instance ApsaraMQ for MQTT. La valeur doit correspondre à l'ID d'instance utilisé par le client ApsaraMQ for MQTT. Vous pouvez obtenir l'ID d'instance sur la page Instance Details de la console ApsaraMQ for MQTT.
RegionId	String	Oui	cn-hangzhou	L'ID de région de l'instance ApsaraMQ for MQTT.

Remarque

Pour plus d'informations sur les paramètres, consultez les rubriques Paramètres communs et Endpoints.

Paramètres de la réponse

Paramètre	Type	Exemple	Description
DeviceCredential	Struct		Les identifiants d'accès de l'appareil.
ClientId	String	GID_test@@@test	L'ID client de l'appareil.
CreateTime	Long	1605541382000	L'horodatage de création des identifiants d'accès de l'appareil. Unité : millisecondes.
DeviceAccessKeyId	String	DC.Z5fXh9sRRVufyLi6wo****	L'ID AccessKey de l'appareil.
DeviceAccessKeySecret	String	DC.BJMkn4eMQJK2vaApTS****	Le secret AccessKey de l'appareil.
InstanceId	String	post-cn-0pp12gl****	L'ID de l'instance ApsaraMQ for MQTT.
UpdateTime	Long	1605541382000	L'horodatage de la dernière mise à jour des identifiants d'accès de l'appareil. Unité : millisecondes.
RequestId	String	E4581CCF-62AF-44D9-B5B4-D1DQDC0E****	L'ID de la requête.

Exemples

Exemples de requêtes

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=GetDeviceCredential
&ClientId=GID_test@@@test
&InstanceId=post-cn-0pp12gl****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemples de réponses réussies

Format XML

<GetDeviceCredentialResponse>
  <RequestId>E4581CCF-62AF-44D9-B5B4-D1DQDC0E****</RequestId>
  <DeviceCredential>
        <InstanceId>post-cn-0pp12gl****</InstanceId>
        <DeviceAccessKeySecret>DC.BJMkn4eMQJK2vaApTS****</DeviceAccessKeySecret>
        <CreateTime>1605541382000</CreateTime>
        <UpdateTime>1605541382000</UpdateTime>
        <DeviceAccessKeyId>DC.Z5fXh9sRRVufyLi6wo****</DeviceAccessKeyId>
        <ClientId>GID_test@@@test</ClientId>
  </DeviceCredential>
</GetDeviceCredentialResponse>

Format JSON

{
    "RequestId": "E4581CCF-62AF-44D9-B5B4-D1DQDC0E****",
    "DeviceCredential": {
        "InstanceId": "post-cn-0pp12gl****",
        "DeviceAccessKeySecret": "DC.BJMkn4eMQJK2vaApTS****",
        "CreateTime": 1605541382000,
        "UpdateTime": 1605541382000,
        "DeviceAccessKeyId": "DC.Z5fXh9sRRVufyLi6wo****",
        "ClientId": "GID_test@@@test"
    }
}

Codes d'erreur

HttpCode	Code d'erreur	Message d'erreur	Description
404	ApiNotSupport	The specified API is not supported.	L'opération n'est pas prise en charge.
400	ApplyTokenOverFlow	You have applied for tokens too many times. Please try again later.	Des demandes de jetons trop fréquentes ont déclenché la limitation du débit. Réessayez ultérieurement.
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 votre compte sur l'instance ApsaraMQ for MQTT. Vérifiez la propriété et la stratégie d'autorisation de l'instance.
500	InternalError	An error occurred while processing your request. Try again later.	Le service backend de l'instance ApsaraMQ for MQTT est anormal. Réessayez.
400	ParameterCheckFailed	An error occurred while validating the parameters. The parameters may be missing or invalid.	Échec de la vérification du paramètre. Celui-ci est peut-être manquant ou invalide.
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 votre compte sur les ressources spécifiées. Vérifiez la propriété et les stratégies d'autorisation de l'instance, du sujet (topic) et du groupe spécifiés.
500	SystemOverFlow	An error occurred while processing your request. Please try again.	La limitation du débit a été déclenchée. Réessayez.
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. Celui-ci est peut-être manquant ou invalide.

Pour obtenir la liste des codes d'erreur, visitez le centre API Error Center.