查询作业工单列表
功能介绍
查询作业工单列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/executions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
参数解释: 分页参数。 约束限制: 每页返回记录个数限制,不传默认第一页查10个。 取值范围: 不涉及。 默认取值: 不涉及。 |
offset |
否 |
Long |
参数解释: 分页参数。 约束限制: 从offset指定的下一条数据开始查询,不传默认0。 取值范围: 不涉及。 默认取值: 不涉及。 |
creator |
否 |
String |
参数解释: 创建人,模糊查询。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
start_time |
否 |
Long |
参数解释: 开始时间,大于。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
end_time |
否 |
Long |
参数解释: 结束时间,小于。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
document_name |
否 |
String |
参数解释: 作业名称,模糊查询。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
document_id |
否 |
String |
参数解释: 作业id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
tags |
否 |
String |
参数解释: 标签过滤条件,例:?tags=key1=value1,key2=value2。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
exclude_child_executions |
否 |
Boolean |
参数解释: 列表查询不返回子工单。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码。 取值范围: 不涉及。 |
error_msg |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
data |
Array of data objects |
参数解释: 返回数据。 取值范围: 不涉及。 |
total |
Long |
参数解释: 总数。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
execution_id |
String |
参数解释: 工单唯一id。 取值范围: 不涉及。 |
document_name |
String |
参数解释: 作业名称。 取值范围: 不涉及。 |
document_id |
String |
参数解释: 作业id。 取值范围: 不涉及。 |
document_version_id |
String |
参数解释: 作业版本id。 取值范围: 不涉及。 |
document_version |
String |
参数解释: 作业版本号。 取值范围: 不涉及。 |
start_time |
Long |
参数解释: 工单执行开始时间。 取值范围: 不涉及。 |
end_time |
Long |
参数解释: 工单执行结束时间。 取值范围: 不涉及。 |
update_time |
Long |
参数解释: 工单更新时间。 取值范围: 不涉及。 |
creator |
String |
参数解释: 工单创建时间。 取值范围: 不涉及。 |
status |
String |
参数解释: 工单状态。 取值范围: 不涉及。 |
description |
String |
参数解释: 工单执行描述。 取值范围: 不涉及。 |
parameters |
Array of parameters objects |
参数解释: 工单执行全局参数。 取值范围: 不涉及。 |
sys_tags |
Array of sys_tags objects |
参数解释: 系统标签列表。 取值范围: 不涉及。 |
tags |
Array of tags objects |
参数解释: 自定义标签列表。 取值范围: 不涉及。 |
type |
String |
参数解释: 工单类型。
取值范围: |
target_parameter_name |
String |
参数解释: 速率模式执行指定参数。 取值范围: 不涉及。 |
targets |
Array of Target objects |
参数解释: 速率模式执行指定元素。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
参数解释: 速率模式执行类型,InstanceValues。 取值范围: 不涉及。 |
values |
Array of objects |
参数解释: 速率模式执行元素,目前只支持cmdb资源。 取值范围: 不涉及。 |
状态码:400
请求示例
查询作业工单列表。
GET https://{Endpoint}/v1/executions?offset=0&limit=2
响应示例
状态码:200
请求成功。
{
"data" : [ {
"id" : 3025,
"execution_id" : "EX2025070121014xxxxxxx",
"type" : "NORMAL",
"document_name" : "test_document",
"document_id" : "DM202507011802390xxxxxxx",
"document_version_id" : "573634e7-5e69-4b4b-b4a1-b7xxxxxxx",
"document_version" : "v2",
"start_time" : 1751374905000,
"end_time" : null,
"update_time" : 1751374905000,
"status" : "Pending",
"description" : null,
"parameters" : [ ],
"target_parameter_name" : null,
"targets" : null,
"creator" : "COC-Script",
"tags" : [ ],
"sys_tags" : [ ]
}, {
"id" : 3024,
"execution_id" : "EX2025063021172xxxxxxx",
"type" : "NORMAL",
"document_name" : "qweqwe",
"document_id" : "DM202506302117010xxxxxxx",
"document_version_id" : "6b3a059d-2cca-4bb0-82c0-e9xxxxxxx",
"document_version" : "v1",
"start_time" : 1751289441000,
"end_time" : 1751289511000,
"update_time" : 1751289512000,
"status" : "Succeeded",
"description" : null,
"parameters" : [ {
"key" : "aaa",
"value" : "[\"qwe\",\"rew\"]"
} ],
"target_parameter_name" : null,
"targets" : null,
"creator" : "COC-Script",
"tags" : [ ],
"sys_tags" : [ ]
} ],
"total" : 718
}
状态码
状态码 |
描述 |
---|---|
200 |
请求成功。 |
400 |
包含错误信息。 更多状态码请参考状态码。 |
错误码
请参见错误码。