accessReviewHistoryInstance リソースの種類

名前空間: microsoft.graph

重要

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

accessReviewHistoryDefinition オブジェクトの繰り返しを表します。 繰り返さない履歴定義には、インスタンスが 1 つだけ含まれます。

すべての accessReviewHistoryInstance とそれに関連する accessReviewHistoryDefinition には、 プロパティ reviewHistoryPeriodStartDateTime、 reviewHistoryPeriodEndDateTime、 decisions、 scheduleSettings、およびスコープが含 まれます。 これらのプロパティは、定期的なスケジュール設定やレビュー データの選択時に使用され、変更できます。 各 accessReviewHistoryInstance オブジェクトとデータは、30 日間のみ使用できます。 accessReviewHistoryInstance 状態がリンクにdone移動されると、generateDownloadUri を呼び出してインスタンスのデータを取得できます。

メソッド

メソッド	戻り値の種類	説明
accessReviewHistoryInstances を一覧表示する	accessReviewHistoryInstance コレクション	accessReviewHistoryInstance オブジェクトとそのプロパティの一覧を取得します。
generateDownloadUri	accessReviewHistoryDefinition	インスタンスのレビュー履歴データを取得するために使用できる URI を生成します。

プロパティ

プロパティ	型	説明
downloadUri	String	レビュー履歴データを取得するために使用できる Uri。 この URI は、生成後 24 時間アクティブになります。 必須です。
expirationDateTime	DateTimeOffset	このインスタンスと関連付けられているデータの有効期限が切れ、履歴が削除されたときのタイムスタンプ。 必須です。
fulfilledDateTime	DateTimeOffset	このインスタンスで使用可能なすべてのデータが収集されたタイムスタンプ。 これは、このインスタンスの状態が done[ . 必須。
id	String	アクセス レビュー履歴インスタンスの割り当てられた一意の識別子。 読み取り専用です。 必須です。
reviewHistoryPeriodEndDateTime	DateTimeOffset	タイムスタンプ、この日付より前のレビューは、フェッチされた履歴データに含まれます。
reviewHistoryPeriodStartDateTime	DateTimeOffset	タイムスタンプ、この日付以降のレビューは、フェッチされた履歴データに含まれます。
runDateTime	DateTimeOffset	インスタンスの履歴データが生成されるようにスケジュールされたときのタイムスタンプ。
status	accessReviewHistoryStatus	レビュー履歴データ収集の状態を表します。 使用可能な値: done、inProgress、error、requested、unknownFutureValue。 状態 がマークdoneされたら、generateDownloadUri メソッドを呼び出してインスタンスのデータを取得するリンクを生成できます。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.accessReviewHistoryInstance",
  "id": "String (identifier)",
  "reviewHistoryPeriodStartDateTime": "String (timestamp)",
  "reviewHistoryPeriodEndDateTime": "String (timestamp)",
  "status": "String",
  "runDateTime": "String (timestamp)",
  "fulfilledDateTime": "String (timestamp)",
  "downloadUri": "String",
  "expirationDateTime": "String (timestamp)"
}