文档首页/数据复制服务 DRS/API参考/API v5（公测中）/参数管理/查询任务的参数配置修改历史 - ListJobHistoryParameters
更新时间：2025-12-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询任务的参数配置修改历史 - ListJobHistoryParameters

功能介绍

查询任务的参数配置修改历史。

接口约束

  • 仅支持MySQL->MySQL、MySQL->PostgreSQL、MySQL->GaussDB分布式、MySQL->GaussDB集中式、MySQL->TaurusDB、MySQL->Kafka、MySQL->Oracle的实时同步任务使用。
  • 任务状态为配置中、全量中、增量中、全量失败、增量失败、暂停中的实时同步任务使用。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/jobs/{job_id}/configuration-histories

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID。

job_id

是

String

任务ID。

Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量，表示从此偏移量开始查询，offset 大于等于 0。

默认为0。

limit

否

Integer

每页显示的条目数量。默认为10，取值范围【1-1000】。

begin_time

否

String

开始时间，UTC时间，例如：2020-09-01T18:50:20Z。

end_time

否

String

结束时间，UTC时间，例如：2020-09-01T19:50:20Z。

name

否

String

参数名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。

缺省值：application/json

X-Auth-Token

是

String

从IAM服务获取的用户Token。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。

缺省值：en-us

枚举值：

  • en-us
  • zh-cn

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

count

Integer

历史记录总数。

parameter_history_config_list

Array of objects

任务参数历史修改列表。

详情请参见表4。

表4 parameter_history_config_list字段数据结构说明

参数

参数类型

描述

name

String

参数名称。

old_value

String

旧参数值。

new_value

String

新参数值。

is_update_success

Boolean

更新结果。true：成功，false：失败

is_applied

Boolean

是否已应用。true：已应用，false：未应用

update_time

String

参数修改时间。

apply_time

String

参数应用时间。

请求示例

查询任务的参数配置修改历史

https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r/configuration-histories?offset={offset}&limit={limit}&begin_time={begin_time}&end_time={end_time}

响应示例

状态码：200

任务参数配置修改历史列表

{ 
  "count" : 0, 
  "parameter_history_config_list" : [ { 
    "name" : "strapplier_thread_numing", 
    "old_value" : "10", 
    "new_value" : "20", 
    "is_update_success" : true, 
    "is_applied" : "true", 
    "update_time" : "2020-09-01T18:50:20Z", 
    "apply_time" : "2020-09-01T18:50:20Z" 
  } ] 
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：参数管理