根据开始时间和结束时间查询项目下指定应用的历史部署记录列表
功能介绍
根据开始时间和结束时间查询项目下指定应用的历史部署记录列表。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/task/{id}/history
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目id,获取方式请参见获取项目id。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
id |
是 |
String |
参数解释: 部署任务id。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串,长度不超过20000个字符。 默认取值: 不涉及。 |
|
Content-Type |
是 |
String |
参数解释: 消息体的类型(格式)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
Array of ExecuteRecordV2Body objects |
参数解释: 应用历史部署记录列表。 |
|
total_num |
Integer |
参数解释: 开始时间和结束时间内应用历史部署记录总数。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
duration |
String |
参数解释: 部署用时,格式为:HH:mm:ss。 取值范围: 不涉及。 |
|
state |
String |
参数解释: 应用最后一次执行状态。 取值范围:
|
|
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 |
参数解释: 部署类型。 取值范围:
|
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
状态码:403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。