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