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

错误码

最近更新时间:2026-09-29 01:09: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 CAM签名/鉴权错误。
AuthFailure.Registry 镜像仓库认证失败
FailedOperation.DependencyUnavailable 依赖服务不可用或超时
FailedOperation.DuplicateRequest 重复请求(幂等性检查)
FailedOperation.PrecacheFailed 预热任务执行失败
FailedOperation.RequestInProgress 请求正在处理中(幂等性检查)
FailedOperation.StorageMount 沙箱实例存储配置挂载失败
InternalError.InternalError InternalError.InternalError
InternalError.NetworkSetupFailed 网络初始化失败
InternalError.Unknown 未分类内部错误
InternalError.VPCServiceUnavailable VPC服务不可用
InvalidParameter.AffinityConfiguration InvalidParameter.AffinityConfiguration
InvalidParameter.AgentSource InvalidParameter.AgentSource
InvalidParameter.CustomDescriptors InvalidParameter.CustomDescriptors
InvalidParameter.DefaultSessionSpaceProtected 指定的会话空间为系统默认会话空间,不允许删除。
InvalidParameter.DeploymentId InvalidParameter.DeploymentId
InvalidParameter.DeploymentName InvalidParameter.DeploymentName
InvalidParameter.Description InvalidParameter.Description
InvalidParameter.EndTime InvalidParameter.EndTime
InvalidParameter.EventIdDuplicate InvalidParameter.EventIdDuplicate
InvalidParameter.Filters InvalidParameter.Filters
InvalidParameter.InvalidParameter InvalidParameter.InvalidParameter
InvalidParameter.LifecycleConfiguration InvalidParameter.LifecycleConfiguration
InvalidParameter.Limit InvalidParameter.Limit
InvalidParameter.MCPSource InvalidParameter.MCPSource
InvalidParameter.Name InvalidParameter.Name
InvalidParameter.Offset InvalidParameter.Offset
InvalidParameter.RecordId InvalidParameter.RecordId
InvalidParameter.RecordSelector InvalidParameter.RecordSelector
InvalidParameter.RecordSource InvalidParameter.RecordSource
InvalidParameter.RegistryId InvalidParameter.RegistryId
InvalidParameter.ScalingConfiguration InvalidParameter.ScalingConfiguration
InvalidParameter.SessionIdDuplicate InvalidParameter.SessionIdDuplicate
InvalidParameter.SkillSource InvalidParameter.SkillSource
InvalidParameter.StartTime InvalidParameter.StartTime
InvalidParameter.Tags InvalidParameter.Tags
InvalidParameter.ToolId InvalidParameter.ToolId
InvalidParameter.VersionId InvalidParameter.VersionId
InvalidParameterValue.AgentSourceType InvalidParameterValue.AgentSourceType
InvalidParameterValue.ApprovalMode InvalidParameterValue.ApprovalMode
InvalidParameterValue.DescriptorType InvalidParameterValue.DescriptorType
InvalidParameterValue.Image 镜像地址无效
InvalidParameterValue.ImageRegistry 镜像仓库类型无效
InvalidParameterValue.InstanceIds InstanceIds 参数格式错误或 ID 列表超过最大数量限制
InvalidParameterValue.MCPSourceType InvalidParameterValue.MCPSourceType
InvalidParameterValue.MountOption MountOption部分参数填写错误
InvalidParameterValue.OffsetTooLarge Offset must be at most 10000
InvalidParameterValue.RoleArn Role Arn格式不满足腾讯云规范
InvalidParameterValue.SandboxTool 沙箱工具名称不可用,可能是已经存在
InvalidParameterValue.Scope 参数 Scopes 取值无效,或当前地域不支持指定的镜像预热范围。
InvalidParameterValue.SecurityGroupId 安全组ID格式错误
InvalidParameterValue.SkillSourceType InvalidParameterValue.SkillSourceType
InvalidParameterValue.StorageMount StorageMount部分参数错误
InvalidParameterValue.SubnetId 子网ID格式错误
InvalidParameterValue.Timeout 超时时间格式错误或超过最大限制
InvalidParameterValue.ToolIds ToolIds 参数格式错误或 ID 列表超过最大数量限制
InvalidParameterValue.ToolType 不支持的沙箱工具类型
LimitExceeded.APIKeyQuota 账号下 API 密钥数量达到上限
LimitExceeded.Deployment LimitExceeded.Deployment
LimitExceeded.RecordLabelCount LimitExceeded.RecordLabelCount
LimitExceeded.SandboxInstance 沙箱实例配额超限
MissingParameter.AgentSourceEndpointURL MissingParameter.AgentSourceEndpointURL
MissingParameter.MCPSourceDescriptors MissingParameter.MCPSourceDescriptors
MissingParameter.MissingParameter MissingParameter.MissingParameter
MissingParameter.Reason MissingParameter.Reason
MissingParameter.RecordSource MissingParameter.RecordSource
MissingParameter.RoleArn 缺少角色Arn
MissingParameter.SkillSourceSkillMd MissingParameter.SkillSourceSkillMd
MissingParameter.VPCParameters VPC网络模式缺少必需参数
ResourceInUse.Deployment ResourceInUse.Deployment
ResourceInUse.DeploymentName ResourceInUse.DeploymentName
ResourceInUse.SandboxTool 沙箱工具正在使用中
ResourceInUse.SessionSpaceNotEmpty 指定的会话空间中仍存在会话、事件或用户状态数据,不能删除。
ResourceNotFound.Deployment ResourceNotFound.Deployment
ResourceNotFound.Image 镜像不存在
ResourceNotFound.RegistryRecord ResourceNotFound.RegistryRecord
ResourceNotFound.SandboxInstance 沙箱实例不存在
ResourceNotFound.SandboxTool 沙箱工具不存在
ResourceNotFound.SecurityGroup 安全组不存在或不属于用户
ResourceNotFound.Session ResourceNotFound.Session
ResourceNotFound.SessionNotExist Session 不存在,或 UserId 无权限访问该 Session
ResourceNotFound.SessionSpaceNotExist 指定的会话空间不存在,或不属于当前应用及地域。
ResourceNotFound.StorageMount 指定的StorageMount不存在
ResourceNotFound.Subnet 子网不存在或不属于用户
ResourceUnavailable.Deployment ResourceUnavailable.Deployment
ResourceUnavailable.ImagePreheating 镜像预热仍在处理中
ResourceUnavailable.SandboxTool 沙箱工具不可用
UnauthorizedOperation.UnauthorizedOperation UnauthorizedOperation.UnauthorizedOperation
UnsupportedOperation.SandboxInstance 实例状态不允许修改(只有RUNNING状态的实例可以修改)