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

错误码

最近更新时间:2026-09-23 04:25:03
我的收藏

功能说明

如果返回结果中存在 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.IdentityNotFound AuthFailure.IdentityNotFound
AuthFailure.IdentityResolutionFailed AuthFailure.IdentityResolutionFailed
FailedOperation.AgentNoRoutingConfig FailedOperation.AgentNoRoutingConfig
FailedOperation.EntitlementNotFound FailedOperation.EntitlementNotFound
FailedOperation.ExternalBindFailed FailedOperation.ExternalBindFailed
FailedOperation.ExternalOperationFailed FailedOperation.ExternalOperationFailed
FailedOperation.ExternalRegisterFailed FailedOperation.ExternalRegisterFailed
FailedOperation.IdentityServiceError FailedOperation.IdentityServiceError
FailedOperation.RoutingDuplicateVersion FailedOperation.RoutingDuplicateVersion
FailedOperation.RoutingInvalidVersion FailedOperation.RoutingInvalidVersion
FailedOperation.RoutingInvalidWeight FailedOperation.RoutingInvalidWeight
FailedOperation.RoutingWeightSumInvalid FailedOperation.RoutingWeightSumInvalid
FailedOperation.SessionCrossAgentMigrate FailedOperation.SessionCrossAgentMigrate
FailedOperation.SessionHistoryNotReady FailedOperation.SessionHistoryNotReady
FailedOperation.SessionHistoryUnavailable FailedOperation.SessionHistoryUnavailable
FailedOperation.SessionNotMigrable FailedOperation.SessionNotMigrable
FailedOperation.VersionNotEditable FailedOperation.VersionNotEditable
InternalError.AgentOperationFailed InternalError.AgentOperationFailed
InternalError.EntitlementCheckFailed InternalError.EntitlementCheckFailed
InternalError.MarshalFailed InternalError.MarshalFailed
InternalError.ModelManagementFailed InternalError.ModelManagementFailed
InternalError.NoResolver InternalError.NoResolver
InternalError.Panic InternalError.Panic
InternalError.ReadBodyFailed InternalError.ReadBodyFailed
InternalError.ResolveEnterpriseFailed InternalError.ResolveEnterpriseFailed
InternalError.RuntimeCreateFailed InternalError.RuntimeCreateFailed
InternalError.SessionHistoryFailed InternalError.SessionHistoryFailed
InternalError.SessionOperationFailed InternalError.SessionOperationFailed
InternalError.TenantResolveFailed InternalError.TenantResolveFailed
InternalError.TracingNotConfigured InternalError.TracingNotConfigured
InternalError.Unknown InternalError.Unknown
InternalError.VersionOperationFailed InternalError.VersionOperationFailed
InvalidParameter.A2AEnabledRequired InvalidParameter.A2AEnabledRequired
InvalidParameter.ActionNotFound InvalidParameter.ActionNotFound
InvalidParameter.ActionRequired InvalidParameter.ActionRequired
InvalidParameter.AgentAccountIDInvalid InvalidParameter.AgentAccountIDInvalid
InvalidParameter.AgentIDRequired InvalidParameter.AgentIDRequired
InvalidParameter.AgentNameLength Agent 名称长度需要在 2-32 位
InvalidParameter.AgentNoPublishedVersion InvalidParameter.AgentNoPublishedVersion
InvalidParameter.ConnectorRequest InvalidParameter.ConnectorRequest
InvalidParameter.EmptyBody InvalidParameter.EmptyBody
InvalidParameter.EndpointInvalid InvalidParameter.EndpointInvalid
InvalidParameter.EndpointRequired InvalidParameter.EndpointRequired
InvalidParameter.EnterpriseIDRequired InvalidParameter.EnterpriseIDRequired
InvalidParameter.ExternalAgentIDRequired InvalidParameter.ExternalAgentIDRequired
InvalidParameter.InvalidJSON InvalidParameter.InvalidJSON
InvalidParameter.InvalidRequestBody InvalidParameter.InvalidRequestBody
InvalidParameter.ManifestRequired InvalidParameter.ManifestRequired
InvalidParameter.ModelManagement InvalidParameter.ModelManagement
InvalidParameter.NoUpdatableField InvalidParameter.NoUpdatableField
InvalidParameter.OneIDAccountRequired InvalidParameter.OneIDAccountRequired
InvalidParameter.Pagination InvalidParameter.Pagination
InvalidParameter.SessionIDRequired InvalidParameter.SessionIDRequired
InvalidParameter.SourceRequired InvalidParameter.SourceRequired
InvalidParameter.TracingRequest InvalidParameter.TracingRequest
InvalidParameter.VersionIDRequired InvalidParameter.VersionIDRequired
InvalidParameterValue.InvalidConnectorSource InvalidParameterValue.InvalidConnectorSource
InvalidParameterValue.InvalidConnectorStatus InvalidParameterValue.InvalidConnectorStatus
MissingParameter.UinRequired MissingParameter.UinRequired
ResourceInUse.AgentIDConflict ResourceInUse.AgentIDConflict
ResourceNotFound.Agent ResourceNotFound.Agent
ResourceNotFound.ExternalAgent ResourceNotFound.ExternalAgent
ResourceNotFound.Session ResourceNotFound.Session
ResourceNotFound.SessionNotFound ResourceNotFound.SessionNotFound
ResourceNotFound.Version ResourceNotFound.Version
ResourceUnavailable.A2ANotConfigured ResourceUnavailable.A2ANotConfigured
ResourceUnavailable.ChatTokenUnavailable ResourceUnavailable.ChatTokenUnavailable
ResourceUnavailable.IdentityNotConfigured ResourceUnavailable.IdentityNotConfigured
ResourceUnavailable.RuntimeAPIUnavailable ResourceUnavailable.RuntimeAPIUnavailable
UnauthorizedOperation.AccountNotAuthorized UnauthorizedOperation.AccountNotAuthorized
UnauthorizedOperation.NotConnectorOwner UnauthorizedOperation.NotConnectorOwner
UnauthorizedOperation.UnprovisionedTenant UnauthorizedOperation.UnprovisionedTenant