Type de ressource accessReview (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.

Représente une révision d’accès Microsoft Entra.

Méthodes

Méthode Type renvoyé Description
Répertorier les vues d’accès collection accessReview Répertorier accessReviews pour un businessFlowTemplate.
Obtenir accessReview accessReview Obtenez une révision d’accès avec un ID spécifique.
Créer accessReview accessReview Créez un accessReview.
Mettre à jour accessReview accessReview Mettre à jour un accessReview.
Supprimer accessReview Aucun. Supprimer un accessReview.
Répertorier les réviseurs accessReview collection userIdentity Obtenez les réviseurs d’un accessReview.
Ajouter un réviseur accessReview Aucun. Ajouter un réviseur à un accessReview.
Supprimer le réviseur accessReview Aucun. Supprimer un réviseur d’un accessReview.
Lister les décisions accessReview collection accessReviewDecision Obtenir les décisions d’un accessReview.
Répertorier mes décisions accessReview collection accessReviewDecision En tant que réviseur, obtenez mes décisions d’un accessReview.
Envoyer le rappel accessReview Aucun. Envoyez un rappel aux réviseurs d’un accessReview.
Arrêter accessReview Aucun. Arrêter un accessReview.
Réinitialiser les décisions accessReview Aucun. Réinitialisez les décisions dans un accessReview en cours.
Appliquer les décisions accessReview Aucun. Appliquer les décisions d’un accessReview terminé.

Propriétés

Propriété Type Description
id Chaîne Identificateur unique attribué à une fonctionnalité d’une révision d’accès.
displayName Chaîne Nom de la révision d’accès. Obligatoire avec create.
startDateTime DateTimeOffset Date et heure de début de la révision. Cette date peut être à l’avenir. Obligatoire avec create.
endDateTime DateTimeOffset DateTime à laquelle la révision est planifiée pour se terminer. Cela doit être au moins un jour plus tard que la date de début. Obligatoire avec create.
status Chaîne Ce champ en lecture seule spécifie la status d’un accessReview. Les états classiques incluent Initializing, NotStarted, Starting,InProgressCompleting , CompletedAutoReviewing, et AutoReviewed.
description Chaîne Description fournie par le créateur de la révision d’accès, à afficher aux réviseurs.
businessFlowTemplateId Chaîne Identificateur du modèle de flux d’entreprise. Obligatoire avec create. Cette valeur respecte la casse.
reviewerType Chaîne Type de relation du réviseur à l’objet cible, l’un des éléments suivants : self, delegated, entityOwners. Obligatoire avec create.
createdBy userIdentity Utilisateur qui a créé cette révision.
reviewedEntity identity Objet pour lequel la révision d’accès examine les attributions de droits d’accès. Cette identité peut être le groupe pour l’examen des appartenances des utilisateurs dans un groupe, ou l’application pour une révision des affectations d’utilisateurs à une application. Obligatoire avec create.
paramètres accessReviewSettings Les paramètres d’un accessReview, voir définition de type ci-dessous.

Relations

Relation Type Description
Examinateurs collection userIdentity Collection de réviseurs pour une révision d’accès, si révision d’accès reviewerType est de type delegated.
Décisions collection accessReviewDecision Collection de décisions pour cette révision d’accès.
myDecisions collection accessReviewDecision Collection de décisions pour l’appelant, si l’appelant est un réviseur.
instances collection accessReview Collection d’instances de révisions d’accès passées, présentes et futures, si cet objet est une révision d’accès périodique.

Si ces relations sont présentes sur un objet, dépend du fait que l’objet est une révision d’accès unique, la série d’une révision d’accès périodique ou une instance d’une révision d’accès périodique.

Scénario Il y a des réviseurs ? A des décisions et myDecisions ? Vous disposez d’instances ?
Révision d’accès unique Oui Oui, une fois démarré Non
Révision d’accès périodique Oui Non Oui
Instance d’une révision d’accès périodique Oui Oui, une fois démarré Non

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "description": "string",
 "businessFlowTemplateId": "string (identifier)",
 "reviewerType": "string",
 "createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
 "reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
 "settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
 "reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}