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 das Erteilen von Berechtigungen für eine App angibt. Die Details umfassen die Begründung für die Anforderung des Zugriffs, den 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
List	userConsentRequest-Sammlung	Ruft eine Auflistung von userConsentRequest-Objekten für eine appConsentRequest ab.
Get	userConsentRequest	Liest die 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 Bearbeiter 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 dem 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 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	Zeichenfolge	Freitextfeld zum Definieren von benutzerdefinierten Daten für die Anforderung der Benutzerzustimmung. 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. 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

Die folgende JSON-Darstellung zeigt 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"
}