数据复制服务 DRS-创建对比任务:请求参数

时间:2024-10-18 19:41:52

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

指定类型为application/json。

缺省值:application/json

X-Auth-Token

String

IAM 服务获取的用户Token。

X-Language

String

请求语言类型。

缺省值:en-us

取值:

  • en-us
  • zh-cn
表3 请求Body参数

参数

是否必选

参数类型

描述

job_id

String

任务ID。

object_level_compare_type

String

对象级对比类型,取值为空代表不创建对象级对比。object_level_compare_type和data_level_compare_info都为空时,只查询已创建的对比任务列表。

取值:objects

data_level_compare_info

Object

数据级对比信息,不创建数据级对比时可以不传。object_level_compare_type和data_level_compare_info都为空时,只查询已创建的对比任务列表。

详情请参见表4

表4 data_level_compare_info字段数据结构说明

参数

是否必选

参数类型

描述

conflict_policy

String

一个任务只允许有一个未完成的数据级对比任务,该字段决定对未完成数据级对比任务的处理方式。cancel:取消后重新创建。keep:保持未完成的不再创建。

取值:

  • cancel
  • keep

compare_type

String

数据级对比类型,lines:行对比,contents:内容对比。

取值:

  • lines
  • contents
    说明:

    不能同时进行对象级对比和内容对比。

compare_mode

String

数据级对比模式,取值为空时需要在compare_object_infos或者compare_object_infos_with_token传对象信息,quick_comparison-快速对比,需要加入该功能的白名单才能使用。

缺省值:quick_comparison

取值:quick_comparison

start_time

String

对比任务启动时间,取值为空代表立即启动。

compare_object_infos

Array of objects

数据级对比的对象。非“快速对比”模式时,compare_object_infos和compare_object_infos_with_token根据链路二选一传值,不允许都为空。

详情请参见表5

compare_object_infos_with_token

Array of objects

数据级对比的对象(Cassandra灾备专用,带token信息)。非“快速对比”模式时,compare_object_infos和compare_object_infos_with_token根据链路二选一传值,不允许都为空。

详情请参见表6

表5 compare_object_infos字段数据结构说明

参数

是否必选

参数类型

描述

db_name

String

库名。

table_name

Array of strings

该库下的表名列表。

表6 compare_object_infos_with_token字段数据结构说明

参数

是否必选

参数类型

描述

db_name

String

库名。

table_name_with_token

Array of objects

该库下的表信息列表(带token)。

详情请参见表7

表7 table_name_with_token字段数据结构说明

参数

是否必选

参数类型

描述

table_name

String

表名。

min_token

String

该表的min token。

max_token

String

该表的max token。

support.huaweicloud.com/api-drs/drs_03_0136.html