Dedicated Hypervisor API reference (1.0.0)

Download OpenAPI specification:Download

This manual explains how to use the Smart Data Platform Dedicated Hypervisor API

Servers

The following APIs create, list, and delete servers.

Creating a new Hyper-V server is no longer available.

List Servers

This API lists your dedicated hypervisor information.

path Parameters

tenant_id

required

string

Example: aaa8749130bc3d2886d6b9bb3fcb1715

ID of the tenant

query Parameters

changes-since	string <date-time> A time/date stamp for when the server last changed status.
marker	string <uuid> UUID of the server at which you want to set a marker. The list starts from the server after the given UUID.
limit	integer Integer value for the maximum number of servers to return.
name	string Name of the server as a string.
image	string Name of the image in URL format. This parameter can be obtained by the GET /images API.
flavor	string Name of the flavor in URL format. This parameter can be obtained by the GET /flavors API.
status	string Value of the server status to filter results by.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/servers

https://{api_endpoint}/v1.0/{tenant_id}/servers

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"servers": 
[
{"id": "string",
"name": "new-server-test",
"links": 
[
{"href": "https://dedicated-hypervisor-jp1-ecl.api.ntt.com/v1.0/f118d06a83ce49938b3cf6bf3400e4cd/servers/347708f8-cd51-42b1-b3c3-a0597514e982",
"rel": "self"
}
],
"baremetal_server": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
],
"name": "new-server-test"
}
}
]
}

Create Server

Creating a new Hyper-V server is no longer available.

This API creates a new server.

path Parameters

tenant_id

required

string

ID of the tenant

Request Body schema: application/json

server

object

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

503

Service Unavailable

post/servers

https://{api_endpoint}/v1.0/{tenant_id}/servers

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"server": 
{"name": "server-test-1",
"description": "string",
"adminPass": "aabbccddeeff",
"imageRef": "b5660a6e-4b46-4be3-9707-6b47221b454f",
"flavorRef": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
"networks": 
[
{"uuid": "d32019d3-bc6e-4319-9c1d-6722fc136a22",
"fixed_ip": "10.0.0.100",
"segmentation_id": 2001
},
{"uuid": "d32019d3-bc6e-4319-9c1d-6722fc136a22",
"fixed_ip": "10.0.0.101",
"segmentation_id": 2001
}
],
"availability_zone": "zone1-groupa",
"metadata": 
{"foo": "bar"
}
}
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"server": 
{"id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
"links": 
[
{"rel": "self",
"href": "https://dedicated-hypervisor-jp1-ecl.api.ntt.com/v1.0/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931"
},
{"rel": "bookmark",
"href": "https://dedicated-hypervisor-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931"
}
],
"name": "new-server-test",
"adminPass": "aabbccddeeff"
}
}

List Servers Detail

This API lists your dedicated hypervisor information in detail.

path Parameters

tenant_id

required

string

Example: aaa8749130bc3d2886d6b9bb3fcb1715

ID of the tenant

query Parameters

changes-since	string <date-time> A time/date stamp for when the server last changed status.
marker	string <uuid> UUID of the server at which you want to set a marker. The list starts from the server after the given UUID.
limit	integer Integer value for the maximum number of servers to return.
name	string Name of the server as a string.
image	string Name of the image in URL format. This parameter can be obtained by the GET /images API.
flavor	string Name of the flavor in URL format. This parameter can be obtained by the GET /flavors API.
status	string Value of the server status to filter results by.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/servers/detail

