Partager via


Type de ressource accessReviewInstance

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 .

Notes

Il s’agit de l’API recommandée pour les révisions d’accès. La version précédente de l’API révisions d’accès est déconseillée.

Représente une périodicité de révision d’accès Microsoft Entra. Si le parent accessReviewScheduleDefinition est une révision d’accès périodique, les instances représentent chaque périodicité. Une révision qui ne se répète pas aura exactement une instance. Les instances représentent également chaque groupe unique en cours de révision dans la définition de planification. Si une définition de planification passe en revue plusieurs groupes, chaque groupe a une instance unique pour chaque périodicité.

Chaque accessReviewInstance contient une liste de décisions sur laquelle les réviseurs peuvent prendre des mesures. Il y a une décision par identité en cours de révision.

Méthodes

Méthode Type renvoyé Description
List collection accessReviewInstance Obtenez la liste des objets accessReviewInstance et leurs propriétés.
Obtenir accessReviewInstance Lisez les propriétés et les relations d’un objet accessReviewInstance .
Mettre à jour accessReviewInstance Mettez à jour les réviseurs d’un objet accessReviewInstance .
Filtrer par utilisateur actuel collection accessReviewInstance Retourne toutes les instances sur un accessReviewScheduleDefinition donné pour lequel l’utilisateur appelant est le réviseur d’une ou plusieurs décisions.
Répertorier les réviseurs contactés collection accessReviewReviewer Obtenez les réviseurs qui ont reçu des notifications pour une instance de révision d’accès.
Envoyer un rappel Aucun. Envoyez un rappel aux réviseurs d’un accessReviewInstance.
Stop Aucun. Arrêtez manuellement une accessReviewInstance.
Accepter les recommandations Aucun. Permet à l’utilisateur appelant d’accepter la recommandation de décision pour chaque objet NotReviewed accessReviewInstanceDecisionItem sur lequel il est le réviseur pour un accessReviewInstance spécifique.
Appliquer les décisions Aucun. Appliquer manuellement des décisions sur un accessReviewInstance.
Arrêter les décisions d’application Aucun. Permet à l’utilisateur appelant d’arrêter l’action d’application de décision sur un accessReviewInstance spécifique.
Décisions relatives aux enregistrements par lots Aucune Passez en revue les lots de principaux ou de ressources dans un appel.
Réinitialiser les décisions Aucune Réinitialise tous les éléments de décision sur une instance à notReviewed.
Étapes de liste collection accessReviewStage Récupérez les étapes dans une instance de révision d’accès multiphase.
Répertorier les décisions. collection accessReviewInstanceDecisionItem Obtenez les ressources accessReviewInstanceDecisionItem à partir de la propriété de navigation decisions.
Répertorier les instances de révision d’accès en attente (déconseillé) collection accessReviewInstance . Obtenez toutes les ressources accessReviewInstance en attente affectées à l’utilisateur appelant. Cette méthode est déconseillée et remplacée par filterByCurrentUser.

Propriétés

Propriété Type Description
endDateTime DateTimeOffset DateTime lorsque l’instance de révision est planifiée pour se terminer. Le type DatetimeOffset représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Prend en charge $select. En lecture seule.
erreurs collection accessReviewError Collection d’erreurs dans le cycle de vie d’une instance de révision d’accès. En lecture seule.
secoursReviewers collection accessReviewReviewerScope Cette collection d’étendues de réviseurs est utilisée pour définir la liste des réviseurs de secours. Ces réviseurs de secours sont avertis de prendre des mesures si aucun utilisateur n’est trouvé dans la liste des réviseurs spécifiés. Cela peut se produire lorsque le propriétaire du groupe est spécifié en tant que réviseur, mais que le propriétaire du groupe n’existe pas, ou que le responsable est spécifié en tant que réviseur, mais que le responsable d’un utilisateur n’existe pas. Prend en charge $select.
id Chaîne Identificateur unique de l’instance. Prend en charge $select. En lecture seule.
étendue accessReviewScope Créé en fonction de scope et instanceEnumerationScope au niveau accessReviewScheduleDefinition. Définit l’étendue des utilisateurs examinés dans un groupe. Prend en charge $select et $filter (contains uniquement). En lecture seule.
startDateTime DateTimeOffset DateTime lorsque le démarrage de l’instance de révision est planifié. Peut-être à l’avenir. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Prend en charge $select. En lecture seule.
status Chaîne Spécifie l’état d’un accessReview. Valeurs possibles : Initializing, NotStarted, Starting, InProgress, CompletingCompleted, AutoReviewing, et AutoReviewed. Prend en charge $select, $orderbyet $filter (eq uniquement). En lecture seule.
Examinateurs collection accessReviewReviewerScope Cette collection d’étendues de révision d’accès est utilisée pour définir qui sont les réviseurs. Prend en charge $select. Pour obtenir des exemples d’options d’affectation de réviseurs, consultez Affecter des réviseurs à votre définition de révision d’accès à l’aide de l’API Microsoft Graph.

Relations

Relation Type Description
contactedReviewers collection accessReviewReviewer Retourne la collection des réviseurs qui ont été contactés pour effectuer cette révision. Bien que les propriétés reviewers et fallbackReviewers de l’accessReviewScheduleDefinition puissent spécifier des propriétaires de groupe ou des responsables en tant que réviseurs, contactedReviewers retourne leurs identités individuelles. Prend en charge $select. En lecture seule.
définition accessReviewScheduleDefinition Il existe exactement un accessReviewScheduleDefinition associé à chaque instance. Il s’agit de la planification parente de l’instance, où des instances sont créées pour chaque récurrence d’une définition de révision et chaque groupe sélectionné pour la révision par la définition.
stages collection accessReviewStage Si l’instance a plusieurs phases, cette opération retourne la collection de phases. Une nouvelle étape n’est créée qu’à la fin de la phase précédente. L’existence, le nombre et les paramètres des phases sur une instance de révision sont créés en fonction de accessReviewStageSettings sur le parent accessReviewScheduleDefinition.
Décisions collection accessReviewInstanceDecisionItem Chaque utilisateur examiné dans un accessReviewInstance a un élément de décision indiquant s’il a été approuvé, refusé ou pas encore révisé.

Représentation JSON

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

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}