Docs
api
Data Transmission Service(UDTS)
CheckUDTSTask

Check Task - CheckUDTSTask

Overview

Provide pre-check function for UDTS tasks

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is CheckUDTSTask.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
ProjectIdstringProject ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.No
NamestringTask name, length cannot exceed 128Yes
TypestringTask type, value is either ‘transfer’ or ‘integration’. When it’s ‘transfer’, the task is ‘Data Migration’. When it’s ‘integration’, the task is ‘Data Integration’.Yes
MaxRetryCountstringRetry times, maximum is 5. Default is 0.Yes
Source.N.ServiceTypestringService type, the value can be small, medium, large, corresponding to “Basic Edition”, “Light Edition” and “Flagship Edition” respectively.Yes
Source.N.ModestringTask mode, the value can be full, incremental, full+incremental, bidirectionalNo
Source.N.DataTypestringDatabase type, such as mysqlNo
Source.N.NWTypestringSource network type, can be public, user, dedicated_lineNo
Source.N.MySQLNode.HoststringSource database address, for example 10.9.37.200No
Source.N.MySQLNode.PortintSource MySQL port, such as 3306No
Source.N.MySQLNode.UserstringSource MySQL username, such as rootNo
Source.N.MySQLNode.PasswordstringSource MySQL PasswordNo
Source.N.MySQLNode.VPCIdstringVPC ID, can be obtained from https://console.dezai.com/vpc/vpc, for example, uvnet-u0ecaceNo
Source.N.MySQLNode.SubnetIdstringSubnet ID, which can be obtained from https://console.dezai.com/vpc/subnet, for example subnet-2sloxsNo
Source.N.MySQLNode.DataRegionstringDatabase region, for example cn-bj2No
Source.N.MySQLNode.DatabasestringName of the DB to be migratedNo
Source.N.MySQLNode.TablestringName of the table to be migratedNo
Source.N.MySQLNode.SyncData.BinlogNamestringThe binlog name needs to be specified during the incremental time, which can be obtained through the ‘show master status’ command, or it will be automatically set in the full + incremental task.No
Source.N.MySQLNode.SyncData.BinlogPosintThe binlog pos that needs to be specified during incremental time can be obtained through show master status, or it will be automatically set by full + incremental tasks.No
Source.N.MySQLNode.SyncData.ServerIDintThe serverID that needs to be specified during the increment cannot be duplicated with the existing slave. This value will be checked during the pre-check.No
Source.N.MySQLNode.SyncData.BinlogGTIDstringThe binlog gtid that needs to be specified during the incremental time can be obtained through the show master status, or it will be automatically set by the full + incremental task.No
QueryData.N.DBNamestringName of the DB to be migrated during data integrationNo
QueryData.N.NewDBNamestringDB Name after Data Integration MigrationNo
QuerystringDiscardNo
Target.DataTypestringTarget database type, for example mysqlNo
Target.NWTypestringTarget db network type, currently only supports userNo
Target.MySQLNode.HoststringTarget database address, for example 10.9.37.212No
Target.MySQLNode.PortintTarget database port, for example 3306No
Target.MySQLNode.UserstringTarget database username, for example rootNo
Target.MySQLNode.PasswordstringTarget Database PasswordNo
Target.MySQLNode.VPCIdstringTarget Database VPC, for example uvnet-1wz5rqteNo
Target.MySQLNode.SubnetIdstringTarget database subnet ID, for example subnet-zl44fktqNo
Target.MySQLNode.DataRegionstringTarget database region, for example cn-bj2No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
DataCheckUDTSTaskResultCheck ResultYes

Data Model

CheckUDTSTaskResult

Field NameTypeDescription InformationRequired
SourceCheckResultNo
TargetCheckResultNo

CheckResult

Field NameTypeDescription InformationRequired
ConfigCheckResultItemNo
ConnectionCheckResultItemNo
PrivilegesCheckResultItemNo

CheckResultItem

Field NameTypeDescription InformationRequired
StatestringYes
ErrMessagestringYes

Example

Request Example

https://api.dezai.com/?Action=CheckUDTSTask
&ProjectId=ySxOuFNP
&Name=iybJMhOY
&Type=kKLbtCIE
&Source=WQVyJAPj
&Target=ELyCuYTU
&MaxRetryCount=ozdxEUIr
&Query=PizEAjrP
&Source.N.Mode=PzcXhLrG
&Source.N.DataType=bZWssMSz
&Source.N.NWType=QTIhWJAT
&Source.N.MySQLNode.Host=tYybGVwL
&Source.N.MySQLNode.Port=2
&Source.N.MySQLNode.User=IVvsQESS
&Source.N.MySQLNode.Password=rehIyiiG
&Source.N.MySQLNode.VPCId=oslSTCGw
&Source.N.MySQLNode.SubnetId=knkzvAuv
&Source.N.MySQLNode.DataRegion=BsDfVJsM
&Source.N.MySQLNode.Database=ICfGrSzd
&Source.N.MySQLNode.Table=sSYUlfrC
&Source.N.MySQLNode.SyncData.BinlogName=aUVlvMba
&Source.N.MySQLNode.SyncData.BinlogPos=9
&Source.N.MySQLNode.SyncData.ServerID=9
&Source.N.MySQLNode.SyncData.BinlogGTID=ZfHgMkbW
&Source.N.MySQLNode.QueryData.N.DBName=AXGkZnMf
&Source.N.MySQLNode.QueryData.N.NewDBName=hGUvPTmf
&Target.DataType=vcFAMLPD
&Target.NWType=ttJRgGYj
&Target.MySQLNode.Host=UJQuSQBf
&Target.MySQLNode.Port=4
&Target.MySQLNode.User=FzrvgBcz
&Target.MySQLNode.Password=LbAmOPmz
&Target.MySQLNode.VPCId=kFiSKqpB
&Target.MySQLNode.SubnetId=VTTYIvGY
&Target.MySQLNode.DataRegion=MzdqBMqb
&Source.N.ServiceType=epppksUq

Response Example

{
  "Action": "CheckUDTSTaskResponse",
  "Data": {},
  "Message": "aKSpQMwy",
  "RetCode": 0
}