异步启动 MCP Server 连通性和工具列表检测,首次调用会提示需要等待一分钟拉起资源,后再次调用将返回用于轮询结果的临时 Session ID。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| McpServerUuid |
string |
否 |
要检测连通性并查询工具列表的 MCP Server ID。仅服务创建者可触发检测。 |
44lg***z65 |
| Language |
string |
否 |
检测会话使用的语言。 |
CHINESE |
| DMSUnit |
string |
否 |
运行 Data Agent 资源的 DMS 单元标识。 |
cn-hangzhou |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID,用于定位本次调用。 |
550e8400-e29b-41d4-a716-446655440000 |
| Success |
boolean |
请求处理是否成功。取值为 true 表示成功,取值为 false 表示失败。 |
|
| ErrorCode |
string |
返回码。请求成功时为 success;请求失败时为对应的错误码。 |
success |
| ErrorMessage |
string |
系统级请求失败时返回的错误信息。 |
agent status=wait_resource_running |
| Data |
object |
异步检测启动结果。资源仍在启动时可能只返回 StartTimestamp。 |
|
| SessionId |
string |
本次检测的临时会话 ID。启动成功后使用该值调用 GetListMcpServerToolsResult 轮询结果。 |
1vw***6wr |
| StartTimestamp |
string |
服务端启动检测的 Unix 时间戳,单位为毫秒。 |
1785819600000 |
示例
正常返回示例
JSON格式
{
"RequestId": "550e8400-e29b-41d4-a716-446655440000",
"Success": true,
"ErrorCode": "success",
"ErrorMessage": "agent status=wait_resource_running",
"Data": {
"SessionId": "1vw***6wr",
"StartTimestamp": "1785819600000"
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。