accessReviewHistoryInstance: generateDownloadUri
Namespace: microsoft.graph
Generiert einen URI für ein accessReviewHistoryInstance-Objekt, das status, für das istdone
. Jeder URI kann verwendet werden, um die Überprüfungsverlaufsdaten des instance abzurufen. Jeder URI ist 24 Stunden gültig und kann durch Abrufen der downloadUri-Eigenschaft aus dem accessReviewHistoryInstance-Objekt abgerufen werden.
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) | AccessReview.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | AccessReview.ReadWrite.All | Nicht verfügbar. |
In delegierten Szenarien muss der angemeldete Benutzer mindestens über eine der folgenden Microsoft Entra Rollen verfügen.
Schreiben von Zugriffsüberprüfungen für eine Gruppe oder App | Schreiben von Zugriffsüberprüfungen für eine Microsoft Entra Rolle |
---|---|
Benutzeradministrator Identity Governance-Administrator |
Identity Governance-Administrator Mit privilegierter Rolle Administrator |
Der Ersteller der Überprüfungsverlaufsdefinition kann auch den Downloadlink generieren.
HTTP-Anforderung
POST /identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinitionId}/instances/{accessReviewHistoryInstanceId}/generateDownloadUri
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 Aktion erfolgreich verläuft, werden der 200 OK
Antwortcode und accessReviewHistoryInstances im Antworttext zurückgegeben.
Beispiele
Anforderung
POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/historyDefinitions/b2cb022f-b7e1-40f3-9854-c65a40861c38/instances/b2cb022f-b7e1-40f3-9854-c65a40861c38/generateDownloadUri
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.accessReviewHistoryInstance",
"id": "b2cb022f-b7e1-40f3-9854-c65a40861c38",
"reviewHistoryPeriodStartDateTime": "2000-06-19T08:00:00Z",
"reviewHistoryPeriodEndDateTime": "2100-06-19T07:00:00Z",
"status": "done",
"runDateTime": "2022-01-20T17:46:54.6085806Z",
"fulfilledDateTime": "2022-01-20T10:00:24.9114365-08:00",
"downloadUri": "https://dfermconsolreportusc.blob.core.windows.net/df-erm-reports/Last months reviews for ELM-e642e792-9884-413d-9299-982b37bfe369.csv?skoid=fa04d013-9f36-4d7d-8b8e-7276fb3bd36e&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skt=2022-01-20T18:03:59Z&ske=2022-01-20T18:05:59Z&sks=b&skv=2020-04-08&sv=2020-04-08&st=2022-01-20T18:04:01Z&se=2022-01-21T18:04:01Z&sr=b&sp=r&sig=...",
"expiration": "2022-02-19T10:00:24.9114365-08:00"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für