Répertorier accessReviews (déconseillé)

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Attention

Cette version de l’API de révision d’accès est déconseillée et cessera de retourner des données le 19 mai 2023. Utilisez l’API révisions d’accès.

Récupérez les objets accessReview pour un businessFlowTemplate particulier. Une liste de zéro ou plusieurs objets accessReview sont retournés, pour chaque révision d’accès ponctuelle et périodique créée avec ce modèle de flux d’entreprise. Notez que les ID de modèle de flux d’entreprise respectent la casse.

Remarque

Si l’une des révisions d’accès qui correspondent au filtre est une révision d’accès périodique, un objet accessReview est retourné pour représenter chaque série périodique dans son ensemble, en plus des instance actuelles, passées et suivantes à venir. Par exemple, s’il existe une révision d’accès périodique mensuelle des membres invités du groupe A, une révision d’accès périodique trimestrielle des membres invités du groupe B et une révision d’accès unique des membres invités du groupe C, chacune de ces périodicités vient de commencer, et l’appelant interroge les révisions d’accès avec un modèle de flux d’entreprise de révisions des membres invités des groupes, trois objets représentant les trois séries sont retournés, ainsi que trois objets pour les instances de révision d’accès actuelles et potentiellement trois objets pour les instances à venir suivantes. Pour récupérer les instances d’une révision d’accès périodique, ou la révision d’accès instance planifiée pour un mois ou un trimestre particulier, l’appelant peut par la suite parcourir la relation instance de l’objet accessReview périodique. La relation instance est liée aux objets accessReview pour une instance actuelle ou passée de la révision d’accès périodique.

Si de nombreuses révisions d’accès correspondent au filtre, pour améliorer l’efficacité et éviter les délais d’expiration, récupérez le jeu de résultats dans les pages, en incluant à la fois le $top paramètre de requête avec une taille de page, par exemple 100, et le paramètre de $skip=0 requête dans la requête. Ces paramètres peuvent être inclus même si vous ne prévoyez pas que la requête s’étendra sur plusieurs pages. 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 d’autres demandes avec l’URL @odata.nextLink dans chaque réponse, jusqu’à ce que tous les résultats soient renvoyés, comme décrit dans la section paginer les données Microsoft Graph de votre application.

Les objets accessReview retournés par cette API n’incluent pas les propriétés de structure imbriquées telles que les paramètres ou les relations. Pour récupérer des paramètres ou des relations de révision d’accès, utilisez l’API get accessReview .

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) AccessReview.Read.All AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application AccessReview.Read.All AccessReview.ReadWrite.Membership

L’utilisateur connecté doit également être dans un rôle d’annuaire qui lui permet de lire une révision d’accès.

Requête HTTP

GET /accessReviews?$filter=businessFlowTemplateId eq {businessFlowTemplate-id}&$top={pagesize}&$skip=0

En-têtes de demande

Nom Type Description
Autorisation string Porteur {token}. Obligatoire.

Corps de la demande

Ne fournissez pas de corps de demande.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un tableau d’objets accessReview dans le corps de la réponse.

Exemples

Demande

L’exemple suivant montre une demande de récupération de toutes les révisions d’accès ponctuelles et périodiques pour un modèle de flux d’entreprise « 6e4f3d20-c5c3-407f-9695-8460952bcc68 ».

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0
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": "2b83cc42-09db-46f6-8c6e-16fec466a82d",
         "displayName": "review",
         "startDateTime": "2017-11-14T01:14:54.89Z",
         "endDateTime": "2017-12-14T01:14:54.89Z",
         "status": "InProgress",
         "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
         "reviewerType": "self",
         "description": "",
         "reviewedEntity":{"id":"3b4f7e74-eb82-4120-9ff5-ba429c1ea6df","displayName":"Salesforce"}
       }
    ]
}

Contenu connexe