Get Virtual Machine Details
Get details for virtual machine
Path Parameters
- vmUUID string required
The vmUUID can be obtained from GET /virtualMachines UUID property
Query Parameters
- showInheritedAssociation boolean
- 200
- 404
Success
- application/json
- Schema
- Example (from schema)
Schema
vmDetails object
displayName stringThe display name of the virtual machine
summary object
The Virtual Machine detail summary. Hypervisor is the software that creates and runs virtual machines(VMs).
hypervisor object
id int32name stringvmGroup object
id int32name stringhost stringThe host name for the computer where the source virtual machine or instance resides.
os stringThe operating system version for the VM or instance.
vendor stringPossible values: [
NONE,VMW,MICROSOFT,XEN_SERVER,AMAZON,AZURE,REDHAT,AZURE_V2,SCVMM,NUTANIX,ORACLE_VM,DOCKER,OPENSTACK,ORACLE_CLOUD,FUSIONCOMPUTE,VCLOUD,GOOGLE_CLOUD,AZURE_STACK,ALIBABA_CLOUD,ORACLE_CLOUD_INFRASTRUCTURE,KUBERNETES,REDHAT_OPENSHIFT,MONGODB_ATLAS,PROXMOX,KUBERNETES_AKS,AZURE_STACK_HCI,KUBERNETES_EKS,MORPHEUS,KUBERNETES_GKE,KUBERNETES_OKE,NUTANIX_PRISM_CENTRAL,APACHE_CLOUDSTACK,VMWARE_CLOUD_FOUNDATION,NEXAVM,INCUS]vmSize int64The total space allocated(in bytes) for the virtual machine.
applicationSize int64The amount of data being protected for the VM client(in bytes)
plan object
id int32name stringsubType stringPossible values: [
ANY,DLO,SERVER,LAPTOP,DATABASE,SNAP,FS_SERVER,VSA_SERVER,VSA_REPLICATION,EXCHANGE_USER,EXCHANGE_JOURNAL,DATA_CLASSIFICATION,E_DISCOVERY,OFFICE_365,ARCHIVER,FSIBMIVTL,DYNAMICS_365,CDM,ObjectStore]lastBackup object
last backup job details for the client
time int64UNIX time for the last backup job run
jobId int32Job id of the last backup job
status stringPossible values: [
NEVER_BACKED_UP,COMPLETED,FAILED,COMPLETED_WITH_ERRORS,KILLED,SUSPENDED,INTERRUPTED,ANY_STATUS,SKIPPED,FAILED_TO_START,SYNCHRONIZED,NOT_SYNCHRONIZED,NOT_ATTEMPTED,STARTED,COMPLETED_WITH_WARNINGS,SYSTEM_FAILED,COMMITTED]Status of the last backup job performed.
lastSuccessfullBackupTime int64UNIX time for the last successful backup job run
failureReason stringFailure reason for the last backup job
latestRecoveryPoint int64The latest recovery time for the vm(in unix)
oldestRecoveryPoint int64The oldest recovery time for the vm(in unix)
status stringPossible values: [
PROTECTED,NOT_PROTECTED,PENDING,BACKED_UP_WITH_ERROR,DISCOVERED]The status of the backup for the VM, instance, or container.
SLA object
status stringPossible values: [
MET_SLA,MISSED_SLA,EXCLUDED_SLA,YET_TO_BE_PROTECTED,MIGHT_MISS_SLA,UNKNOWN]Provides the SLA status.
slaMayMissReason stringThe reason for the missed SLA of the VM client
reason stringThe reason for the current SLA status of the VM client
company object
id int32name stringappJobInfo object[]
instanceName stringThe name of the instance.
appName stringThe name of the App.
jobId int32The child JobId for which the app has been backedup.
applicationValidationResults object
bootStatus booleantrue if backup validation is set
lastValidationJobId int64job id of the last backup validation job
backupValidated int64job id of the last backup job that was validated
backupCompletionDate int64timestamp(in unix) for the last backup job completed
appsDiscovered object[]
name stringname of the VM apps discovered for validation
scriptStatus booleantrue if validation status is true
failureReason stringreason for failure of validation of app
passkey object
authType stringPossible values: [
USE_LOGIN,USE_PASSKEY,USE_LOGGEDIN_SESSION]The authentication type set for browse and restore
expirationTime int32The duration(in unix time) for which a user can continue browsing and restoring backup data without being prompted to enter the passkey, again.
passKeyRequiredForRestore booleanTo tell if passkey is required for browse and restore
enableAuthorizeForRestore booleanTo tell if user is authorized for restore
security object
associations object[]
user object
id int32name stringcompany object
id int32name stringuserGroup object
id int32name stringcompany object
id int32name stringrole object
id int32name stringpermissions object[]
permissionId int32permissionName stringcategoryId int32categoryName stringtype stringPossible values: [
ALL_CATEGORIES,CATEGORY_ENTITY,PERMISSION_ENTITY]Returns the type of association.
exclude booleanFlag to specify if this is included permission or excluded permission.
owners object[]
userId int32userName stringuserGroupId int32userGroupName stringactivityControl object[]
activityType stringPossible values: [
BACKUP,RESTORE,ONLINECI,ARCHIVEPRUNE,AUXCOP,DRBACKUP,MEDIARECYCLE,SYNTHETICFULL,ALLACTIVITY,SCHEDULE,OFFLINECI,DDBACTIVITY,DATAVERIFICATION,SENDLOGFILEACTIVITY]denotes the activity type being considered
enableAfterADelay booleanTrue if the activity will be enabled after a delay time interval
enableActivityType booleanTrue if the activity type is enabled
delayTime object
timeZone object
id int32name stringtime int32delay time in unix timestamp
value stringactual delay time value in string format according to the timezone
tags object[]
id int32name stringvalue stringadditionalProperties object
isContentIndexed booleanReturns true if content is indexed on VM client
isIndexingV2 booleanReturns true if the VM is a indexing V2 client
isSnapshotV2 booleanReturns true if snapshot V2 is enabled
isPasskeyFeatureEnabled booleanReturns true if passkey feauture is enabled
isPrivacyFeatureEnabled booleanReturns true if privacy feauture is enabled
isAppValidationEnabled booleanReturns true if app validation is enabled
latestBackupTimeCatalogedSuccessfully int64Last successfully cataloged backup time
indexingStatus stringPossible values: [
NOT_APPLICABLE,ENABLED,SETUP_IN_PROGRESS]Default value:
NOT_APPLICABLEType of indexing status.
isBackupAllowed booleanReturns true if the backups are allowed for the VM client
isBackupActivityEnabled booleanReturns true if the backup activity is enabled for the VM
isRestoreActivityEnabled booleanReturns true if the restore activity is enabled for the VM
retireAgentPhase RetireClientPhasePossible values: [
UNKNOWN,RETIRE_IN_PROGRESS,DECONFIGURED]retireClientPhase RetireClientPhasePossible values: [
UNKNOWN,RETIRE_IN_PROGRESS,DECONFIGURED]bkpEndTime int64UNIX time for the backup end time
bkpStartTime int64UNIX time for the backup start time
vmBackupJob int32Backup job Id of the VM
pseudoClientDisabled booleanReturns true if the client is disabled
isDeleted booleanReturns true if the VM is deleted
isSnapBackupEnabled booleanReturns true if the snap backup is enabled for the VM client
associatedVMSubclient object
Summary of VMEntity in Virtual Machine summary
instance object
id int32name stringbackupset object
id int32name stringvmGroup object
id int32name stringvsaNextBackupSubClientEntity object
Summary of VMEntity in Virtual Machine summary
instance object
id int32name stringbackupset object
id int32name stringvmGroup object
id int32name stringclient object
id int32name stringreplicationSiteInfo object
BkpJobsToSync stringBackup jobs that need to be synchronized to the replication site
isIndexingV2 booleanReturns true if the VM is a indexing V2 client
lastRestoreTime int64UNIX time of last restore operation
replicationId int32Replication ID of particular VM
destinationName stringName of the recovered entity
lastSyncedBkpJob int64ID of the last synchronized backup job
FailoverStatus stringCurrent failover status of the VM
DRVendor stringPossible values: [
NONE,VMW,MICROSOFT,XEN_SERVER,AMAZON,AZURE,REDHAT,AZURE_V2,SCVMM,NUTANIX,ORACLE_VM,DOCKER,OPENSTACK,ORACLE_CLOUD,FUSIONCOMPUTE,VCLOUD,GOOGLE_CLOUD,AZURE_STACK,ALIBABA_CLOUD,ORACLE_CLOUD_INFRASTRUCTURE,KUBERNETES,REDHAT_OPENSHIFT,MONGODB_ATLAS,PROXMOX,KUBERNETES_AKS,AZURE_STACK_HCI,KUBERNETES_EKS,MORPHEUS,KUBERNETES_GKE,KUBERNETES_OKE,NUTANIX_PRISM_CENTRAL,APACHE_CLOUDSTACK,VMWARE_CLOUD_FOUNDATION,NEXAVM,INCUS]SourceVendor stringPossible values: [
NONE,VMW,MICROSOFT,XEN_SERVER,AMAZON,AZURE,REDHAT,AZURE_V2,SCVMM,NUTANIX,ORACLE_VM,DOCKER,OPENSTACK,ORACLE_CLOUD,FUSIONCOMPUTE,VCLOUD,GOOGLE_CLOUD,AZURE_STACK,ALIBABA_CLOUD,ORACLE_CLOUD_INFRASTRUCTURE,KUBERNETES,REDHAT_OPENSHIFT,MONGODB_ATLAS,PROXMOX,KUBERNETES_AKS,AZURE_STACK_HCI,KUBERNETES_EKS,MORPHEUS,KUBERNETES_GKE,KUBERNETES_OKE,NUTANIX_PRISM_CENTRAL,APACHE_CLOUDSTACK,VMWARE_CLOUD_FOUNDATION,NEXAVM,INCUS]replicationGroup object
id int32name stringreplicationTarget object
id int32name stringdestinationHypervisor object
id int32name stringUUID stringUnique identifier of the VM
vmStatusError stringVM status error message
vmFailureReasonForWarning stringWarning reason for VM failure
{
"vmDetails": {
"displayName": "string",
"summary": {
"hypervisor": {
"id": 0,
"name": "string"
},
"vmGroup": {
"id": 0,
"name": "string"
},
"host": "string",
"os": "string",
"vendor": "NONE",
"vmSize": 0,
"applicationSize": 0,
"plan": {
"id": 0,
"name": "string",
"subType": "ANY"
},
"lastBackup": {
"time": 0,
"jobId": 0,
"status": "NEVER_BACKED_UP",
"lastSuccessfullBackupTime": 0,
"failureReason": "string"
},
"latestRecoveryPoint": 0,
"oldestRecoveryPoint": 0,
"status": "PROTECTED",
"SLA": {
"status": "MET_SLA",
"slaMayMissReason": "string",
"reason": "string"
},
"company": {
"id": 0,
"name": "string"
}
},
"appJobInfo": [
{
"instanceName": "string",
"appName": "string",
"jobId": 0
}
],
"applicationValidationResults": {
"bootStatus": true,
"lastValidationJobId": 0,
"backupValidated": 0,
"backupCompletionDate": 0,
"appsDiscovered": [
{
"name": "string",
"scriptStatus": true,
"failureReason": "string"
}
]
},
"passkey": {
"authType": "USE_LOGIN",
"expirationTime": 0,
"passKeyRequiredForRestore": true,
"enableAuthorizeForRestore": true
},
"security": {
"associations": [
{
"user": {
"id": 0,
"name": "string",
"company": {
"id": 0,
"name": "string"
}
},
"userGroup": {
"id": 0,
"name": "string",
"company": {
"id": 0,
"name": "string"
}
},
"role": {
"id": 0,
"name": "string"
}
}
],
"permissions": [
{
"permissionId": 0,
"permissionName": "string",
"categoryId": 0,
"categoryName": "string",
"type": "ALL_CATEGORIES",
"exclude": true
}
],
"owners": [
{
"userId": 0,
"userName": "string",
"userGroupId": 0,
"userGroupName": "string"
}
]
},
"activityControl": [
{
"activityType": "BACKUP",
"enableAfterADelay": true,
"enableActivityType": true,
"delayTime": {
"timeZone": {
"id": 0,
"name": "string"
},
"time": 0,
"value": "string"
}
}
],
"tags": [
{
"id": 0,
"name": "string",
"value": "string"
}
],
"additionalProperties": {
"isContentIndexed": true,
"isIndexingV2": true,
"isSnapshotV2": true,
"isPasskeyFeatureEnabled": true,
"isPrivacyFeatureEnabled": true,
"isAppValidationEnabled": true,
"latestBackupTimeCatalogedSuccessfully": 0,
"indexingStatus": "NOT_APPLICABLE",
"isBackupAllowed": true,
"isBackupActivityEnabled": true,
"isRestoreActivityEnabled": true,
"retireAgentPhase": "UNKNOWN",
"retireClientPhase": "UNKNOWN",
"bkpEndTime": 0,
"bkpStartTime": 0,
"vmBackupJob": 0,
"pseudoClientDisabled": true,
"isDeleted": true,
"isSnapBackupEnabled": true,
"associatedVMSubclient": {
"instance": {
"id": 0,
"name": "string"
},
"backupset": {
"id": 0,
"name": "string"
},
"vmGroup": {
"id": 0,
"name": "string"
}
},
"vsaNextBackupSubClientEntity": {
"instance": {
"id": 0,
"name": "string"
},
"backupset": {
"id": 0,
"name": "string"
},
"vmGroup": {
"id": 0,
"name": "string"
}
},
"client": {
"id": 0,
"name": "string"
},
"replicationSiteInfo": {
"BkpJobsToSync": "string",
"isIndexingV2": true,
"lastRestoreTime": 0,
"replicationId": 0,
"destinationName": "string",
"lastSyncedBkpJob": 0,
"FailoverStatus": "string",
"DRVendor": "NONE",
"SourceVendor": "NONE",
"replicationGroup": {
"id": 0,
"name": "string"
},
"replicationTarget": {
"id": 0,
"name": "string"
},
"destinationHypervisor": {
"id": 0,
"name": "string"
}
},
"UUID": "string",
"vmStatusError": "string",
"vmFailureReasonForWarning": "string"
}
}
}
Requested Details not found