文档中心

数据库传输服务

请输入

数据传输

SuspendTransmissionTasks

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

请求类型

异步请求。

注意事项

如果批量暂停的任务中存在任务状态不是 Running 的任务，则对应任务接口调用不成功。您可以调用 DescribeTransmissionTasks 接口查看传输任务的详细信息。

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

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

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

请求参数

参数	类型	是否必选	示例值	描述
TaskIds	Array of String	是	["2e0f73647d294856aa41ec3034d8**","bfc3e433e06f48d196ddeafe7979**"]	任务 ID。说明您可以调用 DescribeTransmissionTasks 接口查询任务 ID。在进行批量暂停任务时，多个任务 ID 间使用英文逗号（,）隔开。

返回参数

null

示例

请求示例

POST /?Action=SuspendTransmissionTasks&Version=2022-10-01 HTTP/1.1​
Content-Type: application/json​
Host: dts.cn-beijing.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​
}​

错误码

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

最近更新时间：2026.02.03 14:23:47

这个页面对您有帮助吗？

有用

无用