GET /admin/extension/vimServer/{id}/vmsList

Operation:

GET /admin/extension/vimServer/{id}/vmsList

Description:

Retrieve a list of virtual machines that can be imported from a registered vCenter server.

This request supports optional query parameters:

• page - The page to return. The first page is page 1.
• pageSize - The number of virtual machines to list on a page. An integer value between 1 and 100. The default value is 1.

Since:

1.0

Input parameters

Consume media type(s):

None

Input type:

None

Query parameters

Parameter

page

Documentation

Parameter

pageSize

Documentation

Output parameters

VmObjectRefsListType

Produce media type(s):

application/vnd.vmware.admin.vmsObjectRefsList+xml
application/vnd.vmware.admin.vmsObjectRefsList+json

Output type:

VmObjectRefsListType

Examples

Request

HTTP 1.1
GET /api/admin/extension/vimServer/5b2f648b-9da7-4d7b-8212-6ed8a83f2102/vmsList

Headers:
x-vcloud-authorization: M69zc2o7Ol7AuYVBAslGYbnTluZZVZKIYa1HPe8MzEk=

Body:

Response

HTTP/1.1 200 OK

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

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:VmObjectRefsList
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    numberOfPages="1"
    page="1"
    xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd">
    <vmext:VmObjectRef
        name="New Virtual Machine">
        <vmext:VimServerRef
            href="https://vcloud.example.com/api/admin/extension/vimServer/5b2f648b-9da7-4d7b-8212-6ed8a83f2102"
            name="ConfigWizard Configured vCenter"
            type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
        <vmext:MoRef>vm-232</vmext:MoRef>
        <vmext:VimObjectType>VIRTUAL_MACHINE</vmext:VimObjectType>
    </vmext:VmObjectRef>
</vmext:VmObjectRefsList>