Freigeben über


protectionRuleBase-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Schutzregel dar, die vom Client als Teil eines Schutzplans angegeben wird, der auf Microsoft 365-Daten in einem organization angewendet wird. Derzeit können nur Einschlussregeln definiert werden, bei denen es sich um Regeln handelt, die angeben, dass eine Schutzrichtlinie den angegebenen Kriterien entsprechen soll.

Derzeit sind Schutzregeln statisch, was bedeutet, dass Richtlinienänderungen nur angewendet werden, wenn die Regel ausgeführt wird, ohne automatische/dynamische Updates.

Dieser abstrakte Typ ist der Basistyp für siteProtectionRule, mailboxProtectionRule und driveProtectionRule.

Für diese Ressource gelten die folgenden Einschränkungen:

  • Die Schutzregel-APIs für das Massenhinzufügen von Websites über Websitenamen oder URL im Workflow zur Erstellung von Sicherungsrichtlinien können maximal 10 Schlüsselwörter gleichzeitig aufnehmen. Jede Schlüsselwort (keyword) darf mindestens drei Zeichen und maximal 255 Zeichen enthalten.
  • Die Schutzregel-APIs für das Massenhinzufügen von Benutzerkonten über Sicherheitsgruppen oder Verteilerlisten können maximal drei Gruppen gleichzeitig aufnehmen.
  • Die Regeln sind statisch und werden nur einmal angewendet. Das heißt, die Sicherheitsgruppen oder Verteilerlisten werden vereinfacht, wenn sie der Sicherungskonfigurationsrichtlinie hinzugefügt werden. Beispielsweise werden Gruppen oder Listen im System nicht dynamisch aktualisiert, wenn Benutzer der ursprünglichen Sicherheitsgruppe hinzugefügt oder daraus entfernt werden.

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Der eindeutige Bezeichner der Der Richtlinie zugeordneten Schutzregel.
createdBy identitySet Die Identität der Person, die die Regel erstellt hat.
createdDateTime DateTimeOffset Der Zeitpunkt der Erstellung der Regel.
error publicError Enthält Fehlerdetails, wenn ein Vorgang für eine Regel fehlschlägt.
isAutoApplyEnabled Boolesch true gibt an, dass die Schutzregel dynamisch ist; false dass es statisch ist. Derzeit werden nur statische Regeln unterstützt.
lastModifiedBy identitySet Die Identität der Person, die die Regel zuletzt geändert hat.
lastModifiedDateTime DateTimeOffset Zeitstempel der letzten Änderung, die an der Regel vorgenommen wurde.
status protectionRuleStatus Die status der Schutzregel. Mögliche Werte sind: draft, active, completed, completedWithErrors, unknownFutureValue. Der draft Member wird derzeit nicht unterstützt.

protectionRuleStatus-Werte

Member Beschreibung
Entwurf Die anfängliche status der Schutzregel bei der Erstellung. Der draft Member wird derzeit nicht unterstützt.
aktiv Die status der Schutzregel, wenn sie ausgeführt wird.
abgeschlossen Die status der Schutzregel, wenn sie erfolgreich auf die entsprechende Richtlinie angewendet wird.
completedWithErrors Die status der Schutzregel, wenn die Regel ausgeführt wurde, aber Fehler aufgetreten sind.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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