云数据库 TiDB 版
云数据库 TiDB 版
云数据库 TiDB 版
文档指南
请输入
产品动态
用户指南
数据管理
设置
回收站管理
通用参考
相关协议
API 参考
导入任务管理
- 文档首页
云数据库 TiDB 版API 参考导入任务管理CreateImportUploadUrl - 创建本地文件上传预签名 URL
复制全文
下载 pdfCreateImportUploadUrl - 创建本地文件上传预签名 URL
文档反馈
问问助手调用 CreateImportUploadUrl 接口创建本地文件上传预签名 URL 请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：CreateImportUploadUrl
要执行的操作，取值：CreateImportUploadUrl。
Version string 必选 示例值：2026-06-30
API的版本，取值：2026-06-30。
file_name string 必选 示例值：customer_data.csv
待导入文件名。
ProjectName string 可选 示例值：default
项目名称。
InstanceId string 必选 示例值：tidb-eb7cbe******
实例 ID。
返回参数
upload_url string 示例值：https://prod-cn-beijing-vt01-stashing-area.tos-s3-cn-beijing.volces.com/org‑******/import/upl‑qcpjvbfdsrgftnodhf******/test.csv?X‑Amz‑Algorithm=AWS4‑HMAC‑SHA256\u0026X‑Amz‑Credential=AKLT******%2F20260728%2Fcn‑beijing%2Fs3%2Faws4_request\u0026X‑Amz‑Date=20260728T102043Z\u0026X‑Amz‑Expires=21600\u0026X‑Amz‑SignedHeaders=host\u0026x‑id=PutObject\u0026X‑Amz‑Signature=******
上传文件用的预签名 URL。
upload_id string 示例值：upload‑882fa31e‑76b2‑4411‑b721******
上传 ID。
compatible_id string 示例值：1237244
兼容 dataflow-svc v1beta OPENAPI 的 uint64 标识（字符串）。
请求示例
POST /?Action=CreateImportUploadUrl&Version=2026-06-30 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: tidb.cn-beijing.volcengineapi.com
X-Date: 20260728T000000Z
Authorization: HMAC-SHA256 Credential=AK****/20260728/cn-beijing/tidb/request, SignedHeaders=accept;content-type;host;x-date, Signature=****
{
"InstanceId": "tidb-eb7cbe******",
"file_name": "customer_data.csv",
"ProjectName": "default"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260728182042D52741BE01209F29******",
"Action": "CreateImportUploadUrl",
"Version": "2026-06-30",
"Service": "tidb",
"Region": "cn-beijing"
},
"Result": {
"compatible_id": "1237244",
"upload_id": "upl-qcpjvbfdsrgftnodhf******",
"upload_url": "https://prod-cn-beijing-vt01-stashing-area.tos-s3-cn-beijing.volces.com/org‑******/import/upl‑qcpjvbfdsrgftnodhf******/test.csv?X‑Amz‑Algorithm=AWS4‑HMAC‑SHA256\u0026X‑Amz‑Credential=AKLT******%2F20260728%2Fcn‑beijing%2Fs3%2Faws4_request\u0026X‑Amz‑Date=20260728T102043Z\u0026X‑Amz‑Expires=21600\u0026X‑Amz‑SignedHeaders=host\u0026x‑id=PutObject\u0026X‑Amz‑Signature=******"
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
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. | 当前服务暂时不可用。 |
最近更新时间：2026.10.30 11:06:01
这个页面对您有帮助吗？
有用
有用
无用
无用