All Products
Search
Document Center

IoT Platform:Error codes for devices

Last Updated:Aug 18, 2023

This topic describes the error codes that IoT Platform may return to devices.

Common error codes

Table 1 General-purpose error codes

Error code

Cause

Troubleshooting

400

An error occurred when the system processed the request.

Submit a ticket.

429

Traffic throttling is triggered due to frequent requests.

Submit a ticket.

460

The data submitted by the device is empty, the format of the parameter is invalid, or the number of parameters exceeds the limit.

Check the parameters based on the data formats that are described in the Alink protocol topic.

500

An unknown error occurred in IoT Platform.

Submit a ticket.

5005

An error occurred when the system queried the product information.

Check the product information in the IoT Platform console and make sure that the ProductKey is valid.

5244

An error occurred when the system queried the metadata of the LoRaWAN-based product.

Submit a ticket.

6100

An error occurred when the system queried information about the specified device.

Check the device information on the Devices page of the IoT Platform console.

6203

An error occurred when the system parsed the topic.

Submit a ticket.

6250

An error occurred when the system queried the product information.

Check the product information in the IoT Platform console and make sure that the ProductKey is valid.

6204

The specified device is disabled. You cannot perform operations on this device.

Check the device status on the Devices page of the IoT Platform console.

6450

The method parameter is missing after the custom data is parsed to the standard Alink format.

On the Device Log page of the IoT Platform console or in the on-premises log file of the device, check whether the data submitted by the device contains the method parameter.

6760

A system exception occurred.

Submit a ticket.

Table 2 Error codes for data parsing

Error code

Cause

Troubleshooting

26001

The system failed to find a parsing script.

Go to the Data Parsing page in the IoT Platform console and make sure that the script is submitted.

Note

You cannot run scripts that are not submitted.

26002

The script runs as expected, but the script content is invalid. For example, the script contains syntax errors.

Use the same data to test the script. Check the error message and modify the script. We recommend that you test the script on an on-premises device before you submit the script to IoT Platform.

26006

The script runs as expected. However, the script content is invalid. The script must contain the protocolToRawData and rawDataToProtocol methods. If the methods are missing, an error occurs.

Go to the Data Parsing page of the IoT Platform console and check whether the protocolToRawData and rawDataToProtocol methods exist.

26007

The script runs as expected, but the format of the response is invalid. The script must contain the protocolToRawData and rawDataToProtocol methods. The protocolToRawData method must return a byte[] array, and the rawDataToProtocol method must return a JSON object. If the response is not in the required format, an error occurs.

Test the script in the IoT Platform console or on an on-premises device and check whether the format of the response is valid.

26010

Traffic throttling is triggered due to frequent requests.

Submit a ticket.

Table 3 Error codes for Thing Specification Language (TSL) models

Error code

Cause

Troubleshooting

5159

The system failed to query the defined properties when the system verified parameters based on the TSL model.

Submit a ticket.

5160

The system failed to query the defined events when the system verified parameters based on the TSL model.

Submit a ticket.

5161

The system failed to query the defined services when the system verified parameters based on the TSL model.

Submit a ticket.

6207

The Alink data submitted by the device or the data returned after the system parses the custom data is not in the JSON format.

View data formats in the Device properties, events, and services topic, and submit data in the required formats.

6300

The method parameter that is required by the Alink protocol does not exist in the standard Alink data or in the parsed custom data that is submitted by the device.

On the Device Log page of the IoT Platform console or in the on-premises log file of the device, check whether the data submitted by the device contains the method parameter.

6301

If the system verifies parameters based on the TSL model, the data type is specified as an array. However, the type of data submitted by the device is not an array.

Go to the Define Feature tab of the product in the IoT Platform console and check the data type defined in the TSL model. Submit data based on the required data type.

6302

The required input parameters of the service are not specified.

Log on to the IoT Platform console and check the TSL model. Make sure that the required input parameters are specified.

6306

If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The parameter value is not in the defined range.

