Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 8
Next »
Introduction
Installing a guest operating system is a very common task upon VM creation, and in order to reduce deployment time, we have included the ability of mounting an ISO image right after a VM has been created, so users can power on the VM and start installing the desired OS without remotely mounting the ISO image, which depending of user's bandwidth, could take longer because it has to transmit the ISO file contents to the VM.
Our ISO image catalog is composed by more than 130 ISO images (and growing) stored within our virtual environment to make a faster VM-ISO interaction, where users can pick and choose the most common Linux distributions, Windows, Solaris, etc. or any other Software like SQL Server.
The following table shows a brief description and HTTP methods allowed to interact with ISO images available to customers.
| Resource | URI | Description | GET | POST | PUT | PATCH | OPTIONS |
|---|
| ISO images | /iso | CD/DVD iso images available to customers. |  | | | | |
List
In order to list available ISO images you should make a GET request to the endpoint /v2/iso passing your access token. As a result, you will get list of ISO images in form of JSON objects with the following attributes:
| Name | Type | Description |
|---|
| name | string | ISO image file name |
| path | string | Datastore path location |
The following examples implements HTTPie and CURL to list available ISO images:
http GET "https://vss-api.eis.utoronto.ca/v2/iso" "Authorization: Bearer $TK"
curl -H "Authorization: Bearer $TK" -X GET "https://vss-api.eis.utoronto.ca/v2/iso"
{
"_links": {
"api": "https://vss-api.eis.utoronto.ca/v2/",
"self": "https://vss-api.eis.utoronto.ca/v2/iso"
},
"data": [
{
"name": "CentOS-7.0-1406-x86_64-DVD",
"path": "[vss-ISOs] Linux/CentOS/CentOS-7.0-1406-x86_64-DVD.iso"
},
{
"name": "CentOS-7.0-1406-x86_64-Minimal",
"path": "[vss-ISOs] Linux/CentOS/CentOS-7.0-1406-x86_64-Minimal.iso"
},
{
"name": "CentOS-7.0-1406-x86_64-NetInstall",
"path": "[vss-ISOs] Linux/CentOS/CentOS-7.0-1406-x86_64-NetInstall.iso"
}
],
"meta": {
"count": 3,
"time": "0.91943s",
"user": "jm"
}
}
Sort
Sorting results has been recently introduced on version 3.2.1:
| Name | Description |
|---|
| sort | sort results by path or name |
The following examples show how to structure a GET request, with sorting:
http GET "https://vss-api.eis.utoronto.ca/v2/iso?sort=name" "Authorization: Bearer $TK"
http GET "https://vss-api.eis.utoronto.ca/v2/iso?sort=path" "Authorization: Bearer $TK"
Filters
This resource has one filter to narrow down the number of ISO images shown in the result.
| Name | Description |
|---|
| name | ISO image file name |
The following examples show how to structure a GET request, with filters:
http GET "https://vss-api.eis.utoronto.ca/v2/iso?name=ubuntu" "Authorization: Bearer $TK"
http GET "https://vss-api.eis.utoronto.ca/v2/iso?name=ubuntu-16" "Authorization: Bearer $TK"
{
"_links": {
"api": "https://vss-api.eis.utoronto.ca/v2/",
"self": "https://vss-api.eis.utoronto.ca/v2/iso"
},
"data": [
{
"name": "ubuntu-12.04.1-server-i386",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.04.1-server-i386.iso"
},
{
"name": "ubuntu-12.04.2-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.04.2-server-amd64.iso"
},
{
"name": "ubuntu-12.04.3-desktop-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.04.3-desktop-amd64.iso"
},
{
"name": "ubuntu-12.04.3-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.04.3-server-amd64.iso"
},
{
"name": "ubuntu-12.04.4-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.04.4-server-amd64.iso"
},
{
"name": "ubuntu-12.10-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-12.10-server-amd64.iso"
},
{
"name": "ubuntu-13.04-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-13.04-server-amd64.iso"
},
{
"name": "ubuntu-13.10-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-13.10-server-amd64.iso"
},
{
"name": "ubuntu-14.04-desktop-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04-desktop-amd64.iso"
},
{
"name": "ubuntu-14.04-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04-server-amd64.iso"
},
{
"name": "ubuntu-14.04.1-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04.1-server-amd64.iso"
},
{
"name": "ubuntu-14.04.1-server-i386",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04.1-server-i386.iso"
},
{
"name": "ubuntu-14.04.2-desktop-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04.2-desktop-amd64.iso"
},
{
"name": "ubuntu-14.04.3-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.04.3-server-amd64.iso"
},
{
"name": "ubuntu-14.10-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-14.10-server-amd64.iso"
},
{
"name": "ubuntu-15.04-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-15.04-server-amd64.iso"
},
{
"name": "ubuntu-15.10-desktop-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-15.10-desktop-amd64.iso"
},
{
"name": "ubuntu-15.10-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-15.10-server-amd64.iso"
},
{
"name": "ubuntu-16.04-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-16.04-server-amd64.iso"
}
],
"meta": {
"count": 19,
"time": "0.90471s",
"user": "jm"
}
}
{
"_links": {
"api": "https://vss-api.eis.utoronto.ca/v2/",
"self": "https://vss-api.eis.utoronto.ca/v2/iso"
},
"data": [
{
"name": "ubuntu-16.04-server-amd64",
"path": "[vss-ISOs] Linux/Ubuntu/ubuntu-16.04-server-amd64.iso"
}
],
"meta": {
"count": 1,
"time": "0.87093s",
"user": "jm"
}
}