You need to enable JavaScript to run this app.
导航

DescribeTransmissionTasks

最近更新时间2023.10.17 13:56:37

首次发布时间2023.03.29 20:40:15

调用 DescribeTransmissionTasks 接口查看传输任务列表。

请求类型

同步请求。

请求参数

名称类型是否必选描述示例值

TaskType

String

任务类型。取值如下:

  • DataMigration:表示创建数据迁移任务。

  • DataSubscription:表示创建数据订阅任务。

  • DataSynchronization:表示创建数据同步任务。

DataMigration

PageNumberInteger页码。取值范围 1~1000,默认值为 1。1
PageSizeInteger每页记录数。取值范围 1~1000,默认值为 10。10

StartTime

Integer

任务开始时间,使用毫秒时间戳格式。

说明

  • 若设置了该参数,查询结束时间(即 EndTime)参数也必填。

  • 若该参数留空,默认返回当前任务类型下已存在的所有任务。

1679279179688

EndTime

Integer

任务结束时间,使用毫秒时间戳格式。

说明

  • 若设置了该参数,查询结束时间(即 EndTime)参数也必填。

  • 结束时间要晚于开始时间。

1679279179699

TaskStatus

String

任务状态,取值如下:

  • Success:表示传输已完成。

  • Failed:表示传输任务执行失败。

  • Running:表示传输任务执行中。

  • Suspend:表示传输任务暂停中。

  • Init:表示传输任务待启动。

  • Terminating:表示传输任务已终止。

Terminating

Name

String

任务名称。命名规则:

  • 以字母开头且不能为空。

  • 长度需在 64 个字符内。

  • 只能包含字母、数字、下划线(_)和中划线(-)。

test****

Ids

Array of String

任务 ID 的列表。

78b65776a25d4970a1c82bd2f35****

ChargeType

String

计费类型,取值如下:

  • NotEnabled:表示未开启计费。

  • PostPaid:表示按量付费。

  • PrePaid:表示包年包月。

PostPaid

ProjectName

String

项目名称。

说明

您可以调用 CreateProject 接口创建项目。

default

返回参数

名称类型描述示例值
TotalInteger任务总数量。1
TasksArray of TaskInfo任务列表。详细信息,请参见 TaskInfo-

请求示例

POST /?Action=DescribeTransmissionTasks&Version=2022-10-01 HTTP/1.1
Content-Type: application/json
Host:dts.volcengineapi.com
X-Date: 20221001T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20221001/cn-beijing/dts/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****

