Feedback Bearbeiten

List directoryAudits

  • Artikel
  • 3 Minuten Lesedauer

Namespace: microsoft.graph

Dient zum Abrufen der Liste der von Azure Active Directory generierten Überwachungsprotokolle. Dazu gehören Überwachungsprotokolle, die von verschiedenen Diensten innerhalb Azure AD generiert werden, einschließlich Benutzer-, App-, Geräte- und Gruppenverwaltung, Privileged Identity Management (PIM), Zugriffsüberprüfungen, Nutzungsbedingungen, Identitätsschutz, Kennwortverwaltung (Self-Service- und Administratorkennwortzurücksetzungen) und Self-Service-Gruppenverwaltung usw.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) AuditLog.Read.All und Directory.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung AuditLog.Read.All und Directory.Read.All

Wichtig

Diese API hat ein bekanntes Problem und erfordert derzeit die Zustimmung sowohl der AuditLog.Read.All- als auch der Directory.Read.All-Berechtigung.

HTTP-Anforderung

GET /auditLogs/directoryaudits

Optionale Abfrageparameter

Diese Methode unterstützt die folgenden OData-Abfrageparameter, um die Antwort anzupassen. Weitere Informationen zur Verwendung dieser Parameter finden Sie unter OData-Abfrageparameter.

Parameter Beschreibung Beispiel
$Filter Dient zum Filtern von Ergebnissen (Zeilen). /auditLogs/directoryAudits?&$filter=activityDateTime le 2018-01-24
$Nach oben Dient zum Festlegen der Seitengröße von Ergebnissen. /auditLogs/directoryAudits?$top=1
$skiptoken Dient zum Abrufen der nächsten Seite von Ergebnissen aus Resultsets, die mehrere Seiten umfassen. /auditLogs/directoryAudits?$skiptoken=01fa0e77c60c2d3d63226c8e3294c860__1

Vom Filterparameter unterstützte Attribute $

Attribut Unterstützte Operatoren
activityDisplayName eq, startswith
activityDateTime eq, ge, le
loggedByService eq
initiatedBy/user/id eq
initiatedBy/user/displayName eq
initiatedBy/user/userPrincipalName eq, startswith
initiatedBy/app/appId eq
initiatedBy/app/displayName eq
targetResources/any(t: t/id eq '{value}') eq
targetResources/any(t:t/displayName eq '{value}') eq
targetResources/any(x: startswith(x/displayName, '{value}')) startswith

Anforderungsheader

Name Beschreibung
Authorization Bearer {code}

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und eine Sammlung von directoryAudit-Objekten im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

In der SDK-Dokumentation finden Sie Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#auditlogs/directoryaudits",
  "value": [{
        "id": "id",
        "category": "UserManagement",
        "correlationId": "da159bfb-54fa-4092-8a38-6e1fa7870e30",
        "result": "success",
        "resultReason": "Successfully added member to group",
        "activityDisplayName": "Add member to group",
        "activityDateTime": "2018-01-09T21:20:02.7215374Z",
        "loggedByService": "Core Directory",
        "initiatedBy": {
            "user": {
                "id": "728309ae-1a37-4937-9afe-e35d964db09b",
                "displayName": "Audry Oliver",
                "userPrincipalName": "bob@wingtiptoysonline.com",
                "ipAddress": "127.0.0.1"
            },
            "app": null
        },
        "targetResources": [{
            "id": "ef7e527d-6c92-4234-8c6d-cf6fdfb57f95",
            "displayName": "Example.com",
            "Type": "Group",
            "modifiedProperties": [{
                "displayName": "Action Client Name",
                "oldValue": null,
                "newValue": "DirectorySync"}],
            "groupType": "unifiedGroups"
            }, 
            {
            "id": "1f0e98f5-3161-4c6b-9b50-d488572f2bb7",
            "displayName": null,
            "Type": "User",
            "modifiedProperties": [],
            "userPrincipalName": "bob@contoso.com"
        }],
        "additionalDetails": [{
            "key": "Additional Detail Name",
            "value": "Additional Detail Value"
        }]
    }]
}