RetentionLabels auflisten
Namespace: microsoft.graph.security
Ruft eine Liste der retentionLabel-Objekte und deren Eigenschaften ab.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | RecordsManagement.Read.All | RecordsManagement.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
GET /security/labels/retentionLabels
Optionale Abfrageparameter
Diese Methode unterstützt den expand
OData-Abfrageparameter, um die Antwort anzupassen.
Beispiel:
- Verwenden Sie
$expand=retentionEventType
, um die retentionEventType-Eigenschaft abzurufen. - Verwenden Sie
$expand=descriptors
, um die Deskriptors-Eigenschaft abzurufen.
Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Sammlung von microsoft.graph.security.retentionLabel-Objekten im Antworttext zurückgegeben.
Beispiele
Anforderung
Hier sehen Sie ein Beispiel für eine Anforderung.
GET https://graph.microsoft.com/v1.0/security/labels/retentionLabels
Antwort
Hier ist ein Beispiel für die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.security.retentionLabel",
"id": "64a99fb4-07be-0481-8746-44c15c0eef1f",
"displayName": "Retention Schedule 10004",
"behaviorDuringRetentionPeriod": "retain",
"actionAfterRetentionPeriod": "relabel",
"retentionTrigger": "dateCreated",
"retentionDuration": {
"@odata.type": "microsoft.graph.security.retentionDurationInDays",
"days": "730"
},
"isInUse": true,
"descriptionForAdmins": "creation based retention label for schedule 10004",
"descriptionForUsers": "retains for 2 years then relabeled",
"createdBy": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "Admin"
}
},
"createdDateTime": "2017-11-27T02:10:12Z",
"lastModifiedBy": {
"user": {
"id": "9563a605-e827-4324-a5a9-09efddff1e90",
"displayName": "Records Manager"
}
},
"lastModifiedDateTime": "2020-08-28T22:13:09Z",
"labelToBeApplied": "Retention schedule 10005",
"defaultRecordBehavior": "startLocked"
}
]
}