IoT Hub API common error codes
The following table lists error codes common to the IoT Hub APIs. HTTP status code being N/A means the error occurs only through AMQP or MQTT.
| Error code | Description | HTTP status code |
|---|---|---|
| 400004 | The body of the request is not valid; for example, it cannot be parsed, or the object cannot be validated. | 400 Bad Format |
| 400027 | See 400027 ConnectionForcefullyClosedOnNewConnection. | N/A |
| 400103 | InvalidContentEncodingOrType | 400 Bad Request |
| 401002 | IotHub Unauthorized Access | 401 Unauthorized |
| 401003 | The authorization token cannot be validated; for example, it is expired or does not apply to the request’s URI and/or method. To learn more, see 401003 IoTHubUnauthorized. | 401 Unauthorized |
| 403010 | This operation is not valid for the current IoT Hub tier. How To Upgrade your IoT Hub | 403 Forbidden |
| 403002 | See 403002 IoTHubQuotaExceeded. | 403 Forbidden |
| 403004 | See 403004 DeviceMaximumQueueDepthExceeded. | 403 Forbidden |
| 403006 | See 403006 DeviceMaximumActiveFileUploadLimitExceeded. | 403 Forbidden |
| 404001 | See 404001 DeviceNotFound. | 404 Not Found |
| 404104 | See 404001 DeviceNotFound. | 404 Not Found |
| 404103 | See 404103 DeviceNotOnline. | 404 Not Found |
| 404104 | See 404104 DeviceConnectionClosedRemotely. | 404 Not Found |
| 409001 | See 409001 DeviceAlreadyExists. | 409 Conflict |
| 409002 | See 409002 LinkCreationConflict. | N/A |
| 412001 | The etag in the request does not match the etag of the existing resource, as per RFC7232. | 412 Precondition Failed |
| 412002 | See 412002 DeviceMessageLockLost. | N/A |
| 413001 | Message sent to the IoT Hub exceeds the maximum allowable size for IoT Hub messages. | 413 RequestEntityTooLarge |
| 429001 | See 429001 ThrottlingException. | 429 Too Many Requests |
| 500xxx | See 500xxx Internal errors. | 500 Internal Server Error |
| 500001 | See 500xxx Internal errors. | 500 Internal Server Error |
| 503xxx | Service Unavailable | Service Unavailable |
| 503003 | See 503003 PartitionNotFound. | 503 Service Unavailable |
| 503008 | Receive link throttled. Message throttled, please retry operation. | 503 Server Unavailable |
| 504101 | See 504101 GatewayTimeout. | 504 Gateway Timeout |