AccessReviewScheduleDefinition abrufen
Namespace: microsoft.graph
Liest die Eigenschaften und Beziehungen eines accessReviewScheduleDefinition-Objekts .
Verwenden Sie zum Abrufen der Instanzen der Zugriffsüberprüfungsreihe die list accessReviewInstance-API .
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.Read.All | AccessReview.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | AccessReview.Read.All | AccessReview.ReadWrite.All |
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.
Lesezugriffsüberprüfungen einer Gruppe oder App | Lesezugriffsüberprüfungen einer Microsoft Entra-Rolle |
---|---|
Der Ersteller der Definition des Zugriffsüberprüfungszeitplans Globaler Leser Sicherheitsleseberechtigter Benutzeradministrator Sicherheitsadministrator für Identitätsgovernanceadministrator |
Sicherheitsleseberechtigter Identity Governance-Administrator Administrator für privilegierte Rollen – Sicherheitsadministrator |
Der angemeldete Benutzer kann die Definition der Zugriffsüberprüfung lesen, wenn er als Prüfer zugewiesen ist.
HTTP-Anforderung
GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}
Optionale Abfrageparameter
Diese Methode unterstützt $select
den OData-Abfrageparameter, um die Antwort anzupassen. 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
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein accessReviewScheduleDefinition-Objekt im Antworttext zurück.
Beispiele
Anforderung
GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/3856fd6f-36e2-4152-97c9-76070d19f730
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"id": "d6bf2f6c-2f6c-d6bf-6c2f-bfd66c2fbfd6",
"displayName": "Review example",
"status": "Applying",
"scope": {
"@odata.type": "#microsoft.graph.accessReviewQueryScope",
"query": "/v1.0/groups/4444d821-ca3b-45cc-98ee-54c00a04deef/transitiveMembers/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest')",
"queryType": "MicrosoftGraph",
"queryRoot": null
},
"reviewers": [
{
"query": "/v1.0/users/5555556e-fce3-4e2d-b28e-4ac0c7d2fa10",
"queryType": "MicrosoftGraph",
"queryRoot": null
}
],
"fallbackReviewers": [],
"instanceEnumerationScope": {
"@odata.type": "#microsoft.graph.accessReviewQueryScope",
"query": "/v1.0/groups/4444d821-ca3b-45cc-98ee-54c00a04deef",
"queryType": "MicrosoftGraph",
"queryRoot": null
},
"settings": {
"mailNotificationsEnabled": true,
"reminderNotificationsEnabled": true,
"justificationRequiredOnApproval": false,
"defaultDecisionEnabled": true,
"defaultDecision": "Deny",
"instanceDurationInDays": 10,
"autoApplyDecisionsEnabled": false,
"recommendationsEnabled": true,
"recurrence": {
"pattern": null,
"range": {
"type": "numbered",
"numberOfOccurrences": 0,
"recurrenceTimeZone": null,
"startDate": "2021-04-28",
"endDate": "2021-05-08"
}
},
"applyActions": [
{
"@odata.type": "#microsoft.graph.disableAndDeleteUserApplyAction"
}
]
}
}
}