userConsentRequest 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 Details der Zustimmungsanforderung dar, die ein Benutzer erstellt, wenn er den Zugriff auf eine App oder die Erteilung von Berechtigungen für eine App anfordert. Zu den Details gehören die Begründung für die Beantragung des Zugriffs, der Status der Anforderung und die Details zur Genehmigung.

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 userConsentRequest-Sammlung Rufen Sie eine Auflistung von userConsentRequest-Objekten für eine appConsentRequest ab.
Get userConsentRequest Lesen der Eigenschaften und Beziehungen eines userConsentRequest-Objekts .
Nach aktuellem Benutzer filtern userConsentRequest-Sammlung Lesen Sie die Eigenschaften von userConsentRequest-Objekten für eine appConsentRequest , für die der aktuelle Benutzer der Prüfer ist.

Eigenschaften

Eigenschaft Typ Beschreibung
approvalId Zeichenfolge Die ID der Genehmigung. Dieser Wert ist gleich dem Wert von .id
completedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Status der Anforderung als Completedmarkiert wurde. Die Datums- und Uhrzeitinformationen sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
createdBy identitySet Der Benutzer, der die Anforderung erstellt hat.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Anforderung erstellt wurde. Die Datums- und Uhrzeitinformationen sind im ISO 8601-Format dargestellt und werden immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Unterstützt $filter (eq nur) und $orderby.
customData Zeichenfolge Freitextfeld zum Definieren beliebiger benutzerdefinierter Daten für die Benutzereinwilligungsanfrage. Nicht verwendet.
id Zeichenfolge Bezeichner der Anforderung.
reason Zeichenfolge Die Begründung des Benutzers für die Anforderung des Zugriffs auf die App. Unterstützt $filter (eq nur) und $orderby.
status Zeichenfolge Der Status der App-Zustimmungsanforderung des Benutzers. Die möglichen Werte sind: Initializing, InProgress, Expiredund Completed. Unterstützt $filter (eq nur) und $orderby.

Beziehungen

Beziehung Typ Beschreibung
Genehmigung Genehmigung Genehmigungsentscheidungen, die einer Anforderung zugeordnet sind.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.userConsentRequest",
  "id": "String (identifier)",
  "status": "String",
  "completedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "approvalId": "String",
  "customData": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "reason": "String"
}
  • Last updated on