Feedback Bearbeiten

accessReviewInstanceDecisionItem: filterByCurrentUser

  • Artikel
  • 7 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Rufen Sie alle Entscheidungselemente in einer Instanz einer Zugriffsüberprüfung oder einer Phase einer Instanz einer mehrstufigen Zugriffsüberprüfung ab, für die der aufrufende Benutzer der Prüfer ist. Die Entscheidungselemente werden von einem accessReviewInstanceDecisionItem-Objekt in einer bestimmten accessReviewInstance oder accessReviewStage dargestellt, für die der aufrufende Benutzer der Prüfer ist.

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) AccessReview.Read.All, AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung AccessReview.Read.All, AccessReview.ReadWrite.All

HTTP-Anforderung

So rufen Sie Entscheidungen für eine Instanz einer Zugriffsüberprüfung ab, für die der aufrufende Benutzer der Prüfer ist:

GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/decisions/filterByCurrentUser(on='reviewer')

So rufen Sie Entscheidungen für eine Phase in einer Instanz einer Zugriffsüberprüfung ab, für die der aufrufende Benutzer der Prüfer ist:

GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/stages/{accessReviewStageId}/decisions/filterByCurrentUser(on='reviewer')

Hinweis

Bearbeiter von mehrstufigen Rezensionen können die Entscheidungen aus vorherigen Phasen abrufen, wenn die decisionHistoriesForReviewersEnabled-Eigenschaft in den Einstellungen des accessReviewScheduleDefinition-Objekts aktiviert ist.

Funktionsparameter

In der folgenden Tabelle sind die Abfrageparameter aufgeführt, die mit dieser Methode verwendet werden können.

Parameter Typ Beschreibung
on accessReviewInstanceDecisionItemFilterByCurrentUserOptions Filtern, um Entscheidungsobjekte für den aktuellen Benutzer abzufragen. Mögliche Werte sind reviewer, unknownFutureValue. Verwenden Sie reviewer. Erforderlich.

Optionale Abfrageparameter

Diese Methode unterstützt die $selectAbfrageparameter , , $filter``$orderByund $top $skipOData, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Die Standardseitengröße für diese API ist 100 accessReviewInstanceDecisionItem-Objekte . Um die Effizienz zu verbessern und Timeouts aufgrund umfangreicher Resultsets zu vermeiden, wenden Sie die Paginierung mithilfe der Parameter und $top der $skip Abfrage an. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Funktion erfolgreich verläuft, werden der 200 OK Antwortcode und eine accessReviewInstanceDecisionItem-Auflistung im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Abrufen aller Entscheidungen für eine accessReviewInstance, für die der aufrufende Benutzer der Prüfer ist

Anforderung

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-5678-ae36-41b923c3bf87/decisions/filterByCurrentUser(on='reviewer')

Antwort

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(accessReviewInstanceDecisionItem)",
    "@odata.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItem",
            "id": "139166ec-d214-4835-95aa-3c1d89581e51",
            "accessReviewId": "8d035c9d-798d-47fa-beb4-f986a4b8126f",
            "reviewedDateTime": "2021-05-03T19:28:25.02Z",
            "decision": "Approve",
            "justification": "Christie still needs access to the Marketing group as she works in the Marketing organization.",
            "appliedDateTime": null,
            "applyResult": "New",
            "recommendation": "Deny",
            "principalLink": "https://graph.microsoft.com/v1.0/users/1800bb2c-955d-4205-8471-3a6c3116435d",
            "resourceLink": null,
            "resource": null,
            "reviewedBy": {
                "id": "36c4c56e-fce3-4e2d-b28e-4ac0c7d2fa10",
                "displayName": "MOD Administrator",
                "userPrincipalName": "MOD Administrator"
            },
            "appliedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "target": {
                "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
                "userId": "1800bb2c-955d-4205-8471-3a6c3116435d",
                "userDisplayName": "Christie Cline",
                "userPrincipalName": "ChristieC@contoso.com"
            },
            "principal": {
                "@odata.type": "#microsoft.graph.userIdentity",
                "id": "1800bb2c-955d-4205-8471-3a6c3116435d",
                "displayName": "Christie Cline",
                "userPrincipalName": "ChristieC@contoso.com"
            }
        }
    ]
}

Beispiel 2: Abrufen aller Entscheidungen für eine accessReviewStage einer mehrstufigen Zugriffsüberprüfung, für die der aufrufende Benutzer der Prüfer ist

Anforderung

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-5678-ae36-41b923c3bf87/stages/9458f255-dff2-4d86-9a05-69438f49d7f8/decisions/filterByCurrentUser(on='reviewer')

Antwort

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(accessReviewInstanceDecisionItem)",
    "@odata.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItem",
            "id": "139166ec-d214-4835-95aa-3c1d89581e51",
            "accessReviewId": "8d035c9d-798d-47fa-beb4-f986a4b8126f",
            "reviewedDateTime": "2021-05-03T19:28:25.02Z",
            "decision": "Approve",
            "justification": "Christie still needs access to the Marketing group as she works in the Marketing organization.",
            "appliedDateTime": null,
            "applyResult": "New",
            "recommendation": "Deny",
            "principalLink": "https://graph.microsoft.com/v1.0/users/1800bb2c-955d-4205-8471-3a6c3116435d",
            "resourceLink": null,
            "resource": null,
            "reviewedBy": {
                "id": "36c4c56e-fce3-4e2d-b28e-4ac0c7d2fa10",
                "displayName": "MOD Administrator",
                "userPrincipalName": "MOD Administrator"
            },
            "appliedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "target": {
                "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
                "userId": "1800bb2c-955d-4205-8471-3a6c3116435d",
                "userDisplayName": "Christie Cline",
                "userPrincipalName": "ChristieC@contoso.com"
            },
            "principal": {
                "@odata.type": "#microsoft.graph.userIdentity",
                "id": "1800bb2c-955d-4205-8471-3a6c3116435d",
                "displayName": "Christie Cline",
                "userPrincipalName": "ChristieC@contoso.com"
            }
        }
    ]
}