ITS Private Cloud API v2021.8.0🎉

Created by JM Lopez
Last updated: Aug 18, 2021
3 min read

We are pleased to announce we released the ITS Cloud API v2021.8.0 with the following improvements and bug fixes:

Improvements

VM/CPU advanced configuration: cores_per_socket. (#1691)

Endpoints

  • /v2/vm (POST)
  •  /v2/vm/<id>/cpu (PUT)
  •  /v2/vm/<id>/spec (GET)

Description

Allows the user to set advanced configuration for CPUs by setting cores_per_socket in the virtual machine creation payload.

POST /vm
curl -X POST https://vss-api.eis.utoronto.ca/v2/vm -H "Authorization: Bearer $TK" -d '{"os": "centos7_64Guest", "built_from": "os_install", "client": "EIS", "cpu": {"count": 4, "cores_per_socket": 2}, "memory": 1, "usage": "Test", "description": "new release vm deployment, "folder": "group-v2658", "networks": [{"network": "dvportgroup-1111", "type": "vmxnet3"}], "disks": [{"capacity_gb": 20, "scsi": 0}, {"capacity_gb": 100, "scsi": 1}], "power_on": true, "template": false, "name": "vm-0231", "vss_service": 1}'

Also, provides the cpu configuration in the /v2/vm/<id>/spec resource:

GET /vm/<id>/spec 
{
  "built": "os_install",
  "machine": {
    "name": "vm-0231",
    "os": "CentOS 7 (64-bit)",
    "cpu": {
      "cores_per_socket": 2,
      "count": 4
    },
    "memory": 1,
    "folder": "VSS > Sandbox > jm > Folder12",
    "disks": [
      {
        "backing_mode": "persistent",
        "backing_sharing": "sharingnone",
        "capacity_gb": 20,
        "scsi": 0
      },
      {
        "backing_mode": "persistent",
        "backing_sharing": "sharingnone",
        "capacity_gb": 100,
        "scsi": 1
      }
    ],
    "iso": "CentOS"
  },
  "networking": {
    "interfaces": [
      {
        "network": "VL-1111-NET",
        "type": "vmxnet3"
      }
    ]
  },
  "metadata": {
    "client": "EIS",
    "description": "content library deployment",
    "usage": "Test",
    "inform": [
      "jm(at)eis.utoronto.ca"
    ],
    "admin": {
      "name": "Jose Manuel Lopez Lujan",
      "email": "jm(at)eis.utoronto.ca",
      "phone": "647-000-0000"
    },
    "vss_service": "",
    "vss_options": []
  }
}

If the virtual machine requires to update an existing cpu value, the payload now supports the following format but also supports a simpler payload if there's no need to set the cores_per_socket value:

curl -X POST https://vss-api.eis.utoronto.ca/v2/vm/vm-1234 -H "Authorization: Bearer $TK" -d '{"value": {"count": 4, "cores_per_socket": 2}}'
curl -X POST https://vss-api.eis.utoronto.ca/v2/vm/vm-1234 -H "Authorization: Bearer $TK" -d '{"value": 4}'


VM/Clone and deploy to mark resulting vm as template. (#1692)

Endpoints

  • /v2/vm (POST)

Description

The improvement allows to convert a resulting virtual machine into template by adding the template attribute in the new vm request payload:

POST /v2/vm
curl -X POST https://vss-api.eis.utoronto.ca/v2/vm -H "Authorization: Bearer $TK" -d '{"os": "centos7_64Guest", "built_from": "os_install", "client": "EIS", "cpu": {"count": 4, "cores_per_socket": 2}, "memory": 1, "usage": "Test", "description": "new release vm deployment, "folder": "group-v2658", "networks": [{"network": "dvportgroup-1111", "type": "vmxnet3"}], "disks": [{"capacity_gb": 20, "scsi": 0}, {"capacity_gb": 100, "scsi": 1}], "power_on": false, "template": true, "name": "vm-0231", "vss_service": 1}'

Sync/VM add cores_per_socket to local db object. (#1693)

Endpoints

  • /v2/vm (GET)

Description

The cores_per_socket attribute is now available in the main virtual machine resource as follows:

GET /v2/vm?filter=cores_per_socket,eq,1
...
      "cores_per_socket": 1,
      "cpu_count": 1,
...

 Inventory/Add coresPerSocket as new property. (#1694)

Endpoints

  • /v2/inventory (POST)
  • /inventory/options (GET)

Description

The coresPerSocket inventory property is now available to be included in the reports:

curl -X POST https://vss-api.eis.utoronto.ca/v2/inventory -H $TK -d '{"properties": ["cpu", "coresPerSocket"]}'

University of Toronto - Since 1827