# Virtual Provider Controller Resource

### GET /virtual-providers

Returns list of virtual providers (HVM + standalone HV) filtered by specified query parameters.

Request Parameters
name | type | description | multivalued
--- | --- | --- | ---
direction | query |  | no
filter | query |  | no
guids | query |  | yes
nameLike | query |  | no
orderBy | query |  | no
page | query |  | no
size | query |  | no
type | query |  | no

Response Body
media type | data type | description
--- | --- | ---
application/json | array of VirtualProviderListRecord (JSON) | list of virtual providers (HVM + standalone HV) filtered by specified query parameters

#### Example

##### Request

    GET /virtual-providers
    Content-Type: */*
    Accept: application/json

    ...

##### Response

    HTTP/1.1 200 OK
    Content-Type: application/json

    [ { } ]

### GET /virtual-providers/for-migration/{backupGuid}

Returns list of hypervisor managers for a restore operation filtered by specified query parameters.

Request Parameters
name | type | description
--- | --- | ---
backupGuid | path | specify query parameters to filter list of hypervisor managers

Response Body
media type | data type | description
--- | --- | ---
application/json | array of VirtualProviderMigrationDetails (JSON) | list of hypervisor manager name and guids filtered by specified query parameters

#### Example

##### Request

    GET /virtual-providers/for-migration/{backupGuid}
    Content-Type: */*
    Accept: application/json

    ...

##### Response

    HTTP/1.1 200 OK
    Content-Type: application/json

    [ { } ]

### GET /virtual-providers/for-restore/{backupGuid}

Returns list of hypervisor managers for a restore operation filtered by specified query parameters.

Request Parameters
name | type | description
--- | --- | ---
backupGuid | path | specify query parameters to filter list of hypervisor managers

Response Body
media type | data type | description
--- | --- | ---
application/json | array of VirtualProviderListRecord (JSON) | list of hypervisor manager name and guids filtered by specified query parameters

#### Example

##### Request

    GET /virtual-providers/for-restore/{backupGuid}
    Content-Type: */*
    Accept: application/json

    ...

##### Response

    HTTP/1.1 200 OK
    Content-Type: application/json

    [ { } ]