- About Veeam ONE REST API
- Overview
- Changelog
- About
- Alarms
- Authentication
- Business View
- Licensing
- Microsoft Hyper-V Infrastructure
- getGet Infrastructure Object Relations
- getGet Relations of Infrastructure Object
- getGet All Microsoft Hyper-V VMs
- getGet Microsoft Hyper-V VM
- getGet All Microsoft Hyper-V Host Clusters
- getGet Microsoft Hyper-V Host Cluster
- getGet All Microsoft Hyper-V CSVs
- getGet Microsoft Hyper-V CSV
- getGet All Microsoft Hyper-V Host Groups
- getGet Microsoft Hyper-V Host Group
- getGet All Microsoft Hyper-V Hosts
- getGet Microsoft Hyper-V Host
- getGet All Microsoft Hyper-V Physical Disks
- getGet Microsoft Hyper-V Physical Disk
- getGet All Microsoft Hyper-V SCVMM Servers
- getGet Microsoft Hyper-V SCVMM Server
- getGet All Microsoft Hyper-V File Servers
- getGet Microsoft Hyper-V File Server
- getGet All Microsoft Hyper-V File Shares
- getGet Microsoft Hyper-V File Share
- Public Cloud
- getGet All Cloud VM Policies.
- getGet Cloud VM Policy
- getGet All Cloud File Share Policies
- getGet Cloud File Share Policy
- getGet All Cloud Database Policies
- getGet Cloud Database Policy
- getGet All Public Cloud Network Policies
- getGet Public Cloud Network Policy
- getGet All Cloud VMs
- getGet All Cloud File Shares
- getGet All Cloud Databases
- Public Cloud Protected Data
- getGet All Protected Cloud VMs
- getGet Protected Cloud VM
- getGet Backups of All Protected Cloud VMs
- getGet All Backups of Protected Cloud VM
- getGet All Restore Points of Protected Cloud VM
- getGet All Protected Cloud File Shares
- getGet Protected Cloud File Share
- getGet Backups of All Protected Cloud File Shares
- getGet All Backups of Protected Cloud File Share
- getGet All Restore Points of Protected Cloud File Share
- getGet All Protected Cloud Databases
- getGet Protected Cloud Database
- getGet Backups of All Protected Cloud Databases
- getGet All Backups of Protected Cloud Database
- getGet All Restore Points of Protected Cloud Database
- getGet All Protected Cloud Networks
- getGet Protected Cloud Network
- getGet All Cloud Network Backups
- getGet Backups of Cloud Network
- getGet Restore Points of Cloud Network
- Task Sessions
- VMware Cloud Director Infrastructure
- getGet Infrastucture Object Relations
- getGet Relations of Infrastructure Object
- getGet All Organizations
- getGet Organization
- getGet All Organization VDCs
- getGet Organization VDC
- getGet All Provider VDCs
- getGet Provider VDC
- getGet All Provider VDC Datastores
- getGet Provider VDC Datastore
- getGet All vApps
- getGet vApp
- getGet All VMs in vApps
- getGet All VMs in vApp
- getGet All VMware Cloud Director Servers
- getGet VMware Cloud Director Server
- VMware vSphere Infrastructure
- getGet Infrastructure Object Relations
- getGet Relations of Infrastructure Object
- getGet All vCenter Servers
- getGet vCenter Server
- getGet All VMware vSphere VMs
- getGet VMware vSphere VM
- getGet All VMware vSphere Host Clusters
- getGet Host Cluster
- getGet All VMware vSphere Datastores
- getGet VMware vSphere Datastore
- getGet All VMware vSphere Hosts
- getGet VMware vSphere Host
- getGet All Host Hardware Sensors
- getGet Hardware Sensors of Host
- getGet All Resource Pools
- getGet Resource Pool
- getGet All Datastore Clusters
- getGet Datastore Cluster
- getGet All vApps
- getGet vApp
- getGet All VMware vSphere VM Folders
- getGet VMware vSphere VM Folder
- Veeam Backup & Replication Failover Plans
- Veeam Backup & Replication Infrastructure
- getGet Infrastructure Object Relations
- getGet Relations of Infrastructure Object
- getGet All Backup Agents
- getGet Backup Agent
- getGet All Veeam Backup & Replication Servers
- getGet Veeam Backup & Replication Server
- getGet All Best Practices
- getGet Best Practices for Veeam Backup & Replication Server
- getGet All Backup Proxies
- getGet Backup Proxy
- getGet All WAN Accelerators
- getGet WAN Accelerator
- getGet All Tape Servers
- getGet Tape Server
- getGet All Veeam Backup Enterprise Manager Servers
- getGet Veeam Backup Enterprise Manager Server
- getGet All Backup Repositories
- getGet Backup Repository
- getGet All External Backup Repositories
- getGet External Backup Repository
- getGet All Object Storage Repositories
- getGet Object Storage Repository
- getGet All Scale-Out Repositories
- getGet Scale-Out Repository
- getGet All Performance Tier Extents
- getGet Performance Tier Extent
- getGet All Archive Tier Extents
- getGet Archive Tier Extent
- getGet All Capacity Tier Extents
- getGet Capacity Tier Extent
- getGet All Connected Applications
- getGet Connected Application
- Veeam Backup & Replication Jobs
- getGet All VM Backup Jobs
- getGet VM Backup Job
- getGet All VMware Cloud Director Backup Jobs
- getGet VMware Cloud Director Backup Job
- getGet All VM Replication Jobs
- getGet VM Replication Job
- getGet All VMware Cloud Director Replication Jobs
- getGet VMware Cloud Director Replication Job
- getGet All Backup to Tape Jobs
- getGet Backup to Tape Job
- getGet All Backup Copy Jobs
- getGet Backup Copy Job
- getGet All Child Jobs of Backup Copy Job
- getGet All SureBackup Jobs
- getGet SureBackup Job
- getGet All VM Copy Jobs
- getGet VM Copy Job
- getGet All Snapshot-Only Jobs
- getGet Snapshot-Only Job
- getGet All CDP Policies
- getGet CDP Policy
- getGet All File to Tape Jobs
- getGet File to Tape Job
- getGet All Object to Tape Jobs
- getGet Object to Tape Job
- getGet All File Copy Jobs
- getGet File Copy Job
- getGet All File Backup Jobs
- getGet File Backup Job
- getGet All Agent Backup Jobs
- getGet Agent Backup Job
- getGet All Veeam Backup Agent Policies
- getGet Veeam Backup Agent Policy
- getGet All Veeam Backup Agent Policy Child Jobs
- getGet All Application Backup Jobs
- getGet Application Backup Job
- getGet All Enterprise Application Transaction Log Backup Jobs
- getGet Enterprise Application Transaction Log Backup Job
- getGet All Transaction Log Backup Jobs
- getGet Transaction Log Backup Job
- getGet All Object Storage Jobs
- getGet Object Storage Job
- Veeam Backup & Replication Protected Data
- getGet All Protected VMs
- getGet Protected VM
- getGet Backups of All Protected VMs
- getGet Backups of Protected VM
- getGet All Backup Restore Points of Protected VM
- getGet All Replication Restore Points of Protected VM
- getGet All Protected Computers
- getGet Protected Computer
- getGet Backups of All Protected Computers
- getGet All Backups of Protected Computer
- getGet All Backup Restore Points of Protected Computer
- getGet All Protected File Shares
- getGet Protected File Share
- getGet Backups of All Protected File Shares
- getGet Backups of Protected File Share
- getGet All Backup Restore Points of Protected File Share
- getGet All Protected Object Storages
- getGet Protected Object Storage
- getGet Backups of All Protected Object Storages
- getGet Backups of Protected Object Storage
- getGet All Backup Restore Points of Protected Object Storage
- getGet All Protected Applications
- getGet Protected Application
- getGet Backups of All Application Databases
- getGet All Database Backups of Application
- Veeam Backup for Microsoft 365 Infrastructure
- getGet Infrastructure Object Relations
- getGet Relations of Infrastructure Object
- getGet All Veeam Backup for Microsoft 365 Servers
- getGet Veeam Backup for Microsoft 365 Server
- getGet All Proxy Pools
- getGet Backup Proxy Pool
- getGet All Veeam Backup for Microsoft 365 Backup Proxy Servers
- getGet Veeam Backup for Microsoft 365 Backup Proxy Server
- getGet All Veeam Backup for Microsoft 365 Backup Repositories
- getGet Veeam Backup for Microsoft 365 Backup Repository
- getGet All Veeam Backup for Microsoft 365 Object Storage Repositories
- getGet Veeam Backup for Microsoft 365 Object Storage Repository
- getGet All Microsoft Organizations
- getGet Microsoft Organization
- getGet All Users of Microsoft Organization
- getGet Microsoft 365 User
- getGet All Microsoft 365 Users
- getGet All Groups of Microsoft Organization
- getGet Microsoft 365 Group
- getGet All Microsoft 365 Groups
- getGet SharePoint Sites of Microsoft Organization
- getGet Microsoft SharePoint Site
- getGet All Microsoft SharePoint Sites
- getGet All Teams of Microsoft Organization
- getGet Microsoft 365 Team
- getGet All Microsoft 365 Teams
- Veeam Backup for Microsoft 365 Jobs
- Veeam Backup for Microsoft 365 Protected Data
- getGet All Protected Microsoft 365 Users
- getGet Restore Points of All Protected Microsoft 365 Users
- getGet Protected Microsoft 365 User
- getGet All Microsoft 365 User Restore Points
- getGet All Protected Microsoft 365 Groups
- getGet Restore Points of All Protected Microsoft 365 Groups
- getGet Protected Microsoft 365 Group
- getGet All Microsoft 365 Group Restore Points
- getGet All Protected Microsoft 365 Sites
- getGet Restore Points of All Protected Microsoft 365 Sites
- getGet Protected Microsoft 365 Site
- getGet All Microsoft 365 Site Restore Points
- getGet All Protected Microsoft 365 Teams
- getGet Restore Points of All Protected Microsoft 365 Teams
- getGet Protected Microsoft 365 Team
- getGet All Microsoft 365 Team Restore Points
- Veeam Cloud Connect
This resource collection represents monitored Microsoft Hyper-V infrastructure.
Get Infrastructure Object Relations
Returns a collection resource representation of all objects in Microsoft Hyper-V infrastructure and their relations.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "objectId": 1724,
- "objectName": "access",
- "objectType": "FileShare",
- "parentId": 1726,
- "parentName": "es-win2019-ws.tech.local",
- "parentType": "FileServer"
}, - {
- "objectId": 98,
- "objectName": "az_Ubnt18",
- "objectType": "Vm",
- "parentId": 76,
- "parentName": "azhv.tech.local",
- "parentType": "Host"
}, - {
- "objectId": 76,
- "objectName": "azhv.tech.local",
- "objectType": "Host",
- "parentId": 71,
- "parentName": "cluaz.tech.local",
- "parentType": "Cluster"
}, - {
- "objectId": 77,
- "objectName": "azhv1.tech.local",
- "objectType": "Host",
- "parentId": 71,
- "parentName": "cluaz.tech.local",
- "parentType": "Cluster"
}
], - "totalCount": 4
}
Get Relations of Infrastructure Object
Returns a resource representation of a Microsoft Hyper-V infrastructure object with the specified ID and its relations.
path Parameters
objectId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "objectId": 0,
- "objectName": "Virtual Infrastructure",
- "objectType": "VirtualInfrastructure",
- "parentId": null,
- "parentName": null,
- "parentType": null
}
Get All Microsoft Hyper-V VMs
Returns a collection resource representation of all VMs in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "vmId": 95,
- "guid": "D67D87B9-7180-42AC-9A79-700283C525B3",
- "name": "az_vm3",
- "powerState": "Enabled",
- "cpuCount": 1,
- "totalDatastoreCommittedBytes": 4194304,
- "totalDatastoreUncommitedBytes": 1073741824,
- "guestDisks": [ ],
- "ipAddresses": [ ],
- "guestOs": "",
- "isReplica": false,
- "snapshotFolder": "C:\\ProgramData\\Microsoft\\Windows\\Hyper-V",
- "creationTime": "2025-07-10T05:09:56Z",
- "hostId": 71,
- "dnsName": "",
- "dynamicMemoryEnabled": false,
- "assignedMemoryMb": 32,
- "uptimeMs": 930019871,
- "vmAssignedMemoryMb": 32,
- "integrationServices": [
- {
- "wmiClassName": "Msvm_HeartbeatComponentSettingData",
- "name": "Heartbeat",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_KvpExchangeComponentSettingData",
- "name": "Key-Value Pair Exchange",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_ShutdownComponentSettingData",
- "name": "Shutdown",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_TimeSyncComponentSettingData",
- "name": "Time Synchronization",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_VssComponentSettingData",
- "name": "VSS",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_GuestServiceInterfaceComponentSettingData",
- "name": "Guest Service Interface",
- "isLaunched": false
}
], - "cpuMhz": 2400,
- "memoryReservationMb": 32,
- "memoryLimitMb": 1048576,
- "isShielded": false,
- "lastProtectedDate": null,
- "businessViewGroupIds": [
- 1752,
- 1754,
- 1756
]
}, - {
- "vmId": 86,
- "guid": "5C15CBD0-259E-4384-9547-DE9F5122776A",
- "name": "az_vm4",
- "powerState": "Disabled",
- "cpuCount": 1,
- "totalDatastoreCommittedBytes": 4194304,
- "totalDatastoreUncommitedBytes": 1073741824,
- "guestDisks": [ ],
- "ipAddresses": [ ],
- "guestOs": "",
- "isReplica": false,
- "snapshotFolder": "C:\\Users\\Public\\Documents\\Hyper-V\\Virtual hard disks\\AutoTestsEbVm",
- "creationTime": "2025-07-10T05:09:56Z",
- "hostId": 71,
- "dnsName": "",
- "dynamicMemoryEnabled": false,
- "assignedMemoryMb": 0,
- "uptimeMs": 0,
- "vmAssignedMemoryMb": 100,
- "integrationServices": [
- {
- "wmiClassName": "Msvm_HeartbeatComponentSettingData",
- "name": "Heartbeat",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_KvpExchangeComponentSettingData",
- "name": "Key-Value Pair Exchange",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_ShutdownComponentSettingData",
- "name": "Shutdown",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_TimeSyncComponentSettingData",
- "name": "Time Synchronization",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_VssComponentSettingData",
- "name": "VSS",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_GuestServiceInterfaceComponentSettingData",
- "name": "Guest Service Interface",
- "isLaunched": false
}
], - "cpuMhz": null,
- "memoryReservationMb": 100,
- "memoryLimitMb": 1048576,
- "isShielded": false,
- "lastProtectedDate": null,
- "businessViewGroupIds": [
- 1752,
- 1754,
- 1756
]
}, - {
- "vmId": 80,
- "guid": "0204011D-A1AE-48BD-ACF3-845F09BA7D08",
- "name": "vvg-azclu",
- "powerState": "Enabled",
- "cpuCount": 1,
- "totalDatastoreCommittedBytes": 4194304,
- "totalDatastoreUncommitedBytes": 1073741824,
- "guestDisks": [ ],
- "ipAddresses": [ ],
- "guestOs": "",
- "isReplica": false,
- "snapshotFolder": "C:\\ProgramData\\Microsoft\\Windows\\Hyper-V",
- "creationTime": "2025-07-10T05:09:56Z",
- "hostId": 71,
- "dnsName": "",
- "dynamicMemoryEnabled": false,
- "assignedMemoryMb": 514,
- "uptimeMs": 11522626759,
- "vmAssignedMemoryMb": 514,
- "integrationServices": [
- {
- "wmiClassName": "Msvm_HeartbeatComponentSettingData",
- "name": "Heartbeat",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_KvpExchangeComponentSettingData",
- "name": "Key-Value Pair Exchange",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_ShutdownComponentSettingData",
- "name": "Shutdown",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_TimeSyncComponentSettingData",
- "name": "Time Synchronization",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_VssComponentSettingData",
- "name": "VSS",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_GuestServiceInterfaceComponentSettingData",
- "name": "Guest Service Interface",
- "isLaunched": false
}
], - "cpuMhz": 2400,
- "memoryReservationMb": 512,
- "memoryLimitMb": 1048576,
- "isShielded": false,
- "lastProtectedDate": null,
- "businessViewGroupIds": [
- 1752,
- 1754,
- 1756
]
}, - {
- "vmId": 81,
- "guid": "22E019CF-11D1-4E44-8B68-05BFFFAB40CF",
- "name": "vvg-dynam-azclu",
- "powerState": "Enabled",
- "cpuCount": 1,
- "totalDatastoreCommittedBytes": 4194304,
- "totalDatastoreUncommitedBytes": 2147483648,
- "guestDisks": [ ],
- "ipAddresses": [ ],
- "guestOs": "",
- "isReplica": false,
- "snapshotFolder": "C:\\ProgramData\\Microsoft\\Windows\\Hyper-V",
- "creationTime": "2025-07-10T05:09:56Z",
- "hostId": 71,
- "dnsName": "",
- "dynamicMemoryEnabled": true,
- "assignedMemoryMb": 512,
- "uptimeMs": 11522608161,
- "vmAssignedMemoryMb": 512,
- "integrationServices": [
- {
- "wmiClassName": "Msvm_HeartbeatComponentSettingData",
- "name": "Heartbeat",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_KvpExchangeComponentSettingData",
- "name": "Key-Value Pair Exchange",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_ShutdownComponentSettingData",
- "name": "Shutdown",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_TimeSyncComponentSettingData",
- "name": "Time Synchronization",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_VssComponentSettingData",
- "name": "VSS",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_GuestServiceInterfaceComponentSettingData",
- "name": "Guest Service Interface",
- "isLaunched": false
}
], - "cpuMhz": 2400,
- "memoryReservationMb": 512,
- "memoryLimitMb": 1048576,
- "isShielded": false,
- "lastProtectedDate": null,
- "businessViewGroupIds": [
- 1752,
- 1754,
- 1756
]
}
], - "totalCount": 4
}
Get Microsoft Hyper-V VM
Returns a resource representation of a connected Microsoft Hyper-V VM with the specified ID.
path Parameters
vmId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "vmId": 83,
- "guid": "0CC951AD-2298-4AFA-AF86-E25C441A5F48",
- "name": "hvykw8q1",
- "powerState": "Enabled",
- "cpuCount": 2,
- "totalDatastoreCommittedBytes": 15682502656,
- "totalDatastoreUncommitedBytes": 64424509440,
- "guestDisks": [ ],
- "ipAddresses": [
- "172.25.50.50"
], - "guestOs": "Windows 8.1 Pro",
- "isReplica": false,
- "snapshotFolder": "F:\\HyperV\\Virtual Machines\\hvykw8q1",
- "creationTime": "2025-07-06T05:20:58Z",
- "hostId": 71,
- "dnsName": "hvykw8q1",
- "dynamicMemoryEnabled": false,
- "assignedMemoryMb": 1024,
- "uptimeMs": 12063560222,
- "vmAssignedMemoryMb": 1024,
- "integrationServices": [
- {
- "wmiClassName": "Msvm_HeartbeatComponentSettingData",
- "name": "Heartbeat",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_KvpExchangeComponentSettingData",
- "name": "Key-Value Pair Exchange",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_ShutdownComponentSettingData",
- "name": "Shutdown",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_TimeSyncComponentSettingData",
- "name": "Time Synchronization",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_VssComponentSettingData",
- "name": "VSS",
- "isLaunched": true
}, - {
- "wmiClassName": "Msvm_GuestServiceInterfaceComponentSettingData",
- "name": "Guest Service Interface",
- "isLaunched": true
}
], - "cpuMhz": 2400,
- "memoryReservationMb": 512,
- "memoryLimitMb": 1048576,
- "isShielded": false,
- "lastProtectedDate": null,
- "businessViewGroupIds": [
- 1752,
- 1755,
- 1757
]
}
Get All Microsoft Hyper-V Host Clusters
Returns a collection resource representation of all host clusters in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "hostClusterId": 71,
- "name": "cluaz.tech.local",
- "scvmmServerId": null,
- "connectionError": null,
- "connectionState": "Connected",
- "businessViewGroupIds": [ ]
}, - {
- "clusterId": 75,
- "name": "hvc.tech.local",
- "scvmmServerId": null,
- "connectionError": null,
- "connectionState": "Connected",
- "businessViewGroupIds": [ ]
}
], - "totalCount": 2
}
Get Microsoft Hyper-V Host Cluster
Returns a resource representation of a connected Microsoft Hyper-V host cluster with the specified ID.
path Parameters
hostClusterId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "hostClusterId": 71,
- "name": "cluaz.tech.local",
- "scvmmServerId": null,
- "connectionError": null,
- "connectionState": "Connected",
- "businessViewGroupIds": [ ]
}
Get All Microsoft Hyper-V CSVs
Returns a collection resource representation of all CSVs in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "csvDiskId": 74,
- "clusterId": 71,
- "name": "Volume1",
- "capacityMb": 10221,
- "freeSpaceMb": 10165,
- "provisionedMb": 56,
- "path": "C:\\ClusterStorage\\Volume1",
- "businessViewGroupIds": [
- 1737
]
}, - {
- "csvDiskId": 97,
- "clusterId": 94,
- "name": "CSV",
- "capacityMb": 23734742,
- "freeSpaceMb": 10563875,
- "provisionedMb": 2501699,
- "path": "",
- "businessViewGroupIds": [
- 141
]
}
], - "totalCount": 2
}
Get Microsoft Hyper-V CSV
Returns a resource representation of a connected Microsoft Hyper-V CSV with the specified ID.
path Parameters
csvDiskId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "csvDiskId": 74,
- "clusterId": 71,
- "name": "Volume1",
- "capacityMb": 10221,
- "freeSpaceMb": 10165,
- "provisionedMb": 56,
- "path": "",
- "businessViewGroupIds": [
- 1737
]
}
Get All Microsoft Hyper-V Host Groups
Returns a collection resource representation of all host groups in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "hostGroupId": 77,
- "name": "Atlanta",
- "parentId": 71,
- "parentType": "Cluster"
}, - {
- "hostGroupId": 79,
- "name": "Texas",
- "parentId": 71,
- "parentType": "Cluster"
}
], - "totalCount": 2
}
Get Microsoft Hyper-V Host Group
Returns a resource representation of a connected Microsoft Hyper-V host group with the specified ID.
path Parameters
hostGroupId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "hostGroupId": 77,
- "name": "Atlanta",
- "parentId": 71,
- "parentType": "Cluster"
}
Get All Microsoft Hyper-V Hosts
Returns a collection resource representation of all hosts in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "hostId": 76,
- "name": "azhv.tech.local",
- "connectionError": null,
- "connectionState": "Connected",
- "powerState": "PoweredOn",
- "memorySizeBytes": 8589398016,
- "cpuCount": 4,
- "cpuFrequencyMhz": 2400,
- "cpuModel": "Intel(R) Xeon(R) Silver 4214R CPU @ 2.40GHz",
- "socketCount": 2,
- "memoryReserveMb": null,
- "version": "6.3.9600",
- "parentId": 71,
- "parentType": "Cluster",
- "businessViewGroupIds": [ ]
}, - {
- "hostId": 77,
- "name": "azhv1.tech.local",
- "connectionError": null,
- "connectionState": "Connected",
- "powerState": "PoweredOn",
- "memorySizeBytes": 8589398016,
- "cpuCount": 2,
- "cpuFrequencyMhz": 2400,
- "cpuModel": "Intel(R) Xeon(R) Silver 4214R CPU @ 2.40GHz",
- "socketCount": 1,
- "memoryReserveMb": null,
- "version": "6.3.9600",
- "parentId": 71,
- "parentType": "Cluster",
- "businessViewGroupIds": [ ]
}
], - "totalCount": 2
}
Get Microsoft Hyper-V Host
Returns a resource representation of a connected Microsoft Hyper-V host with the specified ID.
path Parameters
hostId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "hostId": 77,
- "name": "hv1dmauto.tech.local",
- "connectionError": null,
- "connectionState": "Connected",
- "powerState": "PoweredOn",
- "memorySizeBytes": 8588865536,
- "cpuCount": 4,
- "cpuFrequencyMhz": 2400,
- "cpuModel": "Intel(R) Xeon(R) Silver 4214R CPU @ 2.40GHz",
- "socketCount": 1,
- "memoryReserveMb": null,
- "version": "10.0.17763",
- "parentId": 71,
- "parentType": "Cluster",
- "businessViewGroupIds": [ ]
}
Get All Microsoft Hyper-V Physical Disks
Returns a collection resource representation of all Microsoft Hyper-V physical disks.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "physicalDiskId": 79,
- "capacityBytes": 128203091968,
- "freeSpaceBytes": 93059784704,
- "hostId": 77,
- "provisionedBytes": 36212854784,
- "path": "C:",
- "name": "Disk 0 C:",
- "businessViewGroupIds": [
- 1736
]
}, - {
- "physicalDiskId": 80,
- "capacityBytes": 42930794496,
- "freeSpaceBytes": 42830249984,
- "hostId": 77,
- "provisionedBytes": 1170092032,
- "path": "E:",
- "name": "Disk 1 E:",
- "businessViewGroupIds": [
- 1736
]
}, - {
- "physicalDiskId": 81,
- "capacityBytes": 128203091968,
- "freeSpaceBytes": 79830671360,
- "hostId": 78,
- "provisionedBytes": 48372420608,
- "path": "C:",
- "name": "Disk 0 C:",
- "businessViewGroupIds": [
- 1736
]
}, - {
- "physicalDiskId": 82,
- "capacityBytes": 85880467456,
- "freeSpaceBytes": 69012443136,
- "hostId": 78,
- "provisionedBytes": 65610031104,
- "path": "F:",
- "name": "Disk 1 F:",
- "businessViewGroupIds": [
- 1736
]
}
], - "totalCount": 4
}
Get Microsoft Hyper-V Physical Disk
Returns a resource representation of a Microsoft Hyper-V physical disk with the specified ID.
path Parameters
physicalDiskId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "physicalDiskId": 78,
- "capacityBytes": 107005079552,
- "freeSpaceBytes": 48214056960,
- "hostId": 76,
- "provisionedBytes": 58791022592,
- "path": "C:",
- "name": "Disk 0 C:",
- "businessViewGroupIds": [
- 1737
]
}
Get All Microsoft Hyper-V SCVMM Servers
Returns a collection resource representation of all SCVMM servers in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "scvmmServerId": 85,
- "name": "scvmm1",
- "port": 8200,
- "connectionError": null,
- "connectionState": "Connected",
- "version": "4.1.3403.0"
}, - {
- "scvmmServerId": 87,
- "name": "scvmm2",
- "port": 8201,
- "connectionError": null,
- "connectionState": "Connected",
- "version": "4.1.3403.0"
}
], - "totalCount": 2
}
Get Microsoft Hyper-V SCVMM Server
Returns a resource representation of a connected Microsoft Hyper-V SCVMM server with the specified ID.
path Parameters
scvmmServerId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "scvmmServerId": 85,
- "name": "scvmm1",
- "port": 8200,
- "connectionError": null,
- "connectionState": "Connected",
- "version": "4.1.3403.0"
}
Get All Microsoft Hyper-V File Servers
Returns a collection resource representation of all file servers in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "fileServerId": 1726,
- "name": "es-ws.tech.local",
- "parentId": 1725,
- "parentType": "FileShareFolder"
}, - {
- "fileServerId": 1731,
- "name": "fsrv2.tech.local",
- "parentId": 1725,
- "parentType": "FileShareFolder"
}
], - "totalCount": 2
}
Get Microsoft Hyper-V File Server
Returns a resource representation of a connected Microsoft Hyper-V file server with the specified ID .
path Parameters
fileServerId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "fileServerId": 1726,
- "name": "es-ws.tech.local",
- "parentId": 1725,
- "parentType": "FileShareFolder"
}
Get All Microsoft Hyper-V File Shares
Returns a collection resource representation of all file shares in the connected Microsoft Hyper-V environment.
query Parameters
Offset | integer <int32> Default: 0 |
Limit | integer <int32> Default: 100 |
Filter | string |
Sort | string |
Select | string |
Success
Forbidden
- curl
- 200
- 403
{- "items": [
- {
- "fileShareId": 1724,
- "name": "fsh2",
- "fileServerId": 1726,
- "isHa": false,
- "capacityBytes": 0,
- "freeSpaceBytes": 0,
- "provisionedBytes": null,
- "businessViewGroupIds": [
- 1738
]
}, - {
- "fileShareId": 1731,
- "name": "fsh4",
- "fileServerId": 1733,
- "isHa": false,
- "capacityBytes": 85253419008,
- "freeSpaceBytes": 65909084160,
- "provisionedBytes": 19344334848,
- "businessViewGroupIds": [
- 1738
]
}
], - "totalCount": 2
}
Get Microsoft Hyper-V File Share
Returns a resource representation of a connected Microsoft Hyper-V file share with the specified ID.
path Parameters
fileShareId required | integer <int64> |
Success
Forbidden
- curl
- 200
- 403
{- "fileShareId": 1724,
- "name": "access",
- "fileServerId": 1726,
- "isHa": false,
- "capacityBytes": 0,
- "freeSpaceBytes": 0,
- "provisionedBytes": null,
- "businessViewGroupIds": [
- 1738
]
}