List registeredUsersList registeredUsers

Espace de noms: microsoft.graphNamespace: microsoft.graph

Récupérer la liste des utilisateurs qui sont des utilisateurs du périphérique.Retrieve a list of users that are registered users of the device.

Pour les appareils joints au cloud et les appareils personnels inscrits, les utilisateurs inscrits sont définis sur la même valeur que les propriétaires inscrits au moment de l’inscription.For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllDirectory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Directory.Read.All ou Directory.ReadWrite.AllDirectory.Read.All or Directory.ReadWrite.All

Lorsqu’une application interroge une relation qui renvoie une collection de type directoryObject, si elle n’a pas l’autorisation de lire un certain type dérivé (tel que l’appareil), les membres de ce type sont renvoyés, mais avec une information limitée.When an application queries a relationship that returns a directoryObject type collection, if it does not have permission to read a certain derived type (like device), members of that type are returned but with limited information. Avec ces applications comportementales, les applications peuvent demander les autorisations minimales dont elles ont besoin, plutôt que de s’appuyer sur l’accès aux autorisations.With this behaviour applications can request the least privileged permissions they need, rather than rely on the set of Directory.* permissions. Pour plus d’informations, consultez Informations limitées retournées pour les objets membres inaccessibles.For details, see Limited information returned for inaccessible member objects.

Requête HTTPHTTP request

GET /devices/{id}/registeredUsers

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData Query Parameters to help customize the response.

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et la collection d’objets directoryObject dans le corps de la réponse.If successful, this method returns a 200 OK response code and collection of directoryObject objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/devices/{id}/registeredUsers
RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55

{
  "value": [
    {
      "id": "id-value"
    }
  ]
}