protectionRuleBase tipo de recurso

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 em uma organização. Atualmente, somente 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 será dinâmica; caso contrário, será estática.
  • As alterações de regras estáticas são aplicadas uma vez quando elas são criadas sem atualizações automáticas ou dinâmicas.
  • A regra dinâmica é reavaliada em intervalos regulares para buscar o escopo mais recente da regra, o que resulta na adição ou remoção de artefatos com base na avaliação de regra mais recente.
  • Essa propriedade só pode ser definida quando um objeto protectionRuleBase é criado. Portanto, uma regra dinâmica não pode ser alterada para uma regra estática, nem vice-versa.

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

As seguintes limitações se aplicam a esse 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ítica de backup podem lidar com no máximo 10 palavras-chave por vez. Cada palavra-chave pode ter no mínimo três caracteres e no máximo 255 caracteres.
  • As APIs de regra de proteção para adição em massa de contas de usuário por meio de grupos de segurança ou listas de distribuição podem acomodar no máximo três grupos por vez.
  • As regras estáticas são aplicadas apenas uma vez, durante a qual os grupos de segurança ou as listas de distribuição são nivelados quando adicionados à política de configuração de backup. Por exemplo, grupos ou listas não são atualizados dinamicamente no sistema se usuários são adicionados ou removidos do grupo de segurança original.
  • As regras dinâmicas são atualizadas em intervalos regulares, adicionando e removendo automaticamente artefatos da política de configuração, dependendo do resultado da avaliação da regra.
  • Uma política de proteção pode ter apenas 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 dá suporte a um máximo de 100 IDs de grupo em uma expressão.
  • Atualmente, um máximo de 6.000 usuários podem ser protegidos por meio de uma regra dinâmica.
  • Não há suporte para uma expressão com lista de distribuição aninhada ou grupo de segurança.
  • 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 A hora de criação da regra.
erro publicError Contém detalhes de erro se uma operação em uma 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 feita na regra.
status protectionRuleStatus O status da regra de proteção. Os valores possíveis são draft, active, completed, completedWithErrors, unknownFutureValue, updateRequested, deleteRequested. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes valores nesta enumeração evolutiva: updateRequested , deleteRequested. No draft momento, o membro não tem suporte.

valores de protectionRuleStatus

Member Descrição
Rascunho O status inicial da regra de proteção após a criação. No draft momento, o membro não tem suporte.
Ativo O status da regra de proteção quando ela está em execução.
concluído O status da regra de proteção quando ela é aplicada com êxito à política correspondente.
completedWithErrors O status da regra de proteção quando a regra foi executada, mas encontrou erros.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.
updateRequested O status da regra de proteção quando um patch é solicitado. Esse valor se aplica somente a regras dinâmicas.
deleteRequested O status da regra de proteção quando a ação deleteAndUnprotect é executada. Esse valor se aplica somente a regras dinâmicas.

Relações

Nenhum

Representação JSON

A representação JSON a seguir 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"
}
  • Última atualização em