Members

List

Retrieve the list of VDI Host Pool Members from a VDI Host Pool.

GET/api/VDI/HostPool/{vdiHostPoolId}/Members

Path parameters

vdiHostPoolId*integer (int32)

The VDI Host Pool ID.

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the VDI Host Pool member

namenullable string

Name of the VDI Host Pool member

typeVDIHostPoolMemberType (enum)

VDI Host Pool Member Type

0 = AllHostsInProvider,2 = Host,3 = NativePool,5 = Template,7 = TemplateVersion

providerIdinteger (int32)

ID of the Provider

Request

JavaScriptCurlPython

const response = await fetch('/api/VDI/HostPool/{vdiHostPoolId}/Members', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

[
  {
    "id": 0,
    "name": "text",
    "type": [
      "0 = AllHostsInProvider",
      "2 = Host",
      "3 = NativePool",
      "5 = Template",
      "7 = TemplateVersion"
    ],
    "providerId": 0
  }
]

Add

Add one VDI Host Pool Member to an existing VDI Host Pool.

POST/api/VDI/HostPool/{vdiHostPoolId}/Members

Path parameters

vdiHostPoolId*integer (int32)

The VDI Host Pool ID.

Query parameters

Body

application/json; api-version=1.0

VDI host pool member configuration

type*VDIHostPoolMemberType (enum)

VDI Host Pool Member Type

0 = AllHostsInProvider,2 = Host,3 = NativePool,5 = Template,7 = TemplateVersion

name*nullable string

The VDI Host Pool Member Name.

providerIdnullable integer (int32)

The VDI Host Pool Member Provider ID. This parameter is only accepted with Types: ALLGUESTSONPROVIDER, GUEST or NATIVEPOOL.

vmIdnullable string

The VDI Host Pool Member Guest ID. This parameter is only accepted with Type: GUEST.

nativePoolIdnullable string

The VDI Host Pool Member Native Pool ID. This parameter is only accepted with Type: NATIVEPOOL.

noInstallboolean

Specifies not to install the RAS Guest Agent on the server. If this parameter is omitted, the agent will be push installed in the VM using your RAS admin credentials. To specify different credentials for push installation, use the Username and Password parameters. This parameter can be used in situations when the RAS Guest Agent is already installed in a VM, but the VM is powered down. By including this parameter, you will simply power up the VM and make it available for Parallels RAS operations.

vmIdsnullable array of string

The VDI Host Pool Member Desktops IDs. This parameter is only accepted with Type: ALLDESKTOPSONPROVIDER.

Response

201401

Created

Request

JavaScriptCurlPython

const response = await fetch('/api/VDI/HostPool/{vdiHostPoolId}/Members', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({
      "name": "text",
      "type": [
        "0 = AllHostsInProvider",
        "2 = Host",
        "3 = NativePool",
        "5 = Template",
        "7 = TemplateVersion"
      ]
    }),
});
const data = await response.json();

Response

401

{
  "type": "text",
  "title": "text",
  "status": 0,
  "detail": "text",
  "instance": "text"
}

Get

Retrieve a VDI Host Pool Member from a VDI Host Pool.

GET/api/VDI/HostPool/{vdiHostPoolId}/Members/{id}

Path parameters

vdiHostPoolId*integer (int32)

The VDI Host Pool ID.

id*integer (int32)

The VDI Host Pool Member ID.

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the VDI Host Pool member

namenullable string

Name of the VDI Host Pool member

typeVDIHostPoolMemberType (enum)

VDI Host Pool Member Type

0 = AllHostsInProvider,2 = Host,3 = NativePool,5 = Template,7 = TemplateVersion

providerIdinteger (int32)

ID of the Provider

Request

JavaScriptCurlPython

const response = await fetch('/api/VDI/HostPool/{vdiHostPoolId}/Members/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "id": 0,
  "name": "text",
  "type": [
    "0 = AllHostsInProvider",
    "2 = Host",
    "3 = NativePool",
    "5 = Template",
    "7 = TemplateVersion"
  ],
  "providerId": 0
}

Delete

Remove a VDI Host Pool Member from a VDI Host Pool.

DELETE/api/VDI/HostPool/{vdiHostPoolId}/Members/{id}

Path parameters

vdiHostPoolId*integer (int32)

The VDI Host Pool ID.

id*integer (int32)

The VDI Host Pool Member ID.

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/VDI/HostPool/{vdiHostPoolId}/Members/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "status": 0,
  "detail": "text",
  "instance": "text"
}