Freigeben über


protectionPolicyBase-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.

Enthält Details zu Schutzrichtlinien, die auf Microsoft 365-Daten in einem organization angewendet werden. Schutzrichtlinien werden vom globalen Admin (oder dem SharePoint Online-Admin oder Exchange Online Admin) definiert und enthalten, welche Daten zu schützen sind, wann sie geschützt werden sollen und wie lange die geschützten Daten für einen einzelnen Microsoft 365-Dienst aufbewahrt werden sollen.

Basistyp für sharePointProtectionPolicy, exchangeProtectionPolicy und onedriveForBusinessProtectionPolicy.

Methoden

Methode Rückgabetyp Beschreibung
List protectionPolicyBase-Sammlung Rufen Sie eine Liste der protectionPolicyBase und deren Eigenschaften ab.
Get protectionPolicyBase Lesen sie die Eigenschaften und Beziehungen einer protectionPolicyBase.
Löschen Keine Löschen sie eine protectionPolicyBase.Delete a protectionPolicyBase.
Activate protectionPolicyBase Aktivieren sie eine inaktive Schutzrichtlinie.
Deactivate protectionPolicyBase Deaktivieren Sie eine aktive Schutzrichtlinie.

Eigenschaften

Eigenschaft Typ Beschreibung
createdBy identitySet Die Identität der Person, die die Richtlinie erstellt hat.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung der Richtlinie. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
displayName String Der Name der Richtlinie
id Zeichenfolge Der eindeutige Bezeichner der Der Richtlinie zugeordneten Schutzregel.
isEnabled Boolescher Wert Gibt an, ob die Richtlinie aktiviert ist.
lastModifiedBy identitySet Die Identität der Person, die die Richtlinie zuletzt geändert hat.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit der letzten Änderung der Richtlinie. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
offboardRequestedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu dem das Offboarding für die Schutzrichtlinie angefordert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
protectionPolicyArtifactCount protectionPolicyArtifactCount Die Anzahl der Artefakte in der Schutzrichtlinie nach status. Wird nur auf $select zurückgegeben.
retentionSettings retentionSetting-Sammlung Enthält die Details der Aufbewahrungseinstellung für die Richtlinie.
status protectionPolicyStatus Die aggregierte status der der Richtlinie zugeordneten Schutzeinheiten. Mögliche Werte sind: inactive, activeWithErrors, updating, active, unknownFutureValue, offboardRequested, offboarded. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: offboardRequested, offboarded.

protectionPolicyStatus-Werte

Member Beschreibung
aktiv Alle Einheiten sind geschützt.
activeWithErrors Einige Einheiten sind geschützt, andere nicht geschützt.
Inaktiv Alle Einheiten sind nicht geschützt.
Aktualisierung Einige oder alle Einheiten befinden sich im protectRequestedZustand , unprotectRequestedoder removeRequested .
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
offboardRequested Für die Schutzrichtlinie wurde offboarding angefordert.
offboarded Die Schutzrichtlinie wurde erfolgreich offboarded.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.protectionPolicyBase",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "id": "String (identifier)",
  "isEnabled": "Boolean",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "offboardRequestedDateTime": "String (timestamp)",
  "protectionPolicyArtifactCount": {"@odata.type": "microsoft.graph.protectionPolicyArtifactCount"},
  "retentionSettings": [{"@odata.type": "microsoft.graph.retentionSetting"}],
  "status": "String"
}