List VM Folders

List VM Folders

At least one of the listed privileges is required -

Privileges Description
GLOBAL_CONFIG_VIEW Caller should have permission to this privilege, to perform this operation.
VC_CONFIG_VIEW Caller should have permission to this privilege, to perform this operation.
Request
URI
GET
https://{api_host}//localhost/rest/external/v1/vm-folders
COPY
Query Parameters
string
datacenter_id
Required

Datacenter ID

datacenter_id example
datacenter-1
string
vcenter_id
Required

Virtual Center ID

vcenter_id example
d0325b13-2bf1-4fa4-b027-e780004f2d1e

Authentication
This operation uses the following authentication methods.
Responses
200

OK

[
    {
        "children": [],
        "datacenter_id": "datacenter-1",
        "id": "group-v1",
        "incompatible_reasons": [
            "string"
        ],
        "name": "Discovered virtual machine",
        "path": "/Datacenter/vm/Discovered virtual machine",
        "type": "FOLDER",
        "vcenter_id": "d0325b13-2bf1-4fa4-b027-e780004f2d1e"
    }
]

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