文档首页/ 数据复制服务 DRS/ API参考/ API v5（公测中）/ 实例详情/ 查询用户对比详情 - ShowCompareUsersDetail
更新时间：2026-05-11 GMT+08:00
查看PDF
分享

查询用户对比详情 - ShowCompareUsersDetail

功能介绍

查询用户对比详情

授权信息

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

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

URI

GET /v5/{project_id}/jobs/{job_id}/compare/users/{compare_job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。 获取方法请参见获取项目ID。

job_id

是

String

任务ID。

compare_job_id

是

String

对比任务的ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

String

偏移量，表示查询该偏移量后面的记录，默认为0。

limit

否

String

查询返回记录的数量限制，默认为10。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

否

String

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

X-Auth-Token

是

String

从IAM服务获取的用户Token。

用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。

枚举值：

  • en-us

  • zh-cn

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

用户对比信息的总数

user_compare_info

Array of objects

用户对比信息

详情请参看CompareUserInfo。
表5 CompareUserInfo

参数

参数类型

描述

id

String

id

src_user_name

String

源数据库账号名称

tar_user_name

String

目标数据库账号名称

src_privileges

String

源数据库账号权限

tar_privileges

String

目标数据库账号权限

is_target_existed

Boolean

目标端是否存在，取值：

  • false：不存在

  • true：存在

compare_result

Integer

对比结果，取值：

  • INCONSISTENT：不一致

  • UNABLE_TO_COMPARE：无法比对

  • CONSISTENT：一致

  • TARGET_SCHEMA_NOT_EXIST：目标库不存在

  • COMPARE_FAILED：比对失败

  • COMPARING：比对中

  • WAITING_COMPARE：等待比对

  • UNKNOWN：未知错误

created_at

String

创建时间

updated_at

String

更新时间

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r/compare/users/fc77e18b-21c8-4040-96b5-ae599d3jb201

响应示例

状态码：200

{
  "total_count" : 3,
  "user_compare_info" : [ {
    "id" : "acc-1001",
    "src_user_name" : "job-20251201-001",
    "tar_user_name" : "db_user_001",
    "src_privileges" : "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, RELOAD, PROCESS, REFERENCES, INDEX, ALTER, SHOW DATABASES, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, CREATE USER, EVENT, TRIGGER, CREATE ROLE, DROP ROLE ON *.* TO `root`@`%` WITH GRANT OPTION;GRANT XA_RECOVER_ADMIN ON *.* TO `root`@`%` WITH GRANT OPTION",
    "dst_privileges" : "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, RELOAD, PROCESS, REFERENCES, INDEX, ALTER, SHOW DATABASES, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, CREATE USER, EVENT, TRIGGER, CREATE ROLE, DROP ROLE ON *.* TO `root`@`%` WITH GRANT OPTION;GRANT XA_RECOVER_ADMIN ON *.* TO `root`@`%` WITH GRANT OPTION",
    "is_target_existed" : true,
    "compare_result" : 2,
    "created_at" : "2025-12-01T10:30:45Z",
    "updated_at" : "2025-12-01T14:22:10Z"
  } ]
}

状态码：400

Bad Request

{
  "error_code" : "DRS.M00202",
  "error_msg" : "The value of limit is invalid."
}

状态码

状态码

描述

200

OK

400

Bad Request

其他状态请参见状态码。

错误码

请参见错误码。

父主题： 实例详情

相关文档