https://{api_endpoint}/v1.0/{tenant_id}/servers/detail

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"servers": 
[
{"id": "string",
"name": "new-server-test",
"description": "hogehoge",
"hypervisor_type": "vsphere_esxi",
"imageRef": "string",
"image_name": "string",
"status": "ACTIVE",
"baremetal_server": 
{"OS-EXT-STS:power_state": "RUNNING",
"OS-EXT-STS:task_state": "None",
"OS-EXT-STS:vm_state": "ACTIVE",
"OS-EXT-AZ:availability_zone": "zone1-groupa",
"created": "2026-09-07T12:59:01Z",
"flavor": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/flavors/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"id": "string",
"image": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
],
"metadata": 
{"My Server Name": "Apache1"
},
"name": "new-server-test",
"progress": 0,
"status": "ACTIVE",
"tenant_id": "aaa8749130bc3d2886d6b9bb3fcb1715",
"updated": "2026-09-07T12:59:01Z",
"user_id": "fake",
"raid_arrays": 
[
{"primary_storage": true,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk0_uuid",
"disk1_uuid",
"disk2_uuid",
"disk3_uuid"
],
"partitions": 
[
{"lvm": true,
"partition_label": "partition_label"
},
{"lvm": false,
"size": "100G",
"partition_label": "var"
}
]
},
{"primary_storage": false,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk4_uuid",
"disk5_uuid",
"disk6_uuid",
"disk7_uuid"
],
"raid_level": 10,
"partitions": 
[
{"lvm": true,
"partition_label": "secondary-part1"
}
]
}
],
"lvm_volume_groups": 
[
{"vg_label": "VG_root",
"physical_volume_partition_labels": 
["primary-part1",
"secondary-part1"
],
"logical_volumes": 
[
{"lv_label": "LV_root"
},
{"size": "2G",
"lv_label": "LV_swap"
}
]
}
],
"filesystems": 
[
{"label": "LV_root",
"mount_point": "/",
"fs_type": "xfs"
},
{"label": "var",
"mount_point": "/var",
"fs_type": "xfs"
},
{"label": "LV_swap",
"mount_point": "swap"
}
],
"nic_physical_ports": 
[
{"id": "39285bf9-12fb-4064-b98b-a552efc51cfc",
"mac_addr": "0a:31:c1:d5:6d:9c",
"network_physical_port_id": "38268d94-584a-4f14-96ff-732a68aa7301",
"plane": "data",
"attached_ports": 
[
{"port_id": "61b7da1e-9571-4d63-b779-e003a56b8105",
"network_id": "9aa93722-1ec4-4912-b813-b975c21460a5",
"fixed_ips": 
[
{"subnet_id": "0419bbde-2b82-4107-9d8a-6bba76e364af",
"ip_address": "192.168.10.2"
}
]
}
],
"hardware_id": "063468e8-61ab-4afd-be38-c937254aeb9a"
}
],
"chassis-status": 
{"chassis-power": true,
"power-supply": true,
"cpu": true,
"memory": true,
"fan": true,
"disk": 0,
"nic": true,
"system-board": true,
"etc": true
},
"media_attachments": 
[
{"image": 
{"id": "3339fd5f-ec06-4ef8-9337-c1c70218a748",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/images/3339fd5f-ec06-4ef8-9337-c1c70218a748",
"rel": "bookmark"
}
]
}
}
]
},
"cfgw_connection_status": true
}
]
}

Show Server

This API shows your dedicated hypervisor information.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
server_id required	string <uuid> ID of the server

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Request URL or method is invalid

500

Internal Server Error

