更新时间:2022-12-08 GMT+08:00

查看迭代历史记录

功能介绍

查看迭代历史记录

URI

GET /v4/iterations/{iteration_id}/histories

表1 路径参数

参数

是否必选

参数类型

描述

iteration_id

Integer

迭代id

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

偏移量

最小值:0

缺省值:0

limit

Integer

每页数量,最大为100

最小值:1

最大值:100

缺省值:10

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:10

最大长度:32768

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

总数

histories

Array of IterationHistory objects

历史记录

表5 IterationHistory

参数

参数类型

描述

iteration_id

String

迭代ID

project_id

String

项目ID

operator

operator object

变更操作人

operate

String

操作类型

operate_time

String

操作时间

details

Array of details objects

操作详情

表6 operator

参数

参数类型

描述

user_id

String

用户uuid

user_name

String

用户名

nick_name

String

昵称

domain_id

String

租户uuid

domain_name

String

租户名

表7 details

参数

参数类型

描述

operate_field_name

String

变更的字段

new_value

String

操作后的值

old_value

String

操作前的值

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表9 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Get https://{endpoint}/v4/iterations/11225793/histories

响应示例

状态码: 200

OK

{
  "total" : 1,
  "histories" : [ {
    "iteration_id" : 123454,
    "project_id" : "19274e1adffb4cc0b866ef6dd3ad0100",
    "operator" : {
      "user_id" : "0a938608ac00f2271f2ec01cccb94c19",
      "user_name" : "Banna",
      "nick_name" : "红海",
      "domain_id" : "9b33eb1d219140fea54d3b5ac689b073",
      "domain_name" : "devcloud_test"
    },
    "operate" : "NEW",
    "operate_time" : "1665473746000",
    "details" : [ {
      "operate_field_name" : "name",
      "old_value" : null,
      "new_value" : "test"
    }, {
      "operate_field_name" : "description",
      "old_value" : null,
      "new_value" : null
    }, {
      "operate_field_name" : "end_time",
      "old_value" : null,
      "new_value" : "1664380800000"
    }, {
      "operate_field_name" : "status",
      "old_value" : null,
      "new_value" : "0"
    }, {
      "operate_field_name" : "begin_time",
      "old_value" : null,
      "new_value" : "1663776000000"
    }, {
      "operate_field_name" : "program_version_id",
      "old_value" : null,
      "new_value" : "-1"
    } ]
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码