Share via


userConsentRequest-Ressourcentyp

Namespace: microsoft.graph

Stellt die Details der Zustimmungsanforderung dar, die ein Benutzer erstellt, wenn er den Zugriff auf eine App oder das Erteilen von Berechtigungen für eine App angibt. Die Details umfassen die Begründung für die Anforderung des Zugriffs, die status der Anforderung und die Genehmigungsdetails.

Der Benutzer kann eine Zustimmungsanforderung erstellen, wenn eine App oder eine Berechtigung eine Administratorautorisierung erfordert und nur dann, wenn der Workflow für die Administratoreinwilligung aktiviert ist.

Methoden

Methode Rückgabetyp Beschreibung
Auflisten von userConsentRequests userConsentRequest-Sammlung Ruft eine Auflistung von userConsentRequest-Objekten für eine appConsentRequest ab.
UserConsentRequest abrufen userConsentRequest Liest die Eigenschaften und Beziehungen eines userConsentRequest-Objekts .
filterByCurrentUser userConsentRequest-Sammlung Lesen sie die Eigenschaften von userConsentRequest-Objekten für eine appConsentRequest , für die der aktuelle Benutzer der Bearbeiter ist.

Eigenschaften

Eigenschaft Typ Beschreibung
approvalId String Die ID der Genehmigung. Dieser Wert ist gleich dem Wert von id.
completedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu dem die 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 der Erstellung der Anforderung. 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 String Freitextfeld zum Definieren von benutzerdefinierten Daten für die Anforderung der Benutzerzustimmung. Nicht verwendet.
id String Bezeichner der Anforderung.
reason String Die Begründung des Benutzers für die Anforderung des Zugriffs auf die App. Unterstützt $filter (eq nur) und $orderby.
status String Die status der App-Zustimmungsanforderung des Benutzers. Mögliche Werte sind: Initializing, InProgress, Expired, und Completed. Unterstützt $filter (eq nur) und $orderby.

Beziehungen

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

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@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"
}