名前空間: 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"
}