userConsentRequest リソースの種類

名前空間: microsoft.graph

ユーザーがアプリへのアクセスまたはアプリへのアクセス許可の付与を要求したときに作成する同意要求の詳細を表します。 詳細には、アクセスを要求するための正当な理由、要求の状態、および承認の詳細が含まれます。

ユーザーは、アプリまたはアクセス許可に管理者の承認が必要な場合、および 管理者の同意ワークフロー が有効になっている場合にのみ同意要求を作成できます。

メソッド

メソッド	戻り値の種類	説明
userConsentRequests を一覧表示する	userConsentRequest コレクション	appConsentRequest の userConsentRequest オブジェクトのコレクションを取得します。
userConsentRequest を取得する	userConsentRequest	userConsentRequest オブジェクトのプロパティとリレーションシップを読み取ります。
filterByCurrentUser	userConsentRequest コレクション	現在のユーザーがレビュー担当者である appConsentRequest の userConsentRequest オブジェクトのプロパティを読み取ります。

プロパティ

プロパティ	型	説明
approvalId	String	承認の ID。 この値は、 の値と id等しくなります。
CompletedDateTime	DateTimeOffset	要求の 状態 が として Completedマークされた日時。 日時情報は ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
createdBy	identitySet	要求を作成したユーザー。
createdDateTime	DateTimeOffset	要求が作成された日時。 日時情報は ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 (eq のみ) と を$orderbyサポートします$filter。
Customdata	String	ユーザー同意要求のカスタム データを定義するフリー テキスト フィールド。 不使用。
id	String	要求の識別子。
理由	String	アプリへのアクセスを要求するためのユーザーの正当な理由。 (eq のみ) と を$orderbyサポートします$filter。
status	String	ユーザーのアプリの同意要求の状態。 可能な値は、Initializing、InProgress、Expired、および Completed です。 (eq のみ) と を$orderbyサポートします$filter。

リレーションシップ

リレーションシップ	型	説明
承認	承認	要求に関連付けられた承認の決定。

JSON 表記

リソースの JSON 表記を次に示します。

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