查询 Agent 注册信息列表
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。 |
eyJhbGciOiJIUzI1NiIsInR5cC..... |
| PageSize |
integer |
是 |
分页查询大小。 |
2 |
| PageNumber |
integer |
是 |
当前页数，起始值为 1，默认为 1。 |
1 |
| AgentId |
string |
否 |
AgentID，经过 CNNIC 实名认证后，由 CNNIC 统一分配。AgentID 作为 Agent 与实名认证注册人绑定的唯一标识 |
liuq@azt400 |
| AgentDisplayName |
string |
否 |
Agent 显示名称 |
测试Agent |
| AgentHost |
string |
否 |
Agent 主机地址 |
www.example.com |
| AgentVersion |
string |
否 |
Agent 版本 |
1.0.0 |
| Status |
string |
否 |
Agent 状态 |
活跃 |
| MaxResults |
integer |
否 |
本次请求所返回的最大记录条数。 |
100 |
| NextToken |
string |
否 |
下一个查询开始 Token。 |
4698691 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
唯一请求识别码。 |
536E9CAD-DB30-4647-AC87-AA5CC38C5382 |
| PageNumber |
integer |
当前页数，起始值为 1，默认为 1。 |
1 |
| PageSize |
integer |
分页查询时设置的每页行数，最大值 100，默认为 20。 |
20 |
| TotalPages |
integer |
总页数。 |
2 |
| TotalItems |
integer |
总数据条数。 |
11 |
| AgentRegisterInfos |
object |
||
| AgentRegisterInfo |
array<object> |
Agent 信息 |
|
|
array<object> |
|||
| AgentRegisterInfoId |
string |
AgentRegisterInfoId Agent 注册 ID。由阿里云 ATS 平台自动生成，在阿里云 ATS 平台具有全局唯一性。 |
2074753647748672512 |
| AgentId |
string |
AgentID，经过 CNNIC 实名认证后，由 CNNIC 统一分配。AgentID 作为 Agent 与实名认证注册人绑定的唯一标识 |
ag-6c6392b1d226d6e60f7020ce |
| AgentDisplayName |
string |
Agent 显示名称 |
测试Agent |
| AgentHost |
string |
Agent 对外提供服务 Endpoint 域名名称 |
example.com |
| AgentVersion |
string |
Agent 版本 |
1.0.0 |
| Status |
string |
Agent 状态 |
活跃 |
| AtiName |
string |
ATI 名称，在 ATI 信任体系中的全局唯一标识符 示例解析： ati://v1.0.0.www.example.com
|
ati://v1.0.0.www.example.com |
| CreateTimestamp |
string |
创建时间（时间戳）。 |
1585808273000 |
| UpdateTimestamp |
string |
实例配置最后一次修改时间（时间戳）。 |
1729590859000 |
| Endpoints |
object |
||
| Endpoint |
array<object> |
访问端口。取值范围：
|
|
|
object |
访问端口。取值范围：
|
||
| Protocol |
string |
声明该 Agent 端点遵循的通信协议标准，决定调用方如何与该 Agent 交互： 协议 说明 MCP：Model Context Protocol，Anthropic 推出的 Agent 工具调用协议 A2A：Agent-to-Agent Protocol，Google 推出的跨 Agent 通信协议 OpenAPI：标准 RESTful API 规范（Swagger/OpenAPI） 作用：其他 Agent 或客户端看到这个协议标识后，就知道该用什么方式与它对话。比如 MCP 协议走 MCP SDK，A2A 走 A2A SDK，OpenAPI 走标准 HTTP 请求。 |
mcp |
| NextToken |
string |
下一个查询开始 Token。 |
4698691 |
| MaxResults |
integer |
本次请求所返回的最大记录条数。 |
500 |
| AccessDeniedDetail |
object |
访问被拒绝详细信息，只有 RAM 校验失败才会返回此字段。 |
|
| AuthAction |
string |
尝试执行的未授权操作。 |
CreateUser |
| AuthPrincipalDisplayName |
string |
授权主体显示名称。 |
2015555733387XXXX |
| AuthPrincipalOwnerId |
string |
授权主体所有者 ID。 |
1046973331XXXX |
| AuthPrincipalType |
string |
身份类型 |
SubUser |
| EncodedDiagnosticMessage |
string |
加密后的完整诊断信息。 |
AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ== |
| NoPermissionType |
string |
导致鉴权失败的原因。具体取值为：
|
ImplicitDeny |
| PolicyType |
string |
策略类型。 |
DlpSend |
示例
正常返回示例
JSON格式
{
"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
"PageNumber": 1,
"PageSize": 20,
"TotalPages": 2,
"TotalItems": 11,
"AgentRegisterInfos": {
"AgentRegisterInfo": [
{
"AgentRegisterInfoId": "2074753647748672512",
"AgentId": "ag-6c6392b1d226d6e60f7020ce",
"AgentDisplayName": "测试Agent",
"AgentHost": "example.com",
"AgentVersion": "1.0.0",
"Status": "活跃",
"AtiName": "ati://v1.0.0.www.example.com",
"CreateTimestamp": "1585808273000",
"UpdateTimestamp": "1729590859000",
"Endpoints": {
"Endpoint": [
{
"Protocol": "mcp"
}
]
}
}
]
},
"NextToken": "4698691",
"MaxResults": 500,
"AccessDeniedDetail": {
"AuthAction": "CreateUser",
"AuthPrincipalDisplayName": "2015555733387XXXX",
"AuthPrincipalOwnerId": "1046973331XXXX",
"AuthPrincipalType": "SubUser",
"EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
"NoPermissionType": "ImplicitDeny",
"PolicyType": "DlpSend"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。