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