Log on to the IoT Platform console and check the TSL model. Make sure that the data types of the input parameters are the same as the data types that are defined in the TSL model, and that the parameter values are within the value ranges that are defined in the TSL model.

6307

The input parameters do not comply with the 32-bit floating-point data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The parameter value is not in the defined range.

6308

The input parameters do not comply with the Boolean data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The parameter value is not in the defined range.

6310

The input parameters do not comply with the text data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The length of the parameter exceeds the limit that is defined in the TSL model.

6322

The input parameters do not comply with the 64-bit floating-point data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The parameter value is not in the defined range.

6304

The input parameters do not exist in the structure defined in the TSL model.

Log on to the IoT Platform console and check the TSL model. Make sure that the data types of the input parameters are valid.

6309

The input parameters do not comply with the enumeration data specifications defined in the TSL model.

6311

The input parameters do not comply with the date data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The input data is not a UTC timestamp.

6312

The input parameters do not comply with the structure data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The data types of the input parameters are different from the data types that are defined in the TSL model.

  • The number of parameters that are contained in the structure is different from the number of parameters that are defined in the TSL model.

6320

The specified property cannot be found when the system queries the TSL data of the device.

Log on to the IoT Platform console and check whether the specified property exists in the TSL model. If the property does not exist, add the property.

6321

The identifier of the property, event, or service is not specified.

Submit a ticket.

6317

The parameters required in the TSL model are not configured, such as the type and specs parameters.

Submit a ticket.

6324

The input parameters do not comply with the array data specifications defined in the TSL model. If the system verifies parameters based on the TSL model, the following errors may occur:

  • The elements in the array do not follow the array syntax that is defined in the TSL model.

  • The number of elements in the array exceeds the maximum number that is defined in the TSL model.

  • Go to the product details page of the IoT Platform console. On the Define Feature tab, check the array syntax that is defined in the TSL model.

  • View the upstream message logs to check the number of array elements in the data that is submitted by the device.

6325

The data types of the elements in the array are not supported by IoT Platform. Only the following data types of elements are supported: integer, 32-bit floating-point, 64-bit floating-point, double, text, and structure.

Check whether the data types of the elements are supported by IoT Platform.

6326

The format of the time field submitted by the device is invalid.

View data formats in the Device properties, events, and services topic, and submit data in the required formats.

6328

The value of the input parameter is not an array.

Log on to the IoT Platform console and check the TSL model. Make sure that the data type of the input parameter is array.

6318

A system error occurred when the system parsed the TSL model.

Submit a ticket.

6313

6329

6323

6316

6314

6301

Error codes for device registration

  • Register directly connected devices

    • Request topic: /sys/${productKey}/${deviceName}/thing/sub/register
    • Response topic: /sys/${productKey}/${deviceName}/thing/sub/register_reply

    Error codes: 460, 5005, 5244, 500, 6288, 6100, 6619, 6292, and 6203

    The following table describes the causes of and solutions to the errors that may occur when you register a directly connected device. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6288

    Dynamic registration is disabled for the device.

    Log on to the IoT Platform console and enable dynamic registration on the product details page.

    6619

    The device is bound to another gateway.

    Go to the Device Details tab in the IoT Platform console and check whether the device is bound to a gateway.

  • Dynamically register directly connected devices based on unique-certificate-per-product verification

    Error codes: 460, 6250, 6288, 6600, 6289, 500, and 6292

    The following table describes the causes of and solutions to the errors that may occur when you dynamically register a directly connected device based on unique-certificate-per-product verification. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6288

    Dynamic registration is disabled for the device.

    Log on to the IoT Platform console and enable dynamic registration on the product details page.

    6292

    The algorithm that is used to calculate the signature is not supported by IoT Platform.

    Use an algorithm that is supported by the signMethod parameter. For more information, see Register devices.

    6600

    The system failed to verify the signature.

    Use a supported algorithm to calculate a signature and then verify the signature. For more information, see Register devices.

    6289

    The device is activated.

    Log on to the IoT Platform console and check the status of the device.

