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"
}
]
}