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 . CAUTELA: 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 , Deny o 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 . CAUTELA: 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 representación JSON muestra el tipo de 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"
}
]
}