get/servers/{server_id}

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"server": 
{"id": "string",
"name": "new-server-test",
"description": "hogehoge",
"hypervisor_type": "vsphere_esxi",
"imageRef": "string",
"image_name": "string",
"status": "ACTIVE",
"baremetal_server": 
{"OS-EXT-STS:power_state": "RUNNING",
"OS-EXT-STS:task_state": "None",
"OS-EXT-STS:vm_state": "ACTIVE",
"OS-EXT-AZ:availability_zone": "zone1-groupa",
"created": "2026-09-07T12:59:01Z",
"flavor": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/flavors/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"id": "string",
"image": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
],
"metadata": 
{"My Server Name": "Apache1"
},
"name": "new-server-test",
"progress": 0,
"status": "ACTIVE",
"tenant_id": "aaa8749130bc3d2886d6b9bb3fcb1715",
"updated": "2026-09-07T12:59:01Z",
"user_id": "fake",
"raid_arrays": 
[
{"primary_storage": true,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk0_uuid",
"disk1_uuid",
"disk2_uuid",
"disk3_uuid"
],
"partitions": 
[
{"lvm": true,
"partition_label": "partition_label"
},
{"lvm": false,
"size": "100G",
"partition_label": "var"
}
]
},
{"primary_storage": false,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk4_uuid",
"disk5_uuid",
"disk6_uuid",
"disk7_uuid"
],
"raid_level": 10,
"partitions": 
[
{"lvm": true,
"partition_label": "secondary-part1"
}
]
}
],
"lvm_volume_groups": 
[
{"vg_label": "VG_root",
"physical_volume_partition_labels": 
["primary-part1",
"secondary-part1"
],
"logical_volumes": 
[
{"lv_label": "LV_root"
},
{"size": "2G",
"lv_label": "LV_swap"
}
]
}
],
"filesystems": 
[
{"label": "LV_root",
"mount_point": "/",
"fs_type": "xfs"
},
{"label": "var",
"mount_point": "/var",
"fs_type": "xfs"
},
{"label": "LV_swap",
"mount_point": "swap"
}
],
"nic_physical_ports": 
[
{"id": "39285bf9-12fb-4064-b98b-a552efc51cfc",
"mac_addr": "0a:31:c1:d5:6d:9c",
"network_physical_port_id": "38268d94-584a-4f14-96ff-732a68aa7301",
"plane": "data",
"attached_ports": 
[
{"port_id": "61b7da1e-9571-4d63-b779-e003a56b8105",
"network_id": "9aa93722-1ec4-4912-b813-b975c21460a5",
"fixed_ips": 
[
{"subnet_id": "0419bbde-2b82-4107-9d8a-6bba76e364af",
"ip_address": "192.168.10.2"
}
]
}
],
"hardware_id": "063468e8-61ab-4afd-be38-c937254aeb9a"
}
],
"chassis-status": 
{"chassis-power": true,
"power-supply": true,
"cpu": true,
"memory": true,
"fan": true,
"disk": 0,
"nic": true,
"system-board": true,
"etc": true
},
"media_attachments": 
[
{"image": 
{"id": "3339fd5f-ec06-4ef8-9337-c1c70218a748",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/images/3339fd5f-ec06-4ef8-9337-c1c70218a748",
"rel": "bookmark"
}
]
}
}
]
},
"cfgw_connection_status": true
}
}

Delete Server

This API deletes a specified vSphere/Hyper-V server. You can delete a server when its status is ACTIVE or ERROR.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
server_id required	string <uuid> ID of the server

Responses

204

No Content

400

Bad Request

401

Unauthorized

404

Not Found

405

Request URL or method is invalid

409

Conflict

500

Internal Server Error

503

Service Unavailable

delete/servers/{server_id}

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"badRequest": 
{"code": 400,
"message": "Request Parameter Error:\\n"
}
}

Update Server

This API updates the editable attributes of the specified server.

path Parameters

tenant_id required	string <uuid> ID for the tenant.
server_id required	string <uuid> ID for the server.

Request Body schema: application/json

server

object

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Request URL or method is invalid

500

Internal Server Error

503

Service Unavailable

