accessPackageAssignment : filterByCurrentUser

  • Article

Espace de noms: microsoft.graph

Dans Microsoft Entra gestion des droits d’utilisation, récupérez une liste d’objets accessPackageAssignment filtrés sur l’utilisateur connecté.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

Requête HTTP

GET /identityGovernance/entitlementManagement/assignments/filterByCurrentUser(on='parameterValue')

Paramètres de fonction

Le tableau suivant indique les paramètres qui peuvent être utilisés avec cette fonction.

Paramètre Type Description
actif accessPackageAssignmentFilterByCurrentUserOptions Liste des options utilisateur qui peuvent être utilisées pour filtrer sur la liste des affectations de package d’accès. Les valeurs possibles sont : target, createdBy.

  • target est utilisé pour obtenir les accessPackageAssignment objets où l’utilisateur connecté est la cible. La liste résultante inclut toutes les affectations, actuelles et expirées, pour l’appelant dans tous les catalogues et packages d’accès.

  • createdBy est utilisé pour obtenir les accessPackageAssignment objets créés par l’utilisateur connecté. La liste résultante inclut toutes les affectations que l’appelant a créées pour lui-même ou pour le compte d’autres personnes, par exemple en cas d’attribution directe d’administrateur, dans tous les catalogues et packages d’accès.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et une collection accessPackageAssignment dans le corps de la réponse.

Lorsqu’un jeu de résultats s’étend sur plusieurs pages, Microsoft Graph renvoie cette page avec une @odata.nextLink propriété dans la réponse qui contient une URL vers la page de résultats suivante. Si cette propriété est présente, continuez à effectuer des requêtes supplémentaires avec l’URL @odata.nextLink dans chaque réponse, jusqu’à ce que tous les résultats soient retournés. Pour plus d’informations, consultez Pagination des données Microsoft Graph dans votre application.

Exemples

Demande

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignments/filterByCurrentUser(on='target')

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
  "value": [
    {
      "id": "5521fb4f-6a6c-410a-9191-461a65fd39d4",
      "state": "delivered",
      "status": "Delivered",
      "expiredDateTime": "null",
      "schedule": {
        "@odata.type": "microsoft.graph.entitlementManagementSchedule"
      }
    }
  ]
}