文档首页/ 部署 CodeArts Deploy/ API参考(联盟区域)/ API/ 应用管理/ 根据开始时间和结束时间查询项目下指定应用的历史部署记录列表
更新时间:2025-12-25 GMT+08:00

根据开始时间和结束时间查询项目下指定应用的历史部署记录列表

功能介绍

根据开始时间和结束时间查询项目下指定应用的历史部署记录列表。

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/task/{id}/history

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目id,获取方式请参见获取项目id

约束限制

不涉及。

取值范围

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

id

String

参数解释

部署任务id。

约束限制

不涉及。

取值范围

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

page

Integer

参数解释

分页页码, 表示从此页开始查询。

约束限制

不涉及。

取值范围

1-99999

默认取值

不涉及。

size

Integer

参数解释

每页显示的条目数量。

约束限制

不涉及。

取值范围

1-100

默认取值

不涉及。

start_date

String

参数解释

区间开始时间。格式为yyyy-MM-dd。例如:2022-03-16。

约束限制

与end_date配合使用,end_date需大于等于start_date,开始时间和结束时间间隔不能超过30天。

取值范围

1970-01-01 ~ 2125-12-30

默认取值

不涉及。

end_date

String

参数解释

区间结束时间。格式为yyyy-MM-dd。例如:2022-04-15。

约束限制

与start_date配合使用,end_date需大于等于start_date,开始时间和结束时间间隔不能超过30天。

取值范围

1970-01-01 ~ 2125-12-30

默认取值

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。 通过调用IAM服务接口获取(响应消息头中X-Subject-Token的值)。

约束限制

不涉及。

取值范围

字符串,长度不超过20000个字符。

默认取值

不涉及。

Content-Type

String

参数解释

消息体的类型(格式)。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

result

Array of ExecuteRecordV2Body objects

参数解释

应用历史部署记录列表。

total_num

Integer

参数解释

开始时间和结束时间内应用历史部署记录总数。

取值范围

不涉及。

表5 ExecuteRecordV2Body

参数

参数类型

描述

duration

String

参数解释

部署用时,格式为:HH:mm:ss。

取值范围

不涉及。

state

String

参数解释

应用最后一次执行状态。

取值范围

  • abort: 部署中止

  • failed: 部署失败

  • not_started: 取消执行

  • pending: 排队中

  • running: 正在部署

  • succeeded: 部署成功

operator

String

参数解释

操作者账号名称。

取值范围

不涉及。

execution_id

String

参数解释

部署记录id。

取值范围

由英文字母、数字组成,且长度为32个字符。

start_time

String

参数解释

部署应用开始时间。格式为yyyy-MM-dd HH:mm:ss。例如:2021-02-25 10:37:27。

取值范围

1970-01-01 00:00:00 ~ 2125-12-30 11:59:59

nickname

String

参数解释

操作人昵称。

取值范围

字符串,长度为[1-30]个字符。

end_time

String

参数解释

部署应用结束时间。格式为yyyy-MM-dd HH:mm:ss。例如:2021-02-25 10:37:27。

取值范围

1970-01-01 00:00:00 ~ 2125-12-30 11:59:59

release_id

Long

参数解释

部署记录序列号。

取值范围

不涉及。

type

String

参数解释

部署类型。

取值范围

  • install: 执行部署

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

https://{endpoint}/v2/5ab1363a143f46aa9959a4a8c2616589/task/ad9c1d60282544d2b5a380ea22539cf1/history?page=2&size=2&start_date=2022-03-16&end_date=2022-04-15

响应示例

状态码:200

OK 请求响应成功

{
  "result" : [ {
    "duration" : "00:16:53",
    "state" : "succeeded",
    "type" : "install",
    "operator" : "devcloud_devcloud_l00490255_01",
    "execution_id" : "50f18ce454a64ea5a62a33d56617b831",
    "start_time" : "2022-04-15 15:03:24",
    "nickname" : "AB边账号",
    "end_time" : "2022-04-15 15:20:17",
    "release_id" : 20
  }, {
    "duration" : "00:15:31",
    "state" : "failed",
    "type" : "install",
    "operator" : "devcloud_devcloud_l00490255_01",
    "execution_id" : "f757fbe93d35494ba0ff73b34e2f79aa",
    "start_time" : "2022-04-15 15:03:15",
    "nickname" : "AB边账号",
    "end_time" : "2022-04-15 15:18:46",
    "release_id" : 19
  } ],
  "total_num" : 20
}

状态码:400

Bad Request

{
  "error_code" : "Deploy.00015002",
  "error_msg" : "Invalid request parameter."
}

状态码:403

Forbidden

{
  "error_code" : "Deploy.00011154",
  "error_msg" : "You do not have permissions to perform this operation."
}

状态码

状态码

描述

200

OK 请求响应成功

400

Bad Request

403

Forbidden

错误码

请参见错误码