Type de ressource accessReviewScheduleSettings
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.
AccessReviewScheduleSettings définit les paramètres d’un accessReviewScheduleDefinition.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| mailNotificationsEnabled | Valeur booléenne | Indique si les e-mails sont activés ou désactivés. La valeur par défaut est false. |
| reminderNotificationsEnabled | Valeur booléenne | Indique si les rappels sont activés ou désactivés. La valeur par défaut est false. |
| justificationRequiredOnApproval | Valeur booléenne | Indique si les réviseurs sont tenus de justifier leur décision. La valeur par défaut est false. |
| defaultDecisionEnabled | Valeur booléenne | Indique si la décision par défaut est activée ou désactivée lorsque les réviseurs ne répondent pas. La valeur par défaut est false. PRUDENCE: Si autoApplyDecisionsEnabled et defaultDecisionEnabled sont true, tous les accès des principaux à la ressource risquent d’être révoqués si les réviseurs ne répondent pas. |
| defaultDecision | Chaîne | Décision choisie si defaultDecisionEnabled est activé. Il peut s’agir de Approve, Denyou Recommendation. |
| instanceDurationInDays | Int32 | Durée de chaque récurrence de révision (accessReviewInstance) en nombre de jours. NOTE: Si le paramètre stageSettings de l’objet accessReviewScheduleDefinition est défini, son paramètre durationInDays est utilisé à la place de la valeur de cette propriété. |
| recurrence | patternedRecurrence | Paramètres détaillés pour la périodicité à l’aide de l’objet de périodicité Outlook standard. Note: Seules les propriétés dayOfMonth, interval et type ( weekly, absoluteMonthly) sont prises en charge. Utilisez la propriété startDate sur recurrenceRange pour déterminer le jour de début de la révision. |
| autoApplyDecisionsEnabled | Valeur booléenne | Indique si les décisions sont appliquées automatiquement. Lorsqu’il falseest défini sur , un administrateur doit appliquer les décisions manuellement une fois que le réviseur a terminé la révision d’accès.
trueLorsque la valeur est définie sur , les décisions sont appliquées automatiquement après la fin de la durée de l’instance de révision d’accès, que les réviseurs aient répondu ou non. La valeur par défaut est false. PRUDENCE: Si autoApplyDecisionsEnabled et defaultDecisionEnabled sont true, tous les accès des principaux à la ressource risquent d’être révoqués si les réviseurs ne répondent pas. |
| applyActions | collection accessReviewApplyAction | Champ facultatif. Décrit les actions à effectuer une fois qu’une révision est terminée. Deux types sont actuellement pris en charge : removeAccessApplyAction (par défaut) et disableAndDeleteUserApplyAction. Le champ doit uniquement être spécifié dans le cas de disableAndDeleteUserApplyAction. |
| recommendationsEnabled | Valeur booléenne | Indique si les recommandations de décision sont activées ou désactivées. NOTE: Si le paramètre stageSettings de l’objet accessReviewScheduleDefinition est défini, son paramètre recommendationsEnabled est utilisé à la place de la valeur de cette propriété. |
| recommendationLookBackDuration | Durée | Champ facultatif. Indique la période d’inactivité (par rapport à la date de début de l’instance de révision) à partir de laquelle les recommandations seront configurées. Il est recommandé de le faire deny si l’utilisateur est inactif pendant la durée de la recherche en arrière. Pour les révisions des groupes et des rôles Microsoft Entra, toute durée est acceptée. Pour l’examen des demandes, la durée maximale est de 30 jours. S’il n’est pas spécifié, la durée est de 30 jours. NOTE: Si le paramètre stageSettings de l’objet accessReviewScheduleDefinition est défini, son paramètre recommendationLookBackDuration est utilisé à la place de la valeur de cette propriété. |
| decisionHistoriesForReviewersEnabled | Valeur booléenne | Indique si les décisions sur les étapes de révision d’accès précédentes sont disponibles pour les réviseurs sur un accessReviewInstance avec plusieurs étapes suivantes. S’il n’est pas fourni, la valeur par défaut est désactivée (false). |
| recommendationInsightSettings | collection accessReviewRecommendationInsightSetting | Optional. Décrit les types d’insights qui aident les réviseurs à prendre des décisions de révision d’accès. NOTE: Si le paramètre stageSettings de l’objet accessReviewScheduleDefinition est défini, son paramètre recommendationInsightSettings est utilisé à la place de la valeur de cette propriété. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.accessReviewScheduleSettings",
"mailNotificationsEnabled": "Boolean",
"reminderNotificationsEnabled": "Boolean",
"justificationRequiredOnApproval": "Boolean",
"defaultDecisionEnabled": "Boolean",
"defaultDecision": "String",
"instanceDurationInDays": "Integer",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"autoApplyDecisionsEnabled": "Boolean",
"applyActions": [
{
"@odata.type": "microsoft.graph.removeAccessApplyAction"
}
],
"recommendationsEnabled": "Boolean",
"recommendationLookBackDuration": "String (duration)",
"decisionHistoriesForReviewersEnabled": "Boolean",
"recommendationInsightSettings": [
{
"@odata.type": "microsoft.graph.accessReviewRecommendationInsightSetting"
}
]
}