retentionLabel-Ressourcentyp

  • Artikel

Namespace: microsoft.graph.security

Gibt an, wie Organisationen aus Compliance- und Governancegründen ihre Daten auf Elementebene (E-Mail oder Dokument) verwalten können, einschließlich, ob und wie lange das Element aufbewahrt oder gelöscht werden soll.

Organisationen können Aufbewahrungsbezeichnungen für verschiedene Arten von Inhalten verwenden, die unterschiedliche Aufbewahrungseinstellungen erfordern. Sie können z. B. ein Aufbewahrungsetikett auf Steuerformulare und Belege anwenden, um sie für den gesetzlich vorgeschriebenen Zeitraum aufzubewahren.

Organisationen können Aufbewahrungsbezeichnungen mit den Aufbewahrungszeiträumen und Aktionen basierend auf Faktoren wie dem Datum der letzten Änderung oder Erstellung konfigurieren. Sie können auch verschiedene Aufbewahrungszeiträume starten, indem sie ein Ereignis angeben, das die Aufbewahrung auslösen kann , wenn das Ereignis eintritt.

Weitere Informationen dazu, wie Aufbewahrungsbezeichnungen funktionieren, wann sie verwendet werden sollten und wie Microsoft Purview Aufbewahrungsbezeichnungen unterstützt, damit Sie Aufbewahrungs- und Löscheinstellungen konfigurieren können, finden Sie unter Informationen zu Aufbewahrungsrichtlinien und Aufbewahrungsbezeichnungen.

Methoden

Methode Rückgabetyp Beschreibung
RetentionLabels auflisten microsoft.graph.security.retentionLabel-Sammlung Ruft eine Liste der retentionLabel-Objekte und deren Eigenschaften ab.
Create retentionLabel microsoft.graph.security.retentionLabel Create ein neues retentionLabel-Objekt.
Abrufen von retentionLabel microsoft.graph.security.retentionLabel Liest die Eigenschaften und Beziehungen eines retentionLabel-Objekts .
Aktualisieren von retentionLabel microsoft.graph.security.retentionLabel Aktualisieren sie die Eigenschaften eines retentionLabel-Objekts .
retentionLabel löschen Keine Löschen eines retentionLabel-Objekts .
List retentionEventType microsoft.graph.security.retentionEventType-Sammlung Rufen Sie die retentionEventType-Ressourcen aus der exapnd eventType-Navigationseigenschaft ab.
Hinzufügen von retentionEventType microsoft.graph.security.retentionEventType Fügen Sie eventType hinzu, indem Sie beim Erstellen einer Bezeichnung die relevante odata-Eigenschaft hinzufügen.

Eigenschaften

Eigenschaft Typ Beschreibung
actionAfterRetentionPeriod microsoft.graph.security.actionAfterRetentionPeriod Gibt die Aktion an, die nach Ablauf des durch die retentionDuration-Eigenschaft angegebenen Zeitraums für das bezeichnete Dokument ausgeführt werden soll. Mögliche Werte sind: none, delete, startDispositionReview, unknownFutureValue.
behaviorDuringRetentionPeriod microsoft.graph.security.behaviorDuringRetentionPeriod Gibt an, wie das Verhalten eines Dokuments mit dieser Bezeichnung während des Aufbewahrungszeitraums sein soll. Mögliche Werte sind: doNotRetain, retain, retainAsRecord, retainAsRegulatoryRecord, unknownFutureValue.
createdBy microsoft.graph.identitySet Stellt den Benutzer dar, der das retentionLabel erstellt hat.
createdDateTime DateTimeOffset Stellt das Datum und die Uhrzeit dar, zu dem das retentionLabel erstellt wird.
descriptionForAdmins String Stellt Bezeichnungsinformationen für den Administrator bereit. Optional.
descriptionForUsers String Stellt die Bezeichnungsinformationen für den Benutzer bereit. Optional.
displayName String Eindeutige Zeichenfolge, die einen Bezeichnungsnamen definiert.
id String Eindeutige ID des retentionLabel-Werts.
isInUse Boolesch Gibt an, ob die Bezeichnung derzeit verwendet wird.
lastModifiedBy microsoft.graph.identitySet Der Benutzer, der das retentionLabel zuletzt geändert hat.
lastModifiedDateTime DateTimeOffset Das letzte Datum, zu dem das RetentionLabel geändert wurde.
retentionDuration microsoft.graph.security.retentionDuration Gibt die Anzahl der Tage an, für die der Inhalt aufbewahrt werden soll.
retentionTrigger microsoft.graph.security.retentionTrigger Gibt an, ob die Aufbewahrungsdauer anhand des Inhaltserstellungsdatums, des bezeichneten Datums oder des Datums der letzten Änderung berechnet wird. Mögliche Werte sind: dateLabeled, dateCreated, dateModified, dateOfEvent, unknownFutureValue.
defaultRecordBehavior microsoft.graph.security.defaultRecordBehavior Gibt den gesperrten oder entsperrten Zustand einer Datensatzbezeichnung an, wenn sie erstellt wird. Die möglichen Werte sind: startLocked, startUnlocked, unknownFutureValue.
labelToBeApplied String Gibt die Ersatzbezeichnung an, die nach Ablauf des Aufbewahrungszeitraums der aktuellen Bezeichnung automatisch angewendet werden soll.

Beziehungen

Beziehung Typ Beschreibung
dispositionReviewStages microsoft.graph.security.dispositionReviewStage-Sammlung Wenn aktion am Ende der Aufbewahrung als "dispositionReview" ausgewählt wird, gibt dispositionReviewStages eine sequenzielle Gruppe von Phasen an, in denen in jeder Phase mindestens ein Prüfer vorhanden ist.
retentionEventType microsoft.graph.security.retentionEventType Stellt den Typ dar, der einem Aufbewahrungsereignis zugeordnet ist.
Deskriptoren microsoft.graph.security.filePlanDescriptor Stellt sofort einsatzbereite Werte dar, die mehr Optionen bieten, um die Verwaltbarkeit und organization des Zu kennzeichnenden Inhalts zu verbessern.

JSON-Darstellung

Hier ist eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.security.retentionLabel",
  "id": "String (identifier)",
  "displayName": "String",
  "behaviorDuringRetentionPeriod": "String",
  "actionAfterRetentionPeriod": "String",
  "retentionTrigger": "String",
  "retentionDuration": {
    "@odata.type": "microsoft.graph.security.retentionDuration"
  },
  "isInUse": "Boolean",
  "descriptionForAdmins": "String",
  "descriptionForUsers": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "labelToBeApplied": "String",
  "defaultRecordBehavior": "String"
}