UpdateDestination - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Après avoir appelé l'opération CreateDestination pour créer une destination de données, utilisez le DestinationId renvoyé pour mettre à jour les informations de la destination.

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 la signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateDestination	L'opération que vous souhaitez effectuer. Définissez la valeur sur UpdateDestination.
Configuration	String	Yes	{"topic":"/a1POX0c****/device1/user/get","topicType":1}	La configuration de la destination de données au format JSON. La configuration varie en fonction du type d'action de règle. Pour plus d'informations, consultez la description du paramètre Configuration dans la rubrique CreateDestination.
DestinationId	Long	Yes	1002	ID de la destination de données. Appelez l'opération ListDestination pour interroger les destinations de données et obtenir l'ID de la destination de données.
Name	String	Yes	DataPurpose	Nom de la destination de données.
Type	String	Yes	REPUBLISH	Type d'action de règle à appliquer aux données. Valeurs valides : REPUBLISH : transfère les données de topic traitées par l'analyseur vers un topic de communication IoT Platform. AMQP : transfère les données de topic traitées par l'analyseur vers un groupe de consommateurs Advanced Message Queuing Protocol (AMQP). DATAHUB : transfère les données de topic traitées par l'analyseur vers Alibaba Cloud DataHub pour le calcul de flux. ONS : transfère les données de topic traitées par l'analyseur vers Message Queue for Apache RocketMQ pour la distribution de messages. MNS : transfère les données de topic traitées par l'analyseur vers Message Service (MNS) pour la transmission de messages. FC : transfère les données de topic traitées par l'analyseur vers Function Compute pour le calcul événementiel. OTS : transfère les données de topic traitées par l'analyseur vers Tablestore (OTS) pour le stockage de données NoSQL.
IotInstanceId	String	No	iot-2w****	ID de l'instance. Vous pouvez afficher l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier pour ce paramètre. Sinon, l'appel échouera. Si aucune page Overview ou aucun ID n'est généré pour votre instance, vous n'avez pas besoin de spécifier ce paramètre. Pour plus d'informations, consultez Overview.
Description	String	No	The data that is forwarded to another topic.	Description de la destination de données.

En plus des 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 à cette opération. Pour plus d'informations, consultez Paramètres communs.

Paramètres de 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 la requête.
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=UpdateDestination
&Configuration={"topic":"/a1POX0c****/device1/user/get","topicType":1}
&DestinationId=1002
&Name=DataPurpose
&Type=REPUBLISH
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

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

Format JSON

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

Codes d'erreur

HttpCode	Error code	Error message	Description
400	iot.system.SystemException	An internal error occurred. Try again later.	Une exception système s'est produite.
400	iot.ruleng.NullRuleActionConfig	The rule action configuration is empty.	Aucune action n'est spécifiée pour la règle.
400	iot.common.InvalidFormattedParameter	The parameter format is invalid.	Le format du paramètre est incorrect.

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