名前空間: microsoft.graph
Microsoft Entra アクセス レビューの繰り返しを表します。 親の accessReviewScheduleDefinition が繰り返しアクセス レビューである場合、インスタンスは各繰り返しを表します。 繰り返しないレビューには、インスタンスが 1 つだけ含まれます。 また、インスタンスは、スケジュール定義でレビューされる各一意のグループも表します。 スケジュール定義が複数のグループを確認する場合、各グループには、繰り返しごとに一意のインスタンスが含まれます。
すべての accessReviewInstance には、レビュー担当者がアクションを実行できる 決定 のリストが含まれています。 確認対象の ID ごとに 1 つの決定があります。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | accessReviewInstance コレクション | accessReviewInstance オブジェクトとそのプロパティーのリストを取得します。 |
| Get | accessReviewInstance | accessReviewInstance オブジェクトのプロパティと関係を読み取ります。 |
| Update | accessReviewInstance | accessReviewInstance オブジェクトのレビュー担当者を更新します。 |
| 現在のユーザーでフィルター処理する | accessReviewInstance コレクション | 呼び出し元ユーザーが 1 つ以上の決定のレビュー担当者である特定の accessReviewScheduleDefinition のすべてのインスタンスを返します。 |
| 連絡を受けたレビュー担当者を一覧表示する | accessReviewReviewer コレクション | アクセス レビュー インスタンスの通知を受け取ったレビュー担当者を取得します。 |
| リマインダーを送信する | なし | accessReviewInstance のレビュー担当者にリマインダーを送信します。 |
| Stop | なし | accessReviewInstance を手動で停止します。 |
| 推奨事項を受け入れる | なし | 呼び出し元ユーザーが、NotReviewedとしてマークされ、呼び出し元が関連する accessReviewInstance のレビュー担当者である各 accessReviewInstanceDecisionItem に対する決定の推奨事項を受け入れることを許可します。 |
| 意思決定を適用する | なし | accessReviewInstance に決定を手動で適用します。 |
| バッチ レコードの決定 | なし | 1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。 |
| 意思決定をリセットする | なし | インスタンスのすべての決定項目を notReviewed にリセットします。 |
| ステージを一覧表示する | accessReviewStage コレクション | マルチステージ アクセス レビュー インスタンスでステージを取得します。 |
| 決定を一覧表示する | accessReviewInstanceDecisionItem コレクション | decisions navigation プロパティから accessReviewInstanceDecisionItem リソースを取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| endDateTime | DateTimeOffset | レビュー インスタンスの終了がスケジュールされている DateTime。DatetimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻になります。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
$select をサポートしています。 読み取り専用です。 |
| エラー | accessReviewError コレクション | アクセス レビュー インスタンスのライフサイクルにおけるエラーの収集。 読み取り専用です。 |
| fallbackReviewers | accessReviewReviewerScope コレクション | このレビュー担当者スコープのコレクションは、フォールバックレビュー担当者のリストを定義するために使用されます。 指定されたレビュー担当者のリストからユーザーが見つからない場合、これらのフォールバックレビュー担当者はアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているがグループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているがユーザーのマネージャーが存在しない場合に発生することがあります。
$select をサポートします。 |
| id | 文字列 | インスタンスの一意の識別子。
$select をサポートしています。 読み取り専用です。 |
| 校閲者 | accessReviewReviewerScope コレクション | このアクセス レビュー スコープのコレクションは、レビュー担当者を定義するために使用されます。
$select をサポートします。 レビュー担当者を割り当てるオプションの例については、「Microsoft Graph API を使用してアクセス レビュー定義にレビュー担当者を割り当てる」を参照してください。 |
| scope | accessReviewScope | accessReviewScheduleDefinition レベルでス コープ と instanceEnumerationScope に基づいて作成されます。 グループでレビューされるユーザーの範囲を定義します。
$select と $filter (contains のみ) をサポートします。 読み取り専用です。 |
| startDateTime | DateTimeOffset | レビュー インスタンスの開始がスケジュールされている DateTime。 将来かもしれません。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
$select をサポートしています。 読み取り専用です。 |
| status | String | accessReview のステータスを指定します。 使用可能な値: Initializing、 NotStarted、 Starting、 InProgress、 Completing、 Completed、 AutoReviewing、 AutoReviewed。
$select、$orderby、$filter (eq のみ) をサポートします。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| contactedReviewers | accessReviewReviewer コレクション | このレビューを完了するために連絡されたレビュー担当者のコレクションを返します。
accessReviewScheduleDefinition の reviewers プロパティと fallbackReviewers プロパティは、グループの所有者または管理者をレビュー担当者として指定できますが、contactedReviewers は個々の ID を返します。
$select をサポートしています。 読み取り専用です。 |
| 決定 | accessReviewInstanceDecisionItem コレクション | accessReviewInstance でレビューされる各ユーザーには、承認されたか、拒否されたか、まだレビューされていないかを表す決定項目があります。 |
| stages | accessReviewStage コレクション | インスタンスに複数のステージがある場合、ステージのコレクションが返されます。 新しいステージは、前のステージが終了した場合にのみ作成されます。 レビュー・インスタンス上のステージの存在、数、および設定は、親 accessReviewScheduleDefinition の accessReviewStageSettings に基づいて作成されます。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.accessReviewInstance",
"contactedReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewer"
}
],
"endDateTime": "string (timestamp)",
"errors": [
{
"@odata.type": "microsoft.graph.accessReviewError"
}
],
"fallbackReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"id": "string (identifier)",
"reviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"scope": {
"@odata.type": "microsoft.graph.accessReviewScope"
},
"startDateTime": "string (timestamp)",
"status": "string"
}