Compartilhar via

protectionRuleBase resource type (Tipo de recurso protectionRuleBase)

Namespace: microsoft.graph

Representa uma regra de proteção especificada pelo cliente como parte de um plano de proteção aplicado aos dados do Microsoft 365 numa organização. Atualmente, apenas as regras de inclusão, que são regras que indicam que uma política de proteção deve corresponder aos critérios especificados, podem ser definidas.

  • As regras de proteção podem ser estáticas ou dinâmicas. Se a propriedade isAutoApplyEnabled for true, a regra de proteção é dinâmica; caso contrário, é estática.
  • As alterações à regra estática são aplicadas uma vez quando são criadas sem atualizações automáticas ou dinâmicas.
  • A regra dinâmica é reavaliada em intervalos regulares para obter o âmbito mais recente da regra, o que resulta na adição ou remoção de artefactos com base na avaliação da regra mais recente.
  • Esta propriedade só pode ser definida quando é criado um objeto protectionRuleBase . Portanto, uma regra dinâmica não pode ser alterada para uma regra estática, nem vice-versa.

Este tipo abstrato é o tipo base para siteProtectionRule, mailboxProtectionRule e driveProtectionRule.

As seguintes limitações aplicam-se a este recurso:

  • As APIs de regra de proteção para adicionar vários sites por nomes de sites ou URL no fluxo de trabalho de criação de políticas de cópia de segurança podem processar um máximo de 10 palavras-chave de cada vez. Cada palavra-chave pode ter um mínimo de três carateres e um máximo de 255 carateres.
  • As APIs de regra de proteção para a adição em massa de contas de utilizador através de grupos de segurança ou listas de distribuição podem acomodar um máximo de três grupos de cada vez.
  • As regras estáticas são aplicadas apenas uma vez, período durante o qual os grupos de segurança ou listas de distribuição são simplificados quando adicionados à política de configuração de cópias de segurança. Por exemplo, os grupos ou listas não são atualizados dinamicamente no sistema se os utilizadores forem adicionados ou removidos do grupo de segurança original.
  • As regras dinâmicas são atualizadas em intervalos regulares, adicionando e removendo automaticamente artefactos da política de configuração, dependendo do resultado da avaliação da regra.
  • Uma política de proteção só pode ter uma regra dinâmica ativa.
  • As regras dinâmicas não estão disponíveis para políticas de proteção do SharePoint.
  • A expressão de regra dinâmica suporta um máximo de 100 IDs de grupo numa expressão.
  • Atualmente, um máximo de 6000 utilizadores pode ser protegido através de uma regra dinâmica.
  • Uma expressão com lista de distribuição aninhada ou grupo de segurança não é suportada.
  • A multi-geo não está disponível para regras dinâmicas.

Propriedades

Propriedade Tipo Descrição
createdBy identitySet A identidade da pessoa que criou a regra.
createdDateTime DateTimeOffset O tempo de criação da regra.
erro publicError Contém detalhes de erro se uma operação numa regra falhar.
id Cadeia de caracteres O identificador exclusivo da regra de proteção associada à política.
isAutoApplyEnabled Booliano true indica que a regra de proteção é dinâmica; false que é estático.
lastModifiedBy identitySet A identidade da pessoa que modificou a regra pela última vez.
lastModifiedDateTime DateTimeOffset Carimbo de data/hora da última modificação efetuada à regra.
status protectionRuleStatus O status da regra de proteção. Os valores possíveis são draft, active, completed, completedWithErrors, unknownFutureValue, updateRequested, deleteRequested. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: updateRequested , deleteRequested. O draft membro não é atualmente suportado.

valores protectionRuleStatus

Member Descrição
rascunho O status inicial da regra de proteção após a criação. O draft membro não é atualmente suportado.
ativo O status da regra de proteção quando está em execução.
concluído O status da regra de proteção quando é aplicada com êxito à política correspondente.
completedWithErrors O status da regra de proteção quando a regra foi executada, mas encontrou erros.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.
updateRequested O status da regra de proteção quando é pedido um patch. Este valor aplica-se apenas a regras dinâmicas.
deleteRequested O status da regra de proteção quando a ação deleteAndUnprotect é executada. Este valor aplica-se apenas a regras dinâmicas.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.protectionRuleBase",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "error": {"@odata.type": "microsoft.graph.publicError"},
  "id": "String (identifier)",
  "isAutoApplyEnabled": "Boolean",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "status": "String"
}
  • Last updated on