Error codes for topological relationships

  • Add topological relationships

    • Request topic: /sys/${productKey}/${deviceName}/thing/topo/add
    • Response topic: /sys/${productKey}/${deviceName}/thing/topo/add_reply

    Error codes: 460, 429, 6402, 6100, 401, 6204, 6400, and 6203

    The following table describes the causes of and solutions to the errors that may occur when you add a topological relationship between a gateway and a sub-device. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    401

    The system failed to verify the signature when you add the topological relationship.

    Use a supported algorithm to calculate a signature and then verify the signature. For more information, see Manage topological relationships.

    6402

    The gateway and sub-device are the same device. When you add a topological relationship, you cannot add the current gateway as its sub-device.

    View information about all existing sub-devices, and check whether the gateway shares the same information with a sub-device.

    6400

    The number of sub-devices that you add to the gateway exceeds the limit.

    Log on to the IoT Platform console and check the number of existing sub-devices of the gateway on the Sub-device Management tab. For more information about the limits, see Limits.

  • Delete topological relationships

    • Request topic: /sys/${productKey}/${deviceName}/thing/topo/delete
    • Response topic: /sys/${productKey}/${deviceName}/thing/topo/delete_reply.

    Error codes: 460, 429, 6100, 6401, and 6203

    The following table describes the cause and solution of the error that may occur when you delete a topological relationship between a gateway and a sub-device. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6401

    The topological relationship does not exist.

    Log on to the IoT Platform console and click Devices in the left-side navigation pane. Then, click the Sub-device Management tab on the Device Details page of the gateway. You can view information about the sub-device.

  • Obtain topological relationships

    • Request topic: /sys/${productKey}/${deviceName}/thing/topo/get
    • Response topic: /sys/${productKey}/${deviceName}/thing/topo/get_reply

    Error codes: 460, 429, 500, and 6203

    For more information about the error codes, see the "Common error codes" section of this topic.

  • A gateway submits information about a detected sub-device

    • Request topic: /sys/${productKey}/${deviceName}/thing/list/found
    • Response topic: /sys/${productKey}/${deviceName}/thing/list/found_reply

    Error codes: 460, 500, 6250, 6280, and 6203

    The following table describes the cause and solution of an error that may occur when a gateway submits information about a detected sub-device. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6280

    The sub-device name submitted by the gateway is invalid. The name must be 4 to 32 characters in length and can contain letters, digits, and underscores (_).

    Check whether the sub-device name submitted by the gateway is valid.

Error codes for sub-device connections and disconnections

  • A sub-device goes online

    Topic to which error messages are sent: /ext/session/{productKey}/{deviceName}/combine/logout_reply

    Error codes: 460, 429, 6100, 6204, 6287, 6401, 500, 9241, and 9240

  • A sub-device goes offline

    Topic to which error messages are sent: /ext/session/{productKey}/{deviceName}/combine/logout_reply

    Error codes: 460, 520, and 500

  • A sub-device is forced to go offline

    Topic to which error messages are sent: /ext/error/{productKey}/{deviceName}

    Error codes: 427, 521, 522, and 6401

  • A sub-device fails to send a message

    Topic to which error messages are sent: /ext/error/{productKey}/{deviceName}

    Error code: 520

  • A gateway fails to submit multiple messages from sub-devices to IoT Platform

    Topic to which error messages are sent: /sys/${productKey}/${deviceName}/proxy/batch_post_reply

    Error code: 9242

The following table describes the causes of and solutions to the errors that may occur when a sub-device goes online or offline. For more information about other error codes, see the "Common error codes" section of this topic.

Error code

Cause

Troubleshooting

427

The device is forced to go offline because the device certificate is used by another device.

IoT Platform identifies a device only based on the device certificate (ProductKey, DeviceName, and DeviceSecret).

  • The same device certificate is burned on multiple devices.

  • The network or power supply of the device is unstable. The device immediately reconnects to IoT Platform after an instantaneous network outage or power failure. In this case, IoT Platform identifies the reconnected device as a new device. Even if an error message is returned, the device can work as expected.

  • Go to the Device Details page in the console and check the time when the device was last connected to IoT Platform. You can determine whether the same device certificate information is used to connect another device to IoT Platform.

  • Check whether the network environment is stable by using one of the following methods:

