文档中心

应用性能监控全链路版

Trace 分析

ListCozeloopEvaluationSets

分页获取指定 CozeLoop 工作空间下的评测集列表。

请求说明

应用性能监控已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地选择最合适的接入点。

请求方式：POST

请求地址：https://apmplus-server.cn-beijing.volcengineapi.com?Action=ListCozeloopEvaluationSets&Version=2024-07-30

请求参数

下方仅列出该接口特有的请求参数和部分公共参数，更多详细信息参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	ListCozeloopEvaluationSets	接口名称。当前 API 的名称为 ListCozeloopEvaluationSets。
Version	String	是	2024-07-30	接口版本。当前 API 的版本为 2024-07-30。
WorkspaceId	String	是	ws-12345	CozeLoop 工作空间 ID。
Filter	Object of ListCozeloopEvaluationSetsRequestFilter	否	{"Name":"Trace"}	评测集过滤条件。
PageToken	String	否	next-page-token	分页游标，首次请求无需传入。
PageSize	Integer	否	20	每页数量，取值范围为 1 到 200。
Order	String	否	Desc	排序方向。取值： ASC：升序排列 DESC：降序排列（默认值）
OrderBy	String	否	CreatedAt	排序字段。取值： CreatedAt：创建时间 UpdatedAt：更新时间（默认值）
CozeToken	String	是	pat_xxx	访问 CozeLoop 的授权令牌。

ListCozeloopEvaluationSetsRequestFilter

参数	类型	是否必选	示例值	描述
Name	String	否	Trace	评测集名称过滤条件。

请求示例

POST https://apmplus-server.cn-beijing.volcengineapi.com?Action=ListCozeloopEvaluationSets&Version=2024-07-30​
{​
    "WorkspaceId": "ws-12345",​
    "Filter": {​
        "Name": "Trace"​
    },​
    "PageToken": "next-page-token",​
    "PageSize": 20,​
    "Order": "Desc",​
    "OrderBy": "CreatedAt",​
    "CozeToken": "pat_xxx"​
}

返回参数

参数	类型	示例值	描述
Items	Array of EvaluationSet	[{"Id":"eval-set-67890","Name":"Trace Evaluation Set","Status":"active"}]	评测集列表。
HasMore	Boolean	false	是否还有下一页。
TotalCount	Long	1	评测集总数。
NextPageToken	String	next-page-token	下一页分页游标。

EvaluationSet

参数	类型	示例值	描述
Id	String	eval-set-67890	评测集 ID。
Name	String	Trace Evaluation Set	评测集名称。
Status	String	active	评测集状态。
BaseInfo	Object of BaseInfo	{"CreatedBy":{"UserId":"10000001"},"UpdatedBy":{"UserId":"10000002"}}	评测集创建和更新信息。
ItemCount	Long	100	评测集数据项数量。
Description	String	Evaluation set for Trace data	评测集描述。
LatestVersion	String	v1	最新版本号。
CurrentVersion	Object of EvaluationSetVersion	{"VersionId":"version-1","Version":"v1","Description":"Initial version","ItemCount":100}	当前评测集版本。
ChangeUncommitted	Boolean	false	是否存在未提交的变更。

BaseInfo

参数	类型	示例值	描述
CreatedBy	Object of UserInfo	{"UserId":"10000001"}	任务的创建者信息。
UpdatedBy	Object of UserInfo	{"UserId":"10000002"}	任务最近一次更新操作的执行者信息。

UserInfo

参数	类型	示例值	描述
UserId	String	10000001	用户 ID。

EvaluationSetVersion

参数	类型	示例值	描述
Version	String	v1	评测集版本号。
BaseInfo	Object of BaseInfo	{"CreatedBy":{"UserId":"10000001"},"UpdatedBy":{"UserId":"10000002"}}	版本创建和更新信息。
ItemCount	Long	100	当前版本的数据项数量。
VersionId	String	version-1	评测集版本 ID。
Description	String	Initial version	评测集版本描述。
EvaluationSetSchema	Object of EvaluationSetSchema	{"FieldSchemas":[{"Name":"trace_id","Description":"Trace ID","ContentType":"Text","IsRequired":true}]}	评测集字段结构。

EvaluationSetSchema

参数	类型	示例值	描述
FieldSchemas	Array of FieldSchema	[{"Name":"trace_id","Description":"Trace ID","ContentType":"Text","IsRequired":true}]	评测集字段结构列表。

FieldSchema

参数	类型	示例值	描述
Name	String	trace_id	字段名称。
IsRequired	Boolean	true	字段是否必填。
TextSchema	String	{"type":"string"}	文本字段的 JSON Schema 定义。
ContentType	String	Text	字段内容类型。
Description	String	Trace ID	字段描述。
DefaultDisplayFormat	String	plain_text	字段默认展示格式。

返回示例

{​
    "Result": {​
        "Items": [​
            {​
                "Id": "eval-set-67890",​
                "Name": "Trace Evaluation Set",​
                "Status": "active",​
                "BaseInfo": {​
                    "CreatedBy": {​
                        "UserId": "10000001"​
                    },​
                    "UpdatedBy": {​
                        "UserId": "10000002"​
                    }​
                },​
                "ItemCount": 100,​
                "Description": "Evaluation set for Trace data",​
                "LatestVersion": "v1",​
                "CurrentVersion": {​
                    "VersionId": "version-1",​
                    "Version": "v1",​
                    "Description": "Initial version",​
                    "BaseInfo": {​
                        "CreatedBy": {​
                            "UserId": "10000001"​
                        },​
                        "UpdatedBy": {​
                            "UserId": "10000002"​
                        }​
                    },​
                    "ItemCount": 100,​
                    "EvaluationSetSchema": {​
                        "FieldSchemas": [​
                            {​
                                "Name": "trace_id",​
                                "Description": "Trace ID",​
                                "ContentType": "Text",​
                                "IsRequired": true,​
                                "TextSchema": "{\"type\":\"string\"}",​
                                "DefaultDisplayFormat": "plain_text"​
                            }​
                        ]​
                    }​
                },​
                "ChangeUncommitted": false​
            }​
        ],​
        "HasMore": false,​
        "TotalCount": 1,​
        "NextPageToken": "next-page-token"​
    },​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "ListCozeloopEvaluationSets",​
        "Version": "2024-07-30",​
        "Service": "apmplus_server",​
        "Region": "cn-north-1"​
    }​
}

错误码

若接口调用返回异常，可参考以下接口错误码和公共错误码进行故障排查。

HTTP 状态码	错误码	错误信息	说明
500	ErrInternalServerError	We encountered an unexpected server error, please try again later.	服务器内部错误。

最近更新时间：2026.07.30 15:07:42

这个页面对您有帮助吗？

有用

无用