appConsentRequest Ressourcentyp

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.

Stellt die Anforderung dar, die ein Benutzer erstellt, wenn er den Mandantenadministrator um Zustimmung zum Zugriff auf eine App oder zum Erteilen von Berechtigungen für eine App bittet. Zu den Details gehören die App, auf die der Benutzer Zugriff in seinem Namen gewähren möchte, und die Berechtigungen, die der Benutzer anfordert.

Der Benutzer kann eine Zustimmungsanforderung erstellen, wenn für eine App oder eine Berechtigung eine Administratorberechtigung erforderlich ist und nur dann, wenn der Workflow für die Administratorzustimmung aktiviert ist.

Methoden

Methode Rückgabetyp Beschreibung
List appConsentRequest-Sammlung Ruft eine Auflistung von appConsentRequest-Objekten und deren Eigenschaften ab.
Get appConsentRequest Lesen der Eigenschaften und Beziehungen eines appConsentRequest-Objekts .
Nach aktuellem Benutzer filtern appConsentRequest Lesen Sie die Eigenschaften von appConsentRequest-Objekten, für die der aktuelle Benutzer der Prüfer ist und der Status der Benutzereinwilligungsanforderung lautetInProgress.

Eigenschaften

Eigenschaft Typ Beschreibung
appDisplayName Zeichenfolge Der Anzeigename der App, für die die Zustimmung angefordert wird. Erforderlich. Unterstützt $filter (eq nur) und $orderby.
appId Zeichenfolge Der Bezeichner der Anwendung. Erforderlich. Unterstützt $filter (eq nur) und $orderby.
consentType Zeichenfolge Der Zustimmungstyp der Anforderung. Die möglichen Werte sind: Static und Dynamic. Diese stellen statische bzw. dynamische Berechtigungen dar, die im Zustimmungsworkflow angefordert werden. Unterstützt $filter (eq nur) und $orderby. Erforderlich.
id Zeichenfolge Der Bezeichner der App-Zustimmungsanforderung. Erforderlich.
pendingScopes appConsentRequestScope-Sammlung Eine Liste mit ausstehenden Bereichen, die auf die Genehmigung warten. Dieser Wert ist leer, wenn consentType den Wert von Static. Erforderlich.

Beziehungen

Beziehung Typ Beschreibung
userConsentRequests userConsentRequest-Sammlung Eine Liste ausstehender Benutzereinwilligungsanfragen. Unterstützt $filter (eq).

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.appConsentRequest",
  "id": "String (identifier)",
  "appId": "String",
  "appDisplayName": "String",
  "consentType": "String",
  "pendingScopes": [
    {
      "@odata.type": "microsoft.graph.appConsentRequestScope"
    }
  ]
}