功能说明
如果返回结果中存在 Error 字段,则表示调用 API 接口失败。例如:
{
"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"
}
}
Error 中的 Code 表示错误码,Message 表示该错误的具体信息。
错误码列表
公共错误码
| 错误码 | 说明 |
|---|---|
| ActionOffline | 接口已下线。 |
| AuthFailure.InvalidAuthorization | 请求头部的 Authorization 不符合腾讯云标准。 |
| AuthFailure.InvalidSecretId | 密钥非法(不是云 API 密钥类型)。 |
| AuthFailure.MFAFailure | MFA 错误。 |
| AuthFailure.SecretIdNotFound | 密钥不存在。请在 控制台 检查密钥是否已被删除或者禁用,如状态正常,请检查密钥是否填写正确,注意前后不得有空格。 |
| AuthFailure.SignatureExpire | 签名过期。Timestamp 和服务器时间相差不得超过五分钟,请检查本地时间是否和标准时间同步。 |
| AuthFailure.SignatureFailure | 签名错误。签名计算错误,请对照调用方式中的签名方法文档检查签名计算过程。 |
| AuthFailure.TokenFailure | token 错误。 |
| AuthFailure.UnauthorizedOperation | 请求未授权。请参考 CAM 文档对鉴权的说明。 |
| DryRunOperation | DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。 |
| FailedOperation | 操作失败。 |
| InternalError | 内部错误。 |
| InvalidAction | 接口不存在。 |
| InvalidParameter | 参数错误(包括参数格式、类型等错误)。 |
| InvalidParameterValue | 参数取值错误。 |
| InvalidRequest | 请求 body 的 multipart 格式错误。 |
| IpInBlacklist | IP 地址在黑名单中。 |
| IpNotInWhitelist | IP 地址不在白名单中。 |
| LimitExceeded | 超过配额限制。 |
| MissingParameter | 缺少参数。 |
| NoSuchProduct | 产品不存在 |
| NoSuchVersion | 接口版本不存在。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| RequestLimitExceeded.GlobalRegionUinLimitExceeded | 主账号超过频率限制。 |
| RequestLimitExceeded.IPLimitExceeded | IP 限频。 |
| RequestLimitExceeded.UinLimitExceeded | 主账号限频。 |
| RequestSizeLimitExceeded | 请求包超过限制大小。 |
| ResourceInUse | 资源被占用。 |
| ResourceInsufficient | 资源不足。 |
| ResourceNotFound | 资源不存在。 |
| ResourceUnavailable | 资源不可用。 |
| ResponseSizeLimitExceeded | 返回包超过限制大小。 |
| ServiceUnavailable | 当前服务暂时不可用。 |
| UnauthorizedOperation | 未授权操作。 |
| UnknownParameter | 未知参数错误,用户多传未定义的参数会导致错误。 |
| UnsupportedOperation | 操作不支持。 |
| UnsupportedProtocol | http(s) 请求协议错误,只支持 GET 和 POST 请求。 |
| UnsupportedRegion | 接口不支持所传地域。 |
业务错误码
| 错误码 | 说明 |
|---|---|
| AuthFailure | CAM签名/鉴权错误。 |
| FailedOperation.ActionUnreachable | 动作消息不可达。 |
| FailedOperation.BroadcastTaskIsRunning | 广播任务正在执行。 |
| FailedOperation.CloudStorageAIPackageExpireTimeExceeded | 云存 AI 套餐生效时长不能超过当前云存套餐生效时长 |
| FailedOperation.CloudStorageAIServiceNotEnabled | 产品未开通视频AI分析服务 |
| FailedOperation.CloudStorageAIServiceTaskAlreadyExists | 云存 AI 分析任务已存在,不支持重复创建 |
| FailedOperation.CloudStoragePackageRequired | 需先开通云存套餐 |
| FailedOperation.DeviceAlreadyDisabled | 设备已经被禁用。 |
| FailedOperation.DeviceFirmwareIsUpdated | 设备已为目标升级版本。 |
| FailedOperation.DeviceInfoOutdated | 设备固件版本错误。 |
| FailedOperation.DeviceIsUpdating | 设备正在升级中。 |
| FailedOperation.DeviceNoSubscription | 返回:消息发送失败,设备未订阅Topic。 |
| FailedOperation.DeviceOffline | 设备处于离线状态。 |
| FailedOperation.OtherUpdateTaskExist | 存在其他升级任务。 |
| FailedOperation.ProductIotVideoServiceNotEnabled | 产品未开通 IoT Video 服务 |
| FailedOperation.ProductNotReleased | 产品尚未发布。 |
| FailedOperation.RRPCTimeout | RRPC接口未收到设备端响应。 |
| FailedOperation.RequestTRTCFail | 请求TRTC失败 |
| FailedOperation.RuleAlreadyDisabled | 转发已经停止。 |
| FailedOperation.RuleAlreadyEnabled | 该规则已被启用。 |
| FailedOperation.SomeProductIsAlreadyBinded | 部分产品已经被绑定。 |
| FailedOperation.TargetDeviceHasEnabledWeSeeConfig | 目标设备存在启用状态的 TWeSee 配置 |
| FailedOperation.Timeout | 超过时间。 |
| FailedOperation.WeSeeServiceNotEnabled | 未开通 TWeSee 后付费服务 |
| InternalError.DBOperationError | DB操作错误。 |
| InternalError.DBOpertaionError | DB操作错误。 |
| InternalError.InternalLoRaServerError | 内部LoRaServer错误。 |
| InternalError.InternalRPCError | 内部RPC错误。 |
| InternalError.InternalServerException | 发生错误。 |
| InternalError.InternalServerExceptionDB | 内部DB错误。 |
| InternalError.Timeout | 调用超时。 |
| InvalidParameter.ActionInputParamsInvalid | 动作输入参数不合法。 |
| InvalidParameter.FirmwareAlreadyExist | 固件已存在。 |
| InvalidParameter.ProductIsNotGateway | 产品不是网关类型,无法绑定子产品。 |
| InvalidParameter.RoomIdExist | RoomId已存在 |
| InvalidParameter.UserIdOverLimit | UserId数量超出限制 |
| InvalidParameterValue.ActionNil | 规则行为未配置。 |
| InvalidParameterValue.ActionNilOrNotExist | 动作为空或不存在。 |
| InvalidParameterValue.AppDescriptionTooLong | 应用描述过长。 |
| InvalidParameterValue.AppExists | App已存在。 |
| InvalidParameterValue.AppNameTooLong | 应用名称过长。 |
| InvalidParameterValue.AppNoPermission | App无权限。 |
| InvalidParameterValue.AppNotExists | App不存在。 |
| InvalidParameterValue.CheckForwardURLFail | 检查第三方URL超时或失败。 |
| InvalidParameterValue.CloudStorageAIPackageIdNotExist | 指定的云存 AI 套餐不存在 |
| InvalidParameterValue.DeviceAlreadyExist | 创建的设备名已存在。 |
| InvalidParameterValue.DeviceHasNotBindGateway | 设备未绑定任何网关设备。 |
| InvalidParameterValue.DeviceIsNotGateway | 设备不是网关类型。 |
| InvalidParameterValue.DeviceNameInvalid | 设备名称非法。 |
| InvalidParameterValue.DeviceNotExist | 设备不存在。 |
| InvalidParameterValue.ErrLLSyncBroadcastDeviceNameLengthExceed | 使用标准蓝牙广播协议的产品,DeviceName最多不超过8个字符。 |
| InvalidParameterValue.ErrorTaskNotExist | 任务不存在。 |
| InvalidParameterValue.FailActionHasSameDevice | 存失败,行为操作和转发错误行为数据目标不可为同一设备。 |
| InvalidParameterValue.FirmwareAlreadyExist | 固件已经存在。 |
| InvalidParameterValue.ForwardRedirectDenied | 转发重定向被拒绝。 |
| InvalidParameterValue.GetProductsListError | 拉取产品列表失败。 |
| InvalidParameterValue.InvalidCallbackToken | 回调 Token 格式有误 |
| InvalidParameterValue.InvalidCallbackUrl | 回调 URL 无效或格式有误 |
| InvalidParameterValue.InvalidSQL | SQL语句含有非法字符。 |
| InvalidParameterValue.LoRaFreqParmsError | LoRa频点参数错误。 |
| InvalidParameterValue.ModelDefineDontMatchTemplate | 物模型不符合产品模板。 |
| InvalidParameterValue.ModelDefineDupID | 物模型存在重复ID。 |
| InvalidParameterValue.ModelDefineErrorModel | 物模型事件/属性Model错误。 |
| InvalidParameterValue.ModelDefineErrorType | 物模型事件/属性Model Type错误。 |
| InvalidParameterValue.ModelDefineEventParamsDupID | 物模型EVENT Parms存在重复ID。 |
| InvalidParameterValue.ModelDefineEventParamsExceedLimit | 物模型EVENT Parms数量超过限制。 |
| InvalidParameterValue.ModelDefineEventPropError | 物模型事件/属性参数错误。 |
| InvalidParameterValue.ModelDefineEventPropNameError | 物模型事件/属性 Name 错误。 |
| InvalidParameterValue.ModelDefineEventTypeError | 物模型事件 Type 错误:lac 。 |
| InvalidParameterValue.ModelDefineInvalid | 数据模板未定义。 |
| InvalidParameterValue.ModelDefineNil | 物模型为空。 |
| InvalidParameterValue.ModelDefinePropBoolMappingError | 物模型事件/属性 BOOL类型 Mapping 定义错误。 |
| InvalidParameterValue.ModelDefinePropEnumMappingError | 物模型事件/属性 Enum类型 Mapping 定义错误。 |
| InvalidParameterValue.ModelDefinePropRangeError | 物模型事件/属性 Min/Max 定义错误。 |
| InvalidParameterValue.ModelDefinePropRangeOverflow | 物模型事件/属性 Min/Max 范围超限。 |
| InvalidParameterValue.ModelPropertyNotExist | 属性ID不存在。 |
| InvalidParameterValue.MsgContentInvalid | 消息内容非法。 |
| InvalidParameterValue.MsgLevelInvalid | 消息等级非法。 |
| InvalidParameterValue.MsgTitleInvalid | 消息标题非法。 |
| InvalidParameterValue.MsgTypeInvalid | 消息类型非法。 |
| InvalidParameterValue.NoPermission | 无权限。 |
| InvalidParameterValue.OperationDenied | 操作不支持。 |
| InvalidParameterValue.PayloadOverLimit | 消息Payload超出限制。 |
| InvalidParameterValue.ProductAlreadyExist | 创建的产品名已存在。 |
| InvalidParameterValue.ProductIDInvalid | 产品ID非法。 |
| InvalidParameterValue.ProductIsNotGateway | 产品不是网关类型,无法绑定子产品。 |
| InvalidParameterValue.ProductParmsError | 产品参数错误。 |
| InvalidParameterValue.ProjectParmsError | 项目参数错误。 |
| InvalidParameterValue.PushEnvironmentInvalid | PushEnvironment 非法。 |
| InvalidParameterValue.RepublishTopicFormatError | 转发的topic格式错误。 |
| InvalidParameterValue.RuleNumberBeyondLimit | 规则数量超过限制。 |
| InvalidParameterValue.SelectKeyFromBinaryPayload | 二进制数据格式只可利用 * 将数据进行转发。 |
| InvalidParameterValue.StartTimeLaterEndTime | 开始时间晚于结束时间。 |
| InvalidParameterValue.TPNSAndroidValidationFailed | TPNSAndroidAccessID, TPNSAndroidSecretKey, TPNSAndroidRegion validation failed。 |
| InvalidParameterValue.TPNSiOSValidationFailed | TPNSiOSAccessID, TPNSiOSSecretKey, TPNSiOSRegion validation failed。 |
| InvalidParameterValue.TopicPolicyAlreadyExist | Topic已存在。 |
| InvalidParameterValue.TopicRuleAlreadyExist | 规则已存在。 |
| InvalidParameterValue.TopicRuleSqlNotEdited | 规则sql未编辑。 |
| InvalidParameterValue.UpdateTopicRuleDBFail | 请确认规则相关数据是否有更新。 |
| InvalidParameterValue.UserIDInvalid | 用户ID非法。 |
| InvalidParameterValue.VPNParmsError | VPN参数错误。 |
| LimitExceeded.ApplicationExceedLimit | 应用数量超出限制。 |
| LimitExceeded.BatchProductionExceedLimit | 量产超出限制。 |
| LimitExceeded.BatchProductionNull | 量产为空。 |
| LimitExceeded.BindProductsExceedLimit | 绑定的产品数量超过限制。 |
| LimitExceeded.DeviceExceedLimit | 设备数量超过限制。 |
| LimitExceeded.FirmwareExceedLimit | 固件数量超出限制。 |
| LimitExceeded.MessageSaved | 消息数量超过限制。 |
| LimitExceeded.ProductExceedLimit | 超过产品数量限制。 |
| LimitExceeded.ProjectExceedLimit | 项目数量超出限制。 |
| LimitExceeded.StudioLoRaFreqExceedLimit | LoRa频点数量超出限制。 |
| LimitExceeded.StudioProductExceedLimit | 产品数量超出限制。 |
| LimitExceeded.ThingModelExceedLimit | 物模型超出限制。 |
| LimitExceeded.TopicPolicyExceedLimit | Topic数量超出限制。 |
| MissingParameter.ModelDefineEventTypeError | 物模型事件 Type 错误。 |
| ResourceInsufficient.BatchProductionIsRunning | 已有量产进行,请等待量产完成。 |
| ResourceInsufficient.CloudStorageAIServiceTaskQuotaInsufficient | 云存 AI 分析任务创建额度不足 |
| ResourceNotFound.AppNotExists | App不存在。 |
| ResourceNotFound.BatchProductionNotExist | 量产不存在。 |
| ResourceNotFound.CannotGetFromUrl | 上传URL无法获取。 |
| ResourceNotFound.CloudStorageAIServiceTask | 云存AI分析任务不存在 |
| ResourceNotFound.CloudStorageAIServiceTaskFile | 云存AI分析任务输出文件不存在 |
| ResourceNotFound.DeviceDupKeyExist | 存在重复设备。 |
| ResourceNotFound.DeviceFirmWareNotExist | 设备固件信息不存在。 |
| ResourceNotFound.DeviceHasNoFirmware | 固件不存在。 |
| ResourceNotFound.DeviceNotBind | 设备未绑定家庭。 |
| ResourceNotFound.DeviceNotExist | 设备不存在。 |
| ResourceNotFound.DeviceShadowNotExist | 设备影子未创建或是已删除。 |
| ResourceNotFound.FenceBindNotExist | 围栏未绑定该设备。 |
| ResourceNotFound.FenceNotExist | 围栏未创建或是已删除。 |
| ResourceNotFound.FirmwareNotExist | 固件不存在。 |
| ResourceNotFound.FirmwareTaskNotExist | 固件升级任务不存在。 |
| ResourceNotFound.GatewayDupKeyExist | 存在重复网关。 |
| ResourceNotFound.GatewayNotExist | 网关不存在。 |
| ResourceNotFound.InstanceNotExist | 实例未创建或是已删除。 |
| ResourceNotFound.ModuleNotExist | 模组不存在或改动未生效。 |
| ResourceNotFound.ProductNotExist | 产品不存在。 |
| ResourceNotFound.ProductOrDeviceNotExist | 产品或设备不存在。 |
| ResourceNotFound.ProductResourceNotExist | 产品资源不存在。 |
| ResourceNotFound.ProjectNotExist | 项目不存在。 |
| ResourceNotFound.SpaceNotExist | 位置空间未创建或是已删除。 |
| ResourceNotFound.StudioLoRaFreqNotExist | LoRa频点尚未创建或已被删除。 |
| ResourceNotFound.StudioProductNotExist | 产品不存在。 |
| ResourceNotFound.TopicPolicyNotExist | Topic不存在。 |
| ResourceNotFound.TopicRuleNotExist | 规则不存在。 |
| ResourceUnavailable.WeSeeServiceIsolated | TWeSee 后付费资源已隔离 |
| UnauthorizedOperation.APPNoPermissionToStudioProduct | APP对产品没有权限。 |
| UnauthorizedOperation.ApiCreateAITaskNotInWhitelist | 该账号未在白名单内,不能通过 API 创建 AI 任务 |
| UnauthorizedOperation.AppNoPermission | App无权限。 |
| UnauthorizedOperation.DeviceHasAlreadyBindGateway | 该设备绑定了网关设备,无法删除。 |
| UnauthorizedOperation.DeviceIsNotEnabled | 设备未启用。 |
| UnauthorizedOperation.GatewayHasBindedDevices | 该设备下仍有绑定的设备。 |
| UnauthorizedOperation.NoPermissionToFamily | 此家庭无权操作。 |
| UnauthorizedOperation.NoPermissionToInstance | 实例ACL错误。 |
| UnauthorizedOperation.NoPermissionToProject | 项目ACL错误。 |
| UnauthorizedOperation.NoPermissionToStudioFence | 围栏ACL错误。 |
| UnauthorizedOperation.NoPermissionToStudioInstance | 实例ACL错误。 |
| UnauthorizedOperation.NoPermissionToStudioProduct | 产品ACL错误。 |
| UnauthorizedOperation.NoPermissionToTRTCRoom | 无权操作该房间 |
| UnauthorizedOperation.NoVerified | 您的账号未实名认证,请登录腾讯云进行实名认证 |
| UnauthorizedOperation.PermissionDenied | 没有权限。 |
| UnauthorizedOperation.ProductNotSupportPSK | 产品不支持密钥认证。 |
| UnauthorizedOperation.UserLicenseExceedLimit | License数量不足。 |
| UnsupportedOperation.BindsExistUnderFence | 围栏下还存在绑定的设备。 |
| UnsupportedOperation.CannotReBindFamily | 存在重复的绑定关系。 |
| UnsupportedOperation.CloudStoragePackageTimeMismatch | 云存套餐与云存 AI 套餐时长不匹配 |
| UnsupportedOperation.CloudStoragePackageTypeMismatch | 云存套餐与云存 AI 套餐类型不匹配 |
| UnsupportedOperation.DeviceDupKeyExist | 创建的设备已经存在。 |
| UnsupportedOperation.DeviceExceedLimit | 设备数量超出实例限制。 |
| UnsupportedOperation.DeviceOtaTaskInProgress | 设备ota升级中。 |
| UnsupportedOperation.DeviceType | 设备类型错误。 |
| UnsupportedOperation.DevicesExistUnderProduct | 产品下还存在未删除的设备。 |
| UnsupportedOperation.EnableSaasServiceExistUnderProject | 该项目下存在物联使能SaaS服务。 |
| UnsupportedOperation.ExistBindedDevicesUnderGatewayProduct | 网关产品下存在设备绑定了子设备。 |
| UnsupportedOperation.FenceDupKeyExist | 存在重复围栏。 |
| UnsupportedOperation.FenceExistUnderSpace | 位置空间下还存在未删除的围栏。 |
| UnsupportedOperation.GatewayProductHasBindedProduct | 网关产品还绑定子产品,无法删除。 |
| UnsupportedOperation.InstanceIsolated | 由于实例到期已被禁用,请续费后使用。 |
| UnsupportedOperation.LoRaFreqDupKeyExist | 存在重复LoRa频点。 |
| UnsupportedOperation.LoRaNoUpLink | LoRa设备未上报数据。 |
| UnsupportedOperation.LoRaNotActivate | Lora设备没有激活。 |
| UnsupportedOperation.NodesExistUnderVPN | VPN下还存在未删除的设备。 |
| UnsupportedOperation.PoolExistUnderProject | 该项目下还存在人员库,需删除人员库后才允许删除项目。 |
| UnsupportedOperation.ProductDupKeyExist | 存在重复产品。 |
| UnsupportedOperation.ProductExistUnderProject | 项目下有产品。 |
| UnsupportedOperation.ProductHasBindedGateWayProduct | 产品被绑定到网关产品。 |
| UnsupportedOperation.ProductHasShared | 产品已被共享,请先解除共享。 |
| UnsupportedOperation.ProjectDupKeyExist | 存在重复项目。 |
| UnsupportedOperation.SpaceDupKeyExist | 存在重复位置空间。 |
| UnsupportedOperation.StaffPoolDupNameExist | 人员库名称已存在。 |
| UnsupportedOperation.StudioLoRaFreqInUsed | LoRa频点还被节点或网关使用。 |
| UnsupportedOperation.TRTCServiceNotOpen | TRTC增值服务未开通 |
| UnsupportedOperation.UnpaidOrder | 账户有未支付订单。 |
| UnsupportedOperation.VPNDupKeyExist | 存在重复VPN。 |
| UnsupportedOperation.VideoAccountNotExist | Video账户未创建,请检查后重新操作。 |
| UnsupportedOperation.VideoInsufficientLicenses | Video平台license数量不足。 |
| UnsupportedOperation.VideoProductNotExist | Video平台产品不存在。 |