Get Machine | VMware Horizon Server API

Get Machine

At least one of the listed privileges is required -

Privileges	Description
MACHINE_VIEW	Caller should have permission to this privilege, on the associated access group of machine's desktop pool.
GLOBAL_CONFIG_VIEW	Caller should have permission to this privilege to read the unmanaged (physical) machines that are part of desktop pool.

Request

URI

GET

https://{api_host}//localhost/rest/inventory/v1/machines/{id}

COPY

Path Parameters

string

Required

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

Returns MachineInfo of type(s) */*

{
    "agent_build_number": 22673015,
    "agent_version": 7.12,
    "attempted_theft_by_connection_server": [
        "string"
    ],
    "configured_by_connection_server": [
        "string"
    ],
    "desktop_pool_id": "855ea6c5-720a-41e1-96f4-958c90e6e424",
    "dns_name": "machine1.example.com",
    "id": "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
    "managed_machine_data": {
        "clone_error_message": "Timeout expired trying to clone a virtual machine.",
        "clone_error_time": 1575285661395,
        "create_time": 1575285661395,
        "host_name": "WD332H5",
        "in_hold_customization": false,
        "in_maintenance_mode": false,
        "memory_mb": 1024,
        "missing_in_vcenter": false,
        "network_labels": [
            {
                "network_label_name": "example-network",
                "nic_name": "network1"
            }
        ],
        "path": "/path/host",
        "storage_accelerator_state": "CURRENT",
        "virtual_center_id": "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "virtual_disks": [
            {
                "capacity_mb": 102400,
                "datastore_path": "datastore1",
                "path": "/path/host"
            }
        ],
        "virtual_machine_power_state": "POWERED_ON"
    },
    "message_security_enhanced_mode_supported": true,
    "message_security_mode": "MIXED",
    "name": "machine1",
    "operating_system": "WINDOWS_SERVER_2016",
    "operating_system_architecture": "BIT_64",
    "pairing_state": "IN_PAIRING",
    "remote_experience_agent_build_number": 32573985,
    "remote_experience_agent_version": 7.12,
    "state": "PROVISIONING",
    "type": "MANAGED_MACHINE",
    "user_ids": [
        "S-1-1-1-3965912346-1012345398-3123456564-123",
        "S-1-2-3-3123456786-1012345398-3123456784-124"
    ]
}

string

agent_build_number

Optional

The Horizon Agent build number.
Supported Filters : 'Equals'.

string

agent_version

Optional

The Horizon Agent version.
Supported Filters : 'Equals'.

array of string

attempted_theft_by_connection_server

Optional

Names of the Horizon Connection Servers that attempted theft of pairing for this Agent.

array of string

configured_by_connection_server

Optional

Names of the Horizon Connection Servers the Horizon Agent is paired with.

string

desktop_pool_id

Optional

The id of the Desktop Pool that the machine belongs to.
Supported Filters : 'Equals'.

string

dns_name

Optional

DNS name of the machine.
Supported Filters : 'Equals', 'StartsWith', 'EndsWith' and 'Contains'.

string

Optional

Unique ID representing machine.
Supported Filters : 'Equals'.

ManagedMachineData

managed_machine_data

Optional

managed_machine_data

boolean

message_security_enhanced_mode_supported

Optional

Indicates whether ENHANCED message security mode is currently supported by this machine.

string

message_security_mode

Optional

The current JMS message security mode used by this machine.
Supported Filters : 'Equals'.

DISABLED: Message security mode is disabled.
MIXED: Message security mode is enabled but not enforced.
ENABLED: Message security mode is enabled. Unsigned messages are rejected by Horizon components.
ENHANCED: Message Security mode is Enhanced. Message signing and validation is performed based on the current Security Level and desktop Message Security mode.

Possible values are : DISABLED, MIXED, ENABLED, ENHANCED,

string

name

Optional

Name of the machine.
Supported Filters : 'Equals', 'StartsWith' and 'Contains'.

string

operating_system

Optional

The guest operating system.

UNKNOWN: Unknown
WINDOWS_XP: Windows XP
WINDOWS_VISTA: Windows Vista
WINDOWS_7: Windows 7
WINDOWS_8: Windows 8
WINDOWS_10: Windows 10
WINDOWS_SERVER_2003: Windows Server 2003
WINDOWS_SERVER_2008: Windows Server 2008
WINDOWS_SERVER_2008_R2: Windows Server 2008 R2
WINDOWS_SERVER_2012: Windows Server 2012
WINDOWS_SERVER_2012_R2: Windows Server 2012 R2
WINDOWS_SERVER_2016_OR_ABOVE: Windows Server 2016 or above
LINUX_OTHER: Linux (other)
LINUX_SERVER_OTHER: Linux server (other)
LINUX_UBUNTU: Linux (Ubuntu)
LINUX_RHEL: Linux (Red Hat Enterprise)
LINUX_SUSE: Linux (Suse)
LINUX_CENTOS: Linux (CentOS)

Possible values are : UNKNOWN, WINDOWS_XP, WINDOWS_VISTA, WINDOWS_7, WINDOWS_8, WINDOWS_10, WINDOWS_SERVER_2003, WINDOWS_SERVER_2008, WINDOWS_SERVER_2008_R2, WINDOWS_SERVER_2012, WINDOWS_SERVER_2012_R2, WINDOWS_SERVER_2016_OR_ABOVE, LINUX_OTHER, LINUX_SERVER_OTHER, LINUX_UBUNTU, LINUX_RHEL, LINUX_SUSE, LINUX_CENTOS,

string

operating_system_architecture

Optional

The guest operating system architecture.

UNKNOWN: Operating System cannot be determined.
BIT_32: 32 bit Operating System Architecture.
BIT_64: 64 bit Operating System Architecture.

Possible values are : UNKNOWN, BIT_32, BIT_64,

string

pairing_state

Optional

Horizon Agent pairing state.

NOT_AVAILABLE: Agent pairing state is not available.
IN_PAIRING: Agent pairing with Horizon Connection Server is in progress.
PAIRED_AND_SECURED: Agent is paired and secured with a Horizon Connection Server.

Possible values are : NOT_AVAILABLE, IN_PAIRING, PAIRED_AND_SECURED,

string

remote_experience_agent_build_number

Optional

The remote experience Horizon Agent build number.
Supported Filters : 'Equals'.

string

remote_experience_agent_version

Optional

The remote experience Horizon Agent version.
Supported Filters : 'Equals'.

string

state

Optional

The state of the machine.
Supported Filters : 'Equals'.

PROVISIONING: The machine is being provisioned.
PROVISIONING_ERROR: An error occurred during provisioning.
WAITING_FOR_AGENT: Horizon Connection Server is waiting to establish communication with Horizon Agent for one of these cases - a virtual machine in a manual desktop pool, unmanaged machine or RDS server.
CUSTOMIZING: The machine which is from an automated desktop pool is being customized after provisioning.
DELETING: The machine is marked for deletion.
MAINTENANCE: The machine is in maintenance mode. Users cannot log in or use the machine.
ERROR: An unknown error occurred in the machine.
PROVISIONED: The machine is powered off or suspended.
AGENT_UNREACHABLE: Horizon Connection Server cannot establish communication with Horizon Agent on the machine.
UNASSIGNED_USER_CONNECTED: A user other than the assigned user is logged in to the machine in a dedicated desktop pool.
CONNECTED: The machine is in an active session and has an active connection to a Horizon client.
UNASSIGNED_USER_DISCONNECTED: A user other than the assigned user is logged in and disconnected from the machine in a dedicated desktop pool.
DISCONNECTED: The machine is in an active session, but it is disconnected from the Horizon client.
AGENT_ERROR_STARTUP_IN_PROGRESS: Horizon Agent has started on the machine, but other required services such as the display protocol are still starting.
AGENT_ERROR_DISABLED: Horizon Agent is disabled.
AGENT_ERROR_INVALID_IP: Horizon Agent has an invalid IP address.
AGENT_ERROR_NEEDS_REBOOT: Horizon Agent needs reboot.
AGENT_ERROR_PROTOCOL_FAILURE: Protocol such as BLAST, RDP or PCoIP is not enabled.
AGENT_CONFIG_ERROR: The Remote Desktop Services role is not enabled on the windows server.
AGENT_DRAIN_MODE: RDS host is configured for drain mode. New connections are currently disabled.
AGENT_DRAIN_UNTIL_RESTART: RDS host is configured for drain-until-restart mode.
ALREADY_USED: The machine is configured to have only one session which is currently in progress and cannot accept new sessions.
AVAILABLE: The machine is powered on and ready for active connections.
IN_PROGRESS: There is a machine operation in progress.
DISABLED: The machine is disabled.
DISABLE_IN_PROGRESS: Disabled Horizon Connection Server still has some Horizon brokered sessions. It can still accept re-connections.
VALIDATING: The Horizon Connection Server is synchronizing state information with the agent.
UNKNOWN: Could not determine the state of the machine.

Possible values are : PROVISIONING, PROVISIONING_ERROR, WAITING_FOR_AGENT, CUSTOMIZING, DELETING, MAINTENANCE, ERROR, PROVISIONED, AGENT_UNREACHABLE, UNASSIGNED_USER_CONNECTED, CONNECTED, UNASSIGNED_USER_DISCONNECTED, DISCONNECTED, AGENT_ERROR_STARTUP_IN_PROGRESS, AGENT_ERROR_DISABLED, AGENT_ERROR_INVALID_IP, AGENT_ERROR_NEEDS_REBOOT, AGENT_ERROR_PROTOCOL_FAILURE, AGENT_CONFIG_ERROR, AGENT_DRAIN_MODE, AGENT_DRAIN_UNTIL_RESTART, ALREADY_USED, AVAILABLE, IN_PROGRESS, DISABLED, DISABLE_IN_PROGRESS, VALIDATING, UNKNOWN,

string

type

Optional

The type of machine.
Supported Filters : 'Equals'.