UpdateDestination - IoT Platform - Centro de documentación de Alibaba Cloud

Actualice el nombre, el tipo de operación y la descripción de un destino de datos.

Notas de uso

Después de llamar a la operación CreateDestination para crear un destino de datos, utilice el valor DestinationId devuelto para actualizar la información del destino.

Límites de QPS

Cada cuenta de Alibaba Cloud puede ejecutar hasta 10 consultas por segundo (QPS).

Nota

Los usuarios de RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Se recomienda llamar a esta operación desde OpenAPI Explorer, ya que genera de forma dinámica código de ejemplo para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	UpdateDestination	La operación que desea ejecutar. Establezca el valor en UpdateDestination.
Configuration	String	Sí	{"topic":"/a1POX0c****/device1/user/get","topicType":1}	La configuración del destino de datos en formato JSON. Esta configuración varía según el tipo de acción de la regla. Para obtener más información, consulte la descripción del parámetro Configuration en el tema CreateDestination.
DestinationId	Long	Sí	1002	El ID del destino de datos. Llame a la operación ListDestination para consultar los destinos de datos y obtener el ID del destino de datos.
Name	String	Sí	DataPurpose	El nombre del destino de datos.
Type	String	Sí	REPUBLISH	El tipo de acción de regla que se ejecuta sobre los datos. Valores válidos: REPUBLISH: reenvía los datos del tema procesados por el analizador sintáctico a un tema de comunicación de IoT Platform. AMQP: reenvía los datos del tema procesados por el analizador sintáctico a un grupo de consumidores de Advanced Message Queuing Protocol (AMQP). DATAHUB: reenvía los datos del tema procesados por el analizador sintáctico a Alibaba Cloud DataHub para computación de flujos. ONS: reenvía los datos del tema procesados por el analizador sintáctico a Message Queue for Apache RocketMQ para distribuir mensajes. MNS: reenvía los datos del tema procesados por el analizador sintáctico a Message Service (MNS) para transmitir mensajes. FC: reenvía los datos del tema procesados por el analizador sintáctico a Function Compute para computación de eventos. OTS: reenvía los datos del tema procesados por el analizador sintáctico a Tablestore (OTS) para almacenamiento de datos NoSQL.
IotInstanceId	String	No	iot-2w****	El ID de la instancia. Consulte el ID de la instancia en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, especifíquelo en este parámetro. De lo contrario, la llamada falla. Si no se generó ninguna página Overview ni ningún ID para su instancia, no es necesario especificar este parámetro. Para obtener más información, consulte Descripción general.
Description	String	No	Los datos que se reenvían a otro tema.	La descripción del destino de datos.

Además de los parámetros de solicitud específicos de la operación, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.system.SystemException	El código de error que se devuelve si la llamada falla. Para obtener más información, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error que se devuelve si la solicitud falla.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	El ID de la solicitud.
Success	Boolean	true	Indica si la llamada fue exitosa. true: la llamada fue exitosa. false: la llamada finalizó con errores.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas de ejemplo exitosas

Formato XML

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

Formato JSON

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

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	iot.system.SystemException	An internal error occurred. Try again later.	El mensaje de error que se devuelve porque ocurrió una excepción del sistema.
400	iot.ruleng.NullRuleActionConfig	The rule action configuration is empty.	El mensaje de error que se devuelve porque no se especificó ninguna acción para la regla.
400	iot.common.InvalidFormattedParameter	The parameter format is invalid.	El mensaje de error que se devuelve porque el formato del parámetro no es válido.

Para consultar la lista de códigos de error, visite el centro de errores de API.