| name | repo |
| description | Repository (data snapshot) operations. Actions: list(tag?, page=1), create(memo?), tag(id, name), untag(name), checkout(id), diff(left, right), search(keyword, page?), purge(), file_get(id), file_rollback(id), file_open(id), file_export(id). |
repo
action: list
列出数据仓库的所有历史版本快照列表
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
tag | boolean | 否 | List tagged snapshots only (for list, optional) | - |
page | number | 否 | Page number (for list, search; default 1) | - |
使用示例
repo({
"action": "list",
"tag": "...",
"page": "..."
})
action: create
手动创建一个当前工作区状态的数据版本快照
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
memo | string | 否 | Snapshot memo (for create, optional) | - |
使用示例
repo({
"action": "create",
"memo": "..."
})
action: tag
给指定数据快照添加标签标记
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
name | string | 是 | Tag name (for tag, untag) | - |
使用示例
repo({
"action": "tag",
"id": "20200812220555-w7m19sc",
"name": "..."
})
action: untag
移除数据快照的指定标签
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
name | string | 是 | Tag name (for tag, untag) | - |
使用示例
repo({
"action": "untag",
"name": "..."
})
action: checkout
签出/将整个工作区数据还原到指定的快照版本状态
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
使用示例
repo({
"action": "checkout",
"id": "20200812220555-w7m19sc"
})
action: diff
对比两个版本快照之间的数据变动差异
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
left | string | 是 | Left snapshot ID (for diff) | - |
right | string | 是 | Right snapshot ID (for diff) | - |
使用示例
repo({
"action": "diff",
"left": "...",
"right": "..."
})
action: search
根据关键词搜索历史版本快照
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
keyword | string | 是 | Search keyword (for search) | - |
page | number | 否 | Page number (for list, search; default 1) | - |
使用示例
repo({
"action": "search",
"keyword": "...",
"page": "..."
})
action: purge
清理冗余的历史快照以释放磁盘空间
该 action 无其他参数。
使用示例
repo({
"action": "purge"
})
action: file_get
获取快照中指定文件的历史内容
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
使用示例
repo({
"action": "file_get",
"id": "20200812220555-w7m19sc"
})
action: file_rollback
回滚工作区中的单个文件到快照版本
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
使用示例
repo({
"action": "file_rollback",
"id": "20200812220555-w7m19sc"
})
action: file_open
在编辑器中打开指定快照中的文件版本
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
使用示例
repo({
"action": "file_open",
"id": "20200812220555-w7m19sc"
})
action: file_export
将快照中的指定文件导出到本地绝对路径 (.)
参数说明
| 参数名 | 类型 | 必填 | 描述 | 可选值 |
|---|
id | string | 是 | Snapshot ID (for tag, checkout, file_get, file_rollback, file_open, file_export) | - |
使用示例
repo({
"action": "file_export",
"id": "20200812220555-w7m19sc"
})