retentionEvent リソースの種類
名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
保持期間の開始が特定の種類のイベントが発生した場合に基づく、イベント ベースの保持ラベルのトリガーを表します。 詳細については、「 イベントが発生したときにリテンション期間を開始する」を参照してください。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| retentionEvent を一覧表示する | microsoft.graph.security.retentionEvent コレクション | retentionEvent オブジェクトとそのプロパティの一覧を取得します。 |
| retentionEvent を作成する | microsoft.graph.security.retentionEvent | 新しい retentionEvent オブジェクトを作成します。 |
| retentionEvent を取得する | microsoft.graph.security.retentionEvent | retentionEvent オブジェクトのプロパティとリレーションシップを読み取ります。 |
| retentionEvent を削除する | なし | retentionEvent オブジェクトを削除します。 |
| retentionEventType を一覧表示する | microsoft.graph.security.retentionEventType コレクション | exapnd eventType ナビゲーション プロパティから retentionEventType リソースを取得します。 |
| retentionEventType を作成する | microsoft.graph.security.retentionEventType | イベントの作成時に関連する odata プロパティを追加して eventType を追加します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| createdBy | microsoft.graph.identitySet | retentionEvent を作成したユーザー。 |
| createdDateTime | DateTimeOffset | retentionEvent が作成された日時。 |
| 説明 | String | イベントに関する省略可能な情報。 |
| displayName | String | イベントの名前。 |
| eventPropagationResults | microsoft.graph.security.eventPropagationResult コレクション | 作成されたイベントの成功状態と追加情報を表します。 |
| eventQueries | microsoft.graph.security.eventQuery コレクション | 保持イベントに関連付けられているワークロード (SharePoint Online、OneDrive for Business、Exchange Online) と識別情報を表します。 |
| eventStatus | microsoft.graph.security.retentionEventStatus | イベントが作成された後のスコープ付き場所へのイベントのプロポゲーションの状態。 |
| eventTriggerDateTime | DateTimeOffset | イベントをトリガーする必要がある省略可能な時刻。 |
| id | String | retentionEvent を作成したユーザーの一意の ID を表します。 エンティティ。 |
| lastModifiedBy | microsoft.graph.identitySet | retentionEvent を最後に変更したユーザー。 |
| lastModifiedDateTime | DateTimeOffset | retentionEvent が変更された最新の日付時刻。 |
| lastStatusUpdateDateTime | DateTimeOffset | イベントの状態が最後に更新された時刻。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| retentionEventType | microsoft.graph.security.retentionEventType | イベントの作成時にこのイベントの種類を使用するラベルの保持期間を開始するイベントを指定します。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.retentionEvent",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"eventQueries": [
{
"@odata.type": "microsoft.graph.security.eventQuery"
}
],
"eventTriggerDateTime": "String (timestamp)",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)",
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"eventPropagationResults": [
{
"@odata.type": "microsoft.graph.security.eventPropagationResult"
}
],
"eventStatus": {
"@odata.type": "microsoft.graph.security.retentionEventStatus"
},
"lastStatusUpdateDateTime": "String (timestamp)"
}