GetAgentSpec - 查询 AgentSpec 详情
查询指定 AgentSpec 的治理详情，包括基础信息、治理指针和全部版本摘要。
接口说明
请求说明
查询指定 AgentSpec 的治理详情，包括基础信息、治理指针和全部版本摘要。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
agentcore:GetAgentSpec |
get |
*AgentSpec
|
无 | 无 |
请求语法
GET /workspaces/{workspaceId}/agent-specs/{agentSpecName} HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspaceId |
string |
是 |
工作空间 ID |
550e8400-e29b-41d4-a716-446655440000 |
| agentSpecName |
string |
是 |
AgentSpec 唯一名称 |
my-worker |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
当前API无需请求参数
调用“查询 AgentSpec 详情”接口时，请按参数定义传入：工作空间 ID、AgentSpec 唯一名称。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
RestResult |
||
| data |
object |
返回数据。 |
|
| bizTags |
string |
业务标签。 |
示例属性值 |
| description |
string |
描述。 |
用于说明资源用途的示例描述。 |
| downloadCount |
integer |
下载次数。 |
10 |
| editingVersion |
string |
当前编辑中的版本。 |
1.0.0 |
| enable |
boolean |
是否启用。 |
|
| from |
string |
来源。 |
UPLOAD |
| labels |
object |
版本标签。 |
|
|
string |
版本标签中的属性值。 |
示例属性值 |
|
| name |
string |
名称。 |
agentspec-example |
| onlineCnt |
integer |
在线版本数量。 |
1 |
| reviewingVersion |
string |
当前审核中的版本。 |
1.0.0 |
| scope |
string |
可见范围。 |
PRIVATE |
| updateTime |
integer |
更新时间，Unix 时间戳，单位为毫秒。 |
1787671022000 |
| versions |
array<object> |
版本摘要列表。 |
|
|
object |
|||
| author |
string |
版本作者。 |
alice |
| createTime |
integer |
创建时间，Unix 时间戳，单位为毫秒。 |
1787671022000 |
| description |
string |
描述。 |
用于说明资源用途的示例描述。 |
| downloadCount |
integer |
下载次数。 |
10 |
| publishPipelineInfo |
string |
发布流水线信息。 |
{"status":"SUCCESS"} |
| status |
string |
状态。 |
READY |
| updateTime |
integer |
更新时间，Unix 时间戳，单位为毫秒。 |
1787671022000 |
| version |
string |
版本号。 |
1.0.0 |
| requestId |
string |
请求 ID。 |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
“查询 AgentSpec 详情”接口的响应包含：请求 ID、返回数据。
示例
正常返回示例
JSON格式
{
"data": {
"bizTags": "示例属性值",
"description": "用于说明资源用途的示例描述。",
"downloadCount": 10,
"editingVersion": "1.0.0",
"enable": true,
"from": "UPLOAD",
"labels": {
"key": "示例属性值"
},
"name": "agentspec-example",
"onlineCnt": 1,
"reviewingVersion": "1.0.0",
"scope": "PRIVATE",
"updateTime": 1787671022000,
"versions": [
{
"author": "alice",
"createTime": 1787671022000,
"description": "用于说明资源用途的示例描述。",
"downloadCount": 10,
"publishPipelineInfo": "{\"status\":\"SUCCESS\"}",
"status": "READY",
"updateTime": 1787671022000,
"version": "1.0.0"
}
]
},
"requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IllegalRequest | Illegal request: %s. | 非法请求 |
| 400 | InvalidParameter | Parameter error: %s. | 参数错误 |
| 400 | InvalidParameter.ImportFileSize | The import file size exceeds the allowed limit: %s. | 导入文件大小超过限制 |
| 500 | InternalError | An internal error occurred. Please try again later. | 内部异常，请稍后重试；如持续失败，请提供 RequestId 排查 |
| 403 | NoPermission | You are not authorized to perform this operation: %s. | 无操作权限 |
| 404 | AgentSpecNotFound | Not found: %s. | |
| 409 | ResourceAlreadyExist | Resource already exists: %s. | 指定的资源已存在 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。