调用 SuspendTransmissionTask 接口暂停传输任务。

请求类型

同步请求。

注意事项

• 如果暂停的任务状态不是 Running，那么对应任务接口调用不成功。您可以调用 DescribeTransmissionTasks 接口查看传输任务的详细信息。
• 不支持暂停执行中的订阅任务。
• 任务暂停超过 7 天时会因为源库所需日志过期而导致任务无法恢复续传。为了避免任务出现无法恢复的问题，建议暂停时间不超过 24 小时。
• 正常执行的传输任务暂停后，当前会话（即 DTS 服务端到目标端的数据库会话）不会立马中断，同时，当前会话所执行的事务在未提交的情况下，相关事务所占用的行锁和表锁等资源也不会被释放，因此可能会导致其他会话申请相关资源受阻，影响数据库现有的性能。若任务暂停时间过长（超过非活跃会话回收参数限制），则会导致会话中断、事务回滚，建议在暂停任务时，确认 DTS 未在进行大事务的传输，否则可能导致数据库性能受损。

请求参数

返回参数

null

示例

请求示例

POST /?Action=SuspendTransmissionTask&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": "5cf6450e217b4c8eb834e339a5*****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230320103919389DBD989A72920DB4EB",
        "Action": "RetryTransmissionTask",
        "Version": "2022-10-01",
        "Service": "dts",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

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