调用 DescribeWorkspacesExportTask 接口查询 Workspace 列表导出任务的执行状态、进度及下载链接，支持查询指定任务或当前账号最近一次导出任务。 ## 请求类型同步请求。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=DescribeWorkspacesExportTask&serviceCode=aidap&version=2025-10-01&groupName=) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |TaskId |String |否 |workspace\-export\-9e726467\-d629\-4a5f\-bf22\-43bdb2c1\*\*\*\* |导出 Workspace 列表任务的 ID。

说明

不传时则查询当前账号最近一次创建的 Workspace 列表导出任务。

| ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |CreatedAt |String |2026\-07\-27T11:51:39Z |导出 Workspace 列表任务的创建时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。 | |DownloadUrl |String |https://ai\-dap\-billing.tos\-cn.volces.com/workspace\-export/210000\*\*\*\*/workspace\-export\-d8635b9e\-1947\-453a\-a14e\-41cd4fe3\*\*\*\*/workspaces.jsonl?X\-Tos\-Algorithm=TOS4\-HMAC\-SHA256&X\-Tos\-Credential=AKLTMDcyNTA4YzIwYWUxNDkzNDhmYzRkNDU1NmUwZGU\*\*\*\*%2F20260727%2Fcn\-boe%2Ftos%2Frequest&X\-Tos\-Date=20260727T121452Z&X\-Tos\-Expires=900&X\-Tos\-Signature=4cdd934c0ea8cd9a0f921bf188adacafda79e89bd0ad8c8d8feb9110982b\*\*\*\*&X\-Tos\-SignedHeaders=host |Workspace 列表导出文件的下载链接。 | |ExpiredAt |String |2026\-08\-03T11:56:53Z |Workspace 列表导出文件的下载链接的过期时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。 | |FileFormat |String |jsonl |导出文件格式。当前仅支持 `jsonl` 格式。 | |FileSize |Long |829392586 |导出文件大小，单位为 Byte。 | |FinishedAt |String |2026\-07\-27T11:56:53Z |导出 Workspace 列表任务的完成时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。 | |Message |String |Export task completed. |导出 Workspace 列表任务的提示信息。 | |RecordCount |Long |764353 |导出 Workspace 列表任务中的 Workspace 数量。 | |StartedAt |String |2026\-07\-27T11:51:40Z |导出 Workspace 列表任务的开始时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。 | |Status |String |Pending |导出任务状态。取值：

* `Pending`：任务已创建，等待执行。

* `Running`：任务执行中。

* `Success`：任务执行成功，文件可下载。

* `Failed`：任务执行失败。

* `Expired`：导出文件已过期。 | |Step |String |Created |导出任务步骤。取值：

* `Created`：任务已创建。

* `Dispatching`：正在发起任务流。

* `QueryingWorkspaces`：正在查询。

* `Workspace`：列表。

* `WritingFile`：正在写入导出文件。

* `UploadingFile`：正在上传导出文件。

* `CleaningOldFile`：正在清理旧导出文件。

* `Completed`：任务已完成。

* `Failed`：任务失败。 | |TaskId |String |workspace\-export\-9e726467\-d629\-4a5f\-bf22\-43bdb2c1\*\*\*\* |导出 Workspace 列表任务的 ID。 | ## 示例 ### 请求示例 ```JSON POST /?Action=DescribeWorkspacesExportTask&Version=2025-10-01 Content-Type: application/json Host: aidap.cn-beijing.volcengineapi.com X-Date: 20251001T101010Z Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20251001/cn-beijing/aidap/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458**** { "TaskId": "workspace-export-9e726467-d629-4a5f-bf22-43bdb2c1****" } ``` ### 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20260727201452736642192B27DE070BCA-33b277", "Action": "DescribeWorkspacesExportTask", "Version": "2025-10-01", "Service": "aidap", "Region": "cn-beijing" }, "Result": { "CreatedAt": "2026-07-27T11:51:39Z", "DownloadUrl": "https://ai-dap-billing.tos-cn.volces.com/workspace-export/210000****/workspace-export-d8635b9e-1947-453a-a14e-41cd4fe3****/workspaces.jsonl?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTMDcyNTA4YzIwYWUxNDkzNDhmYzRkNDU1NmUwZGU****%2F20260727%2Fcn-boe%2Ftos%2Frequest&X-Tos-Date=20260727T121452Z&X-Tos-Expires=900&X-Tos-Signature=4cdd934c0ea8cd9a0f921bf188adacafda79e89bd0ad8c8d8feb9110982b****&X-Tos-SignedHeaders=host", "ExpiredAt": "2026-08-03T11:56:53Z", "FileFormat": "jsonl", "FileSize": 829392586, "FinishedAt": "2026-07-27T11:56:53Z", "Message": "Export task completed.", "RecordCount": 764353, "StartedAt": "2026-07-27T11:51:40Z", "Status": "Success", "Step": "Completed", "TaskId": "workspace-export-d8635b9e-1947-453a-a14e-41cd4fe344ce" } } ``` ## 错误码更多详情，请参见[错误码](https://www.volcengine.com/docs/87275/2105926)。

AI 原生 BaaS 平台 Supabase 版