HyperV Service for EFA (2.2.0)

Download OpenAPI specification:Download

API specification provided by the hyperv service from EFA

HyperV

getSCVMMServer

Get HyperV server details from specified SCVMM server. The SCVMM server can be identified by IP Address or HostName

query Parameters
host_name
string

IP/Host Name of the SCVMM Server

Responses

200

OK

401

Authorization information is missing or invalid.

404

A SCVMM server with the specified IP/Host Name was not found.

500

Unexpected error.

default

Unexpected error

get/hyperv
http://gohyperv-service:8087/v1/microsoft/hyperv

registerSCVMMServer

Register SCVMM server with the HyperV service

Request Body schema: application/json

Register a new SCVMM Server.

host_name
required
string
username
required
string
password
required
string
tenant
required
string

Responses

200

OK

401

Authorization information is missing or invalid.

409

A SCVMM Server with the specified IP/Host Name already exists.

500

Unexpected error.

default

Unexpected error

post/hyperv
http://gohyperv-service:8087/v1/microsoft/hyperv

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "host_name": "string",
  • "username": "string",
  • "password": "string",
  • "tenant": "string"
}

deleteSCVMMServer

Delete the specified SCVMM server from the inventory.

query Parameters
host_name
required
string

IP/Host Name of the SCVMM to be deleted.

cleanup_epgs
boolean

Flag to indicate whether the EPGs should be deleted on SCVMM Deletion

Responses

200

OK

401

Authorization information is missing or invalid.

404

A SCVMM Server with the specified IP Address/Host Name was not found.

500

Unexpected error.

default

Unexpected error

delete/hyperv
http://gohyperv-service:8087/v1/microsoft/hyperv

updateSCVMMServer

Update the specified SCVMM server details in the inventory.

path Parameters
host_name
required
string

IP Address/Host Name of the SCVMM server to be updated.

Request Body schema: application/json

Update SCVMM server. If credentials change provide new username and password

host_name
required
string
username
string
password
string

Responses

200

OK

401

Authorization information is missing or invalid.

404

Couldnt connect to the SCVMM Server. Check the credentials and/or host name.

500

Unexpected error.

default

Unexpected error

put/hyperv/{host_name}
http://gohyperv-service:8087/v1/microsoft/hyperv/{host_name}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "host_name": "string",
  • "username": "string",
  • "password": "string"
}

Service Setting

updateServiceSetting

Request Body schema: application/json

Update Service Settings.

key
required
string
Value: "Poll Frequency"
value
required
string
example
any

Responses

200

OK

400

Incorrect values specified for Service setting

500

Unexpected error.

default

Unexpected error

put/settings
http://gohyperv-service:8087/v1/microsoft/settings

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "key": "Poll Frequency",
  • "value": "string",
  • "example": null
}

getServiceSettings

Get the settings for the HyperV service

Responses

200

OK

500

Unexpected error.

default

Unexpected error

get/settings
http://gohyperv-service:8087/v1/microsoft/settings