GET /admin/extension/hostReferences

Operation:

GET /admin/extension/hostReferences

Description:

Retrieve a list of references to ESX/ESXi hosts attached to the system.

Since:

1.0

Input parameters

Consume media type(s):

None

Input type:

None

Output parameters

VMWHostReferences

Produce media type(s):

application/vnd.vmware.admin.vmwHostReferences+xml

Output type:

VMWHostReferencesType

Examples

Request

HTTP 1.1
GET /api/admin/extension/hostReferences

Headers:
x-vcloud-authorization: M69zc2o7Ol7AuYVBAslGYbnTluZZVZKIYa1HPe8MzEk=

Body:

Response

HTTP/1.1 200 OK

Headers:
Content-Length: 832
Content-Type: application/vnd.vmware.admin.vmwhostreferences+xml;version=5.5
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:VMWHostReferences
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    type="application/vnd.vmware.admin.vmwHostReferences+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension"
        rel="up"
        type="application/vnd.vmware.admin.vmwExtension+xml"/>
    <vmext:HostReference
        href="https://vcloud.example.com/api/admin/extension/host/9f5e4893-97f3-4958-a56c-a8acae8eca13"
        name="10.26.51.104"
        type="application/vnd.vmware.admin.host+xml"/>
</vmext:VMWHostReferences>