userConsentRequest リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

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

メソッド

メソッド 戻り値の種類 説明
List userConsentRequest コレクション appConsentRequest の userConsentRequest オブジェクトのコレクションを取得します。
Get userConsentRequest userConsentRequest オブジェクトのプロパティとリレーションシップを読み取ります。
現在のユーザーでフィルター処理する userConsentRequest コレクション 現在のユーザーがレビューアーになっている appConsentRequest の userConsentRequest オブジェクトのプロパティを読み取ります。

プロパティ

プロパティ 型 説明
approvalId 文字列 承認の 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 です。 $filter (eq のみ) と$orderbyをサポートします。
customData 文字列 ユーザー同意要求のカスタム データを定義する自由テキスト フィールド。 不使用。
id 文字列 要求の識別子。
理由 文字列 アプリへのアクセスを要求するユーザーの正当化。 $filter (eq のみ) と$orderbyをサポートします。
status String ユーザーのアプリの同意要求の状態。 有効な値は、 Initializing、 InProgress、 Expired、および Completed です。 $filter (eq のみ) と$orderbyをサポートします。

リレーションシップ

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

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