Type de ressource accessReview (déconseillé)
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 .
Attention
Cette version de l’API de révision d’accès est déconseillée et cessera de retourner des données le 19 mai 2023. Utilisez l’API révisions d’accès.
Représente une révision d’accès Microsoft Entra.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Répertorier les révisions d’accès | collection accessReview | Répertorier accessReviews pour un businessFlowTemplate. |
| Obtenir une révision d’accès | accessReview | Obtenez une révision d’accès avec un ID spécifique. |
| Créer une révision d’accès | accessReview | Créez un accessReview. |
| Mettre à jour une révision d’accès | accessReview | Mettre à jour un accessReview. |
| Supprimer une révision d’accès | Aucun. | Supprimer un accessReview. |
| Répertorier les relecteurs | collection userIdentity | Obtenez les réviseurs d’un accessReview. |
| Ajouter un relecteur | Aucun. | Ajouter un réviseur à un accessReview. |
| Supprimer le relecteur | Aucun. | Supprimer un réviseur d’un accessReview. |
| Répertorier les décisions. | collection accessReviewDecision | Obtenir les décisions d’un accessReview. |
| Liste mes décisions | collection accessReviewDecision | En tant que réviseur, obtenez mes décisions d’un accessReview. |
| Envoyer un rappel | Aucun. | Envoyez un rappel aux réviseurs d’un accessReview. |
| Stop | Aucun. | Arrêter un accessReview. |
| Reset | Aucun. | Réinitialisez les décisions dans un accessReview en cours. |
| Appliquer les décisions | Aucun. | Appliquer les décisions d’un accessReview terminé. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | Chaîne | Identificateur unique attribué à une fonctionnalité d’une révision d’accès. |
| displayName | Chaîne | Nom de la révision d’accès. Obligatoire avec create. |
| startDateTime | DateTimeOffset | Date et heure de début de la révision. Cette date peut être à l’avenir. Obligatoire avec create. |
| endDateTime | DateTimeOffset | DateTime à laquelle la révision est planifiée pour se terminer. Cela doit être au moins un jour plus tard que la date de début. Obligatoire avec create. |
| status | Chaîne | Ce champ en lecture seule spécifie l’état d’un accessReview. Les états classiques incluent Initializing, NotStarted, Starting,InProgressCompleting , CompletedAutoReviewing, et AutoReviewed. |
| description | Chaîne | Description fournie par le créateur de la révision d’accès, à afficher aux réviseurs. |
| businessFlowTemplateId | Chaîne | Identificateur du modèle de flux d’entreprise. Obligatoire avec create. Cette valeur respecte la casse. |
| reviewerType | Chaîne | Type de relation du réviseur à l’objet cible, l’un des éléments suivants : self, delegated, entityOwners. Obligatoire avec create. |
| createdBy | userIdentity | Utilisateur qui a créé cette révision. |
| reviewedEntity | identity | Objet pour lequel la révision d’accès examine les attributions de droits d’accès. Cette identité peut être le groupe pour l’examen des appartenances des utilisateurs dans un groupe, ou l’application pour une révision des affectations d’utilisateurs à une application. Obligatoire avec create. |
| paramètres | accessReviewSettings | Les paramètres d’un accessReview, voir définition de type ci-dessous. |
Relations
| Relation | Type | Description |
|---|---|---|
| Examinateurs | collection userIdentity | Collection de réviseurs pour une révision d’accès, si révision d’accès reviewerType est de type delegated. |
| Décisions | collection accessReviewDecision | Collection de décisions pour cette révision d’accès. |
| myDecisions | collection accessReviewDecision | Collection de décisions pour l’appelant, si l’appelant est un réviseur. |
| instances | collection accessReview | Collection d’instances de révisions d’accès passées, présentes et futures, si cet objet est une révision d’accès périodique. |
Si ces relations sont présentes sur un objet, dépend du fait que l’objet est une révision d’accès à usage unique, la série d’une révision d’accès périodique ou une instance d’une révision d’accès périodique.
| Scénario | Il y a des réviseurs ? | A des décisions et myDecisions ? | Vous disposez d’instances ? |
|---|---|---|---|
| Révision d’accès unique | Oui | Oui, une fois démarré | Non |
| Révision d’accès périodique | Oui | Non | Oui |
| Instance d’une révision d’accès périodique | Oui | Oui, une fois démarré | Non |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"id": "string (identifier)",
"displayName": "string",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"description": "string",
"businessFlowTemplateId": "string (identifier)",
"reviewerType": "string",
"createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
"reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
"settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
"reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}