Freigeben über

Update adminConsentRequestPolicy

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren Sie die Eigenschaften eines adminConsentRequestPolicy-Objekts .

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 Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Policy.ReadWrite.ConsentRequest Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Policy.ReadWrite.ConsentRequest Directory.ReadWrite.All

Wichtig

Für den delegierten Zugriff mithilfe von 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 geringsten Berechtigungen bereitstellen:

  • Cloudanwendungsadministrator
  • Anwendungsadministrator

HTTP-Anforderung

PUT /policies/adminConsentRequestPolicy

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 des adminConsentRequestPolicy-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Aktualisieren von adminConsentRequestPolicy erforderlich sind.

Eigenschaft Typ Beschreibung
isEnabled Boolescher Wert Gibt an, ob das Feature zur Anforderung der Administratoreinwilligung aktiviert oder deaktiviert ist.
notifyReviewers Boolean Gibt an, ob Prüfer Benachrichtigungen erhalten.
remindersEnabled Boolean Gibt an, ob Prüfer Erinnerungs-E-Mails erhalten.
requestDurationInDays Int32 Gibt die Dauer an, für die die Anforderung aktiv ist, bevor sie automatisch abläuft, wenn keine Entscheidung angewendet wird.
Bewertungen accessReviewReviewerScope-Sammlung Die Liste der Prüfer für die Administratoreinwilligung.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No content zurückgegeben.

Beispiele

Anforderung

PUT https://graph.microsoft.com/beta/policies/adminConsentRequestPolicy 
Content-Type: application/json

{
  "isEnabled": true,
  "notifyReviewers": true,
  "remindersEnabled": true,
  "requestDurationInDays": 5,
  "reviewers": [
    {
      "query": "/users/b6879be8-fb87-4482-a72e-18445d2b5c54",
      "queryType": "MicrosoftGraph"
    },
    {
      "query": "/users/b3427cc5-bf69-4dcd-95f7-ed1eb432f5e9",
      "queryType": "MicrosoftGraph"
    }
  ]
}

Antwort

HTTP/1.1 204 No Content
Content-Type: text/plain
  • Last updated on