tencent cloud

Data Transfer Service

소식 및 공지 사항
릴리스 노트
제품 소개
제품 개요
데이터 마이그레이션 기능 설명
데이터 동기화 기능 설명
데이터 구독(Kafka 버전) 기능 설명
제품 장점
구매 가이드
과금 개요
환불 설명
시작하기
데이터 마이그레이션 작업 가이드
데이터 동기화 작업 가이드
데이터 구독 작업 가이드(Kafka 버전)
준비 작업
자체구축 MySQL용 Binlog 설정
데이터 마이그레이션
데이터 마이그레이션 지원 데이터베이스
ApsaraDB 교차 계정 인스턴스 간 마이그레이션
PostgreSQL로 마이그레이션
작업 관리
데이터 동기화
데이터 동기화가 지원하는 데이터베이스
계정 간 TencentDB 인스턴스 동기화
작업 관리
데이터 구독(Kafka 버전)
데이터 구독이 지원하는 데이터베이스
데이터 구독 작업 생성
작업 관리
컷오버 설명
모니터링 및 알람
모니터링 메트릭 조회
사례 튜토리얼
양방향 동기화 데이터 구조 생성
다대일 동기화 데이터 구조 생성
멀티 사이트 Active-Active IDC 구축
데이터 동기화 충돌 해결 정책 선택하기
CLB 프록시를 사용하여 계정 간 데이터베이스 마이그레이션하기
CCN으로 자체 구축 MySQL에서 TencentDB for MySQL로 마이그레이션
검증 불통과 처리 방법
버전 확인
원본 데이터베이스 권한 확인
계정 충돌 확인
부분 데이터베이스 매개변수 확인
원본 인스턴스 매개변수 확인
매개변수 설정 충돌 확인
대상 데이터베이스 콘텐츠 충돌 확인
대상 데이터베이스 공간 확인
Binlog 매개변수 확인
증분 마이그레이션 전제 조건 확인
플러그인 호환성 확인
레벨2 파티션 테이블 확인
기본 키 확인
마이그레이션할 테이블에 대한 DDL 확인
시스템 데이터베이스 충돌 확인
소스 및 대상 인스턴스 테이블 구조 확인
InnoDB 테이블 확인
마이그레이션 객체 종속성 확인
제약 조건 확인
FAQs
데이터 마이그레이션
데이터 동기화
데이터 구독 Kafka 버전 FAQ
구독 정규식
API문서
History
Introduction
API Category
Making API Requests
(NewDTS) Data Migration APIs
Data Sync APIs
Data Consistency Check APIs
(NewDTS) Data Subscription APIs
Data Types
Error Codes
DTS API 2018-03-30
Service Agreement
Service Level Agreements
액세스 관리
DTS를 사용할 서브 계정 생성 및 권한 부여
서브 계정에 재무 권한 부여하기

DescribeMigrateJobs

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-10-28 22:21:00

1. API Description

Domain name for API request: dts.intl.tencentcloudapi.com.

This API is used to query data migration tasks.
For a finance zone linkage, please use the domain name https://dts.ap-shenzhen-fsi.tencentcloudapi.com.

A maximum of 100 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribeMigrateJobs.
Version Yes String Common Params. The value used for this API: 2018-03-30.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
JobId No String Data migration task ID
JobName No String Data migration task name
Order No String Sort by field. Value range: JobId, Status, JobName, MigrateType, RunMode, CreateTime
OrderSeq No String Sorting order. Value range: ASC (ascending), DESC (descending)
Offset No Integer Offset. Default value: 0
Limit No Integer Number of the returned instances. Value range: [1, 100]. Default value: 20
TagFilters.N No Array of TagFilter Tag filter.

3. Output Parameters

Parameter Name Type Description
TotalCount Integer Number of tasks
JobList Array of MigrateJobInfo Array of task details
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Querying data migration tasks

Input Example

https://dts.intl.tencentcloudapi.com/?Action=DescribeMigrateJobs
&Order=CreateTime
&OrderSeq=DESC
&Offset=0
&Limit=2
&<Common request parameters>

Output Example

{
    "Response": {
        "TotalCount": 1,
        "JobList": [
            {
                "JobId": "dts-1kl0iy0v",
                "JobName": "userdts",
                "MigrateOption": {
                    "RunMode": 1,
                    "ExpectTime": "0000-00-00 00:00:00",
                    "MigrateType": 2,
                    "MigrateObject": 2,
                    "ConsistencyType": 5,
                    "IsOverrideRoot": 0,
                    "ExternParams": "[]",
                    "ConsistencyParams": {
                        "SelectRowsPerTable": 0,
                        "TablesSelectAll": 0,
                        "TablesSelectCount": 0
                    }
                },
                "SrcAccessType": "extranet",
                "SrcDatabaseType": "mysql",
                "SrcInfo": {
                    "AccessKey": "",
                    "Ip": "9.18.84.24",
                    "Port": 10304,
                    "User": "root",
                    "Password": "",
                    "RdsInstanceId": "",
                    "CvmInstanceId": "",
                    "UniqDcgId": "",
                    "SubnetId": "",
                    "UniqVpnGwId": "",
                    "InstanceId": "",
                    "Region": "ap-guangzhou",
                    "VpcId": ""
                },
                "DstAccessType": "cdb",
                "DstDatabaseType": "mysql",
                "DstInfo": {
                    "InstanceId": "cdb-l78e0nbv",
                    "Ip": "",
                    "Port": 0,
                    "Region": "ap-shanghai",
                    "ReadOnly": 0
                },
                "Tags": [
                    {
                        "TagKey": "Owner",
                        "TagValue": "alice"
                    }
                ],
                "Detail": {
                    "StepAll": 0,
                    "StepNow": 0,
                    "Progress": "0",
                    "CurrentStepProgress": "0",
                    "MasterSlaveDistance": 0,
                    "SecondsBehindMaster": 0,
                    "StepInfo": []
                },
                "Status": 1,
                "DatabaseInfo": "[]",
                "CreateTime": "2018-05-24 15:06:03",
                "StartTime": "0000-00-00 00:00:00",
                "EndTime": "0000-00-00 00:00:00",
                "ErrorInfo": []
            }
        ],
        "RequestId": "c032aab5-b56a-428d-9cf7-e5f324ee408b"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
AuthFailure.AuthFailureError Authentication failed.
AuthFailure.UnauthorizedOperationError The current user is not allowed to perform this operation as the authentication failed.
FailedOperation.NotAllowOperation This operation is prohibited.
InternalError.DatabaseError Failed to access the database on the DTS platform.
InternalError.InternalErrorError An internal error occurred.
InternalError.ProtocolError A communication protocol error occurred.
InternalError.UndefinedError An internal error occurred.
InternalError.UnknownError An unknown internal error occurred.
InvalidParameter The parameter is incorrect.
InvalidParameter.InvalidParameterError The parameter is invalid.
InvalidParameterValue.BizInvalidParameterValueError Invalid business parameters.
InvalidParameterValue.DataConvertError A data conversion error occurred.
InvalidParameterValue.InvalidParameterValueError The parameter is invalid.
RequestLimitExceeded.RequestLimitExceededError The number of requests exceeds the limit.
UnauthorizedOperation.NotEnoughPrivileges Authentication failed as there were no required permissions.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백