调用 CancelExportTask 接口取消导出任务。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：CancelExportTask

要执行的操作，取值：CancelExportTask。

Version string 必选示例值：2026-06-30

API的版本，取值：2026-06-30。

ExportId string 必选示例值：exp-eptxnlpgrffjldmlmnli******

需要取消的导出任务 ID。

ProjectName string 可选示例值：default

项目名称。

InstanceId string 必选示例值：tidb-3a91ee******

实例 ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Export_ object 示例值：{ "InstanceId": "tidb-3a91ee******", "CompleteTime": "2026-10-26T06:54:44.774881237Z", "CreateTime": "2026-10-26T06:54:36Z", "ExportId": "exp-wxs5w5w5sbeubjiyld3******", "ExportOptions": { "Compression": "ZSTD", "FileType": "SQL", "Filter": { "Table": { "Patterns": [ "tpcc_db.customer10" ] } } }, "ExportTaskName": "export2", "SnapshotTime": "2026-10-26T06:54:35.043Z", "State": "CANCELED", "Target": { "Tos": { "AccessKey": { "Id": "AKLTNG*****iMzJhMTYyNGEzMmIxNzg0YjQ1OG******" }, "AuthType": "ACCESS_KEY", "Uri": "tos://test/" }, "Type": "TOS" }, "UpdateTime": "2026-10-26T06:54:44.775Z" }

取消后的导出任务信息。

ExportId string 示例值：exp-eptxnlpgrffjldmlmnli******

导出任务 ID。

State string 示例值：CANCEL

任务状态。

ExportOptions object 示例值："ExportOptions": { "Compression": "ZSTD", "FileType": "SQL", "Filter": { "Table": { "Patterns": [ "test.*" ] } } }

导出选项。

FileType string 示例值：SQL

数据格式。取值如下：

SQL：SQL 格式。

CSV：CSV 格式。

Parquet：Parquet 格式。

Compression string 示例值：ZSTD

压缩算法。取值如下：

ZSTD：ZSTD 压缩格式。

Gzip：Gzip 压缩格式。

Snappy：Snappy 压缩格式。

NULL：无压缩。

Filter object 示例值：{ "Table": { "Patterns": [ "test.*" ] } }

过滤条件。

Sql string

SQL 过滤条件。

Table object

表过滤规则。

Patterns string[] 示例值：test.*

表匹配规则。例如：

*.*：匹配该数据源下所有库的全部表。

test.*：匹配 test 库下面的全部数据表。

test.name：精准匹配 test 库下面的 name 表。

Where string

WHERE 条件。

CsvFormat object

CSV 格式配置。

Separator string 示例值：,

列分隔符。

Delimiter string 示例值："

包裹符。

NullValue string 示例值：\\N

NULL 的字符串表示。

SkipHeader boolean 示例值：true

是否跳过表头。

ParquetFormat object

Parquet 格式配置。

Compression string 示例值：GZIP

压缩算法。取值如下：

ZSTD：ZSTD 压缩格式。

Gzip：Gzip 压缩格式。

Snappy：Snappy 压缩格式。

NULL：无压缩。

Target object 示例值： "Target": { "Tos": { "AccessKey": { "Id": "AKLTNGRlYWNiMzJhMTYyNGEzMmIxNz*******************" }, "AuthType": "ACCESS_KEY", "Uri": "tos://test/" }, "Type": "TOS" }

目标存储配置。

Type string

目标类型。

Tos object 示例值：{ "AccessKey": { "Id": "AKLTNGRlYWNiMzJhMTYyNGEzMmIxNz*******************" }, "AuthType": "ACCESS_KEY", "Uri": "tos://test/" }

TOS 目标配置。

Uri string 示例值：tos://test/

TOS URI。

AuthType string 示例值：ACCESS_KEY

固定为 ACCESS_KEY。

AccessKey object

访问凭证。

Id string 示例值：AKLTNGRlYWNiMzJhMTYyNGEzMmIxNz*******************

AccessKey ID。

Secret string 示例值：*********

AccessKey Secret。

Reason string

失败或取消原因。

CreateTime string 示例值：2026-08-24T07:13:14.904Z

创建时间。

UpdateTime string 示例值：2026-08-24T07:13:14.904Z

最近更新时间。

CompleteTime string 示例值：2026-08-24T07:13:14.904Z

完成时间。

SnapshotTime string 示例值：2026-08-24T07:13:14.904Z

快照时间。

ExpireTime string 示例值：2026-08-24T07:13:14.904Z

结果过期时间。

ExportTaskName string 示例值：SNAPSHOT_2026-10-26T06:22:45Z

导出任务名称。

InstanceId string 示例值：tidb-3a91ee******

