{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"5c9106c7-bb7d-4dc9-8749-3c1d237d68fe"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c4f8ecfa-3d69-47b9-9259-fde67a9d9af8"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"This tutorial continues on from ","type":"text"},{"text":"Get started with the Abiquo API","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/doc/pages/311374290"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In this tutorial, you will use the Abiquo API to do the following.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure a VM by adding an IP address (NIC)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete a VM","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"There is also a link to another section that describes how to power cycle a VM.","type":"text"},{"type":"hardBreak"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"This tutorial requires two VMs that are:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Not deployed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have no IP addresses (NICs)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You will also need 2 free IP addresses in private networks in the virtual datacenter with the VMs.","type":"text"}]},{"type":"paragraph","content":[{"text":"To use VMs from the previous tutorial, in the UI undeploy it and delete its IP address. ","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Working with Deployed VMs","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"A deployed VM must always have a NIC. If you want to add another NIC, you may need to create another network to avoid trying to add two IP addresses in the same network.","type":"text"}]},{"type":"paragraph","content":[{"text":"To change the configuration of a deployed VM, if the VM doesn't have network hot-reconfigure, then you will need to shut it down first.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get and modify an entity using the API","type":"text"}]},{"type":"paragraph","content":[{"text":"In general, to modify an entity using the Abiquo API, do these steps.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" request to retrieve the entity's data object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify the data object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use a ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" request to update the entity","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Within a data object, links can define an entity's configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"When you edit the VM data object, be careful not to accidentally delete links because you could change the configuration, such as by deleting a disk from your VM!","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure a VM to add a NIC using the UI","type":"text"}]},{"type":"paragraph","content":[{"text":"First perform the action using the Abiquo UI, to view the API request that the UI makes.","type":"text"}]},{"type":"paragraph","content":[{"text":"To the first VM, which is not deployed, add a network interface card (NIC) with an IP address in a private network. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the browser console to the ","type":"text"},{"text":"Network","type":"text","marks":[{"type":"strong"}]},{"text":" tab and record actions","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":"VM ","type":"text","marks":[{"type":"strong"}]},{"text":"and go to ","type":"text"},{"text":"Network","type":"text","marks":[{"type":"strong"}]},{"text":" → ","type":"text"},{"text":"Private","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"network","type":"text","marks":[{"type":"strong"}]},{"text":" and drag an ","type":"text"},{"text":"IP address","type":"text","marks":[{"type":"strong"}]},{"text":" into the ","type":"text"},{"text":"NICs","type":"text","marks":[{"type":"strong"}]},{"text":" panel, and ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" the VM","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" request and copy it, or get the ","type":"text"},{"text":"nic","type":"text","marks":[{"type":"code"}]},{"text":" link and VM data object","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":1440,"alt":"The PUT request to add a NIC to a VM in the browser console","id":"66bae149-cd5b-457a-a83d-aa0b916a3fdd","collection":"contentId-311373739","type":"file","height":821}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Obtain the link to the NIC","type":"text"}]},{"type":"paragraph","content":[{"text":"In the VM object, find the link to the NIC (with a ","type":"text"},{"text":"rel","type":"text","marks":[{"type":"code"}]},{"text":" attribute with a value of ","type":"text"},{"text":"nic1","type":"text","marks":[{"type":"code"}]},{"text":" near the end of the VM links section.","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"title\":\"privateip\",\n \"rel\":\"nic1\",\n \"type\":\"application/vnd.abiquo.privateip+json\",\n \"href\":\"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/11\"\n }, ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get an IP address to add to the VM","type":"text"}]},{"type":"paragraph","content":[{"text":"To find a free IP address:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the link to the NIC in the previous step, get only the networks IPs link","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use a GET request to obtain the first 3 IP addresses in this network, and add the query parameter ","type":"text"},{"text":"limit","type":"text","marks":[{"type":"code"}]},{"text":" with a value of ","type":"text"},{"text":"3","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --verbose 'https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips?limit=3' \\\n -H 'Accept: application/vnd.abiquo.privateips+json; version=6.1' \\\n\t -u user:password -k | jq . ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-check_mark","text":":check_mark:","shortName":":check_mark:"}},{"text":" To retrieve IPs that are available for use only, use the query parameter ","type":"text"},{"text":"free","type":"text","marks":[{"type":"code"}]},{"text":" with a value of ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The response has 3 IP addresses: the gateway and the IP addresses we created specifically for this exercise.","type":"text"}]},{"type":"codeBlock","content":[{"text":"√ ~ % curl --verbose -k 'https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips?limit=3' \\\n -H 'Accept: application/vnd.abiquo.privateips+json; version=6.1' \\\n -u user:password | jq .\n \n> GET /api/cloud/virtualdatacenters/12/privatenetworks/9/ips?limit=3 HTTP/1.1\n> Host: abiquo.lab.example.com\n> Authorization: Basic XXXXXX\n> User-Agent: curl/7.88.1\n> Accept: application/vnd.abiquo.privateips+json; version=6.1\n> \n< HTTP/1.1 200 200\n< Date: Wed, 07 Jun 2023 13:54:46 GMT\n< Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips\n< Set-Cookie: ABQSESSIONID=5848743475559326145; Max-Age=1800; Expires=Wed, 07-Jun-2023 14:24:46 GMT; Path=/; Secure; HttpOnly; SameSite=strict\n< X-Abiquo-TracerContext: c2b1df27-14c5-4e28-917d-f793d7dc3a71\n< X-Abiquo-Token: XXXXXX\n< Cache-Control: no-cache, no-store, max-age=0, must-revalidate\n< Pragma: no-cache\n< Expires: 0\n< Strict-Transport-Security: max-age=31536000 ; includeSubDomains\n< X-XSS-Protection: 1; mode=block\n< X-Frame-Options: DENY\n< X-Content-Type-Options: nosniff\n< Content-Type: application/vnd.abiquo.privateips+json; version=6.1\n< Transfer-Encoding: chunked\n< \n\n{\n \"totalSize\": 4,\n \"links\": [\n {\n \"rel\": \"first\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips?limit=3&by=ip&asc=true\"\n },\n {\n \"rel\": \"next\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips?startwith=3&limit=3&by=ip&asc=true\"\n },\n {\n \"rel\": \"last\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips?startwith=1&limit=3&by=ip&asc=true\"\n }\n ],\n \"collection\": [\n {\n \"id\": 8,\n \"ip\": \"192.168.0.1\",\n \"mac\": \"00:50:56:2F:D8:F3\",\n \"name\": \"0050562FD8F3_captured\",\n \"networkName\": \"default_private_network\",\n \"ipv6\": false,\n \"quarantine\": false,\n \"available\": true,\n \"links\": [\n {\n \"title\": \"default_private_network\",\n \"rel\": \"privatenetwork\",\n \"type\": \"application/vnd.abiquo.vlan+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9\"\n },\n {\n \"title\": \"privateip\",\n \"rel\": \"self\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/8\"\n },\n {\n \"title\": \"vdcbcdc\",\n \"rel\": \"virtualdatacenter\",\n \"type\": \"application/vnd.abiquo.virtualdatacenter+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12\"\n }\n ]\n },\n {\n \"id\": 11,\n \"ip\": \"192.168.0.2\",\n \"mac\": \"00:50:56:1A:2E:18\",\n \"name\": \"0050561A2E18_captured\",\n \"networkName\": \"default_private_network\",\n \"ipv6\": false,\n \"usedBy\": \"1979e77f-32b1-430d-9b92-9f6347dbd416\",\n \"quarantine\": false,\n \"available\": true,\n \"links\": [\n {\n \"title\": \"default_private_network\",\n \"rel\": \"privatenetwork\",\n \"type\": \"application/vnd.abiquo.vlan+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9\"\n },\n {\n \"title\": \"privateip\",\n \"rel\": \"self\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/11\"\n },\n {\n \"title\": \"vdcbcdc\",\n \"rel\": \"virtualdatacenter\",\n \"type\": \"application/vnd.abiquo.virtualdatacenter+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12\"\n },\n {\n \"title\": \"vapbcdc\",\n \"rel\": \"virtualappliance\",\n \"type\": \"application/vnd.abiquo.virtualappliance+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4\"\n },\n {\n \"title\": \"vmapihowto\",\n \"rel\": \"virtualmachine\",\n \"type\": \"application/vnd.abiquo.virtualmachine+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/304\"\n }\n ]\n },\n {\n \"id\": 12,\n \"ip\": \"192.168.0.3\",\n \"mac\": \"00:50:56:18:63:13\",\n \"name\": \"005056186313_host\",\n \"networkName\": \"default_private_network\",\n \"ipv6\": false,\n \"quarantine\": false,\n \"available\": true,\n \"links\": [\n {\n \"title\": \"default_private_network\",\n \"rel\": \"privatenetwork\",\n \"type\": \"application/vnd.abiquo.vlan+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9\"\n },\n {\n \"title\": \"privateip\",\n \"rel\": \"self\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/12\"\n },\n {\n \"title\": \"vdcbcdc\",\n \"rel\": \"virtualdatacenter\",\n \"type\": \"application/vnd.abiquo.virtualdatacenter+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12\"\n }\n ]\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"In the above example, the NIC for the IP address of ","type":"text"},{"text":"192.168.0.2","type":"text","marks":[{"type":"code"}]},{"text":" is the one that we just added to the VM called ","type":"text"},{"text":"vmapihowto","type":"text","marks":[{"type":"code"}]},{"text":" and it has a link to the VM.","type":"text"}]},{"type":"paragraph","content":[{"text":"The available IP address of ","type":"text"},{"text":"192.168.0.3","type":"text","marks":[{"type":"code"}]},{"text":" is the one we will use, and it has an ID of ","type":"text"},{"text":"12","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a NIC link","type":"text"}]},{"type":"paragraph","content":[{"text":"From the IP address object in the above step, get the link with a ","type":"text"},{"text":"rel","type":"text","marks":[{"type":"code"}]},{"text":" attribute that has a value of ","type":"text"},{"text":"self","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"title\": \"privateip\",\n \"rel\": \"self\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/12\"\n }, ","type":"text"}]},{"type":"paragraph","content":[{"text":"To prepare it for the VM, change the ","type":"text"},{"text":"rel","type":"text","marks":[{"type":"code"}]},{"text":" attribute from a value of ","type":"text"},{"text":"self","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"nicX","type":"text","marks":[{"type":"code"}]},{"text":", where ","type":"text"},{"text":"X","type":"text","marks":[{"type":"code"}]},{"text":" represents the number of the new NIC in the VM. So if there are no NICs, add ","type":"text"},{"text":"nic1","type":"text","marks":[{"type":"code"}]},{"text":" as shown here.","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"title\": \"privateip\",\n \"rel\": \"nic1\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/12\"\n },","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add the NIC link to the VM object","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the VM object that you created using the API in the first part of this tutorial.","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-check_mark","text":":check_mark:","shortName":":check_mark:"}},{"text":" To get the VM entity again, you can send a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" request to the ","type":"text"},{"text":"cloud/virtualmachines","type":"text","marks":[{"type":"code"}]},{"text":" link. ","type":"text"},{"type":"hardBreak"},{"text":"In this case, we are using a ","type":"text"},{"text":"vmname","type":"text","marks":[{"type":"code"}]},{"text":" query parameter to filter on the number ","type":"text"},{"text":"2","type":"text","marks":[{"type":"code"}]},{"text":" in the VM name to only retrieve the VM from the first part of the tutorial.","type":"text"}]},{"type":"codeBlock","content":[{"text":"√ ~ % curl --verbose 'https://abiquo.lab.example.com:443/api/cloud/virtualmachines?vmname=2' \\\n -H 'Accept: application/vnd.abiquo.virtualmachines+json; version=6.1' \\\n -u user:password -k | jq .","type":"text"}]},{"type":"paragraph","content":[{"text":"This request returns a collection of VMs, so you will need to select the individual VM from the collection.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the VM object, go the end of the ","type":"text"},{"text":"links","type":"text","marks":[{"type":"code"}]},{"text":" section and add the NIC link from the previous step.","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" If this is the last link, remember to add a comma before it, and remove any comma after it.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is an example of a modified VM object, with the ","type":"text"},{"text":"nic1","type":"text","marks":[{"type":"code"}]},{"text":" link at the end of a shortened ","type":"text"},{"text":"links","type":"text","marks":[{"type":"code"}]},{"text":" section. We shortened the ","type":"text"},{"text":"links","type":"text","marks":[{"type":"code"}]},{"text":" section to make the example more readable ","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"id\": 305,\n \"uuid\": \"eb613c22-ffa1-4498-827a-ccaf37385c2e\",\n \"fqdn\": \"box.localdomain\",\n \"description\": \"A virtual machine\",\n \"coresPerSocket\": 1,\n \"idState\": 1,\n \"idType\": 0,\n \"type\": \"MANAGED\",\n \"highDisponibility\": 0,\n \"monitored\": false,\n \"monitoringLevel\": \"DEFAULT\",\n \"protected\": false,\n \"variables\": {},\n \"backuppolicies\": [],\n \"lastSynchronize\": 1686046081000,\n \"generateGuestInitialPassword\": false,\n \"natrules\": [],\n \"vdrpEnabled\": true,\n \"vdrpPort\": 0,\n \"password\": \"6t51rgZ9\",\n \"deallocated\": false,\n \"name\": \"vmapihowto2\",\n \"ram\": 48,\n \"cpu\": 1,\n \"state\": \"NOT_ALLOCATED\",\n \"creationTimestamp\": 1686042455000,\n \"birthTimestamp\": 1686045726000,\n \"links\": [\n {\n \"title\": \"Abiquo\",\n \"rel\": \"enterprise\",\n \"type\": \"application/vnd.abiquo.enterprise+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/admin/enterprises/1\"\n },\n {\n \"title\": \"vmapihowto2\",\n \"rel\": \"edit\",\n \"type\": \"application/vnd.abiquo.virtualmachine+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/305\"\n },\n ...\n {\n \"title\": \"VMware vCenter Cluster\",\n \"rel\": \"hypervisortype\",\n \"type\": \"application/vnd.abiquo.hypervisortype+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/config/hypervisortypes/VCENTER_CLUSTER\"\n },\n {\n \"title\": \"yVM\",\n \"rel\": \"virtualmachinetemplate\",\n \"type\": \"application/vnd.abiquo.virtualmachinetemplate+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/admin/enterprises/1/datacenterrepositories/2/virtualmachinetemplates/145\"\n },\n {\n \"title\": \"Others\",\n \"rel\": \"category\",\n \"type\": \"application/vnd.abiquo.category+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/config/categories/1\"\n },\n {\n \"title\": \"privateip\",\n \"rel\": \"nic1\",\n \"type\": \"application/vnd.abiquo.privateip+json\",\n \"href\": \"https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/privatenetworks/9/ips/12\"\n } \n ],\n \"usageStatistics\": []\n } ","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Update the VM to add the NIC","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" request to update the whole VM, including all the links.","type":"text"}]},{"type":"paragraph","content":[{"text":"To easily manage the large data object, you can save it to a JSON file, and use the ","type":"text"},{"text":"@","type":"text","marks":[{"type":"code"}]},{"text":" notation to reference the file in the ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" request.","type":"text"}]},{"type":"paragraph","content":[{"text":"In our example, we called the file ","type":"text"},{"text":"vmapihowto2.json","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --verbose -X PUT 'https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/305' \\\n -H 'Content-Type: application/vnd.abiquo.virtualmachine+json; version=6.1' \\\n -H 'Accept: application/vnd.abiquo.acceptedrequest+json; version=6.1' \\\n -u user:password \\\n -d @vmapihowto2.json -k ","type":"text"}]},{"type":"paragraph","content":[{"text":"Send the ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" request.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the platform updates the VM successfully, the response status and message will be ","type":"text"},{"text":"204 No content","type":"text","marks":[{"type":"code"}]},{"text":" for an undeployed VM.","type":"text"}]},{"type":"paragraph","content":[{"text":"An example of the request is given here.","type":"text"}]},{"type":"codeBlock","content":[{"text":" √ api_tutorials % curl --verbose -X PUT 'https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/305' \\\n -H 'Content-Type: application/vnd.abiquo.virtualmachine+json; version=6.1' \\\n -H 'Accept: application/vnd.abiquo.acceptedrequest+json; version=6.1' \\\n -u user:password \\\n -d @vmapihowto2.json -k\n \n> PUT /api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/305 HTTP/1.1\n> Host: abiquo.lab.example.com\n> Authorization: Basic XXXXXXX\n> User-Agent: curl/7.88.1\n> Content-Type: application/vnd.abiquo.virtualmachine+json; version=6.1\n> Accept: application/vnd.abiquo.acceptedrequest+json; version=6.1\n> Content-Length: 12498\n> \n< HTTP/1.1 204 204\n< Date: Wed, 07 Jun 2023 15:06:58 GMT\n< Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips\n< Set-Cookie: ABQSESSIONID=7288756894413749700; Max-Age=1800; Expires=Wed, 07-Jun-2023 15:36:58 GMT; Path=/; Secure; HttpOnly; SameSite=strict\n< X-Abiquo-TracerContext: e54d1e2f-6b6a-4338-ba9e-4c770f4e9813\n< X-Abiquo-Token: XXXXXX\n< Cache-Control: no-cache, no-store, max-age=0, must-revalidate\n< Pragma: no-cache\n< Expires: 0\n< Strict-Transport-Security: max-age=31536000 ; includeSubDomains\n< X-XSS-Protection: 1; mode=block\n< X-Frame-Options: DENY\n< X-Content-Type-Options: nosniff\n< ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Check your VM in the UI","type":"text"}]},{"type":"paragraph","content":[{"text":"In the UI, when you select the VM, and open the ","type":"text"},{"text":"VM details","type":"text","marks":[{"type":"strong"}]},{"text":" panel to the ","type":"text"},{"text":"NICs","type":"text","marks":[{"type":"strong"}]},{"text":" tab, the NIC should display.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":1440,"alt":"The NIC will display on the VM details panel on the NICs tab","id":"904dea80-23b9-4480-9335-a2b8b38f7a7a","collection":"contentId-311373739","type":"file","height":821}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Change the power states of a VM","type":"text"}]},{"type":"paragraph","content":[{"text":"To prepare a VM to change power states, deploy a VM using the UI or the API.","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-check_mark","text":":check_mark:","shortName":":check_mark:"}},{"text":" To deploy the VM you were using in the previous step, send a ","type":"text"},{"text":"POST","type":"text","marks":[{"type":"code"}]},{"text":" request to the ","type":"text"},{"text":"deploy","type":"text","marks":[{"type":"code"}]},{"text":" link.","type":"text"}]},{"type":"paragraph","content":[{"text":"Then see ","type":"text"},{"text":"Administer and troubleshoot VMs","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/doc/pages/311373630"}}]},{"text":" in the \"Manage VM power states using the API\" section","type":"text"}]},{"type":"paragraph"},{"type":"rule"},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Delete a VM using the API","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete a VM (or another entity), simply perform a DELETE request to the API link.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that there may be restrictions on what you can delete. For example, you cannot delete a virtual datacenter that contains virtual appliances.","type":"text"}]},{"type":"paragraph","content":[{"text":"If we delete the VM as shown here, it will be removed from the platform (and if it exists on the hypervisor, it will be destroyed). And the IP address will return to the virtual datacenter.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X DELETE https://abiquo.lab.example.com:443/api/cloud/virtualdatacenters/12/virtualappliances/4/virtualmachines/305 \\\n\t-H 'Accept: text/json,application/json;' \\\n\t-u user:password -k","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Conclusion","type":"text"}]},{"type":"paragraph","content":[{"text":"Congratulations, you have now completed the Abiquo API tutorials. You can now continue to experiment using the API together with the UI. And you can find more examples in the API Howtos section. ","type":"text"}]},{"type":"paragraph","content":[{"text":"And of course don't forget to check out the Java and Python libraries. Enjoy!","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Related links","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Get started with the Abiquo API","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/doc/pages/311374290"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Basic behaviors","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/doc/pages/311374188"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API How Tos","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/doc/pages/311374195"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API reference documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.abiquo.com/api/latest"}}]}]}]}]}],"version":1}

Browser not supported