tipo de recurso accessReviewScheduleSettings

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Nota:

Esta es la API recomendada para las revisiones de acceso. La versión anterior de la API de revisiones de acceso está en desuso .

AccessReviewScheduleSettings define la configuración de un accessReviewScheduleDefinition.

Propiedades

Propiedad Tipo Descripción
mailNotificationsEnabled Booleano Indica si los correos electrónicos están habilitados o deshabilitados. El valor predeterminado es false.
reminderNotificationsEnabled Booleano Indica si los recordatorios están habilitados o deshabilitados. El valor predeterminado es false.
justificationRequiredOnApproval Booleano Indica si los revisores deben proporcionar una justificación con su decisión. El valor predeterminado es false.
defaultDecisionEnabled Booleano Indica si la decisión predeterminada está habilitada o deshabilitada cuando los revisores no responden. El valor predeterminado es false.

PRECAUCIÓN: Si tanto autoApplyDecisionsEnabled como defaultDecisionEnabled son true, todo el acceso de las entidades de seguridad a los riesgos de recursos se revocará si los revisores no responden.
defaultDecision Cadena Decisión elegida si defaultDecisionEnabled está habilitada. Puede ser uno de Approve, Denyo Recommendation.
instanceDurationInDays Int32 Duración de cada periodicidad de revisión (accessReviewInstance) en número de días.
NOTA: Si se define el valor stageSettings del objeto accessReviewScheduleDefinition , se usará su valor durationInDays en lugar del valor de esta propiedad.
recurrence patternedRecurrence Configuración detallada de la periodicidad mediante el objeto de periodicidad estándar de Outlook.

Nota: Solo se admiten las propiedades dayOfMonth, interval y type (weekly, absoluteMonthly). Use la propiedad startDate en recurrenceRange para determinar el día en que se inicia la revisión.
autoApplyDecisionsEnabled Booleano Indica si las decisiones se aplican automáticamente. Cuando se establece en false, un administrador debe aplicar las decisiones manualmente una vez que el revisor complete la revisión de acceso. Cuando se establece en true, las decisiones se aplican automáticamente después de que finalice la duración de la instancia de revisión de acceso, independientemente de si los revisores han respondido o no. El valor predeterminado es false.

PRECAUCIÓN: Si tanto autoApplyDecisionsEnabled como defaultDecisionEnabled son true, todo el acceso de las entidades de seguridad a los riesgos de recursos se revocará si los revisores no responden.
applyActions colección accessReviewApplyAction Campo opcional. Describe las acciones que se realizarán una vez completada una revisión. Actualmente se admiten dos tipos: removeAccessApplyAction (valor predeterminado) y disableAndDeleteUserApplyAction. El campo solo debe especificarse en el caso de disableAndDeleteUserApplyAction.
recommendationsEnabled Booleano Indica si las recomendaciones de decisión están habilitadas o deshabilitadas.
NOTA: Si se define el valor stageSettings del objeto accessReviewScheduleDefinition , se usará su configuración recommendationsEnabled en lugar del valor de esta propiedad.
recommendationLookBackDuration Duración Campo opcional. Indica el período de inactividad (con respecto a la fecha de inicio de la instancia de revisión) desde el que se configurarán las recomendaciones. La recomendación será deny si el usuario está inactivo durante la duración de la vista atrás. Para las revisiones de grupos y roles de Microsoft Entra, se acepta cualquier duración. Para las revisiones de aplicaciones, 30 días es la duración máxima. Si no se especifica, la duración es de 30 días.

NOTA: Si se define el valor stageSettings del objeto accessReviewScheduleDefinition , se usará su valor recommendationLookBackDuration en lugar del valor de esta propiedad.
decisionHistoriesForReviewersEnabled Booleano Indica si las decisiones sobre las fases de revisión de acceso anteriores están disponibles para los revisores en una accessReviewInstance con varias fases posteriores. Si no se proporciona, el valor predeterminado está deshabilitado (false).
recommendationInsightSettings colección accessReviewRecommendationInsightSetting Opcional. Describe los tipos de información que ayudan a los revisores a tomar decisiones de revisión de acceso.

NOTA: Si se define el valor stageSettings del objeto accessReviewScheduleDefinition , se usará su configuración recommendationInsightSettings en lugar del valor de esta propiedad.

Relaciones

Ninguna.

Representación JSON

La siguiente es una representación JSON del recurso

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