所属实例 ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	AuditLogDisabled	Audit logging is disabled for the specified cluster.	指定集群未开启审计日志。
400	AuditLogInvalidParameter	The audit log request is invalid: %s	审计日志请求参数无效：%s
400	DefaultPrivateEndpointCannotBeDeleted	The default private endpoint %s cannot be deleted from the allowlist.	默认私网终端节点 %s 不能从白名单中删除。
400	DefaultPrivateEndpointCannotBeReplaced	The default private endpoint %s cannot be replaced. Only its allowlist rule name can be changed.	默认私网终端节点 %s 不支持替换，只能修改其白名单规则名称。
400	PrivateEndpointServiceMismatch	The specified private endpoint %s is not connected to the TiDB endpoint service for this cluster.	私网终端节点 %s 未连接到当前集群对应的 TiDB 终端节点服务。
400	InvalidPrivateEndpoint	The specified private endpoint %s is invalid: %s.	私网终端节点 %s 无效：%s。
400	DisplayNameNotUnique	Cluster names must be unique. The current name [%s] already exists. Please use a different name.	集群名称需保持唯一，当前名称%s已存在，请使用其他名称。
400	QuotaExceeded	The account quota has been exceeded.	账号配额已超限。
400	OperationUnsupported	The operation is unsupported for the specified cluster. %s	操作不支持。%s
400	InvalidParameterFormat	The input parameter is not valid.	请求参数格式错误。
400	UnsupportedParameter	The specified parameter %s is not support.	当前参数%s值不支持。
400	InvalidParameter	The specified parameter %s is not valid.	参数%s值无效。
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.	缺少%s参数。
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.	缺少%s参数。
400	InvalidParameter	The specified parameter %s is not valid.	参数%s值无效。
400	UnsupportedParameter	The specified parameter %s is not support.	当前参数%s值不支持。
400	InvalidParameterFormat	The input parameter is not valid.	请求参数格式错误。
400	OperationUnsupported	The operation is unsupported for the specified cluster. %s	操作不支持。%s
400	QuotaExceeded	The account quota has been exceeded.	账号配额已超限。
400	DisplayNameNotUnique	Cluster names must be unique. The current name [%s] already exists. Please use a different name.	集群名称需保持唯一，当前名称%s已存在，请使用其他名称。
400	InvalidPrivateEndpoint	The specified private endpoint %s is invalid: %s.	私网终端节点 %s 无效：%s。
400	PrivateEndpointServiceMismatch	The specified private endpoint %s is not connected to the TiDB endpoint service for this cluster.	私网终端节点 %s 未连接到当前集群对应的 TiDB 终端节点服务。
400	DefaultPrivateEndpointCannotBeReplaced	The default private endpoint %s cannot be replaced. Only its allowlist rule name can be changed.	默认私网终端节点 %s 不支持替换，只能修改其白名单规则名称。
400	DefaultPrivateEndpointCannotBeDeleted	The default private endpoint %s cannot be deleted from the allowlist.	默认私网终端节点 %s 不能从白名单中删除。
400	AuditLogInvalidParameter	The audit log request is invalid: %s	审计日志请求参数无效：%s
400	AuditLogDisabled	Audit logging is disabled for the specified cluster.	指定集群未开启审计日志。
403	PermissionDenied	You are not authorized to perform this operation.	没有权限执行该操作。
403	PermissionDenied	You are not authorized to perform this operation.	没有权限执行该操作。
404	PrivateEndpointNotFound	The specified private endpoint %s does not exist.	未找到私网终端节点 %s。
404	AuditLogFilterRuleNotFound	The specified audit log filter rule %s does not exist.	未找到审计日志过滤规则 %s。
404	RestoreJobNotFound	No restore job found for the specified cluster.	未找到恢复任务。
404	TableNotFound	The specified table %s does not exist.	未找到Table %s
404	PrivateEndpointAllowlistRuleNotFound	The private endpoint allowlist rule for VpcEndpointId %s does not exist.	未找到 VpcEndpointId 为 %s 的私网白名单规则。
404	BranchNotFound	The specified branch %s does not exist.	未找到BranchId %s。
404	ClusterNotFound	The specified cluster %s does not exist.	未找到ClusterId %s。
404	ProjectNotFound	The specified project %s does not exist.	未找到Project %s。
404	ProjectNotFound	The specified project %s does not exist.	未找到Project %s。
404	ClusterNotFound	The specified cluster %s does not exist.	未找到ClusterId %s。
404	BranchNotFound	The specified branch %s does not exist.	未找到BranchId %s。
404	PrivateEndpointNotFound	The specified private endpoint %s does not exist.	未找到私网终端节点 %s。
404	PrivateEndpointAllowlistRuleNotFound	The private endpoint allowlist rule for VpcEndpointId %s does not exist.	未找到 VpcEndpointId 为 %s 的私网白名单规则。
404	TableNotFound	The specified table %s does not exist.	未找到Table %s
404	RestoreJobNotFound	No restore job found for the specified cluster.	未找到恢复任务。
404	AuditLogFilterRuleNotFound	The specified audit log filter rule %s does not exist.	未找到审计日志过滤规则 %s。
409	AuditLogFilterRuleAlreadyExists	The audit log filter rule %s already exists.	审计日志过滤规则 %s 已存在。
409	PrivateEndpointNotAvailable	The specified private endpoint %s is not available. Current status: %s.	私网终端节点 %s 当前不可用，当前状态：%s。
409	PrivateEndpointAllowlistRuleAlreadyExists	The private endpoint allowlist rule for VpcEndpointId %s already exists.	VpcEndpointId 为 %s 的私网白名单规则已存在。
409	PrivateEndpointAllowlistRuleAlreadyExists	The private endpoint allowlist rule for VpcEndpointId %s already exists.	VpcEndpointId 为 %s 的私网白名单规则已存在。
409	PrivateEndpointNotAvailable	The specified private endpoint %s is not available. Current status: %s.	私网终端节点 %s 当前不可用，当前状态：%s。
409	AuditLogFilterRuleAlreadyExists	The audit log filter rule %s already exists.	审计日志过滤规则 %s 已存在。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。
500	ServiceBusy	The system is busy, please try again later.	系统繁忙，请稍后重试。
500	TiDBError	err from tidb: %s	TiDB错误：%s。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。
500	TiDBError	err from tidb: %s	TiDB错误：%s
500	ServiceBusy	The system is busy, please try again later.	系统繁忙，请稍后重试。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	当前服务暂时不可用。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	当前服务暂时不可用。

云数据库 TiDB 版