tencent cloud

物联网通信

动态与公告
产品动态
产品简介
产品概述
产品功能
产品优势
应用场景
产品限制
基本概念
快速入门
快速开始
场景一:设备互通
场景二:设备状态上报与状态设置
MQTT.fx接入指南
控制台使用手册
产品管理
规则引擎
子账号访问IoT
固件升级
资源管理
证书管理
开发者手册
功能组件
签名方法
设备身份认证
设备接入协议
网关子设备
消息通信
设备影子
设备固件升级
设备远程配置
资源管理
设备日志上报
NTP服务
设备端接入手册
设备接入概述
基于C SDK接入
基于 Android SDK 接入
基于 Java SDK 接入
基于 Python SDK 接入
API 文档
History
Introduction
API Category
Making API Requests
Device Shadow APIs
Device APIs
CA Certificate APIs
Product APIs
Data Types
Error Codes
常见问题
一般性问题
设备接入和上报问题
规则引擎问题
控制台相关问题
IoT Hub 政策
隐私协议
数据处理和安全协议
词汇表

Error Codes

PDF
聚焦模式
字号
最后更新时间: 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.

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