protectionRuleBase-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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"
}