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 .
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 , Completing Completed , AutoReviewing , et AutoReviewed . Prend en charge $select , $orderby et $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"
}
]
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour