1 of 8

4. HI GIO API

Overview

This guide is designed to help developers and technical users integrate and interact with the HI GIO Cloud services through our powerful API.

This manual provides detailed information on authenticating, making API calls, and handling responses effectively. It also covers best practices, code examples, and troubleshooting tips to ensure a smooth integration process.

Please refer to the VM usage guide in the list below.

API creates VM from Template

API creates VM from Template

Overview

In this manual, you will find detailed information on how to prepare & create a VM from the template.
This API creates a VM with the default name (VM name of template), default network "VM Network," and default compute and storage.

Procedure

Step 1: Preparation

{{vcd_url}}

{{vdc_uuid}}: Login vCD portal -> select VDC-> take a look and note vdc_uuid on the URL

{{network_uuid}}: On the vCD portal -> Networking -> Networks -> New

Select the “VM Network” -> take a look and note the network uuid on the url

{{vappTemplate_uuid}}: On the vCD portal -> Content Hub -> Catalogs ->HIGIO Shared Catalogs

-> vApp Templates -> select the template that you want to create VM -> take a look the vappTemplate_uuid on the url

{{Bearer Token}}: Please follow “” document

Step 2: Create VM from template

Postman:

POST https://{{vcd_url}}/api/vdc

/{{vdc_uuid}}/action/instantiateVAppTemplate

Authorization: {{Bearer Token }}

Headers:

- 'Accept: */*;version=37.2

- ‘Content-type’: application/vnd.vmware.vcloud.instantiateVAppTemplateParams+xml; charset=ISO-8859-1

On the vCD -> Data Center -> select your Virtual Data Center ->vApps -> check your vApp and VM.

API reconfigures VM's Disk

Overview

In this manual, you will find detailed information on how to prepare information, get the VM’s disk information, and reconfigure the VM’s disk.

Procedure

Step 1: Prepare Information

{{vcd_url}}

{{vm-uuid}}: select VM -> take a look vm uuid on url

{{Bearer Token}}: Please follow the “API token login” documen

GET https://{{vcd_url}}APIi/vApp/{{vm-uuid}}/virtualHardwareSection/disks
Authorization: {{Bearer Token}}
Headers:

PUT https//{{vcd_url}}APIi/vApp/{{vm-uuid}}/virtualHardwareSection/disks
Authorization: {{Bearer Token }}

Get VM’s disk information

GET https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/disks

Check on vCD portal

API reconfigures VM's Networks

In this manual, you will find detailed information on how to prepare information, get VM’s network information, and reconfigure VM’s networks.

{{vcd_url}}

{{vm-uuid}}: select VM -> take a look vm uuid on url

API token login

Overview

In this manual, you will find detailed information on preparing information, creating a Token on the vCD portal, and creating a Bearer token.

Procedure

Step 1: Prepare Information

* Login IAM portal -> vCD portal: collect the information

{{vcd_url}}
{{tenant_name}}

Ex: https://iaas-hcmc02.higiocloud.vn/tenant/”tenant_name”/vdcs/dashboard

Step 2: Create Token on vCD portal

Login IAM portal -> vCD portal -> User preferences
API tokens -> New

POST https://{{vcd_url}}/oauth/tenant/{{tenant_name}}/token
Authorization: No Auth
Headers:

API reconfigures VM's Memory

Overview

In this manual, you will find detailed information on how to prepare information, get the VM’s memory information, and reconfigure the VM’s memory.

Procedure

Step 1: Prepare Information

* Login IAM portal -> vCD portal: collect the information

{{vcd_url}}

- {{vm-uuid}}: select VM -> take a look vm uuid on url

-{{Bearer Token}}: Please follow “Api token login” document

GET https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/memory
Authorization: {{Bearer Token}}
Headers:

Step 3: Reconfig VM’s memory

PUT https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/memory
Authorization: {{Bearer Token }}

Get VM’s memory information

GET https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/memory

Check on vCD portal

API reconfigures VM's CPU

Overview

In this manual, you will find detailed information on how to prepare information, get the VM’s CPU information, and Reconfigure the VM’s CPU.

Procedure

Step 1: Prepare Information

{{vcd_url}}
{{vm-uuid}}: select VM -> take a look vm uuid on url
{{Bearer Token}}: Please follow “Api token login” document

GET https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/cpu
Authorization: {{Bearer Token }}
Headers:

Step 3: Reconfigure VM’s CPU

Postman:

PUT https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/cpu
Authorization: {{Bearer Token }}

Get VM’s CPU information

GET https://{{vcd_url}}/api/vApp/{{vm-uuid}}/virtualHardwareSection/cpu

Check on vCD portal

API power on/off VM

In this manual, you will find detailed information on how to prepare information, get VM status, and change status VM.

Step 1: Prepare information

{{vcd_url}}

API creates VM from Template

Overview

In this manual, you will find detailed information on how to prepare & create a VM from the template.
This API creates a VM with the default name (VM name of template), default network "VM Network," and default compute and storage.