7.1 Task

7.1.1 列出某个图中全部的异步任务

Params

• status: 异步任务的状态
• limit：返回异步任务数目上限

Method & Url

GET http://localhost:8080/graphs/hugegraph/tasks?status=success

Response Status

200

Response Body

{
    "tasks": [{
        "task_name": "hugegraph.traversal().V()",
        "task_progress": 0,
        "task_create": 1532943976585,
        "task_status": "success",
        "task_update": 1532943976736,
        "task_result": "0",
        "task_retries": 0,
        "id": 2,
        "task_type": "gremlin",
        "task_callable": "com.baidu.hugegraph.api.job.GremlinAPI$GremlinJob",
        "task_input": "{\"gremlin\":\"hugegraph.traversal().V()\",\"bindings\":{},\"language\":\"gremlin-groovy\",\"aliases\":{\"hugegraph\":\"graph\"}}"
    }]
}

7.1.2 查看某个异步任务的信息

Method & Url

GET http://localhost:8080/graphs/hugegraph/tasks/2

Response Status

200

Response Body

{
    "task_name": "hugegraph.traversal().V()",
    "task_progress": 0,
    "task_create": 1532943976585,
    "task_status": "success",
    "task_update": 1532943976736,
    "task_result": "0",
    "task_retries": 0,
    "id": 2,
    "task_type": "gremlin",
    "task_callable": "com.baidu.hugegraph.api.job.GremlinAPI$GremlinJob",
    "task_input": "{\"gremlin\":\"hugegraph.traversal().V()\",\"bindings\":{},\"language\":\"gremlin-groovy\",\"aliases\":{\"hugegraph\":\"graph\"}}"
}

7.1.3 删除某个异步任务信息，不删除异步任务本身

Params

• force: 是否强制删除，默认为 false。当设置为 true 时，不论异步任务处于何种状态，都将删除异步任务信息

Method & Url

DELETE http://localhost:8080/graphs/hugegraph/tasks/2

或者：

DELETE http://localhost:8080/graphs/hugegraph/tasks/2?force=true

Response Status

204

7.1.4 取消某个异步任务，该异步任务必须具有处理中断的能力

假设已经通过Gremlin API创建了一个异步任务如下：

"for (int i = 0; i < 10; i++) {" +
    "hugegraph.addVertex(T.label, 'man');" +
    "hugegraph.tx().commit();" +
    "try {" +
        "sleep(1000);" +
    "} catch (InterruptedException e) {" +
        "break;" +
    "}" +
"}"

Method & Url

PUT http://localhost:8080/graphs/hugegraph/tasks/2?action=cancel

请保证在10秒内发送该请求，如果超过10秒发送，任务可能已经执行完成，无法取消。

Response Status

202

Response Body

{
    "cancelled": true
}

此时查询 label 为 man 的顶点数目，一定是小于 10 的。