文档首页> 数据复制服务 DRS> API参考> API v5(公测中)> 参数管理> 查询任务的参数配置修改历史
更新时间:2024-01-30 GMT+08:00

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

功能介绍

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

接口约束

  • 仅支持MySQL->MySQL、MySQL->PostgreSQL、MySQL->GaussDB分布式、MySQL->GaussDB主备、MySQL->GaussDB(DWS)、MySQL->GaussDB(for MySQL)、MySQL->Kafka、MySQL->CSS/ES、MySQL->Oracle的实时同步任务使用。
  • 任务状态为配置中、全量中、增量中、全量失败、增量失败、暂停中的实时同步任务使用。

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

错误码

请参见错误码