Microsoft Graph レコード管理 API を使用する

重要

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

Microsoft Purview レコード管理 API は、組織が法的義務とコンプライアンス規制を満たすためにデータの保持と削除を管理するのに役立ち、保持する必要がなくなったアイテムの定期的な処理を有効にすることで効率を高めます。

レコード管理ソリューションは、Microsoft Purview コンプライアンス センターの一部です。

保持ラベルを管理する

多くの組織は、業界の規制や内部ポリシーに準拠し、訴訟やセキュリティ違反のリスクを軽減し、従業員が現在および関連する知識を効果的かつ機敏に共有できるように、データを管理する必要があります。 通常、データの管理には、さまざまな種類のコンテンツを適切に保持または削除する必要があります。

保持ラベルを使用して、Microsoft 365 コンテンツの保持と削除の設定を構成できます。 たとえば、コンテンツにラベルが付けられたときからの保持期間を設定し、保持期間の終了時に処理レビューをアクションとして設定できます。

さらに、ファイル プラン記述子を使用して保持ラベルを補完し、Microsoft 365 コンテンツの管理性とorganizationを向上させることができます。 ファイル 計画記述子の例としては、 機関、 引用、 部署などがあります。

既存のラベルのイベントをトリガーする

一部のシナリオでは、従業員がorganizationを離れる、契約の期限切れ、会計年度が終了するなど、特定のイベントで特定のドキュメントの保持期間を開始する必要があります。

retentionLabel リソースを使用すると、retentionTrigger プロパティを としてdateOfEvent設定し、ラベルを retentionEventType リソースに関連付けることによって、イベント ベースのリテンション期間をサポートできます。 retentionEvent も retentionEventType に関連付けられています。 トリガー イベントが発生すると、その保持ラベルが適用されたコンテンツのみが、指定された保持期間に保持されます。

たとえば、organizationでは、従業員が退職すると、雇用記録を 5 年間保持する必要があります。 retentionLabel API と retentionEvent API を使用して、従業員の開始時に各従業員レコードに対して次の操作を行います。

1. 次のように構成された retentionLabel を 適用します。
   • "人事情報" の表示名
   • retentionDuration of 1827 days (5 年)
   • "Employee departure" という名前の retentionEventType のリッスン
2. "Employee departure" という名前の同じ retentionEventType を使用し、eventQuery コレクションの一部として、Asset IDイベントに関連付けられた ID 情報として従業員 ID 値を持つ retentionEvent を定義します。

ID が 1234 の従業員が Contoso を退職すると、人事管理システムで情報が更新されます。 従業員の出発は、"Employee departure" イベントの種類を持つ retentionEvent の新しいインスタンスをトリガーし、 eventQueries プロパティの一部として、クエリ文字列が "AssetID:1234" の eventQuery をトリガーできます。 これにより、"人事情報" 保持ラベルを使用し、従業員 ID 1234 に関連付けられている従業員レコードアイテムは、従業員出発イベントの日付から開始された 5 年間の保持期間を取得します。

Entities

レコード管理 API には、次の主要なエンティティが含まれています。

名前	型	ユースケース
Label	microsoft.graph.security.retentionLabel	期間の終了時にアイテムに適用できる保持設定とアクションが含まれます。
ファイル計画記述子	microsoft.graph.securty.fileplandescriptor	保持ラベルを補完し、organizationの管理性を向上させるためのオプション記述子のセットを表します。
保持イベント	microsoft.graph.security.retentionEvent	イベントが発生した後にリテンション期間が開始される、イベント ベースのリテンション期間のトリガーを表します。
保持イベントの種類	microsoft.graph.security.retentionEventType	同じ種類の保持イベントの 1 つのグループを表します。