put/servers/{server_id}

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"server": 
{"name": "server-test-1"
}
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"server": 
{"id": "string",
"name": "new-server-test",
"description": "hogehoge",
"hypervisor_type": "vsphere_esxi",
"imageRef": "string",
"image_name": "string",
"status": "ACTIVE",
"baremetal_server": 
{"OS-EXT-STS:power_state": "RUNNING",
"OS-EXT-STS:task_state": "None",
"OS-EXT-STS:vm_state": "ACTIVE",
"OS-EXT-AZ:availability_zone": "zone1-groupa",
"created": "2026-09-07T12:59:01Z",
"flavor": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/flavors/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"id": "string",
"image": 
{"id": "string",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
]
},
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
],
"metadata": 
{"My Server Name": "Apache1"
},
"name": "new-server-test",
"progress": 0,
"status": "ACTIVE",
"tenant_id": "aaa8749130bc3d2886d6b9bb3fcb1715",
"updated": "2026-09-07T12:59:01Z",
"user_id": "fake",
"raid_arrays": 
[
{"primary_storage": true,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk0_uuid",
"disk1_uuid",
"disk2_uuid",
"disk3_uuid"
],
"partitions": 
[
{"lvm": true,
"partition_label": "partition_label"
},
{"lvm": false,
"size": "100G",
"partition_label": "var"
}
]
},
{"primary_storage": false,
"raid_card_hardware_id": "fakeraid_card_uuid",
"disk_hardware_ids": 
["disk4_uuid",
"disk5_uuid",
"disk6_uuid",
"disk7_uuid"
],
"raid_level": 10,
"partitions": 
[
{"lvm": true,
"partition_label": "secondary-part1"
}
]
}
],
"lvm_volume_groups": 
[
{"vg_label": "VG_root",
"physical_volume_partition_labels": 
["primary-part1",
"secondary-part1"
],
"logical_volumes": 
[
{"lv_label": "LV_root"
},
{"size": "2G",
"lv_label": "LV_swap"
}
]
}
],
"filesystems": 
[
{"label": "LV_root",
"mount_point": "/",
"fs_type": "xfs"
},
{"label": "var",
"mount_point": "/var",
"fs_type": "xfs"
},
{"label": "LV_swap",
"mount_point": "swap"
}
],
"nic_physical_ports": 
[
{"id": "39285bf9-12fb-4064-b98b-a552efc51cfc",
"mac_addr": "0a:31:c1:d5:6d:9c",
"network_physical_port_id": "38268d94-584a-4f14-96ff-732a68aa7301",
"plane": "data",
"attached_ports": 
[
{"port_id": "61b7da1e-9571-4d63-b779-e003a56b8105",
"network_id": "9aa93722-1ec4-4912-b813-b975c21460a5",
"fixed_ips": 
[
{"subnet_id": "0419bbde-2b82-4107-9d8a-6bba76e364af",
"ip_address": "192.168.10.2"
}
]
}
],
"hardware_id": "063468e8-61ab-4afd-be38-c937254aeb9a"
}
],
"chassis-status": 
{"chassis-power": true,
"power-supply": true,
"cpu": true,
"memory": true,
"fan": true,
"disk": 0,
"nic": true,
"system-board": true,
"etc": true
},
"media_attachments": 
[
{"image": 
{"id": "3339fd5f-ec06-4ef8-9337-c1c70218a748",
"links": 
[
{"href": "https://baremetal-server-jp1-ecl.api.ntt.com/openstack/images/3339fd5f-ec06-4ef8-9337-c1c70218a748",
"rel": "bookmark"
}
]
}
}
]
},
"cfgw_connection_status": true
}
}

Licenses

The following APIs create, list, and delete license keys on vSphere/Hyper-V.

List Licenses

This API lists your guest image licenses.

path Parameters

tenant_id

required

string

Example: aaa8749130bc3d2886d6b9bb3fcb1715

ID of the tenant

query Parameters

license_type

string

Example: license_type=vCenter Server 5.5 Standard

License type name as a string.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/licenses

https://{api_endpoint}/v1.0/{tenant_id}/licenses

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"licenses": 
[
{"id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
"key": "4fbc-b7a2-03b62b884931aaaaaaaaa",
"assigned_from": "2016-06-01T00:00:00.000Z",
"expires_at": "2016-07-01T00:00:00.000Z",
"license_type": "vCenter.Server 5.5 Standard"
},
{"id": "05184ba3-00ba-4fbc-b7a2-03b62b884932",
"key": "4fbc-b7a2-03b62b884931aaaaaabbb",
"assigned_from": "2016-06-02T00:00:00.000Z",
"expires_at": "2016-07-02T00:00:00.000Z",
"license_type": "vCenter.Server 5.5 Standard"
}
]
}

