AttachDestination - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant d'appeler cette opération, appelez l'opération CreateDestination pour créer une destination de données, puis l'opération CreateParser pour créer un analyseur.

Limites de QPS

Chaque compte Alibaba Cloud peut exécuter jusqu'à 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. Il 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	AttachDestination	Opération à effectuer. Définissez la valeur sur AttachDestination.
DestinationId	Long	Yes	1002	ID de la destination de données. Appelez l'opération ListDestination pour répertorier les destinations de données et obtenir l'ID de la destination de données.
IsFailover	Boolean	Yes	false	Indique si la destination de données transfère les données d'opérations ayant échoué. Il s'agit des données dont le transfert a échoué et qui sont retransférées vers d'autres services Alibaba Cloud. true : transfère les données d'opérations ayant échoué. false : transfère les données normales au lieu des données d'opérations ayant échoué. Valeur par défaut : false.
ParserId	Long	Yes	1000	ID de l'analyseur. Appelez l'opération ListParser pour répertorier les analyseurs et obtenir l'ID de l'analyseur.
IotInstanceId	String	No	iot-2w****	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 spécifier cet ID pour ce paramètre. Sinon, l'appel échoue. Si aucune page Overview ni aucun ID n'est généré pour votre instance, vous n'avez pas besoin de configurer ce paramètre. Pour plus d'informations, consultez Overview.

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

Paramètres de la réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	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=AttachDestination
&DestinationId=1002
&IsFailover=false
&ParserId=1000
&<Common request parameters>

Exemple de réponse réussie

Format XML

<AttachDestinationResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Success>true</Success>
</AttachDestinationResponse>

Format JSON

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Success": true
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	iot.system.IllegalRequest	The request parameter is invalid.	Le paramètre de requête n'est pas valide.
400	iot.system.SystemException	An internal error occurred. Try again later.	Une exception système s'est produite.
400	iot.rule.destinationNotExists	Destination not found	La destination de données spécifiée n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.