tencent cloud

IoT Hub

Release Notes and Announcements
Release Notes
Product Introduction
Overview
Features
Strengths
Use Cases
Use Limits
Basic Concepts
Getting Started
Quick Start
Scenario 1: Device Interconnection
Scenario 2: Device Status Reporting and Setting
MQTT.fx Connection Guide
Console Guide
Product Management
Rule Engine
Sub-account Access to IoT Hub
Firmware Upgrade
Resource Management
Certificate Management
Developer Manual
Feature Components
Signature Algorithm
Device Authentication
Device Connection Protocol
Gateway Subdevice
Message Communication
Device Shadow
Device Firmware Upgrade
Remote Device Configuration
Resource Management
Device Log Reporting
NTP Service
Device Connection Manual
Device Connection Overview
Connection Based on SDK for C
Connection Based on SDK for Android
Connection Based on SDK for Java
Connection Based on SDK for Python
API Documentation
History
Introduction
API Category
Making API Requests
Device Shadow APIs
Device APIs
CA Certificate APIs
Product APIs
Data Types
Error Codes
FAQs
General
Device Connection and Reporting
Rule Engine
Console
IoT Hub Policy
Privacy Policy
Data Privacy And Security Agreement
Glossary

Error Codes

PDF
Focus Mode
Font Size
Last updated: 2025-11-13 20:52:11

Feature Description

If there is an Error field in the response, it means that the API call failed. For example:

 {
    "Response": {
        "Error": {
            "Code": "AuthFailure.SignatureFailure",
            "Message": "The provided credentials could not be validated. Please check your signature is correct."
        },
        "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
    }
}

Code in Error indicates the error code, and Message indicates the specific information of the error.

Error Code List

Common Error Codes

Error Code Description
ActionOffline This API has been deprecated.
AuthFailure.InvalidAuthorization Authorization in the request header is invalid.
AuthFailure.InvalidSecretId Invalid key (not a TencentCloud API key type).
AuthFailure.MFAFailure MFA failed.
AuthFailure.SecretIdNotFound Key does not exist. Check if the key has been deleted or disabled in the console, and if not, check if the key is correctly entered. Note that whitespaces should not exist before or after the key.
AuthFailure.SignatureExpire Signature expired. Timestamp and server time cannot differ by more than five minutes. Please ensure your current local time matches the standard time.
AuthFailure.SignatureFailure Invalid signature. Signature calculation error. Please ensure you’ve followed the signature calculation process described in the Signature API documentation.
AuthFailure.TokenFailure Token error.
AuthFailure.UnauthorizedOperation The request is not authorized. For more information, see the CAM documentation.
DryRunOperation DryRun Operation. It means that the request would have succeeded, but the DryRun parameter was used.
FailedOperation Operation failed.
InternalError Internal error.
InvalidAction The API does not exist.
InvalidParameter Incorrect parameter.
InvalidParameterValue Invalid parameter value.
InvalidRequest The multipart format of the request body is incorrect.
IpInBlacklist Your IP is in uin IP blacklist.
IpNotInWhitelist Your IP is not in uin IP whitelist.
LimitExceeded Quota limit exceeded.
MissingParameter A parameter is missing.
NoSuchProduct The product does not exist.
NoSuchVersion The API version does not exist.
RequestLimitExceeded The number of requests exceeds the frequency limit.
RequestLimitExceeded.GlobalRegionUinLimitExceeded Uin exceeds the frequency limit.
RequestLimitExceeded.IPLimitExceeded The number of ip requests exceeds the frequency limit.
RequestLimitExceeded.UinLimitExceeded The number of uin requests exceeds the frequency limit.
RequestSizeLimitExceeded The request size exceeds the upper limit.
ResourceInUse Resource is in use.
ResourceInsufficient Insufficient resource.
ResourceNotFound The resource does not exist.
ResourceUnavailable Resource is unavailable.
ResponseSizeLimitExceeded The response size exceeds the upper limit.
ServiceUnavailable Service is unavailable now.
UnauthorizedOperation Unauthorized operation.
UnknownParameter Unknown parameter.
UnsupportedOperation Unsupported operation.
UnsupportedProtocol HTTP(S) request protocol error; only GET and POST requests are supported.
UnsupportedRegion API does not support the requested region.

Service Error Codes

Error Code Description
FailedOperation.AccountIsolated The operation failed as the account has been suspended due to overdue payments.
FailedOperation.AlreadyDistributionDevice This device has been transferred and cannot be created again.
FailedOperation.TidWhiteListNotOpen You cannot create devices as allowlist authentication is not enabled. IoT Hub will create devices automatically by the names carried during authentication.
InternalError.DBOperationError An internal database error occurred.
InvalidParameterValue.CACertInvalid Incorrect CA certificate content.
InvalidParameterValue.CACertNotMatch CA certificate mismatch.
InvalidParameterValue.DefinedPskNotBase64 Invalid format. DefinedPsk must be a Base64 string.
InvalidParameterValue.DeviceAlreadyExist The device already exists.
InvalidParameterValue.ProductAlreadyExist This product name already exists.
InvalidParameterValue.ProductTypeNotSupport Unsupported product type.
InvalidParameterValue.TidProductAlreadyExist This TID product already exists.
LimitExceeded.CAAlreadyBindProduct Unable to operate because the CA certificate is already bound to a product.
LimitExceeded.CACertNameRepeat The certificate name already exists.
LimitExceeded.CARepeat The CA certificate already exists.
LimitExceeded.DeviceExceedLimit Device quantity exceeded the limit.
LimitExceeded.ProductExceedLimit The number of products exceeds the limit.
ResourceNotFound.CACertNotExist The CA certificate does not exist.
ResourceNotFound.DeviceNotExist The device does not exist.
ResourceNotFound.DeviceShadowNotExist The device shadow does not exist.
ResourceNotFound.ProductNotExist The product does not exist.
ResourceNotFound.ThingModelNotExist The TSL model does not exist.
UnauthorizedOperation.DeleteTidFail There is already a TID application for this product, so it cannot be deleted.
UnauthorizedOperation.DeviceHasAlreadyBindGateway Unable to delete this device as gateway devices have been bound to it.
UnauthorizedOperation.DeviceIsNotEnabled The device is not enabled.
UnauthorizedOperation.DevicesExistUnderProduct There are still devices under this product.
UnauthorizedOperation.GatewayHasBindedDevices There are still devices bound to this device.
UnauthorizedOperation.ProductCantHaveLoRaDevice You cannot create a LoRa device under this product type.
UnauthorizedOperation.ProductCantHaveNormalDevice You cannot create a general device under a NB-IoT product.
UnauthorizedOperation.ProductCantHaveNotLoRaDevice You can create only LoRa devices under this product type.
UnauthorizedOperation.ProductIsForbidden This feature has been disabled for the product.
UnauthorizedOperation.ProductNotSupportPSK The product does not support key authentication.
UnauthorizedOperation.UserNotAuthenticaed The user identity is not verified.
UnsupportedOperation.DeviceOtaTaskInProgress Device OTA update is in progress.
UnsupportedOperation.GatewayProductHasBindedProduct Unable to delete this gateway product as sub-products have been bound to it.
UnsupportedOperation.ProductHasBindGateway Unable to delete this product as gateway devices have been bound to it.
UnsupportedOperation.ProductHasBindedGatewayProduct Unable to delete this product as gateway products have been bound to it.
UnsupportedOperation.SuiteTokenNoCreate You cannot create devices under a suite token product.

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback