SuspendTransmissionTasks

调用 SuspendTransmissionTasks 接口批量暂停传输任务。

前提条件

已创建任务，且任务状态为 Running。您可以调用 DescribeTransmissionTasks 接口查看传输任务的详细信息。

注意事项

• 如果批量暂停的任务中存在任务状态不是 Running 的任务，则对应任务接口调用不成功。

• 不支持暂停执行中的订阅任务。

• 任务暂停超过 7 天时会因为源库所需日志过期而导致任务无法恢复续传。为了避免任务出现无法恢复的问题，建议暂停时间不超过 24 小时。

• 正常执行的传输任务暂停后，当前会话（即 DTS 服务端到目标端的数据库会话）不会立马中断，同时，当前会话所执行的事务在未提交的情况下，相关事务所占用的行锁和表锁等资源也不会被释放，因此可能会导致其他会话申请相关资源受阻，影响数据库现有的性能。若任务暂停时间过长（超过非活跃会话回收参数限制），则会导致会话中断、事务回滚，建议在暂停任务时，确认 DTS 未在进行大事务的传输，否则可能导致数据库性能受损。

请求类型

异步请求。

请求参数

返回参数

null

请求示例

POST /?Action=SuspendTransmissionTasks&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****

{
    "TaskId": [
        "2e0f73647d294856aa41ec3034d8****",
        "bfc3e433e06f48d196ddeafe7979****"
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230831144152DBE7FE5BB6E915ADD037",
        "Action": "SuspendTransmissionTasks",
        "Version": "2022-10-01",
        "Service": "dts",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

更多详情，请参见错误码。