akutz / libstorage / 135

LAST BUILD BRANCH: feature/reduce-makefile
DEFAULT BRANCH: master
Ran
Jobs 1
Files 0
Run time –
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
135

push

travis-ci

akutz 
Introducing Asynchronous Tasks

This patch introduces the concept of Tasks to libStorage. For any
volumes or snapshots collection URL, if the query string `?async` is present,
libStorage will execute the intended operation in a goroutine, and immediately
return the HTTP status 202 (Accepted) to the client.

The 202 response will have a body that adheres to the JSON task schema:

    "task": {
        "type": "object",
        "properties": {
            "id": {
                "type": "number",
                "description": "The task's unique identifier."
            },
            "name": {
                "type": "string",
                "description": "The name of the task."
            },
            "user": {
                "type": "string",
                "description": "The name of the user that created the task."
            },
            "completeTime": {
                "type": "number",
                "description": "The time stamp (epoch) when the task was completed."
            },
            "queueTime": {
                "type": "number",
                "description": "The time stamp (epoch) when the task was created."
            },
            "startTime": {
                "type": "number",
                "description": "The time stamp (epoch) when the task started running."
            },
            "result": {
                "type": "object",
                "description": "The result of the operation."
            },
            "error": {
                "type": "object",
                "description": "If the operation returned an error, this is it."
            },
            "fields": { "$ref": "#/definitions/fields" }
        },
        "required": [ "id", "name",  "user", "queueTime" ],
        "additionalProperties": false
    }

The task's ID can be used to retrieve the result of an asynchronous operation.
To get the result of an operation, use the URL `/tasks/{taskID}`.

If an operation is not asynchronous but ... (continued)
Jobs
ID Job ID Ran Files Coverage
1 135.1 0
Travis Job 135.1
Source Files on build 135
Detailed source file information is not available for this build.