Type de ressource accessReviewInstance

  • 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 .

Remarque

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
Répertorier accessReviewInstances collection accessReviewInstance Obtenez la liste des objets accessReviewInstance et leurs propriétés.
Obtenir accessReviewInstance accessReviewInstance Lisez les propriétés et les relations d’un objet accessReviewInstance .
Mettre à jour accessReviewInstance accessReviewInstance Mettez à jour les réviseurs d’un objet accessReviewInstance .
filterByCurrentUser 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 un instance de révision d’accès.
sendReminder Aucun. Envoyez un rappel aux réviseurs d’un accessReviewInstance.
stop Aucun. Arrêtez manuellement une accessReviewInstance.
acceptRecommendations 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.
applyDecisions Aucun. Appliquer manuellement des décisions sur un accessReviewInstance.
stopApplyDecisions Aucun. Permet à l’utilisateur appelant d’arrêter l’action d’application de décision sur un accessReviewInstance spécifique.
batchRecordDecisions Aucune Passez en revue les lots de principaux ou de ressources dans un appel.
resetDecisions Aucune Réinitialise tous les éléments de décision sur un instance à notReviewed.
Étapes de liste collection accessReviewStage Récupérez les étapes d’un 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.
List pendingAccessReviewInstances (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 à laquelle la fin de l’instance de révision est prévue. 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 une révision d’accès instance cycle de vie. 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 du 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ébut 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 la status 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 permettant d’attribuer des réviseurs, consultez Affecter des réviseurs à votre définition de révision d’accès à l’aide du API Graph Microsoft.

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 pour le instance, où des instances sont créées pour chaque périodicité 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 comporte plusieurs phases, cette opération retourne la collection d’étapes. 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 un 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)",
 "displayName": "string",
 "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"
    }
  ]
}