Compartilhar via


accessReviewScheduleSettings tipo de recurso

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Observação

Esta é a API recomendada para revisões de acesso. A versão anterior da API de revisões de acesso foi preterida.

AccessReviewScheduleSettings define as definições de um accessReviewScheduleDefinition.

Propriedades

Propriedade Tipo Descrição
mailNotificationsEnabled Booliano Indica se os e-mails estão ativados ou desativados. O valor padrão é false.
reminderNotificationsEnabled Booliano Indica se os lembretes estão ativados ou desativados. O valor padrão é false.
justificationRequiredOnApproval Booliano Indica se os revisores são obrigados a fornecer justificação para a decisão. O valor padrão é false.
defaultDecisionEnabled Booliano Indica se a decisão predefinida está ativada ou desativada quando os revisores não respondem. O valor padrão é false.

ATENÇÃO: Se autoApplyDecisionsEnabled e defaultDecisionEnabled forem true, todos os acessos dos principais aos riscos de recurso serão revogados se os revisores não responderem.
defaultDecision Cadeia de caracteres Decisão escolhida se defaultDecisionEnabled estiver ativada. Pode ser um de Approve, Denyou Recommendation.
instanceDurationInDays Int32 Duração de cada periodicidade da revisão (accessReviewInstance) em número de dias.
NOTA: Se as stageSettings do objeto accessReviewScheduleDefinition estiverem definidas, a respetiva definição durationInDays será utilizada em vez do valor desta propriedade.
recurrence patternedRecurrence Definições detalhadas para periodicidade com o objeto de periodicidade padrão do Outlook.

Nota: Apenas são suportadas as propriedades dayOfMonth, interval e type (weekly, absoluteMonthly) . Utilize a propriedade startDate on recurrenceRange para determinar o dia em que a revisão é iniciada.
autoApplyDecisionsEnabled Booliano Indica se as decisões são aplicadas automaticamente. Quando definido como false, um administrador tem de aplicar as decisões manualmente assim que o revisor concluir a revisão de acesso. Quando definida como true, as decisões são aplicadas automaticamente após o fim da duração da instância de revisão de acesso, quer os revisores tenham ou não respondido. O valor padrão é false.

ATENÇÃO: Se autoApplyDecisionsEnabled e defaultDecisionEnabled forem true, todos os acessos dos principais aos riscos de recurso serão revogados se os revisores não responderem.
applyActions accessReviewApplyAction collection (coleção accessReviewApplyAction) Campo opcional. Descreve as ações a efetuar assim que uma revisão estiver concluída. Existem dois tipos que são atualmente suportados: removeAccessApplyAction (predefinição) e disableAndDeleteUserApplyAction. O campo só tem de ser especificado no caso de disableAndDeleteUserApplyAction.
recommendationsEnabled Booliano Indica se as recomendações de decisão estão ativadas ou desativadas.
NOTA: Se as stageSettings do objeto accessReviewScheduleDefinition estiverem definidas, a definição recommendationsEnabled será utilizada em vez do valor desta propriedade.
recommendationLookBackDuration Duração Campo opcional. Indica o período de inatividade (relativamente à data de início da instância de revisão) a partir do qual as recomendações serão configuradas. A recomendação será se deny o utilizador estiver inativo durante a duração do look-back. Para revisões de grupos e funções do Microsoft Entra, qualquer duração é aceite. Para revisões de aplicações, 30 dias é a duração máxima. Se não for especificado, a duração é de 30 dias.

NOTA: Se as stageSettings do objeto accessReviewScheduleDefinition estiverem definidas, a definição recommendationLookBackDuration será utilizada em vez do valor desta propriedade.
decisionHistoriesForReviewersEnabled Booliano Indica se as decisões em fases de revisão de acesso anteriores estão disponíveis para revisores numa accessReviewInstance com várias fases subsequentes. Se não for fornecido, a predefinição é desativada (false).
recommendationInsightSettings accessReviewRecommendationInsightSetting collection Opcional. Descreve os tipos de informações que ajudam os revisores a tomar decisões de revisão de acesso.

NOTA: Se as stageSettings do objeto accessReviewScheduleDefinition estiverem definidas, a definição recommendationInsightSettings será utilizada em vez do valor desta propriedade.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o 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"
    }
  ]
}