帮你快速理解、总结文档立即下载

错误码

最近更新时间:2026-09-23 02:06:16
我的收藏

功能说明

如果返回结果中存在 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.CallThirdPartApiError 调用 <serviceName> 服务的接口 <apiName> 失败:<message>。
FailedOperation.CreateWorkflowFailed 创建工作流失败
FailedOperation.ExistWorkflowExecutions 存在活跃的工作流运行,无法操作
FailedOperation.LabelCountLimit 标签数量已达到最大允许限制
FailedOperation.NoWorkflowExecutionNeedOperate 无需操作的工作流运行
FailedOperation.RerunWorkflowFail 重跑工作流失败
FailedOperation.RunWorkflowFail 运行工作流失败
FailedOperation.RunWorkflowFailExecutionIdEmpty 运行工作流返回的执行ID为空
FailedOperation.UpdateWorkflowFailed 更新工作流失败
FailedOperation.WorkflowBundleNoPermission 该工作流为通过bundle包部署的内容,请勿编辑此工作流
FailedOperation.WorkflowCountLimit 工作流数量超过10000上限
FailedOperation.WorkflowCreateLockAcquireFailed 获取工作流名称分布式锁失败
FailedOperation.WorkflowExecutionHasBeDelete 工作流运行已被删除
FailedOperation.WorkflowNoPermission 无操作权限
InternalError.UnknownError 未知错误
InvalidParameter.InvalidParamsError 无效参数
InvalidParameterValue.DuplicateTaskNameError 同一工作流内存在重名任务
InvalidParameterValue.InvalidParameter 参数错误
InvalidParameterValue.ListWorkflowFilterParamError 工作流列表筛选字段Key值错误
InvalidParameterValue.LoopDataArrayElementCountLimit LoopDataArray 数组元素数量超过了最大允许值
InvalidParameterValue.LoopDataArrayJsonInvalid LoopDataArray 值既不是 JSON 数组字面量,也不是 {{var}} 占位符表达式
InvalidParameterValue.LoopDataArrayNotJsonArray LoopDataArray 值解析成功但顶层节点不是 JSON 数组
InvalidParameterValue.LoopDataArrayNotJsonArrayLiteral LoopDataArray 值既不是 JSON 数组字面量,也不是 {{var}} 占位符表达式
InvalidParameterValue.LoopDataArrayValueBlank FOR_EACH 任务的 LoopDataArray 字段为空或仅含空白字符
InvalidParameterValue.LoopDataArrayValueLengthLimit FOR_EACH 任务的 LoopDataArray 字段字符串长度超过了最大允许值
InvalidParameterValue.LoopDataArrayVariableExpressionInvalid LoopDataArray 变量表达式不满足占位符语法(大括号需成对配对且不嵌套)
InvalidParameterValue.ParamBlankError 参数 <parameter> 不能为空。
InvalidParameterValue.ParamIllegalError 参数 <parameter> 不符合要求:<message>
InvalidParameterValue.ParamNullError 参数 <parameter> 不能为 null。
InvalidParameterValue.TaskHookValidationFailed 引用对象不存在或已被删除
InvalidParameterValue.TaskNameContainsIllegalCharactersError 任务名包含非法字符
InvalidParameterValue.TaskNameExceedsLimitError 任务名超过128字符限制
InvalidParameterValue.TaskTypeNotSupportResourceGroup 请移除该任务类型的资源组配置
InvalidParameterValue.TaskTypePropertyKeyValueRequestRequiredError 任务类型属性值在入参时为必填,但是并没有传递
InvalidParameterValue.WorkflowEndTimeLessStartTime 结束时间不能早于开始时间
InvalidParameterValue.WorkflowNameExists 工作流名称重复
InvalidParameterValue.WorkflowNameInvalid 工作流名称不合法
InvalidParameterValue.WorkflowQueryEndTimeAndStartTimeExceed 查询时间范围超过60天限制
InvalidParameterValue.WorkflowStartTimeAfterEndTimeError 工作流调度开始时间不能晚于结束时间
InvalidParameterValue.WorkflowTriggerAdvancedConfigError 请检查工作流触发器高级配置,修正非法的 JSON 内容
MissingParameter.MissingParameter 缺少必填参数
OperationDenied 操作被拒绝。
RegionError 地域错误
ResourceNotFound.OneFlowResourceNoExistError 资源不存在或已被删除
ResourceNotFound.TaskExecutionNotExist 任务运行不存在
ResourceNotFound.WorkflowExecutionNotExist 工作流运行不存在
ResourceNotFound.WorkflowNotExist 工作流不存在
ResourceNotFound.WorkflowNotFound 根据传入的工作流ID未找到工作流
ResourceNotFound.WorkflowTaskNotExist 工作流下面的任务不存在
ResourceNotFound.WorkflowTriggerNotFound 工作流的调度配置未找到
UnsupportedOperation.WorkflowExecutionHasReachedFinalStateCannotBeStopped 工作流运行已到达终态,不可终止