List Machines V4

List Machines V4

This API supports Pagination and Filters.
For full information on using Filters, refer to 'Horizon Server REST Pagination and Filter Guide' of 'VMware Horizon Server API' in code.vmware.com At least one of the listed privileges is required -

Privileges	Description
MACHINE_VIEW	Returns results only for those machines, for which the caller has permission to this privilege, on the associated access group of machine's desktop pool.
GLOBAL_CONFIG_VIEW	Returns results only for those unmanaged (physical) machines, that are part of desktop pool, for which the caller needs permission to this privilege.

Request

URI

GET

https://{api_host}/rest/inventory/v4/machines

COPY

Query Parameters

integer

page

Optional

page, if passed should be > 0.

page example

integer

size

Optional

size, if passed should be > 0.

size example

string

filter

Optional

filter expression built using fields with 'supported filters' as described in output model schema of this API.

filter example

[object Object]

string

sort_by

Optional

Field that would be used to sort the results.

sort_by example

<property-name>

string

order_by

Optional

Determines the ordering of results.

order_by example

ASC

Possible values are : ASC, DESC,

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

OK

[
    {
        "access_group_id": "6fd4638a-381f-4518-aed6-042aa3d9f14c",
        "agent_build_number": "22673015",
        "agent_upgrade_error_message": "true",
        "agent_upgrade_result": "OK",
        "agent_upgrade_state": "WAIT",
        "agent_version": "7.12",
        "aliases": [
            {
                "ad_user_id": "S-1-5-21-2898529287-1016622242-505487308-1553",
                "alias_name": "Alias1"
            }
        ],
        "attempted_theft_by_connection_server": [
            "connection-server2.example.com"
        ],
        "configured_by_connection_server": [
            "connection-server1.example.com"
        ],
        "desktop_pool_id": "855ea6c5-720a-41e1-96f4-958c90e6e424",
        "dns_name": "machine1.example.com",
        "held_machine": true,
        "id": "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "managed_machine_data": {
            "base_vm_id": "vm-23",
            "base_vm_snapshot_id": "snapshot-2",
            "clone_error_message": "Timeout expired trying to clone a virtual machine.",
            "clone_error_time": 1575285661395,
            "create_time": 1575285661395,
            "datastore_ids": [
                "datastore1",
                "datastore2"
            ],
            "host_name": "WD332H5",
            "image_management_stream_id": "6f85b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
            "image_management_tag_id": "c9896e51-48a2-4d82-ae9e-a0246981b47d",
            "in_hold_customization": false,
            "in_maintenance_mode": false,
            "last_maintenance_time": 1587081283000,
            "logoff_policy": "FORCE_LOGOFF",
            "memory_mb": 1024,
            "missing_in_vcenter": false,
            "network_labels": [
                {
                    "network_label_name": "example-network",
                    "nic_name": "network1"
                }
            ],
            "operation": "REFRESH",
            "operation_state": "AVAILABLE",
            "path": "/path/host",
            "pending_base_vm_id": "vm-8",
            "pending_base_vm_snapshot_id": "snapshot-7",
            "pending_image_management_stream_id": "ec88b3a5-e7d0-4ad6-a1e3-37168dd1fa25",
            "pending_image_management_tag_id": "c9896e51-48a2-4d82-ae9e-a0246981b47d",
            "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",
        "session_id": "6fd4638a-381f-4518-aed6-042aa3d9f14c",
        "state": "PROVISIONING",
        "type": "MANAGED_MACHINE",
        "user_ids": [
            "S-1-1-1-3965912346-1012345398-3123456564-123",
            "S-1-2-3-3123456786-1012345398-3123456784-124"
        ]
    }
]

400

Bad Request

Operation doesn't return any data structure

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

On This Page

Request

Query Parameters

200 Response Body

Errors

Inventory Operations

Add Custom Icon

Add Local Application Pools To GAE

Add Local Desktop Pools To GDE

Add Machines By Name

Add Rds Servers

Application Icon Bulk Associate

Application Icon Bulk Remove Association

Archive Machines

Assign Machine Aliases

Attach Persistent Disk

Cancel Agent Upgrades

Cancel Desktop Pool Task

Cancel Rds Server Agent Upgrades

Cancel Scheduled Maintenance

Cancel Scheduled Push Image

Check Application Pool Name Availability

Check Desktop Pool Name Availability

Check Farm Name Availability

Check Machine Prefix Availability

Check RDS Server Prefix Availability

Create Application Icon

Create Application Pool

Create Application Pool V2

Create Application Pool V3

Create Application Pool V5

Create Desktop Pool

Create Desktop Pool V2

Create Desktop Pool V7

Create Global Application Entitlement

Create Global Application Entitlement V3

