Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |