Updated March 27, 2024: 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 2023 (previously late February) and is expected to be complete by late April 2024 (previously mid-March).

[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:  

[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: 

• Microsoft Purview compliance portal for WW and GCC cloud environments 
• Microsoft Purview compliance portal for GCC-High cloud environments 
• Microsoft Purview compliance portal for DoD cloud environments 

Learn more: 

• Use the Microsoft Graph records management API 
• Create retention labels for exceptions 
• Start retention when an event occurs 

2024 年 3 月 27 日更新: 以下のロ`ルアウト タイムラインを更新しました。何卒ご理解のほどよろしくおいいたします。

C能のビジョンと Microsoft Graph の最初のリリ`スの一hとして、Microsoft Graph ベ`タh境に保持ラベル、イベント、およびイベントのN用の 3 つの新しい API を毪筏皮い蓼埂￥长欷椁 API を使用すると、これまでにu品にMみzんだものをカスタマイズおよびできます。

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

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

[これがいつ起こるか:]

ロ`ルアウトは 2023 年 3 月下旬 (以前は 2 月下旬) に_始され、2024 年 4 月下旬 (以前は 3 月中旬) までに完了する予定です。

[これがMに及ぼす影:]

Mで保持ラベルまたはイベントにvBする操作を自踊工氡匾龊悉稀PowerShell コマンドレットを使用する代わりに、新しい Graph API を使用してこれをgFすることをお幛幛筏蓼埂Graph では、よりれたセキュリティ、性、アプリJ^C能をサポ`トする REST API を使用します。

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

[浃吮匾胜长:]

叵

F在、これらの API は、Graph インタ`フェイスを介して管理される委任されたアクセスS可によってのみサポ`トされています。これらの API にアクセスするために必要な 2 つの新しいアクセスS可が毪丹欷皮い蓼埂

• レコ`ド管理.read.all
• レコ`ド管理.readwrite.all 

ライセンス

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

Microsoft Purview コンプライアンス ポ`タルでデ`タ ライフサイクル管理とレコ`ド管理の概要を_Jします。 

• WW および GCC クラウドh境 用の Microsoft Purview コンプライアンス ポ`タル
• GCC-High クラウドh境 用の Microsoft Purview コンプライアンス ポ`タル
• DoD クラウドh境 用の Microsoft Purview コンプライアンス ポ`タル

情螅 

• Microsoft Graph レコ`ド管理 API を使用する
• 例外 の保持ラベルを作成する
• イベントk生 rに保持を_始する