文档首页/ 数据管理服务 DAS/ API参考/ API（不再推广）/ 修改数据追踪任务 - DataTrackModifyTask
更新时间：2026-01-07 GMT+08:00
查看PDF
分享

修改数据追踪任务 - DataTrackModifyTask

功能介绍

修改数据追踪任务。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    das:clouddba:createBinlogAnalysisTask

    write

    instance

    -

    -

    -

URI

POST /v3/{project_id}/connections/{connection_id}/modify-task

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

connection_id

是

String

参数解释：

连接ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由创建实例连接创建）。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

参数

是否必选

参数类型

描述

task_name

是

String

参数解释：

任务名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start_time

是

Long

参数解释：

解析时间范围开始时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]，实际取决于查询。

默认取值：

不涉及。

end_time

是

Long

参数解释：

解析时间范围结束时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]，实际取决于查询。

默认取值：

不涉及。

db_name

是

String

参数解释：

数据库名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

table_list

否

Array of Strings

参数解释：

表名列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不传入该字段默认选择当前库下全部表。

dml_list

否

Array of Strings

参数解释：

需要解析的DML类型。

约束限制：

不涉及。

取值范围：

  • update
  • insert
  • delete
  • ddl

默认取值：

不传入该字段默认选择全部支持类型。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

id

Long

参数解释：

任务ID。

取值范围：

不涉及。

gmt_create

Long

参数解释：

任务创建时间。

取值范围：

不涉及。

gmt_modified

Long

参数解释：

任务修改时间。

取值范围：

不涉及。

task_name

String

参数解释：

任务名称。

取值范围：

不涉及。

tenant_id

String

参数解释：

创建任务租户ID。

取值范围：

不涉及。

tenant_name

String

参数解释：

创建任务租户名称。

取值范围：

不涉及。

user_id

String

参数解释：

创建任务用户ID。

取值范围：

不涉及。

user_name

String

参数解释：

创建任务用户名称。

取值范围：

不涉及。

network_type

String

参数解释：

数据库引擎类型。

取值范围：

rds

instance_id

String

参数解释：

实例ID。

取值范围：

不涉及。

start_time

Long

参数解释：

解析任务时间范围开始时间。

取值范围：

不涉及。

end_time

Long

参数解释：

解析任务时间范围结束时间。

取值范围：

不涉及。

db_name

String

参数解释：

数据库名称。

取值范围：

不涉及。

table_list

Array of Strings

参数解释：

数据库表名称列表。

取值范围：

不涉及。

dml_list

Array of Strings

参数解释：

需要解析的DML类型。

取值范围：

  • update
  • insert
  • delete
  • ddl

请求示例

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/connections/179e525e-0e9c-4dcc-9dd7-ee2f36121e23/modify-task

{
  "task_name": "test_binlog",
  "start_time": 1766707200740,
  "end_time": 1766714400360,
  "db_name": "cds",
  "table_list": ["departments"],
  "dml_list": ["update", "insert"]
}

响应示例

状态码： 200

Success.

{
    "id": 666,
    "gmt_create": 1766734383335,
    "gmt_modified": 1766734383335,
    "task_name": "test_binlog",
    "tenant_id": "05204146e600d48f0f02c002850ec340",
    "tenant_name": "hwstaff_pub_DasForWlcb",
    "user_id": "052041480300d4871f02c002ddb097b8",
    "user_name": "hwstaff_pub_DasForWlcb",
    "network_type": "rds",
    "connection_id": "a61b44df-2f69-4163-85d8-ba12c3b799f8",
    "instance_id": "bcfa975193f1402fa11a6d4fd6baf5fbin01",
    "start_time": 1766707200740,
    "end_time": 1766714400360,
    "db_name": "cds",
    "table_list": [
        "departments"
    ],
    "dml_list": [
        "update",
        "insert"
    ]
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题： API（不再推广）

相关文档