Partager via

Type de ressource accessReviewInstance

  • Article

Espace de noms: microsoft.graph

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 aura une instance unique pour chaque périodicité.

Chaque accessReviewInstance contient une liste de décisions sur laquelle les réviseurs peuvent prendre des mesures. Une décision par identité est en cours d’examen.

Hérite de l’entité.

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 d’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 Aucune Envoyez un rappel aux réviseurs d’un accessReviewInstance.
Stop Aucune Arrêtez manuellement une accessReviewInstance.
Accepter les recommandations Aucune Permet à l’utilisateur appelant d’accepter la recommandation de décision pour chaque accessReviewInstanceDecisionItem marqué comme NotReviewed et pour lequel l’appelant est un réviseur de l’accessReviewInstance associé.
Appliquer les décisions Aucune Appliquer manuellement des décisions sur un accessReviewInstance.
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.

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.
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 seront 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.
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.
é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.

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

Représentation JSON

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

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