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.
| Panel | ||||
|---|---|---|---|---|
On this page:
|
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. |  | |
| Note | |||||
|---|---|---|---|---|---|
| |||||
Remember, you can also show what methods are allowed and description, parameters, etc. by making an OPTIONS HTTP request to /v2/iso.
|
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:
| Code Block |
|---|
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" |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"_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
This resource has one filter to narrow down the number of ISO images shown in the result.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:
| Code Block |
|---|
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:
| Code Block |
|---|
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" |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"_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"
}
} |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"_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"
}
} |