{
     "TaskType": "DataSubscription",
     "PageNumber": 1,
     "PageSize":10
     
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202303201012545D1AD5D48733EB0D3AE8",
        "Action": "DescribeTransmissionTasks",
        "Version": "2022-10-01",
        "Service": "dts",
        "Region": "cn-beijing"
    },
    "Result": {
        "Tasks": [
            {
                "AddSyncObjectAllowed": true,
                "ChargeDetail": {
                    "ChargeStartTime": 1668569330000,
                    "ChargeStatus": "Normal",
                    "ChargeType": "PostPaid",
                    "OrderNo": "Order7166450525830123807"
                },
                "DestConfig": {
                    "BuiltinKafkaSettings": {
                        "Brokers": [
                            "100.67.158.158:9092",
                            "100.67.158.158:9192",
                            "100.67.158.158:9292",
                            "100.67.158.158:9392",
                            "100.67.158.158:9492"
                        ],
                        "Topic": "6f2fd63c0ea947b280877f5d2a384b1f"
                    },
                    "DataSourceId": "362",
                    "EndpointType": "Builtin_Kafka"
                },
                "EnableCloudMonitor": true,
                "EnableDataValidation": false,
                "EndTime": 0,
                "ErrorInfo": "{\"biz_context\":\"{\\\"log_id\\\":\\\"88e5ed340fb4466b999bc894512b0501\\\",\\\"tenant_id\\\":\\\"2100157781\\\",\\\"instance_id\\\":\\\"6f2fd63c0ea947b280877f5d2a384b1f\\\"}\",\"reason\":\"mysql endpoint error: dial tcp 172.17.46.117:3306: i/o timeout\",\"kind\":1,\"app\":\"AppMySQLIncr2Kafka\",\"app_id\":\"1049\"}",
                "ProgressSummary": {
                    "Infos": [
                        {
                            "ErrorInfo": "mysql endpoint error: dial tcp 172.17.46.117:3306: i/o timeout",
                            "NameCN": "增量订阅",
                            "ProgressType": "Incr",
                            "Status": "Doing"
                        }
                    ]
                },
                "ProjectName": "default",
                "SrcConfig": {
                    "DataSourceId": "361",
                    "EndpointType": "Volc_MySQL",
                    "VolcMySQLSettings": {
                        "DBInstanceId": "mysql-2385c2e8fae0",
                        "DBInstanceName": "",
                        "Password": "******",
                        "RegionSettings": {
                            "Region": "cn-beijing"
                        },
                        "Username": "test****"
                    }
                },
                "StartTime": 1668569302701,
                "TaskId": "6f2fd63c0ea947b280877f5d2a******",
                "TaskName": "test****",
                "TaskStatus": "Failed",
                "TaskSubType": "Default",
                "TaskType": "DataSubscription",
                "TenantId": "2100157781",
                "TrafficSpec": "Compact"
            },
            {
                "AddSyncObjectAllowed": true,
                "ChargeDetail": {
                    "ChargeStatus": "Init",
                    "ChargeType": "PostPaid",
                    "OrderNo": ""
                },
                "DestConfig": {
                    "BuiltinKafkaSettings": {
                        "Topic": "725dd01f2d144d47b66c99078e9b27f2"
                    },
                    "DataSourceId": "324",
                    "EndpointType": "Builtin_Kafka"
                },
                "EnableCloudMonitor": true,
                "EnableDataValidation": false,
                "EndTime": 0,
                "ProgressSummary": {
                    "Infos": [
                        {
                            "ErrorInfo": "",
                            "NameCN": "增量订阅",
                            "ProgressType": "Incr",
                            "Status": "Todo"
                        }
                    ]
                },
                "ProjectName": "default",
                "SrcConfig": {
                    "DataSourceId": "323",
                    "EndpointType": "Volc_MySQL",
                    "VolcMySQLSettings": {
                        "DBInstanceId": "mysql-3d224deff2fa",
                        "DBInstanceName": "",
                        "Password": "******",
                        "RegionSettings": {
                            "Region": "cn-beijing"
                        },
                        "Username": "test****"
                    }
                },
                "StartTime": 1661307246240,
                "TaskId": "725dd01f2d144d47b66c99078e*****",
                "TaskName": "test****2",
                "TaskStatus": "Init",
                "TaskSubType": "Default",
                "TaskType": "DataSubscription",
                "TenantId": "2100157781",
                "TrafficSpec": "Compact"
            },
            {
                "AddSyncObjectAllowed": true,
                "ChargeDetail": {
                    "ChargeStatus": "Init",
                    "ChargeType": "PostPaid",
                    "OrderNo": ""
                },
                "DestConfig": {
                    "DataSourceId": "322",
                    "EndpointType": "Volc_Kafka",
                    "VolcKafkaSettings": {
                        "AuthType": "PLAIN",
                        "InstanceId": "kafka-cnngfsm7glfmji9a",
                        "InstanceName": "",
                        "Password": "******",
                        "RegionSettings": {
                            "Region": ""
                        },
                        "Topic": "hua",
                        "Username": "kakatest****"
                    }
                },
                "EnableCloudMonitor": true,
                "EnableDataValidation": false,
                "EndTime": 0,
                "ProgressSummary": {
                    "Infos": [
                        {
                            "ErrorInfo": "",
                            "NameCN": "增量订阅",
                            "ProgressType": "Incr",
                            "Status": "Todo"
                        }
                    ]
                },
                "ProjectName": "default",
                "SrcConfig": {
                    "DataSourceId": "321",
                    "EndpointType": "Volc_PostgreSQL",
                    "VolcPostgreSQLSettings": {
                        "DBInstanceId": "postgres-338f4f3ad26a",
                        "DBInstanceName": "",
                        "DBName": "test****zaizai",
                        "Password": "******",
                        "RegionSettings": {
                            "Region": "cn-beijing"
                        },
                        "Username": "test****zaizai"
                    }
                },
                "StartTime": 1661242976288,
                "TaskId": "c37008625ddd44019ee85b84fb8*****",
                "TaskName": "test****zaizai",
                "TaskStatus": "Init",
                "TaskSubType": "Default",
                "TaskType": "DataSubscription",
                "TenantId": "2100157781",
                "TrafficSpec": "Compact"
            }
        ],
        "Total": 4
    }
}

错误码

更多详情,请参见错误码