Page tree

Overview

The Update VM Name API updates the name of a virtual machine. 

You can use the Get VMs to find the virtual machine ID (id).

Sample request

PUT https://api.armor.com/vms/9

{
 "id": 9,
 "name": "VMW001",
}

Input

The following table describes the different parts of this API call: 

API Call / URLMethod / Type

/vms/{id}

PUT


The following table describes the parameter (or parameters) for this API call: 

ParameterDescriptionRequired or optionalTypeExample
idThe ID of the virtual machineRequiredInteger9
nameThe name you want to use for the virtual machineRequiredStringVMW001



Sample return

StatusResponse
200
 {
 "canUseFluidScale": false,
 "disks": [],
 "isDeleted": false,
 "id": 9,
 "coreInstanceId": "06daafab-bffb-4f81-8cbf-532faad97037",
 "name": "VMW001",
 "provider": "4",
 "location": "DFW01",
 "zone": "DFW01-VC01",
 "ipAddress": "",
 "status": 100,
 "appId": 1,
 "appName": "General Dynamics Web",
 "osId": null,
 "os": "Ubuntu 14.04",
 "deployed": false,
 "cpu": 1,
 "memory": 2048,
 "storage": 30720,
 "notes": null,
 "vCenterId": 2,
 "vCenterName": "A-VC01",
 "product": {
      "sku": "A1-122",
      "size": "A1",
      "isExpired": false
 },
 "uuid": "urn:firehost:b5e1892b-bf4d-4209-b513-83c04f187ca3",
 "health": 0,
 "tags": [],
 "scheduledEvents": []
}
400
Bad Request

Output

The following table describes the expected results for specific outputs that may not be clear enough within the sample output.

ReturnTypeDescriptionPossible valuesExample
canUseFluidScaleBoolean valueFluidScale allows for application scaling without a reboot.true, falsefalse
taskDateDate and timeThe date and time, in combined date and time format (ISO 8601), of when the event will take place Any date and time2016-09-01T00:00:00
maitenanceWindowIntegerA countdown of when the event will take placeAny value in minutes60

 



In this topic



Have a suggestion for the Armor Knowledge Base? Send a message to kb@armor.com.