Docs
api
Data Transmission Service(UDTS)
CreateUDTSTask

Create UDTS Task - CreateUDTSTask

Overview

Create UDTS Task

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is CreateUDTSTask.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, transfer (data transfer) or integration (data integration)Yes
Source.N.ModestringTask mode, the value can be full, incremental, full+incremental, bidirectionalYes
Source.N.DataTypestringDatabase type, such as mysqlYes
Source.N.NWTypestringSource network type, can be public, user, dedicated_lineYes
Source.N.ServiceTypestringService type, the value can be small, medium, large, corresponding to “Basic Edition”, “Light Edition” and “Flagship Edition” respectively.Yes
Source.N.BandwidthLimitintSource speed limit, unit is MB/sNo
Source.N.MySQLNode.HoststringSource Database AddressNo
Source.N.MySQLNode.PortintSource Database PortNo
Source.N.MySQLNode.UserstringSource database usernameNo
Source.N.MySQLNode.PasswordstringSource Database PasswordNo
Source.N.MySQLNode.VPCIdstringSource database VPC ID, needs to be filled in when the network type is ‘user’. It can be obtained from https://console.dezai.com/vpc/vpc, for example, uvnet-u0ecace.No
Source.N.MySQLNode.SubnetIdstringSource database subnet ID, needs to be filled in when the network type is ‘user’, can be obtained from https://console.dezai.com/vpc/subnet, for example, subnet-2sloxs.No
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
QueryData.N.TableData.TableNamesstringThis field is temporarily unusedNo
QueryData.N.TableData.ExcludeTablesbooleanThis field is temporarily unusedNo
TableMaps.N.TableNamestringTable name that needs to be migrated during data integrationNo
TableMaps.N.NewTableNamestringTable name after data integration migrationNo
Source.N.MySQLNode.KeepExistDatabooleanWhether to retain the original data, this parameter is only effective when data integration is in progress.No
Source.N.MySQLNode.DupActionstringDuplication data processing rules, this parameter is only effective during data integration, the value is either ignore or replace.No
Source.N.MySQLNode.SSLSecurity.SSLCAstringCA certificate, currently only supports PEM format; need to base64 the file content.No
Source.N.MySQLNode.SSLSecurity.SSLCertstringClient Certificate; The file content needs to be base64No
Source.N.MySQLNode.SSLSecurity.SSLKeystringClient private key, the file content needs to be base64No
Target.ModestringYes
Target.DataTypestringTarget database type, for example mysqlYes
Target.NWTypestringTarget db network type, currently only supports userYes
Target.BandwidthLimitstringDestination end speed limit, unit in MB/sNo
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
Target.MySQLNode.NoBinlogbooleanWhether to temporarily disable the generation of binlog in the target MySQL during the full process, it can be used when the target disk space is insufficient, or when a faster migration speed is needed. This parameter will disrupt the high availability of the target MySQL.No
MaxRetryCountstringRetry times, maximum is 5. Default is 0.No
QuerystringThis field is temporarily unusedNo
IsUnidirectionstringThis field is temporarily unusedNo
RemarkstringNote information, length cannot exceed 255No
QuantityintPurchase duration, default: 1No
ChargeTypestringPayment method, enumeration values are: Year, pay annually; Month, pay monthly; Dynamic, pay on demand (permission required); default is monthly payment.No
CouponIdstringVoucher ID, not used by defaultNo

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
DataobjectYes
TaskIdstringTask ID, currently used for console operation logsNo

Example

Request Example