428

The number of sub-devices that you added to the specified gateway exceeds the limit.

For more information, see Limits.

Check the number of sub-devices that are added to the gateway.

521

The device is deleted.

Go to the Devices page in the IoT Platform console and check whether the device is deleted.

522

The device is disabled.

Check the device status on the Devices page of the IoT Platform console.

520

An error occurred in the session between the sub-device and IoT Platform.

  • The specified session does not exist because the sub-device is not connected to IoT Platform or the sub-device is disconnected from IoT Platform.

  • The session exists, but the session is not established by using the current gateway.

6287

An error occurred when the system verified the signature based on the ProductSecret or DeviceSecret.

Use a supported algorithm to calculate a signature and then verify the signature. For more information, see Connect or disconnect sub-devices.

1914

The number of sub-devices that you want to connect to or disconnect from IoT Platform at the same time exceeds the limit. You can connect or disconnect up to five sub-devices at the same time.

Check whether the number of sub-devices that you want to connect to or disconnect from IoT Platform at the same time exceeds the limit.

1913

The gateway is disconnected from IoT Platform.

Check the reason why the gateway is disconnected from IoT Platform based on logs.

9242

The number of messages that are submitted by the gateway for the sub-devices at a time exceeds the limit, which is 50.

Check whether the number of submitted sub-device messages exceeds the limit.

9241

When you use a gateway to connect a sub-device to IoT Platform, you cannot modify the device type of an online device.

For more information about device types, see the conntype parameter in Connect an MQTT client to IoT Platform.

Check whether the gateway and sub-device are online.

9240

When you connect or disconnect multiple sub-devices, the number of sub-devices in a gateway in status-related mode exceeds the limit, which is 10,000.

Check whether the number of sub-devices that you want to connect to or disconnect from IoT Platform at a time exceeds the limit.

Error codes for properties, events, and services

  • A device submits properties

    • Pass-through data format:

      • Request topic: /sys/{productKey}/{deviceName}/thing/model/up_raw

      • Response topic: /sys/${productKey}/${deviceName}/thing/model/up_raw_reply

    • Alink data format:

      • Request topic: /sys/${productKey}/${deviceName}/thing/event/property/post

      • Response topic: /sys/${productKey}/${deviceName}/thing/event/property/post_reply

    Error codes: 460, 500, 6250, 6203, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006, and 26007

    The following table describes the cause and solution of the error that may occur when a device submits properties. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6106

    The number of properties that are submitted by the device exceeds the limit. A device can submit up to 200 properties at the same time.

    Log on to the IoT Platform console, choose Maintenance > Device Log, and then check the number of properties that are submitted by the device. You can also check the information in the on-premises log file of the device.

  • A device submits events

    • Pass-through data format:

      • Request topic: /sys/{productKey}/{deviceName}/thing/model/up_raw

      • Response topic: /sys/${productKey}/${deviceName}/thing/model/up_raw_reply

    • Alink data format:

      • Default module

        • Request topic: /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post

        • Response topic: /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post_reply

      • Custom module

        • Request topic: /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post

        • Response topic: /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post_reply

    Error codes: 460, 500, 6250, 6203, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006, and 26007

    For more information about the error codes, see the "Common error codes" section of this topic.

  • A gateway submits the data of multiple sub-devices at the same time

    • Pass-through data format:

      • Request topic: /sys/{productKey}/{deviceName}/thing/model/up_raw

      • Response topic: /sys/${productKey}/${deviceName}/thing/model/up_raw_reply

    • Alink data format:

      • Request topic: /sys/${productKey}/${deviceName}/thing/event/property/pack/post

      • Response topic: /sys/${productKey}/${deviceName}/thing/event/property/pack/post_reply

    Error codes: 460, 6401, 6106, 6357, 6356, 6100, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006, and 26007

    The following table describes the causes of and solutions to the errors that may occur when the gateway submits the data of multiple sub-devices at the same time. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6401

    The topological relationship does not exist.

    Go to the Sub-device Management tab in the IoT Platform console and check the information about the sub-device.

    6106

    The number of properties that are submitted by the device exceeds the limit. A device can submit up to 200 properties at the same time.

    Log on to the IoT Platform console, choose Maintenance > Device Log, and then check the number of properties submitted by the device. You can also check the information in the on-premises log file of the device.

    6357

    The amount of data submitted by the gateway exceeds the limit. A gateway can submit the data of up to 20 sub-devices at the same time.

    Check the data records in the on-premises log file of the device.

    6356

    The number of events submitted by the gateway exceeds the limit. A gateway can submit up to 200 events at the same time.

    Check the data records in the on-premises log file of the device.

