功能说明
如果返回结果中存在 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状态的实例可以修改) |