userConsentRequest リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

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

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

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

メソッド

メソッド 戻り値の種類 説明
List userConsentRequest コレクション appConsentRequest の userConsentRequest オブジェクトのコレクションを取得します。
Get userConsentRequest userConsentRequest オブジェクトのプロパティとリレーションシップを読み取ります。
現在のユーザーでフィルター処理する 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 です。 $filter (eq のみ) と$orderbyをサポートします。
customData String ユーザー同意要求のカスタム データを定義するフリー テキスト フィールド。 不使用。
id String 要求の識別子。
理由 String アプリへのアクセスを要求するためのユーザーの正当な理由。 $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"
}