https://api.dezai.com/?Action=CreateUDTSTask
&Region=cn-zj
&ProjectId=RxjtEuje
&Name=AxfpqbHf
&Type=LSwCQRth
&Source=DmzCcRiT
&Target=PIVlSiCd
&MaxRetryCount=iPgQdCJm
&Query=YqlCGHLR
&IsDedicatedLine=false
&IsUnidirection=NYPZcshe
&Source.N.Mode=fWsqXqqm
&Source.N.DataType=TGmlMgtA
&Source.N.MySQLNode.Host=nTEGdKOV
&Source.N.MySQLNode.Port=9
&Source.N.MySQLNode.User=PPPsDLEy
&Source.N.MySQLNode.Password=UEEuSVpz
&Source.N.MySQLNode.VPCId=RbLzaWDM
&Source.N.MySQLNode.SubnetId=sHQsachY
&Source.N.MySQLNode.DataRegion=jQPRqZAQ
&Source.N.MySQLNode.Database=HvYuzdTY
&Source.N.MySQLNode.Table=ikPDQCrF
&Source.N.MySQLNode.SyncData.BinlogName=VSbjNbof
&Source.N.MySQLNode.SyncData.BinlogPos=FpQadMWc
&Source.N.MySQLNode.SyncData.ServerID=vcgeBxiE
&Source.N.MySQLNode.SyncData.BinlogGTID=zLehFoxC
&Remark=EtIKkkRF
&Source.N.Mode=uDwvRgXl
&Source.N.DataType=DbBEiBzx
&Source.N.MySQLNode.Host=QCuymrrw
&Source.N.MySQLNode.Port=4
&Source.N.MySQLNode.User=MarpaRLp
&Source.N.MySQLNode.Password=qdYuFUQV
&Source.N.MySQLNode.VPCId=jNXsoOuw
&Source.N.MySQLNode.SubnetId=ZckYkcsB
&Source.N.MySQLNode.DataRegion=hNFUVoFD
&Source.N.MySQLNode.Database=paqulSIo
&Source.N.MySQLNode.Table=LevJUVpc
&Source.N.MySQLNode.SyncData.BinlogName=yWEMtwth
&Source.N.MySQLNode.SyncData.BinlogPos=4
&Source.N.MySQLNode.SyncData.ServerID=7
&Source.N.MySQLNode.SyncData.BinlogGTID=tkPozizE
&Source.N.MySQLNode.QueryData.N.DBName=PmTlGFxe
&Source.N.MySQLNode.QueryData.N.NewDBName=AuKmDOWG
&Source.N.MySQLNode.QueryData.N.TableData.TableNames=YOqUXbCU
&Source.N.MySQLNode.QueryData.N.TableData.ExcludeTables=false
&Source.N.MySQLNode.QueryData.N.TableMaps.N.TableName=TkNweIYw
&Source.N.MySQLNode.QueryData.N.TableMaps.N.NewTableName=Rkpkgosy
&Source.N.MySQLNode.KeepExistData=false
&Source.N.MySQLNode.DupAction=kNJFnpEk
&Source.N.MySQLNode.NoBinlog=lBRXNtLr
&Remark=EdjTSZqb
&Source.N.Mode=GCHwvAzt
&Source.N.DataType=KgnzrHgW
&Source.N.MySQLNode.Host=eqKqgEch
&Source.N.MySQLNode.Port=3
&Source.N.MySQLNode.User=SkPjrFne
&Source.N.MySQLNode.Password=kXgeJFVs
&Source.N.MySQLNode.VPCId=wKnpHJUL
&Source.N.MySQLNode.SubnetId=EDvTEptA
&Source.N.MySQLNode.DataRegion=UbTExpri
&Source.N.MySQLNode.Database=kbThgUPN
&Source.N.MySQLNode.Table=kUhnQaHD
&Source.N.MySQLNode.SyncData.BinlogName=ucmFxWqu
&Source.N.MySQLNode.SyncData.BinlogPos=8
&Source.N.MySQLNode.SyncData.ServerID=1
&Source.N.MySQLNode.SyncData.BinlogGTID=vmQUWAso
&Source.N.MySQLNode.QueryData.N.DBName=TjzHlKBS
&Source.N.MySQLNode.QueryData.N.NewDBName=wveCIOeo
&Source.N.MySQLNode.QueryData.N.TableData.TableNames=ZLNqouij
&Source.N.MySQLNode.QueryData.N.TableData.ExcludeTables=false
&Source.N.MySQLNode.QueryData.N.TableMaps.N.TableName=dukuiUfI
&Source.N.MySQLNode.QueryData.N.TableMaps.N.NewTableName=bpOzaOOY
&Source.N.MySQLNode.KeepExistData=true
&Source.N.MySQLNode.DupAction=qpKOxddJ
&Source.N.MySQLNode.NoBinlog=ZmIFChsZ
&Target.Mode=RboYuTfl
&Target.DataType=lGvNkvQC
&Target.MySQLNode.Host=WHsxlqhF
&Target.MySQLNode.Port=9
&Target.MySQLNode.User=fqccASPj
&Target.MySQLNode.Password=aiOFwckd
&Target.MySQLNode.VPCId=eCxGDRjy
&Target.MySQLNode.SubnetId=KTYviHnO
&Target.MySQLNode.DataRegion=JAJjVkwt
&Remark=LqITzTWH
&Source.N.Mode=MeuRHalq
&Source.N.DataType=HGtXznTH
&Source.N.MySQLNode.Host=MXzVlABy
&Source.N.MySQLNode.Port=6
&Source.N.MySQLNode.User=VkFlnvFJ
&Source.N.MySQLNode.Password=cZsjBPEN
&Source.N.MySQLNode.VPCId=yhseMSjn
&Source.N.MySQLNode.SubnetId=vzigyOkC
&Source.N.MySQLNode.DataRegion=GNfKXekt
&Source.N.MySQLNode.Database=VDYbUHJz
&Source.N.MySQLNode.Table=HPoGAdzN
&Source.N.MySQLNode.SyncData.BinlogName=WnhzlWBW
&Source.N.MySQLNode.SyncData.BinlogPos=6
&Source.N.MySQLNode.SyncData.ServerID=5
&Source.N.MySQLNode.SyncData.BinlogGTID=dgpWMwNV
&Source.N.MySQLNode.QueryData.N.DBName=tVfORnwW
&Source.N.MySQLNode.QueryData.N.NewDBName=kATgswhS
&Source.N.MySQLNode.QueryData.N.TableData.TableNames=SRIMxFtx
&Source.N.MySQLNode.QueryData.N.TableData.ExcludeTables=true
&Source.N.MySQLNode.QueryData.N.TableMaps.N.TableName=WBnoOVha
&Source.N.MySQLNode.QueryData.N.TableMaps.N.NewTableName=tNKMGxTU
&Source.N.MySQLNode.KeepExistData=true
&Source.N.MySQLNode.DupAction=QjlOgJIR
&Source.N.MySQLNode.NoBinlog=UNQtIBlq
&Target.Mode=bxjaBkue
&Target.DataType=rxOuZsXz
&Target.MySQLNode.Host=uCNhKVcq
&Target.MySQLNode.Port=8
&Target.MySQLNode.User=SQvUtfEt
&Target.MySQLNode.Password=mFtYsBCO
&Target.MySQLNode.VPCId=mbxEJZpE
&Target.MySQLNode.SubnetId=hLGVVyoA
&Target.MySQLNode.DataRegion=DzsvzZZo
&Source.N.NWType=yGuzFPDP
&Source.N.BandwidthLimit=6
&Target.NWType=AdfJzmEz
&Target.BandwidthLimit=CFGpkzid
&Source.N.MySQLNode.SSLSecurity.SSLCA=MQKwVQcF
&Source.N.MySQLNode.SSLSecurity.SSLCert=yrUzEnuZ
&Source.N.MySQLNode.SSLSecurity.SSLKey=OYuQESyM
&Source.N.ServiceType=vVuYpUaV
&Quantity=4
&ChargeType=diYSAAQT
&CouponId=flfTnXPG

Response Example

{
  "Action": "CreateUDTSTaskResponse",
  "Data": {},
  "Message": "FnZvjDcL",
  "RetCode": 0,
  "TaskID": "zJeiMttl"
}