Create Global Desktop Entitlement

Create Global Desktop Entitlement V2

Create Global Desktop Entitlement V3

Create Persistent Disk

Create Policy Overrides For Users

Delete Application Icon

Delete Application Pool

Delete Application Pools

Delete Application Pools V5

Delete Desktop Pool

Delete Desktop Pool V7

Delete Global Application Entitlement

Delete Global Application Entitlement V3

Delete Global Desktop Entitlement

Delete Global Desktop Entitlement V3

Delete Machines

Delete Persistent Disk

Delete Physical Machine

Delete Policy Overrides For Users

Delete RDS Server

Delete RDS Server V2

Desktop Pool Apply Image

Desktop Pool Promote Pending Image

Detach Persistent Disk

Disable Application Pools

Disable Desktop Pools

Disable Provisioning For Desktop Pools

Disconnect Global Sessions

Disconnect Sessions

Enable Application Pools

Enable Desktop Pools

Enable Provisioning For Desktop Pools

Enter Maintenance

Exit Maintenance

Farm Apply Image

Farm Promote Pending Image

Get Agent Installer Package

Get Agent Upgrade Task

Get Agent Upgrade Task V2

Get Application Icon

Get Application Pool

Get Application Pool V2

Get Application Pool V3

Get Application Pool V4

Get Application Pool V5

Get Desktop Pool

Get Desktop Pool Task

Get Desktop Pool V2

Get Desktop Pool V3

Get Desktop Pool V4

Get Desktop Pool V5

Get Desktop Pool V6

Get Desktop Pool V7

Get Global Application Entitlement

Get Global Application Entitlement V2

Get Global Application Entitlement V3

Get Global Desktop Entitlement

Get Global Desktop Entitlement V2

Get Global Desktop Entitlement V3

Get Persistent Disk

Get Physical Machine

Get Physical Machine V2

Get Rds Server Agent Upgrade Task

Get RDS Server V2

Get Session Info

List Agent Installer Packages

List Agent Upgrade Tasks

List Agent Upgrade Tasks V2

List Application Icons

List Application Pools

List Application Pools V2

List Application Pools V3

List Application Pools V4

List Application Pools V5

List App Volumes Applications On Farm

List Attachable Machines

List Category Folders

List Compatible Backup GA Es

List Compatible Backup GD Es

List Compatible Local Application Pools

List Compatible Local Desktop Pools

List Custom Application Icons

List Desktop Pools

List Desktop Pools V2

List Desktop Pools V3

List Desktop Pools V4

List Desktop Pools V5

List Desktop Pools V6

List Desktop Pools V7

List Desktop Pool Tasks

List Global Application Entitlements

List Global Application Entitlements V2

List Global Application Entitlements V3

List Global Desktop Entitlements

List Global Desktop Entitlements V2

List Global Desktop Entitlements V3

List Installed Applications On Desktop Pool

List Installed Applications On Farm

List Local Application Pools

List Local Desktop Pools

List Machines V2

List Machines V3

List Machines V4

List Machines V5

List Persistent Disks

List Physical Machines

List Physical Machines V2

List Policies On Desktop Pool

List Rds Server Agent Upgrade Tasks

List RDS Servers

List RDS Servers V2

List Session Info

List Unentitled Machines

List User Policies Overrides

Log Off Global Sessions

Log Off Sessions

Pause Desktop Pool Task

Query Global Sessions

Rebuild Machines

Recover Machines

Recover RDS Servers

Recreate From Persistent Disk

Register Agent Installer Package

Register Physical Machine

Register RDS Server

Remove Custom Icon

Remove Local Application Pools From GAE

Remove Local Desktop Pools From GDE

Remove Machines

Remove Rds Servers

Reset Global Sessions

Restart Global Sessions

Restart Machines

Restart Sessions

Resume Desktop Pool Task

Schedule Agent For Upgrade

Schedule Agent For Upgrade Rds Server

Schedule Agent For Upgrade V2

Schedule Maintenance

Schedule Maintenance V2

Schedule Push Image

Schedule Push Image V2

Send Message To Global Sessions

Send Message To Sessions

Unassign Machine Aliases

Unregister Agent Installer Package

Update Application Pool

Update Application Pool V2

Update Application Pool V3

Update Application Pool V5

Update Desktop Pool

Update Desktop Poolv7

Update Global Application Entitlement

Update Global Application Entitlement V3

Update Global Desktop Entitlement

Update Global Desktop Entitlement V3

Update Persistent Disk

Update Policy Overrides For Users

Update RDS Server

Update RDS Server V2

Updates Policies On Desktop Pool

Validate Installed Applications On Desktop Pool

Validate Installed Applications On Farm

Validate Specified Names