按工作空间列出任务模板，支持分页与排序；可按创建者、TemplateId、TemplateName 筛选。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /api/v1/jobtemplates HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| WorkspaceId |
string |
是 |
工作空间 ID |
4***9 |
| UserId |
string |
否 |
用户 ID |
20**************02 |
| TemplateId |
string |
否 |
按模板 ID 精确筛选列表 |
tpl1****6jcq2q |
| TemplateName |
string |
否 |
按模板名称模糊筛选列表 |
job-template-example-1778047**** |
| SortBy |
string |
否 |
排序字段 |
GmtCreateTime |
| Order |
string |
否 |
排序顺序 |
desc |
| PageNumber |
integer |
否 |
页码 |
1 |
| PageSize |
integer |
否 |
每页数量 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回 body |
||
| JobTemplates |
array<object> |
模板列表 |
|
|
array<object> |
模板信息 |
||
| TemplateId |
string |
模板 ID |
tpl1r5g9ait7**** |
| TemplateName |
string |
模板名称 |
job-template-1772516653885 |
| Description |
string |
模板描述 |
job description |
| Metadata |
object |
自定义元数据 |
{} |
| UserId |
string |
创建者 ID |
20**************26 |
| WorkspaceId |
string |
工作空间 ID |
88**** |
| TenantId |
string |
租户 ID |
142388383837**** |
| DefaultVersion |
integer |
默认版本号 |
2 |
| GmtCreateTime |
string |
创建时间 |
2026-01-23T07:29:06Z |
| GmtModifyTime |
string |
修改时间 |
2026-03-03T05:48:02Z |
| ModifiedBy |
string |
最后修改者 ID |
20**************26 |
| TotalCount |
integer |
总记录数 |
100 |
| PageNumber |
integer |
当前页码 |
1 |
| PageSize |
integer |
每页数量 |
50 |
| RequestId |
string |
请求 ID |
473469C7-AA6F-4DC5-B3DB-A3DC0D***** |
示例
正常返回示例
JSON格式
{
"JobTemplates": [
{
"TemplateId": "tpl1r5g9ait7****",
"TemplateName": "job-template-1772516653885",
"Description": "job description",
"Metadata": {},
"UserId": "20**************26",
"WorkspaceId": "88****",
"TenantId": "142388383837****",
"DefaultVersion": 2,
"GmtCreateTime": "2026-01-23T07:29:06Z",
"GmtModifyTime": "2026-03-03T05:48:02Z",
"ModifiedBy": "20**************26"
}
],
"TotalCount": 100,
"PageNumber": 1,
"PageSize": 50,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0D*****"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。