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

Asocia un analizador sintáctico con un destino de datos.

Notas de uso

Antes de llamar a esta operación, ejecute la operación CreateDestination para crear un destino de datos y la operación CreateParser para crear un analizador sintáctico.

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. Para mayor comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer, ya que genera de forma dinámica el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	AttachDestination	Operación que desea ejecutar. Establezca el valor en AttachDestination.
DestinationId	Long	Sí	1002	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.
IsFailover	Boolean	Sí	false	Indica si el destino de datos reenvía datos de operaciones con errores. Estos datos son aquellos cuyo reenvío falló y que se volvieron a enviar a otros servicios de Alibaba Cloud. true: reenvía los datos de operaciones con errores. false: reenvía datos normales en lugar de datos de operaciones con errores. Valor predeterminado: false.
ParserId	Long	Sí	1000	ID del analizador sintáctico. Llame a la operación ListParser para consultar los analizadores sintácticos y obtener el ID del analizador sintáctico.
IotInstanceId	String	No	iot-2w****	ID de la instancia. Consulte el ID de la instancia en la página descripción general 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 descripción general ni ningún ID para su instancia, no es necesario configurar este parámetro. Para más información, consulte Descripción general.

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

Parámetros de respuesta

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

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=AttachDestination
&DestinationId=1002
&IsFailover=false
&ParserId=1000
&<Common request parameters>

Respuestas de ejemplo exitosas

Formato XML

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

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.IllegalRequest	The request parameter is invalid.	Mensaje de error que se devuelve porque el parámetro de solicitud no es válido.
400	iot.system.SystemException	An internal error occurred. Try again later.	Mensaje de error que se devuelve porque ocurrió una excepción del sistema.
400	iot.rule.destinationNotExists	Destination not found	Mensaje de error que se devuelve porque el destino de datos especificado no existe.

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