Docs
api
Data Transmission Service(UDTS)
GetUDTSTaskStatus

View Service Status - GetUDTSTaskStatus

Overview

View Service Status

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is GetUDTSTaskStatus.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
TaskIdstringTask IDYes
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’.No

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
DataStatusDataStatusDataNo

Data Model

StatusData

Field NameTypeDescription InformationRequired
MaxRetryCountintThe maximum number of failure retries set by the userNo
StatusstringTask Status, the statuses are Created: Created, Checking: Checking, Dumping: Dumping, Loading: Loading, Syncing: Syncing, Synced: Synced, Done: Done, Failed: Failed, Stopping: Stopping, Stopped: Stopped, RetryPending: Retry Pending, Starting: Starting, FailedUnrecoverable: Unrecoverable Failure, StoppedUnrecoverable: Unrecoverable Stop, Success: Success, Started: StartedNo
FailedMessagestringWhen the Status is ‘Failed’, display the failure reason.No
CurRetryCountintCurrent Failure Retry CountNo
ProgressProgressProgress full migration progress information, empty when the type is incremental migrationNo
SyncSyncDataBinlog InformationNo

Progress

Field NameTypeDescription InformationRequired
TotalCountintTotal number of entriesNo
CurCountintNumber of Items MigratedNo
TotalDurationintEstimated Total Consumption Time (in seconds)No
CurDurationintElapsed Time (in seconds)No
PercentagefloatProgress CompletionNo
RedisOffsetSizeintRedis OffsetNo
RedisDelayTimeintRedis Delay Time Unit is SecondsNo
MongoDelayTimeintMongo delay time, in secondsNo

SyncData

Field NameTypeDescription InformationRequired
BinlogNamestringBinlog file name, length does not exceed 128 charactersNo
BinlogPosintBinlog PosNo
BinlogGTIDstringGTIDNo

Example

Request Example

https://api.dezai.com/?Action=GetUDTSTaskStatus
&ProjectId=org-hiny12
&TaskId=udts-ixdp441
&Type=YJymvzTG

Response Example

{
  "Action": "GetUDTSTaskStatusResponse",
  "Data": {
    "CurRetryCount": 0,
    "MaxRetryCount": 0,
    "Progress": {
      "CurCount": 0,
      "CurDuration": 0,
      "Percentage": 0,
      "TotalCount": 0,
      "TotalDuration": 0
    },
    "Status": "Done",
    "Sync": {
      "BinlogName": "mysql-bin.000006",
      "BinlogPos": 154
    }
  },
  "Message": "",
  "RetCode": 0
}