Error codes that may appear when devices specify desired device property values

  • A device obtains desired property values

    • Request topic: /sys/${productKey}/${deviceName}/thing/property/desired/get
    • Response topic: /sys/${productKey}/${deviceName}/thing/property/desired/get_reply

    Error codes: 460, 6104, 6661, and 500

    The following table describes the causes of and solutions to the errors that may occur when you manage desired device property values. For more information about other error codes, see the "Common error codes" section of this topic.

    Error code

    Cause

    Troubleshooting

    6104

    The number of properties contained in the request exceeds the limit. A request can contain up to 200 properties.

    Log on to the IoT Platform console, choose Maintenance > Device Log, and then check the number of properties in the submitted data. You can also check the information in the on-premises log file of the device.

    6661

    The system failed to query the desired property values. A system exception occurred.

    Submit a ticket.

  • A device clears desired property values

    • Request topic: /sys/${productKey}/${deviceName}/thing/property/desired/delete
    • Response topic: /sys/${productKey}/${deviceName}/thing/property/desired/delete_reply

    Error codes: 460, 6104, 6661, 500, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, and 6325

Error codes for device tags

  • A device submits tag information

    • Request topic: /sys/${productKey}/${deviceName}/thing/deviceinfo/update
    • Response topic: /sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply

    Error codes: 460 and 6100

  • A device deletes tag information

    • Request topic: /sys/${productKey}/${deviceName}/thing/deviceinfo/delete
    • Response topic: /sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply

    Error codes: 460 and 500

Error codes that may appear when devices obtain TSL models

  • Request topic: /sys/${productKey}/${deviceName}/thing/dsltemplate/get

  • Response topic: /sys/${productKey}/${deviceName}/thing/dsltemplate/get_reply

Error codes: 460, 5159, 5160, and 5161

Error codes that may appear when devices request update package information

  • Request topic: /sys/${productKey}/${deviceName}/thing/ota/firmware/get

  • Response topic: /sys/${productKey}/${deviceName}/thing/ota/firmware/get_reply

Error codes: 429, 9112, and 500

The following table describes the cause and solution of an error that may occur when a device requests the update package information. For more information about other error codes, see the "Common error codes" section of this topic.

Error code

Cause

Troubleshooting

9112

The system failed to query information about the specified device.

On the Devices page of the IoT Platform console, check whether the device information is valid.

Error codes that may appear when devices request configuration data

  • Request topic: /sys/${productKey}/${deviceName}/thing/config/get
  • Response topic: /sys/${productKey}/${deviceName}/thing/config/get_reply

Error codes: 460, 500, 6713, and 6710

The following table describes the causes of and solutions to the errors that may appear when a device requests the configuration data. For more information about other error codes, see the "Common error codes" section of this topic.

Error code

Cause

Troubleshooting

6713

Remote configuration services are unavailable. The remote configuration feature of the specified product is disabled.

Log on to the IoT Platform console, choose Maintenance > Remote Config, and then enable the remote configuration feature for the specified product.

6710

The system failed to query the remote configuration information.

Log on to the IoT Platform console, choose Maintenance > Remote Config, and then check whether you edited the configuration file for the specified product.