調用DescribeSynchronizationJobStatusList查詢一個或多個數據同步實例同步狀態。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeSynchronizationJobStatusList

系統規定參數，取值：DescribeSynchronizationJobStatusList。

SynchronizationJobIdListJsonStr String 是 ["dtsexjk1alb116****","dtskfq1149w254****"]

數據同步實例ID，格式為JSON數組，可以通過調用DescribeSynchronizationJobs接口查詢。

RegionId String 否 cn-hangzhou

地域ID，傳入本參數來指定實例所在地域，詳情請參見支持的地域列表。

ClientToken String 否 0c593ea1-3bea-11e9-b96b-88e9fe63****

保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken只支持ASCII字符，且不能超過64個字符。

AccountId String 否 12323344****

阿里云主賬號ID，無需設置，該參數即將下線。

返回數據

名稱 類型 示例值 描述
ErrCode String InternalError

調用出錯時返回的錯誤碼。
ErrMessage String The request processing has failed due to some unknown error.

調用錯誤時返回對應的錯誤信息。
PageNumber Integer 1

頁碼。
PageRecordCount Integer 2

一頁展示的同步實例數量。
RequestId String 1413460B-138A-48D1-836C-B24EDDC1****

請求ID。
Success String true

請求是否成功。
SynchronizationJobListStatusList Array of SynchronizationJobStatusInfo

同步任務狀態列表。
SynchronizationDirectionInfoList Array of SynchronizationDirectionInfo

同步方向詳情列表。
Checkpoint String 1610524452

同步最新一條數據的時間戳，格式為Unix時間戳。

說明 Unix時間戳轉換工具可用搜索引擎獲取。
Status String InitializeFailed

同步實例在該方向上的同步狀態，返回值：

  • NotStarted：未啟動
  • Prechecking：預檢查中
  • PrecheckFailed：預檢查失敗
  • Initializing：同步初始化
  • InitializeFailed：同步初始化失敗
  • Synchronizing：同步中
  • Failed：同步失敗
  • Suspending：暫停
  • Modifying：同步對象變更中
  • Finished：完成
SynchronizationDirection String Forward

同步方向，返回值：

  • Forward：正向。
  • Reverse：反向。
SynchronizationJobId String dtsexjk1alb116****

數據同步實例ID。
TotalRecordCount Long 2

所查詢的同步實例總數。

示例

請求示例

http(s)://dts.aliyuncs.com/?Action=DescribeSynchronizationJobStatusList
&SynchronizationJobIdListJsonStr=["dtsexjk1alb116****","dtskfq1149w254****"]
&<公共請求參數>

正常返回示例

XML格式 

<TotalRecordCount>2</TotalRecordCount>
<PageRecordCount>2</PageRecordCount>
<RequestId>1413460B-138A-48D1-836C-B24EDDC1****</RequestId>
<PageNumber>1</PageNumber>
<SynchronizationJobListStatusList>
    <SynchronizationJobId>dtsexjk1alb116****</SynchronizationJobId>
    <SynchronizationDirectionInfoList>
        <Status>InitializeFailed</Status>
        <SynchronizationDirection>Forward</SynchronizationDirection>
    </SynchronizationDirectionInfoList>
</SynchronizationJobListStatusList>
<SynchronizationJobListStatusList>
    <SynchronizationJobId>dtskfq1149w254****</SynchronizationJobId>
    <SynchronizationDirectionInfoList>
        <Status>Failed</Status>
        <Checkpoint>1610524457</Checkpoint>
        <SynchronizationDirection>Forward</SynchronizationDirection>
    </SynchronizationDirectionInfoList>
</SynchronizationJobListStatusList>
<Success>true</Success>

JSON格式 

{
	"TotalRecordCount": 2,
	"PageRecordCount": 2,
	"RequestId": "1413460B-138A-48D1-836C-B24EDDC1****",
	"PageNumber": 1,
	"SynchronizationJobListStatusList": [
		{
			"SynchronizationJobId": "dtsexjk1alb116****",
			"SynchronizationDirectionInfoList": [
				{
					"Status": "InitializeFailed",
					"SynchronizationDirection": "Forward"
				}
			]
		},
		{
			"SynchronizationJobId": "dtskfq1149w254****",
			"SynchronizationDirectionInfoList": [
				{
					"Status": "Failed",
					"Checkpoint": "1610524457",
					"SynchronizationDirection": "Forward"
				}
			]
		}
	],
	"Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。