文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 查看binlog解析任务详情 - BinlogTaskInfo
更新时间：2025-11-28 GMT+08:00
查看PDF
分享

查看binlog解析任务详情 - BinlogTaskInfo

功能介绍

查看binlog解析任务详情。

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    das:clouddba:listBinlog

    list

    instance

    -

    -

    -

URI

GET /v3/{project_id}/connections/{connection_id}/binlog-parse/get-task-info

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

connection_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

task_id

是

Long

参数解释：

解析任务ID。

约束限制：

不涉及。

取值范围：

不涉及

默认取值：

不涉及

请求参数

无。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

id

Long

参数解释：

解析任务ID。

取值范围：

不涉及

gmt_create

Long

参数解释：

任务创建时间，单位毫秒。

取值范围：

不涉及

gmt_modified

Long

参数解释：

任务修改时间，单位毫秒。

取值范围：

不涉及

tenant_id

String

参数解释：

租户ID。

取值范围：

不涉及

tenant_name

String

参数解释：

租户名称

取值范围：

不涉及

user_id

String

参数解释：

用户ID。

取值范围：

不涉及

user_name

String

参数解释：

用户名称。

取值范围：

不涉及

connection_id

String

参数解释：

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

取值范围：

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

binlog_type

String

参数解释：

binlog类型。

取值范围：

  • latest 最近日志
  • backup 归档日志

file_name

String

参数解释：

binlog文件名称。

取值范围：

不涉及

position

String

参数解释：

binlog文件解析位置。

取值范围：

不涉及

status

Integer

参数解释：

任务状态。

取值范围：

  • 0 初始化
  • 1 运行中
  • 2 部分成功
  • 3 成功
  • 4 失败
  • -1 已删除

err_msg

String

参数解释：

错误信息。

取值范围：

不涉及

请求示例

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/connections/179e525e-0e9c-4dcc-9dd7-ee2f36121e23/binlog-parse/get-task-info?task_id=1164

响应示例

状态码： 200

Success.

{
    "id": 1164,
    "gmt_create": 1764142070701,
    "gmt_modified": 1764142668530,
    "tenant_id": "05204146e600d48f0f02c002850ec340",
    "tenant_name": "Tanant_name",
    "user_id": "052041480300d4871f02c002ddb097b8",
    "user_name": "User_name",
    "connection_id": "f6ec61f9-24c5-4aaf-b42b-d45d23274031",
    "binlog_type": "latest",
    "file_name": "mysql-bin.045356",
    "position": "mysql-bin.045356#1720",
    "status": -1,
    "err_msg": ""
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题： 云DBA

相关文档