accessReviewInstance: batchApplyCustomDataProvidedResourceDecisions

Namespace: microsoft.graph

Ermöglicht Prüfern, applyResult und applyDescription für alle accessReviewInstanceDecisionItem-Objekte in einer bestimmten accessReviewInstance stapelweise mithilfe von customDataProvidedResourceId festzulegen.

HINWEIS: Die Zugriffsüberprüfungs-instance muss sich in einem Applying Zustand befinden.

Diese Aktion ist Teil der einheitlichen Oberfläche für Zugriffsüberprüfungen und nur über die /identityGovernance/accessReviews/unified Route verfügbar. Weitere Informationen finden Sie unter unifiedRoot.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigung 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
Application	AccessReview.ReadWrite.All	Nicht verfügbar.

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:

• So schreiben Sie Zugriffsüberprüfungen für eine Gruppe oder App: Benutzeradministrator, Identity Governance-Administrator
• So schreiben Sie Zugriffsüberprüfungen für eine Microsoft Entra Rolle: Identity Governance-Administrator, Administrator für privilegierte Rollen

HTTP-Anforderung

POST /identityGovernance/accessReviews/unified/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, wenn Sie diese Aktion aufrufen.

Parameter	Typ	Beschreibung
applyResult	accessReviewInstanceDecisionItemApplyResult	Die applyResult für die zu überprüfende Entität. Mögliche Werte sind: new, appliedSuccessfully, appliedWithUnknownFailure, appliedSuccessfullyButObjectNotFound, applyNotSupported, unknownFutureValue. Erforderlich.
applyDescription	Zeichenfolge	Falls angegeben, eine Beschreibung für die applyResult. Optional.
customDataProvidedResourceId	Zeichenfolge	Das applyResult wird für alle accessReviewInstanceDecisionItem-Objekte festgelegt, deren benutzerdefinierte Datenquelle id mit der bereitgestellten customDataProvidedResourceId übereinstimmt. Erforderlich.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/unified/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions
Content-Type: application/json

{
  "applyResult": "appliedSuccessfully",
  "applyDescription": "Access was removed from production application: GitHub-app.",
  "customDataProvidedResourceId": "5c728447-be5c-4565-b4d3-cb248b609891"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted