TransformClientId - IoT Platform - Centre de documentation Alibaba Cloud

Spécifiez un ClientID valide pour un appareil en possédant plusieurs afin de prévenir les connexions non autorisées. Cette opération s'applique à l'authentification par certificat unique par produit sans pré-enregistrement.

Notes d'utilisation

Appelez l'opération QueryClientIds pour consulter les ClientIDs d'un appareil.

Limites

Chaque compte Alibaba Cloud peut exécuter au maximum 10 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	TransformClientId	Opération à effectuer. Définissez la valeur sur TransformClientId.
ClientId	String	Yes	9rSz********UNMWj33f000112	ClientID de l'appareil.
IotId	String	Yes	BXPV9Ks3bxwM9fD****0000101	ID de l'appareil.
IotInstanceId	String	No	iot-02****43	ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. À défaut, l'appel échoue. Si votre instance ne dispose pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre. Pour plus d'informations, consultez Overview.

Outre les paramètres de requête spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lors de l'appel. Pour plus d'informations, consultez Paramètres de requête communs.

Paramètres de la réponse

Parameter	Type	Example	Description
Code	String	Success	Code de réponse. La valeur Success indique que l'appel a réussi. Les autres valeurs indiquent des erreurs. Pour plus d'informations, consultez Codes d'erreur.
ErrorMessage	String	request parameter error	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	89F22330-BAEE-**-**-41BA46D6E267	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=TransformClientId
&ClientId=9rSz********UNMWj33f000112
&IotId=BXPV9Ks3bxwM9fD****0000101
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

<TransformClientIdResponse>
  <RequestId>89F22330-BAEE-****-****-41BA46D6E267</RequestId>
  <Code>Success</Code>
  <Success>true</Success>
</TransformClientIdResponse>

Format JSON

{
    "RequestId": "89F22330-BAEE-****-****-41BA46D6E267",
    "Code": "Success",
    "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.