Elenca gli utenti
Descrizione DELL'API
Recupera un elenco di utenti a cui sono assegnati dispositivi gestiti da Microsoft Managed Desktop.
Operatori di query OData V4 supportati:
searchText on name, upn, email, serialNumber, devices name
$skip
$top
Prerequisiti
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Autorizzazioni.
| Tipo di autorizzazione | Autorizzazioni |
|---|---|
| Delegato | MWaaSDevice.Read |
| Applicazione | MmdSupport.ReadWrite |
Richiesta HTTP
GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/users
Intestazioni della richiesta
| Intestazione | Valore |
|---|---|
| Autorizzazione | Bearer {token} (Obbligatorio) |
| Accept | application/json |
Corpo della richiesta
Non specificare un corpo della richiesta per questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un codice di risposta 200 OK e un elenco di dispositivi nel corpo della risposta.
Esempio 1: Elencare tutti gli utenti
Elencare tutte le richieste degli utenti
Di seguito è riportato un esempio della richiesta HTTP.
GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/users
Elencare tutti gli utenti che richiedono una risposta
Ecco un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti gli utenti verranno restituiti da una chiamata effettiva.
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Users",</p>
"value": [
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Surface Laptop",
"ring": "Broad",
"lastIntuneSyncTime": "2021-04-13T09:19:06.6991927Z"
}
]
},
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "First",
"lastIntuneSyncTime": "2021-03-16T11:10:04Z"
}
]
},
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "Test",
"lastIntuneSyncTime": "2021-04-13T12:14:02.968959Z"
},
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "Test",
"lastIntuneSyncTime": "2021-03-17T17:52:04.8631737Z"
},
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "First",
"lastIntuneSyncTime": "2021-03-09T07:10:26Z"
}
]
}
]
}
Esempio 2: Elencare gli utenti con filtri
Elencare gli utenti con richiesta di filtri
Di seguito è riportato un esempio HTTP per ignorare il primo record ed elencare i due record successivi.
GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/users?$skip=1&$top=2
Elencare gli utenti con risposta ai filtri
Di seguito è riportato un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti gli utenti verranno restituiti da una chiamata effettiva.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Users",
"value": [
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "First",
"lastIntuneSyncTime": "2021-03-16T11:10:04Z"
}
]
},
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "Test",
"lastIntuneSyncTime": "2021-04-13T12:14:02.968959Z"
},
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "Test",
"lastIntuneSyncTime": "2021-03-17T17:52:04.8631737Z"
},
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "First",
"lastIntuneSyncTime": "2021-03-09T07:10:26Z"
}
]
}
...
]
}
Esempio 3: Elencare gli utenti in base a searchText
Elencare gli utenti in base alla richiesta searchText
Di seguito è riportato un esempio HTTP per elencare gli utenti con il dispositivo assegnato in base al nome del dispositivo.
GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/users?$searchText={deviceName}
Elencare gli utenti in base alla risposta searchText
Di seguito è riportato un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti gli utenti verranno restituiti da una chiamata effettiva.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Users",
"value": [
{
"name": "User Name",
"upn": "username@contoso.onmicrosoft.com",
"email": "username@contoso.onmicrosoft.com",
"groups": [],
"devices": [
{
"serialNumber": "Serial number value",
"name": "Device Name value",
"model": "Virtual Machine",
"ring": "First",
"lastIntuneSyncTime": "2021-03-16T11:10:04Z"
}
]
}
]
}