RefreshDeviceCredential - - Centre de documentation Alibaba Cloud

Limites

Vous pouvez appeler cette 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. Pour plus d'informations, consultez la section Limites QPS.

Remarque

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

Débogage

OpenAPI Explorer calcule automatiquement la valeur de 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	RefreshDeviceCredential	L'opération à effectuer. Définissez la valeur sur RefreshDeviceCredential.
ClientId	String	Oui	GID_test@@@test	L'ID client de l'appareil dont vous souhaitez mettre à jour 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 sections 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'AccessKey ID de l'appareil.
DeviceAccessKeySecret	String	DC.BJMkn4eMQJK2vaApTS****	L'AccessKey Secret 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-D1DBDC0F****	L'ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

<RefreshDeviceCredentialResponse>
  <RequestId>E4581CCF-62AF-44D9-B5B4-D1DBDC0F****</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>
</RefreshDeviceCredentialResponse>

Format JSON

{
    "RequestId": "E4581CCF-62AF-44D9-B5B4-D1DBDC0F****",
    "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 jetons ont été demandés trop fréquemment, déclenchant 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 sur l'instance ApsaraMQ for MQTT pour votre compte. 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 principal 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. Le paramètre 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 sur les ressources spécifiées pour votre compte. 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. Le paramètre est peut-être manquant ou invalide.

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