Introduction

The /v2/request/new resource provides the list of submitted new requests. With this resource you can get further detail about all or any specific new virtual machine request.

Remember, a new request is created for every POST request to a given Virtual Machine sub-resource.

Resource	URI	Description
New Request	/request/new	New Request Management resource.
New Request	/request/new/<request_id>	Specific New Request management resource
NR User data	/request/new/<request_id>/user-data	Cloud config user data provided
NR Extra Config	/request/new/<request_id>/extra-config	Extra config to inject in the VM config
NR Meta data	/request/new/<request_id>/meta-data	Virtual machine included metadata
NR Guest OS Customization Specification	/request/new/<request_id>/custom-spec	Guest OS customization specification

On this page:

TK stores the Cloud API Token generated as a result of the following POST request to the /auth/request-token resource:

curl -X POST https://vss-api.eis.utoronto.ca/auth/request-token -u <username>

For example, extracting the token with the jq command:

TK=$(curl -X POST https://vss-api.eis.utoronto.ca/auth/request-token -u <username> | jq '.token')

List

To list your new requests, do a GET request to /request resource as follows:

http GET https://vss-api.eis.utoronto.ca/v2/request/new "Authorization: Bearer $TK"
curl -X GET -H "Authorization: Bearer $TK" https://vss-api.eis.utoronto.ca/v2/request/new

Response Body

{
    "data": [
        "http://vss-api.eis.utoronto.ca/v2/request/new/6",
        "http://vss-api.eis.utoronto.ca/v2/request/new/1",
        "http://vss-api.eis.utoronto.ca/v2/request/new/4",
        "http://vss-api.eis.utoronto.ca/v2/request/new/2",
        "http://vss-api.eis.utoronto.ca/v2/request/new/7",
        "http://vss-api.eis.utoronto.ca/v2/request/new/3",
        "http://vss-api.eis.utoronto.ca/v2/request/new/5",
        "http://vss-api.eis.utoronto.ca/v2/request/new/9",
        "http://vss-api.eis.utoronto.ca/v2/request/new/26",
        "http://vss-api.eis.utoronto.ca/v2/request/new/8"
    ],
    "meta": {
        "_link": {
            "self": "http://vss-api.eis.utoronto.ca/v2/request/new"
        },
        "count": 10,
        "pages": {
            "first_url": "http://vss-api.eis.utoronto.ca/v2/request/new?per_page=10&page=1",
            "last_url": "http://vss-api.eis.utoronto.ca/v2/request/new?per_page=10&page=19",
            "next_url": "http://vss-api.eis.utoronto.ca/v2/request/new?per_page=10&page=2",
            "page": 1,
            "pages": 19,
            "per_page": 10,
            "prev_url": null,
            "total": 189
        },
        "time": "0.01800s",
        "user": "jm"
    }
}