Create License

This API creates a new license key.

path Parameters

tenant_id

required

string

ID of the tenant

Request Body schema: application/json

license_type

required

string

Name of your guest image license type as a string.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

503

Service Unavailable

post/licenses

https://{api_endpoint}/v1.0/{tenant_id}/licenses

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"license_type": "vCenter Server 5.5 Standard"
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"license": 
{"id": "string",
"key": "4fbc-b7a2-03b62b884931aaaaaaaaa",
"assigned_from": "2016-06-01T00:00:00.000Z",
"expires_at": "2016-07-01T00:00:00.000Z",
"license_type": "vCenter.Server 5.5 Standard"
}
}

Delete License

This API deletes a specified license.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
license_id required	string <uuid> ID for the license.

Responses

204

No Content

400

Bad Request

401

Unauthorized

404

Not Found

405

Request URL or method is invalid

409

Conflict

500

Internal Server Error

503

Service Unavailable

delete/licenses/{license_id}

https://{api_endpoint}/v1.0/{tenant_id}/licenses/{license_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"badRequest": 
{"code": 400,
"message": "Request Parameter Error:\\n"
}
}

LicenseTypes

The following API lists the license types available for purchase.

List LicenseTypes

This API lists guest image license type information for vSphere/Hyper-V servers.

path Parameters

tenant_id

required

string

Example: aaa8749130bc3d2886d6b9bb3fcb1715

ID of the tenant

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/license_types

https://{api_endpoint}/v1.0/{tenant_id}/license_types

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"license_types": 
[
{"id": "69fcba22209347719e764e3eba862db1",
"name": "vCenter Server 5.5 Standard",
"has_license_key": true,
"license_switch": false,
"unit": "license",
"description": "vCenter Server 5.5 Standard"
},
{"id": "69fcba22209347719e764e3eba862db2",
"name": "SQL Server 2014 Standard Edition",
"has_license_key": false,
"license_switch": true,
"unit": "vCPU",
"description": "SQL Server 2014 Standard Edition"
},
{"id": "69fcba22209347719e764e3eba862db3",
"name": "Windows Server",
"has_license_key": false,
"license_switch": false,
"unit": "VM",
"description": "Windows Server 2008 - 2012 R2"
}
]
}

Usages

The following API lists usages of guest images.

List Usages

This API lists your guestimage usage information.

path Parameters

tenant_id

required

string

Example: aaa8749130bc3d2886d6b9bb3fcb1715

ID of the tenant

query Parameters

from	string Example: from= Date to list usage from. If not specified, the beginning of the month is set.
to	string Example: to= Date to list usage to. The month of this parameter must be the same as 'from'. If not specified, the end of the month is set.
license_type	string Example: license_type=vCenter Server 5.5 Standard License type name as a string.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/usages

https://{api_endpoint}/v1.0/{tenant_id}/usages

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"tenant_id": "9da9116d-cc44-4ad8-aca5-7db398fcb477",
"usages": 
[
{"id": "9da9116d-cc44-4ad8-aca5-7db398fcb477",
"type": "dedicated-hypervisor.guest-image.sql-server-2014-standard",
"value": 4,
"unit": "vCPU",
"name": "SQL Server 2014 Standard Edition",
"description": "SQL Server 2014 Standard Edition",
"has_license_key": false,
"resource_id": "d-cc44-4ad8-aca5-7db398fcb477aaaaaa"
},
{"id": "9da9116d-cc44-4ad8-aca5-7db398fcb478",
"type": "dedicated-hypervisor.guest-image.sql-server-2014-standard",
"value": 6,
"unit": "vCPU",
"name": "SQL Server 2014 Standard Edition",
"description": "SQL Server 2014 Standard Edition",
"has_license_key": false,
"resource_id": "d-cc44-4ad8-aca5-7db398fcb477bbbbbb"
},
{"id": "9da9116d-cc44-4ad8-aca5-7db398fcb479",
"type": "dedicated-hypervisor.guest-image.windows-server",
"value": 3,
"unit": "VM",
"name": "Windows Server",
"description": "Windows Server 2008 - 2012 R2",
"has_license_key": false,
"resource_id": "d-cc44-4ad8-aca5-cc44"
}
]
}

