SHD / MC Checker

MC515536 | (Updated) Microsoft Purview | Data Lifecycle Management and Records Management – Microsoft Graph APIs for extensibility



MC515536 | (Updated) Microsoft Purview | Data Lifecycle Management and Records Management – Microsoft Graph APIs for extensibility

Classification stayInformed
Last Updated 03/09/2023 20:16:40
Start Time 02/15/2023 03:46:03
End Time 05/03/2023 07:00:00
Message Content

Updated March 9, 2023: We have updated the rollout timeline below. Thank you for your patience.

As a part of our extensibility vision and first release to Microsoft Graph, we are introducing three new APIs for retention labels, events, and event types in the Microsoft Graph beta environment. These APIs will enable you to customize and extend on what we have built in the product so far.

These APIs can be used by compliance admins and developers to manage retention labels in Data Lifecycle and Records Management solutions.  

This message is associated with Microsoft 365 Roadmap ID 88276

[When this will happen:]

Rollout will begin in late March (previously late February) and is expected to be complete by end of April.

[How this will affect your organization:]

If your organization needs to automate any operation related to retention labels or events, we recommend you achieve this by using the new Graph APIs instead of using PowerShell cmdlets. With Graph, we use REST APIs that support better security, extensibility, and app authentication features.

The three APIs are available under the security node and the endpoints to access them are as follows:  

Entity name Endpoints Solution
Labels security/labels/retentionLabels Data Lifecycle, Records Management
Events security/triggers/retentionEvents Records Management
Event types security/triggerTypes/retentionEventTypes Records Management

[What you need to do to prepare:]

Permissions

Currently, these APIs are supported through delegated permissions only, which are managed through the Graph interface. We are introducing two new permissions which you will need to access these APIs:

  • recordsmanagement.read.all
  • recordsmanagement.readwrite.all 

Licensing

Access to Data Lifecycle Management and Records Management features varies based on your Microsoft 365 license level. See Microsoft 365 guidance for security & compliance – Service Descriptions for licensing requirement details. 

Get started with Data Lifecycle Management and Records Management in the Microsoft Purview compliance portal: 

Learn more: 

Machine Translation

2023 年 3 月 9 日更新: 以下のロールアウトのタイムラインを更新しました。お待ちいただきありがとうございます。

拡張性のビジョンと Microsoft Graph への最初のリリースの一環として、Microsoft Graph ベータ環境で保持ラベル、イベント、イベントの種類に関する 3 つの新しい API を導入します。これらの API を使用すると、これまでに製品に組み込んだ内容をカスタマイズして拡張できます。

これらの API は、コンプライアンス管理者と開発者がデータ ライフサイクルおよびレコード管理ソリューションで保持ラベルを管理するために使用できます。  

このメッセージは、Microsoft 365 ロードマップ ID 88276 に関連付けられています。

[これが起こるとき:]

ロールアウトは3月下旬(以前は2月下旬)に開始され、4月末までに完了する予定です。

[これが組織に与える影響:]

組織で保持ラベルまたはイベントに関連する操作を自動化する必要がある場合は、PowerShell コマンドレットを使用する代わりに、新しい Graph API を使用してこれを実現することをお勧めします。グラフでは、より優れたセキュリティ、拡張性、アプリ認証機能をサポートする REST API を使用します。

3 つの API はセキュリティ ノードで使用でき、それらにアクセスするエンドポイントは次のとおりです。  

エンティティ名 エンドポイント 解決
ラベル セキュリティ/ラベル/保持ラベル データライフサイクル、レコード管理
イベント セキュリティ/トリガー/保持イベント レコード管理
イベント・タイプ セキュリティ/トリガータイプ/保持イベントタイプ レコード管理

[準備するために必要なこと:]

権限

現在、これらの API は、Graph インターフェイスを介して管理される委任されたアクセス許可によってのみサポートされています。これらの API にアクセスするために必要な 2 つの新しいアクセス許可が導入されます。

  • レコード管理.read.all
  • recordsmanagement.readwrite.all 

ライセンス

データ ライフサイクル管理とレコード管理機能へのアクセスは、Microsoft 365 ライセンス レベルによって異なります。ライセンス要件の詳細については 、「セキュリティとコンプライアンスに関する Microsoft 365 ガイダンス – サービスの説明」を参照してください 。 

Microsoft Purview コンプライアンス ポータルでデータ ライフサイクル管理とレコード管理の使用を開始します。 

詳細情報: