文档首页/ 部署 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

错误码

请参见错误码。