Show Usage Histories

This API shows your guest image usage history information.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
usage_id required	string Example: d22fe95e-f9f5-4cd2-a669-75439eaeada7 Usage ID. This parameter can be retrieved by the List Usages API.

query Parameters

from	string Example: from= Date to list usage from. If not specified, the beginning of the month is set.
to	string Example: to= Date to list usage to. The month of this parameter must be the same as 'from'. If not specified, the end of the month is set.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

405

Request URL or method is invalid

500

Internal Server Error

get/usages/{usage_id}/histories

https://{api_endpoint}/v1.0/{tenant_id}/usages/{usage_id}/histories

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"tenant_id": "9da9116d-cc44-4ad8-aca5-7db398fcb477",
"unit": "VM",
"resource_id": "9da9116d-cc44-4ad8-aca5-7db398fcb488",
"license_type": "Windows Server",
"histories": 
[
{"time": "2015-05-06 11:00:00",
"value": 0
},
{"time": "2015-05-06 12:00:00",
"value": 1
},
{"time": "2015-05-06 13:00:00",
"value": 1
},
{"time": "2015-05-06 14:00:00",
"value": 3
}
]
}

Server Actions

The following API adds a license to a VM and gets the result of adding a license to a VM.

Server Actions

The following API adds a license to a VM and gets the result of adding a license to a VM.

Action	Description
Add License to VM	Adds license meta-information to the VM on the specified hypervisor.
Get Result for add license to VM	Shows the result of the add-license-to-vm API.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID for the tenant.
server_id required	string <uuid> ID for the server.

Request Body schema: application/json

One of

Add License to VM by vm_id
Add License to VM by vm_name
Get Result for add license to VM

add-license-to-vm

required

object

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Request URL or method is invalid

500

Internal Server Error

post/servers/{server_id}/action

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}/action

Request samples

Payload

Content type

application/json

Example

Copy

Expand all Collapse all


{"add-license-to-vm": 
{"vm_id": "cd898512-d145-4198-a256-9c1351cd4fcf",
"license_types": 
["Windows Server",
"SQL Server Standard 2014"
]
}
}

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"job_id": "b4f888dc2b9d4c41bb769cbd"
}

CFGW Connection

The following APIs get and update the CFGW Connection status.

Show CFGW Connection

This API shows the connection status between your dedicated hypervisor and the common function gateway network.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
server_id required	string <uuid> ID of the server

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Request URL or method is invalid

500

Internal Server Error

get/servers/{server_id}/cfgw_connection

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}/cfgw_connection

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"server": 
{"id": "string",
"cfgw_connection": 
{"status": true,
"error_type": null,
"last_established_at": "2022-07-20T06:26:00.000Z",
"updated_at": "2022-07-20T06:26:00.000Z"
}
}
}

Update CFGW Connection Status

This API updates the connection status between your dedicated hypervisor and the common function gateway network.

path Parameters

tenant_id required	string Example: aaa8749130bc3d2886d6b9bb3fcb1715 ID of the tenant
server_id required	string <uuid> ID of the server

Responses

200

400

Bad Request

401

Unauthorized

404

Not Found

405

Request URL or method is invalid

500

Internal Server Error

post/servers/{server_id}/cfgw_connection

https://{api_endpoint}/v1.0/{tenant_id}/servers/{server_id}/cfgw_connection

Response samples

Content type

application/json

Example

Copy

Expand all Collapse all


{"server": 
{"id": "string",
"cfgw_connection": 
{"status": true,
"error_type": null,
"last_established_at": "2022-07-20T06:26:00.000Z",
"updated_at": "2022-07-20T06:26:00.000Z"
}
},
"info": "Successfully updated"
}