accessReviewInstance リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注:
これは、アクセス レビューに推奨される API です。 以前のバージョンの アクセス レビュー API は非推奨になりました。
Microsoft Entra アクセス レビュー の繰り返しを表します。 親 accessReviewScheduleDefinition が定期的なアクセス レビューである場合、インスタンスは各繰り返しを表します。 繰り返されないレビューには、インスタンスが正確に 1 つ存在します。 インスタンスは、スケジュール定義でレビューされる各一意のグループも表します。 スケジュール定義で複数のグループがレビューされる場合、各グループには、繰り返しごとに一意のインスタンスがあります。
すべての accessReviewInstance には、レビュー担当者がアクションを実行できる 決定 の一覧が含まれています。 確認される ID ごとに 1 つの決定があります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | accessReviewInstance コレクション | accessReviewInstance オブジェクトとそのプロパティの一覧を取得します。 |
| Get | accessReviewInstance | accessReviewInstance オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | accessReviewInstance | accessReviewInstance オブジェクトのレビュー担当者を更新します。 |
| 現在のユーザーでフィルター処理する | accessReviewInstance コレクション | 呼び出し元ユーザーが 1 つ以上の決定のレビュー担当者である特定の accessReviewScheduleDefinition のすべてのインスタンスを返します。 |
| 連絡を受けたレビュー担当者を一覧表示する | accessReviewReviewer コレクション | アクセス レビュー インスタンスの通知を受け取ったレビュー担当者を取得します。 |
| リマインダーを送信する | なし。 | accessReviewInstance のレビュー担当者にリマインダーを送信します。 |
| Stop | なし。 | accessReviewInstance を手動で停止します。 |
| 推奨事項を受け入れる | なし。 | 呼び出し元ユーザーが、特定の accessReviewInstance のレビュー担当者である NotReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。 |
| 意思決定を適用する | なし。 | accessReviewInstance に関する決定を手動で適用します。 |
| 適用の決定を停止する | なし。 | 呼び出し元のユーザーが特定の accessReviewInstance に対する適用決定アクションを停止できるようにします。 |
| バッチ レコードの決定 | なし | 1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。 |
| 意思決定をリセットする | なし | インスタンス上のすべてのデシジョン アイテムを notReviewedにリセットします。 |
| ステージを一覧表示する | accessReviewStage コレクション | マルチステージ アクセス レビュー インスタンスのステージを取得します。 |
| 決定を一覧表示する | accessReviewInstanceDecisionItem コレクション | 意思決定ナビゲーション プロパティから accessReviewInstanceDecisionItem リソースを取得します。 |
| 保留中のアクセス レビュー インスタンスを一覧表示する (非推奨) | accessReviewInstance コレクション。 | 保留中のすべての accessReviewInstance リソースを取得し、呼び出し元のユーザーに割り当てます。 このメソッドは非推奨になり、 filterByCurrentUser に置き換えられます。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| endDateTime | DateTimeOffset | レビュー インスタンスが終了するようにスケジュールされている DateTime。 DatetimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
$select をサポートしています。 読み取り専用です。 |
| エラー | accessReviewError コレクション | アクセス レビュー インスタンスのライフサイクルにおけるエラーの収集。 読み取り専用です。 |
| fallbackReviewers | accessReviewReviewerScope コレクション | このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者は、指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。
$select をサポートします。 |
| id | String | インスタンスの一意識別子。
$select をサポートしています。 読み取り専用です。 |
| scope | accessReviewScope | accessReviewScheduleDefinition レベルで スコープ と インスタンスEnumerationScope に基づいて作成されます。 グループ内でレビューされるユーザーのスコープを定義します。
$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のみ)。 読み取り専用です。 |
| レビュー | accessReviewReviewerScope コレクション | このアクセス レビュー スコープのコレクションは、レビュー担当者の定義に使用されます。
$select をサポートします。 レビュー担当者を割り当てるオプションの例については、「 Microsoft Graph API を使用してレビュー担当者をアクセス レビュー定義に割り当てる」を参照してください。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| contactedReviewers | accessReviewReviewer コレクション | このレビューを完了するために連絡を取ったレビュー担当者のコレクションを返します。
accessReviewScheduleDefinition のレビュー担当者とフォールバックReviewers プロパティでは、グループ所有者またはマネージャーをレビュー担当者として指定する場合があります。contactedReviewers は個々の ID を返します。
$select をサポートしています。 読み取り専用です。 |
| definition | accessReviewScheduleDefinition | 各インスタンスに関連付けられている accessReviewScheduleDefinition は 1 つだけです。 これはインスタンスの親スケジュールです。ここで、レビュー定義の繰り返しごとにインスタンスが作成され、定義によってレビューするために選択された各グループが作成されます。 |
| stages | accessReviewStage コレクション | インスタンスに複数のステージがある場合は、ステージのコレクションが返されます。 新しいステージは、前のステージが終了したときにのみ作成されます。 レビュー インスタンスのステージの存在、数、設定は、親 accessReviewScheduleDefinition の accessReviewStageSettings に基づいて作成されます。 |
| 決定 | accessReviewInstanceDecisionItem コレクション | accessReviewInstance でレビューされた各ユーザーには、承認、拒否、またはまだレビューされていないかどうかを表す決定項目があります。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.accessReviewInstance",
"id": "string (identifier)",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"scope": {
"@odata.type": "microsoft.graph.accessReviewScope"
},
"reviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"fallbackReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"contactedReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewer"
}
]
}