Get Physical Machine

All the listed privileges are required -

Privileges	Description
GLOBAL_CONFIG_VIEW	Caller should have permission to this privilege to view the physical machines.

Request

URI

GET

https://{api_host}/rest/inventory/v1/physical-machines/{id}

COPY

Path Parameters

string

Required

Physical machine ID

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

Returns PhysicalMachineInfo of type(s) */*

{
    "description": "This is a physical machine.",
    "dns_name": "machine1.example.com",
    "id": "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
    "message_security_enhanced_mode_supported": true,
    "message_security_mode": "MIXED",
    "name": "machine1",
    "operating_system": "WINDOWS_SERVER_2016",
    "state": "AVAILABLE"
}

string

description

Optional

Description of the machine.
Supported Filters : 'Equals', 'StartsWith' and 'Contains'. This property can be used for sorting.

string

dns_name

Optional

DNS name of the machine.
Supported Filters : 'Equals', 'StartsWith', 'EndsWith' and 'Contains'. This property can be used for sorting.

string

Optional

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

boolean

message_security_enhanced_mode_supported

Optional

Indicates whether ENHANCED message security mode is currently supported by this machine. This property can be used for sorting.

string

message_security_mode

Optional

The current JMS message security mode used by this machine.
Supported Filters : 'Equals'. This property can be used for sorting.

DISABLED: Message security mode is disabled.
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.
MIXED: Message security mode is enabled but not enforced.

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

string

name

Optional

Name of the machine.
Supported Filters : 'Equals', 'StartsWith' and 'Contains'. This property can be used for sorting.

string

operating_system

Optional

The machine operating system. This property can be used for sorting.

LINUX_CENTOS: Linux (CentOS)
LINUX_OTHER: Linux (other)
LINUX_RHEL: Linux (Red Hat Enterprise)
LINUX_SERVER_OTHER: Linux server (other)
LINUX_SUSE: Linux (Suse)
LINUX_UBUNTU: Linux (Ubuntu)
UNKNOWN: Unknown
WINDOWS_10: Windows 10
WINDOWS_11: Windows 11
WINDOWS_7: Windows 7
WINDOWS_8: Windows 8
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
WINDOWS_VISTA: Windows Vista
WINDOWS_XP: Windows XP

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

string

state

Optional

The state of the machine.
Supported Filters : 'Equals'. This property can be used for sorting.

AGENT_CONFIG_ERROR: The Remote Desktop Services role is not enabled on the windows server.
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_ERROR_STARTUP_IN_PROGRESS: Horizon Agent has started on the machine, but other required services such as the display protocol are still starting.
AGENT_UNREACHABLE: Horizon Connection Server cannot establish communication with Horizon Agent on the machine.
AVAILABLE: The machine is powered on and ready for active connections.
CONNECTED: The machine is in an active session and has an active connection to a Horizon client.
DISABLED: The machine is disabled.
DISCONNECTED: The machine is in an active session, but it is disconnected from the Horizon client.
UNASSIGNED_USER_CONNECTED: A user other than the assigned user is logged in to the machine in a dedicated desktop pool.
UNASSIGNED_USER_DISCONNECTED: A user other than the assigned user is logged in and disconnected from the machine in a dedicated desktop pool.
UNKNOWN: Could not determine the state of the machine.
VALIDATING: The Horizon Connection Server is synchronizing state information with the agent.

Possible values are : AGENT_CONFIG_ERROR, AGENT_ERROR_DISABLED, AGENT_ERROR_INVALID_IP, AGENT_ERROR_NEEDS_REBOOT, AGENT_ERROR_PROTOCOL_FAILURE, AGENT_ERROR_STARTUP_IN_PROGRESS, AGENT_UNREACHABLE, AVAILABLE, CONNECTED, DISABLED, DISCONNECTED, UNASSIGNED_USER_CONNECTED, UNASSIGNED_USER_DISCONNECTED, UNKNOWN, VALIDATING,

401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

404

Not Found

Operation doesn't return any data structure

On This Page

Description

Request