# 为周期增量导入触发一次全量刷新

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

为符合条件的 Doris 或 MySQL 周期增量导入执行一次全量刷新。

```text
POST https://api.moi.matrixorigin.cn/v5/task/run-full-refresh
```

## 调用前准备

准备目标工作区的个人访问令牌及相应来源读取或导入运行权限，安装 jq 并设置示例变量。身份、环境和结果交接见[公共说明](objects.md)。

## 请求体

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X POST "https://api.moi.matrixorigin.cn/v5/task/run-full-refresh" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  --data-binary "$(jq -n --arg v0 "$TASK_ID" '{"task_id":$v0}')"
```

:::::
:::::{tab-item} 参数说明

任务须 active、状态为已创建或上传中（1 或 2），run_mode=periodic 且 sync_strategy=incremental。来源限 Doris 或不带 compute 的 MySQL；Kafka、REST API 和普通文件导入不适用。本次执行以 full_refresh 覆盖同步策略，保留原周期任务及配置。成功响应不代表目标数据已经完成刷新；通过运行记录、错误和目标数据确认。结果未知时先回查，不自动重复提交。

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `task_id` | string | 是 | 当前工作区的结构化导入任务 ID。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": null
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功时为 OK；还须检查 HTTP 与业务代码。 |
| `msg` | string | 响应信息。 |
| `data` | null | 本次请求已接受；没有在此返回运行结果。 |

:::::
::::::
:::::::

## 错误响应

按[错误与环境](objects.md#错误与环境)区分参数、能力、授权和运行状态；不要只凭 HTTP 200 判定业务成功。
