错误码
当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
| 状态码 | 错误码 | 错误信息 | 描述 | 处理措施 |
|---|---|---|---|---|
| 400 | AgentArts.03001001 | Input parameter is invalid | 输入参数无效。 | 请检查输入参数是否正确。 |
| 400 | AgentArts.03002106 | Operation failed | 外部知识库不支持文件下载。 | 第三方知识库连接不存在。 |
| 400 | AgentArts.03003039 | Operation failed | 未找到图片或图片已过期。 | 请稍后重试。 |
| 403 | AgentArts.03001021 | Operation failed | 下载的文件为空。 | 请检查并重试。 |
| 404 | AgentArts.03001003 | resource not exist | 资源不存在。 | 请联系技术支持。 |
| 404 | AgentArts.03002010 | Can not retrieve in knowledge base | 这些知识已被删除或关闭。 | 请检查这些知识的状态。 |
| 500 | AgentArts.03000000 | System internal error | 系统内部错误。 | 请联系技术支持。 |
| 500 | AgentArts.03002019 | Operation failed | 未找到该文件或该文件已过期。 | 请检查后再重试。 |
| 500 | AgentArts.03002104 | Query third party knowledgeBases error | 第三方知识库连接信息错误。 | 请检查连接信息后重试。 |
| 400 | AgentArts.05001001 | StartTime can not bigger than EndTime or Time interval is too large. | 结束时间早于了开始时间或者时间间隔过大。 | 请确认入参的开始时间和晚于结束时间。 |
| 400 | AgentArts.05001003 | invalid Parameter:{0}. | 非法参数：{0}。 | 请检查请求参数是否符合接口规范。 |
| 400 | AgentArts.05030001 | not support sentence. | 不支持的查询语句。 | 请检查请求参数是否符合接口规范。 |
| 400 | AgentArts.05080007 | account has been frozen. | 账户被冻结。 | 申请解冻账户。 |
| 400 | AgentArts.05090001 | Non-beta user | 非公测用户 | 用户申请公测。 |
| 403 | AgentArts.05001007 | No permission. | 无权限。 | 请确认当前用户有权限执行该接口。 |
| 404 | AgentArts.05001005 | Resource {0} does not exist. | 资源{0}不存在。 | 请检查请求参数是否符合接口规范。 |
| 500 | AgentArts.05000001 | Internal Server Error | 未知错误 | 系统错误，请稍后重试。 |
| 500 | AgentArts.05000002 | json handle error. | json处理错误。 | 请检查请求参数是否符合接口规范。 |
| 500 | AgentArts.05001010 | datasource init failed:{0}. | 数据库初始化失败:{0}。 | 初始化失败，请稍后重试。 |
| 500 | AgentArts.05080005 | subscribe ops error, step:{}. | 开通ops报错, 步骤:{}。 | 开通失败，请稍后重试。 |
| 500 | AgentArts.05080007 | no subscription. | 未订阅。 | 请确保用户已订阅。 |
| 400 | AgentArts.03400001 | 无效的请求 | 客户端发送的请求语法错误、必填参数缺失或身份鉴权凭证（Token）失效。 | |
| 400 | AgentArts.03400002 | 资源已经存在，导致错误 | 资源已经存在 | 检查资源是否存在 |
| 400 | AgentArts.03400003 | 没有权限访问，导致错误 | 没有权限访问资源 | 检查是否有权限访问 |
| 400 | AgentArts.03400004 | 超出数量限制，导致错误 | 超出资源数量限制 | 检查是否超出数量限制 |
| 404 | AgentArts.03404001 | 资源未找到 | 请求的资源不存在。可能是由于资源 ID 错误、资源已被物理删除或请求了不存在的 API 路径。 | |
| 500 | AgentArts.03500001 | 服务内部错误 | 服务器在处理请求时发生了未预期的异常，通常与后端逻辑故障、数据库连接超时或三方依赖服务异常有关。 | |
| 200 | AgentArts.02101016 | Insufficient execution permissions for Agent. | 当前用户无权在指定项目中运行该单智能体应用 | 请确认当前用户在目标项目中拥有该单智能体应用的执行权限 |
| 200 | AgentArts.100002 | Parameter validation failed | 输入参数格式不正确或缺少必要参数 | 请检查请求参数是否符合接口规范 |
| 400 | AgentArts.02101032 | Current Agent version does not exist | 请求中指定的Agent或其版本在系统中不存在，可能已被删除或未正确发布 | 请确认Agent ID和版本信息是否正确，并确保该Agent已成功发布并可用。 |
| 400 | AgentArts.103004 | Planning assistance engine failed to plan or execute,failed to call model, failed to get the authorization header. | 所配置模型没有认证信息。 | 使用平台预置模型需要开通并设置鉴权信息。 |
| 401 | APIG.0301 | Incorrect IAM authentication information. | IAM身份验证信息不正确： decrypt token fail：token解析失败。 token expires：token过期。 verify aksk signature fail：AK/SK认证失败。 x-auth-token not found：未找到x-auth-token参数。 | token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 token超时（token expires） ，请重新获取token，使用不过期的token。 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 检查账号权限，是否欠费，被冻结等。 检查调用API时，请求header参数X-Auth-Token是否拼写正确。 |
| 401 | common.01010018 | Auth token failed | 不正确的token信息，token解密失败 | 请检查输入的x-auth-token是否正确 |
| 403 | AgentArts.02001017 | API call count for Agent exceeds quota. | 智能体API调用次数已用完。 | 请升级套餐。 |
| 404 | AgentArts.02101007 | Agent does not exist. | 请求的智能体应用未找到或已被删除。 | 请确认该应用是否存在。 |
| 404 | APIG.0101 | The API does not exist or has not been published in the environment. | 访问的API不存在或尚未在环境中发布。 | 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 HTTP请求方法（POST，GET等）是否正确。 |
| 429 | APIG.0308 | The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. | 发送请求超过了服务的默认配置限流。 | 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求。 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
| 500 | AgentArts.02201004 | Workflow or workflow version does not exist. | 请求中指定的工作流ID在当前项目和工作区中不存在，可能已被删除或未正确创建。 | 请确认工作流ID是否正确，并确保该工作流在当前项目和工作区中已存在。 |
| 504 | APIG.0201 | Backend timeout. | 请求超时。 | 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
| 400 | AgentArts.02000001 | 请求参数错误。 | 请求参数错误。 | 根据接口返回的具体原因修改请求参数。 |
| 400 | AgentArts.02000002 | 入站身份配置错误：Discovery地址不可达。 | 入站身份配置错误：Discovery地址不可达。 | 请提供正确的Discovery地址。 |
| 400 | AgentArts.02000003 | 无效的调测方法。 | 无效的调测方法。 | 请使用有效的调测方法（initialize、tools/list或tools/call）。 |
| 401 | AgentArts.02000300 | 认证信息无法识别。 | 认证信息无法识别。 | 使用正确的认证信息访问。 |
| 403 | AgentArts.02000200 | 没有权限执行该操作。 | 没有权限执行该操作。 | 请检查权限是否配置正确。 |
| 403 | AgentArts.02000201 | 该配置不允许。 | 该配置不允许。 | 请检查配置是否正确。 |
| 403 | AgentArts.02000202 | 网关配额不足。 | 网关配额不足。 | 请联系技术支持工程师修改配额。 |
| 403 | AgentArts.02000203 | 网关可创建的目标资源配额不足。 | 网关可创建的目标资源配额不足。 | 请联系技术支持工程师修改配额。 |
| 403 | AgentArts.02000204 | 租户未开通服务，不可操作。 | 租户未开通服务，不可操作。 | 请先开通服务。 |
| 403 | AgentArts.02000205 | 租户受限或冻结中，不可操作。 | 租户受限或冻结中，不可操作。 | 请续费或联系技术支持工程师处理。 |
| 404 | AgentArts.02000100 | 资源未找到。 | 资源未找到。 | 根据接口返回的具体原因检查对应资源是否存在。 |
| 404 | AgentArts.02000101 | 模板未找到。 | 模板未找到。 | 根据接口返回的具体原因检查对应模板资源是否存在。 |
| 409 | AgentArts.02000600 | 网关使用资源存在冲突，无法执行创建操作 | 网关使用资源存在冲突，无法执行创建操作 | 请等待变更中的网关完成，或清理失败的网关 |
| 409 | AgentArts.02000601 | 网关名称重复 | 网关名称重复 | 请更换名称 |
| 409 | AgentArts.02000602 | 网关正在变更中，无法执行此操作 | 网关正在变更中，无法执行此操作 | 请等待网关变更完成 |
| 409 | AgentArts.02000603 | 并发操作过多 | 并发操作过多 | 请稍后重试 |
| 409 | AgentArts.02000604 | 网关下仍有关联的目标资源，无法执行删除操作 | 网关下仍有关联的目标资源，无法执行删除操作 | 请删除该网关下所有目标资源 |
| 409 | AgentArts.02000605 | 网关状态冲突。 | 网关状态冲突。 | 请确保网关处于ACTIVE状态后再调测。 |
| 429 | AgentArts.02000400 | 请求过于频繁，请稍后重试。 | 请求过于频繁，请稍后重试。 | 稍后重试。 |
| 500 | AgentArts.02000500 | 服务连接超时。 | 服务连接超时。 | 请稍后重试。 |
| 500 | AgentArts.02000501 | 操作数据库异常。 | 操作数据库异常。 | 请联系技术支持工程师排查后台相关日志。 |
| 500 | AgentArts.02000502 | 刷新网关配置数据失败。 | 刷新网关配置数据失败。 | 请联系技术支持工程师排查后台相关日志。 |
| 500 | AgentArts.02000503 | 调测失败。 | 调测失败。 | 请联系技术支持工程师排查后台相关日志。 |
| 400 | AgentArts.03000009 | 无效的运行时请求: {0} | 接口调用请求参数错误 | 请检查请求参数是否正确并按照正确格式修改后重试 |
| 400 | AgentArts.03000019 | Runtime正在删除中，无法执行操作 | 运行时资源正在删除中，无法执行操作 | 请避免对删除中的资源进行操作 |
| 400 | AgentArts.03000020 | 文件传输配置不可修改 | 文件传输配置不可修改 | 请删除请求参数中的文件传输配置 |
| 400 | AgentArts.03001004 | 不能删除默认端点 | 默认的运行时访问方式不支持删除 | 请避免对默认的运行时访问方式进行删除操作 |
| 400 | AgentArts.03001005 | 不能修改默认端点 | 默认的运行时访问方式不支持修改 | 请避免对默认的运行时访问方式进行修改操作 |
| 400 | AgentArts.03005400 | 请求参数错误: {0} | 请求参数错误 | 请检查请求参数是否正确并按照正确格式修改后重试 |
| 400 | AgentArts.03005601 | 标签数量超出限制, 最多允许 {0} 个标签 | 标签数量超出限制 | 请将标签数量控制在允许范围后重试 |
| 400 | AgentArts.03005602 | 不能手动添加或删除系统标签, 标签键: {0} | 不能手动添加或删除系统标签 | 请避免添加或者修改_sys_开头的系统标签 |
| 400 | AgentArts.03005604 | 无效的参数: {0} | 标签参数格式非法 | 请按照正确的标签请求格式调整请求后重试 |
| 400 | AgentArts.03005607 | 标签键格式非法: {0}。标签键长度为1-128个字符，不能以空格开头或结尾，不能以_sys_开头，只能包含字母、空格、数字、_.:/=+-@ | 标签键格式非法 | 请按照正确的标签键格式调整请求后重试 |
| 400 | AgentArts.03008005 | 子网 {0} 网络ID缺失 | 子网的网络ID缺失 | 请检查子网是否具有正确的网络ID |
| 400 | AgentArts.03008011 | 创建网关实例失败: {0} | 创建网关实例失败 | 请稍后重试或联系技术支持 |
| 400 | AgentArts.03008012 | 订阅OPS服务失败: {0} | 订阅智能体观测服务失败 | 请稍后重试或联系技术支持 |
| 400 | AgentArts.03009014 | 入站身份认证配置错误：Discovery地址不可达 | 入站身份认证配置中的Discovery地址不可达 | 请检查入站身份认证配置中的Discovery地址是否可以正常访问 |
| 400 | AgentArts.03009016 | 身份认证参数非法: {0} | 入站身份认证请求参数错误 | 请检查入站身份认证请求参数是否正确并按照正确格式修改后重试 |
| 401 | AgentArts.03000006 | 运行时认证失败: {0} | 接口调用认证失败 | 请使用正确的用户凭据进行接口调用 |
| 401 | AgentArts.03005401 | 认证失败: {0} | 认证失败 | 请使用正确的用户凭据进行接口调用 |
| 403 | AgentArts.03000007 | 运行时权限不足: {0} | 接口调用权限不足 | 请为用户授予正确的身份策略 |
| 403 | AgentArts.03005403 | 租户 {0} 访问被拒绝 | 接口调用被拒绝 | 请使用正确的用户凭据进行接口调用 |
| 403 | AgentArts.03008013 | 服务已被冻结 | 服务已被冻结 | 请确认账户是否余额不足或账号是否已被冻结 |
| 403 | AgentArts.03009015 | 身份认证鉴权失败: {0} | 访问身份认证服务鉴权失败 | 请为用户授予正确的身份策略 |
| 404 | AgentArts.03000001 | 未找到运行时ID为: {0} 的Agent | 运行时资源不存在 | 请确认运行时ID对应的资源是否存在 |
| 404 | AgentArts.03000010 | 未找到名称为: {0} 的版本 | 运行时版本不存在 | 请确认版本名称对应的资源是否存在 |
| 404 | AgentArts.03001001 | 未找到端点ID为: {0} 的端点 | 运行时访问方式资源不存在 | 请确认运行时访问方式ID对应的资源是否存在 |
| 404 | AgentArts.03005404 | 资源不存在 | 资源不存在 | 请确认请求的资源是否存在 |
| 404 | AgentArts.03008001 | 网关未找到或服务未开通 | 网关未找到或服务未开通 | 请检查网关资源是否删除或者服务是否正常开通 |
| 404 | AgentArts.03008002 | 子网 {0} 未找到 | 配置的子网不存在 | 请确认子网ID是否配置正确以及对应的子网资源是否存在 |
| 404 | AgentArts.03008008 | DNS域名 {0} 未找到 | DNS域名未找到 | 请稍后重试或联系技术支持 |
| 409 | AgentArts.03000002 | 已存在名称为 {0} 的Agent | 运行时资源名称重复 | 请确认是否存在相同名称的运行时资源 |
| 409 | AgentArts.03000008 | 运行时资源冲突: {0} | 运行时资源并发更新冲突 | 请减少对同一个资源的请求访问频率或稍后重试 |
| 409 | AgentArts.03000011 | 已存在名称为 {0} 的版本 | 运行时版本名称重复 | 请确认是否存在相同名称的运行时版本 |
| 409 | AgentArts.03001002 | 已存在名称为 {0} 的端点 | 运行时访问方式资源名称重复 | 请确认是否存在相同名称的运行时访问方式资源 |
| 409 | AgentArts.03008007 | DNS记录冲突: {0} | DNS记录存在冲突 | 请稍后重试或联系技术支持 |
| 409 | AgentArts.03008010 | VPC {0} 已存在VPC网络配置，无法重复创建 | 无法重复创建VPC网络配置 | 请避免重复创建VPC网络配置 |
| 409 | AgentArts.03008013 | 网关存在进行中的VPC关联操作，请等待完成后再次尝试 | 网关存在进行中的VPC关联操作 | 请确认当前没有正在进行中的VPC关联操作 |
| 429 | AgentArts.03005429 | 请求流控 | 请求流控 | 请减少接口调用频率或稍后重试 |
| 429 | AgentArts.03005801 | 请求被流控策略拒绝 | 请求被流控策略拒绝 | 请减少接口调用频率或稍后重试 |
| 500 | AgentArts.03000003 | 创建运行时失败: {0} | 运行时资源创建失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000004 | 删除运行时失败: {0} | 运行时资源删除失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000005 | 运行时服务错误: {0} | 智能体运行时服务内部错误 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000014 | 创建版本失败: {0} | 运行时版本创建失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000015 | 获取版本失败: {0} | 运行时版本查询失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000017 | 删除版本失败: {0} | 运行时版本删除失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03000018 | 版本服务错误: {0} | 运行时版本操作内部错误 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03005500 | 系统错误，请稍后重试 | 系统内部错误 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03008004 | 查询子网失败: {0} | 查询子网信息异常 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03008006 | 创建DNS记录失败: {0} | 创建DNS记录失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03008016 | 创建DNS域名失败: {0} | 创建DNS域名失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03009001 | 身份认证创建失败: {0} | 创建运行时对应的入站身份认证失败 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.03009002 | 身份认证删除失败: {0} | 删除运行时对应的入站身份认证失败 | 请稍后重试或联系技术支持 |
| 503 | AgentArts.03008009 | DNS服务不可用 | DNS服务不可用 | 请稍后重试或联系技术支持 |
| 400 | AgentArts.01010001 | 请求参数格式无效 | 请求参数格式无效 | 请检查请求参数格式是否正确 |
| 401 | AgentArts.01020002 | 认证失败 | 认证失败 | 请检查认证凭据是否正确 |
| 403 | AgentArts.01010002 | 权限不足 | 权限不足 | 请检查用户权限配置 |
| 403 | AgentArts.01010003 | 内置策略不可修改 | 内置策略不可修改 | 内置策略不支持修改操作 |
| 403 | AgentArts.01010004 | 内置策略不可删除 | 内置策略不可删除 | 内置策略不支持删除操作 |
| 403 | AgentArts.01020003 | 权限不足 | 权限不足 | 请检查用户权限配置 |
| 404 | AgentArts.01010005 | 指定的Space不存在 | 指定的Space不存在 | 请检查Space ID是否正确 |
| 404 | AgentArts.01010006 | 指定的策略不存在 | 指定的策略不存在 | 请检查策略ID是否正确 |
| 404 | AgentArts.01010007 | 指定的任务不存在 | 指定的任务不存在 | 请检查任务ID是否正确 |
| 404 | AgentArts.01020005 | 资源未找到 | 资源未找到 | 请检查请求的资源ID是否正确 |
| 429 | AgentArts.01020008 | 请求过多 | 请求过多 | 请稍后重试 |
| 500 | AgentArts.01010008 | 内部服务错误 | 内部服务错误 | 请联系技术支持 |
| 500 | AgentArts.01020004 | 内部服务错误 | 内部服务错误 | 请联系技术支持 |
| 400 | AgentArts.01020001 | 请求参数无效 | 请求参数无效 | 请检查请求参数格式是否正确 |
| 401 | AgentArts.01020002 | 认证失败 | 认证失败 | 请检查认证凭据是否正确 |
| 403 | AgentArts.01020003 | 权限不足 | 权限不足 | 请检查用户权限配置 |
| 404 | AgentArts.01020005 | 资源未找到 | 资源未找到 | 请检查请求的资源ID是否正确 |
| 409 | AgentArts.01020006 | 请求冲突 | 请求冲突 | 请检查请求幂等键或重试 |
| 413 | AgentArts.01020007 | 数量超过限制 | 数量超过限制 | 请减少请求数量后重试 |
| 429 | AgentArts.01020008 | 请求过多 | 请求过多 | 请稍后重试 |
| 500 | AgentArts.01020004 | 内部服务错误 | 内部服务错误 | 请联系技术支持 |
| 400 | AgentArts.04000400 | 参数 {0} 校验失败:{1} | 接口调用请求参数错误 | 请检查请求参数是否正确并按照正确格式修改后重试 |
| 400 | AgentArts.04001004 | 工具状态不允许该操作 | 工具状态不允许该操作 | 请避免对非运行状态的工具进行操作 |
| 400 | AgentArts.04001006 | 账号ID不存在 | 账号ID不存在 | 请检查账号ID是否存在并采用正确的账号ID重试 |
| 401 | AgentArts.04000401 | 认证失败:{0} | 认证失败 | 请使用正确的用户凭据进行接口调用 |
| 401 | AgentArts.04001003 | 认证信息不匹配:{0} | 认证信息不匹配 | 请使用正确的用户凭据进行接口调用 |
| 403 | AgentArts.04000403 | 操作禁止:{0} | 接口调用被禁止 | 请检查请求参数是否正确，使用正确的参数进行重试 |
| 403 | AgentArts.04001001 | 资源 {0} 配额超限，当前配额：{1}，单位：{2} | 资源使用配额超限 | 请申请新的配额或删除废弃的资源后再重试。 |
| 404 | AgentArts.04000404 | 查找不到:{0} | 资源不存在 | 请确认请求的资源是否存在 |
| 404 | AgentArts.04001008 | 云服务资源 {0} ID: {1} 不存在 | 云服务对应的资源不存在 | 请确认请求的资源是否存在 |
| 405 | AgentArts.04000405 | 请求方法不支持:{0} | 接口调用请求方法参数错误 | 请使用正确的请求方法调用接口 |
| 500 | AgentArts.04000500 | 服务内部错误 | 服务内部错误 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.04001002 | 找不到相关镜像 | 找不到相关镜像 | 请检查指定镜像是否存在或联系技术支持 |
| 500 | AgentArts.04001005 | 调用{0}接口异常 | 调用服务接口异常 | 请稍后重试或联系技术支持 |
| 500 | AgentArts.04001007 | 找不到项目 | 找不到项目 | 请使用正确的项目ID进行重试 |
| 500 | AgentArts.04001009 | 通知配置服务器失败: {0} | 通知配置服务器失败 | 请稍后重试或联系技术支持 |
