Security Controls REST API

Home 

Virtual Infrastructure

Adds virtual infrastructure to the inventory.

Base URL

https://<consoleFQDN:port>/st/console/api/v1.0/virtual

Supported Requests

Hypervisors

Method URL Input Return
GET https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors   Hypervisors[]
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id of hypervisor}   Configuration information for the specified hypervisor.
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id of hypervisor}/images/{id of image}   Configuration information for the specified virtual image.

https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id of hypervisor}/images

URL Parameters

VirtualImages[]
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id of hypervisor}/images/usedby    
POST

https://<consoleFQDN:port>/st/console/api/v1.0/virtual

POST Request Body  
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id}/refresh    
PATCH https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/{id} PATCH Request Body  

VCenters

Method URL Input Return
GET https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters   VCenterServers[]
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters/{id of vcenter}   Configuration information for the specified vCenter Server.
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters/{id of vcenter}/hypervisors   Hypervisors[]
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters/{id of vcenter}/usedby    
     
POST https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters POST Request Body  
https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters/{id}/refresh    
PATCH https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters/{id} PATCH Request Body  

Input Models

URL Parameters

Name Type Description

count

Integer

Provide the count of items to return. The maximum value is 50.

start

Integer

Sets the starting point.

POST Request Body

Name Required? Type Default Value Description

certIficateThumbprint

No

String

None

The server's hexadecimal encoded certificate thumbprint. It is used to verify the server the first time you connect to it.

credentialId

Yes

Guid

None

The credential ID.

name

Yes

String

None

The name of the vCenter.

port

No

Integer

443

The port.

PATCH Request Body

Name Required? Type Default Value Description

certIficateThumbprint

No

String

None

The server's certificate thumbprint. It is used to verify the server the first time you connect to it.

Example

Find all VCenter servers

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/virtual/vcenters

Sample Response

Status code: ###

TBD

Other Request Examples

Add a virtual inventory server to the inventory by IP

https://<consoleFQDN:port>/st/console/api/v1.0/virtual

{

"Name": "192.168.106.128",

"CredentialId": "01234567-89AB-CDEF-0123-456789ABCDEF"

}

Find all hypervisors

https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors

Find the first 10 images managed by a hypervisor server with ID 1

https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/1/images?count=10

Unconditionally delete a hypervisor with ID 10

https://<consoleFQDN:port>/st/console/api/v1.0/virtual/hypervisors/10?forcedelete=true

 

Output Models

VCenterServer

Name Type Description

certificateThumbprint

String

The server's hexadecimal encoded certificate thumbprint. This was provided using the REST API or accepted via the user interface.

credentialId

Guid

The credential ID.

id

Integer

The ID.

links

Links

Shows the related URLs.

managedHypervisors

String

The list of all managed hypervisors.

name

String

The item name.

port

Integer

The port.

VirtualImage

Name Type Description

hostName

String

The host name.

id

Integer

The unique identifier of the item.

inventoryPath

String

The inventory path.

ipAddress

IPAddress

The IP address.

lastKnownPowerState

VirtualMachineState

The last known power state.

links

Links

Shows the related URLs.

name

String

The item name.

runningStatus

ToolsRunningStatus

The VMware tools running status.

versionStatus

ToolsVersionStatus

The VMware tools version status.

Hypervisor

Name Type Description

certificateThumbprint

String

The server's hexadecimal encoded certificate thumbprint. This was provided using the REST API or accepted via the user interface.

credentialId

Guid

The credential ID.

hostSystemName

String

The host system name.

id

Integer

The ID.

ipAddress

String

The IP address.

isInMaintenanceMode

Boolean

Is in maintenance mode.

links

Links

Shows the related URLs.

name

String

The item name.

port

Integer

The port number.

vCenterServerId

Integer

The VCenter Server ID.

HostedVirtualMachine

Name Type Description

adminCredentialId

Guid

The ID of the associated administrative credential (if any).

category

DiscoveryFilterType

The type of filter or machine group item.

id

Integer

The unique identifier of the item.

inventoryPath

String

The inventory path.

links

Links

Shows the related URLs.

note

String

A user-specified note or description.

serverName

String

The server name.

UsedBy

Name Type Description

name

String

Gets the name of the item that is using this hypervisor or vCenter.

usageType

SummaryType

The type of component using this hypervisor or vCenter.

VirtualMachineState

PoweredOff

PoweredOn

Suspended

ToolsRunningStatus

Unknown

GuestToolsNotRunning

GuestToolsRunning

GuestToolsExecutingScripts

ToolsVersionStatus

Blacklisted

Current

NeedUpgrade

NotInstalled

SupportedNew

SupportedOld

TooNew

TooOld

Unmanaged

Unknown

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other