unifiedRoleManagementAlert リソースの種類

名前空間: microsoft.graph

重要

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

Microsoft Entra ロールのPrivileged Identity Management (PIM) のセキュリティ アラートの詳細を表します。 アラート情報には、テナント内の関連するアラート 定義、 構成、 インシデント コレクションが含まれます。

Microsoft Entra ロールに対する PIM の各セキュリティ アラートは、「Microsoft Entra ロールのセキュリティ アラートを取得する」で説明されている種類のいずれかです。 インシデント関係を使用して、アラートの実際のインシデントの詳細を一覧表示できます。 アラートとその関連インシデントは常に同じ種類です。 たとえば、テナント内のグローバル管理者が多すぎることを示すアラートは、型 tooManyGlobalAdminsAssignedToTenantAlertIncident のインシデントに関連します。

エンティティ から継承します。

PIM API を使用したMicrosoft Entraロールのセキュリティ アラートの操作の詳細については、「Microsoft Graph の PIM API を使用してMicrosoft Entraロールのセキュリティ アラートを管理する」を参照してください。

メソッド

メソッド	戻り値の種類	説明
アラートの一覧表示	unifiedRoleManagementAlert コレクション	unifiedRoleManagementAlert オブジェクトとそのプロパティの一覧を取得します。
unifiedRoleManagementAlert を取得する	unifiedRoleManagementAlert	unifiedRoleManagementAlert オブジェクトのプロパティとリレーションシップを読み取ります。
unifiedRoleManagementAlert を更新する	unifiedRoleManagementAlert	unifiedRoleManagementAlert オブジェクトのプロパティを更新します。
更新	なし	Microsoft Entra ロールのPrivileged Identity Management (PIM) に関するすべてのアラートまたは単一のアラートに関するインシデントを更新します。

プロパティ

プロパティ	型	説明
alertDefinitionId	String	アラート定義の識別子。 $filter (eq、ne) をサポートします。
id	String	アラート構成の識別子。 エンティティから継承 されます。
incidentCount	Int32	テナントでトリガーされ、アラートに関連するインシデントの数。 正の整数のみを指定できます。
isActive	ブール型	false 既定では。 true アラートがアクティブな場合。
lastModifiedDateTime	DateTimeOffset	アラート構成が更新された日時、または新しいインシデントが生成された日時。
lastScannedDateTime	DateTimeOffset	このアラートをトリガーするインシデントについてテナントが最後にスキャンされた日時。
scopeId	String	アラートが関連するスコープの識別子。 / は、テナントでサポートされている唯一のです。 $filter (eq、ne) をサポートします。
scopeType	String	アラートが作成されるスコープの種類。 DirectoryRoleは、Microsoft Entra ロールに対して現在サポートされている唯一のスコープの種類です。

リレーションシップ

リレーションシップ	型	説明
alertConfiguration	unifiedRoleManagementAlertConfiguration	Microsoft Entra ロールの PIM でのアラートの構成。 アラート構成は事前に定義されており、作成または削除することはできませんが、一部の構成は変更できます。 $filterisEnabled プロパティと $expandをサポートします。
alertDefinition	unifiedRoleManagementAlertDefinition	テナントでセキュリティ アラートがトリガーされないようにするための説明、影響、対策が含まれています。 $expand をサポートします。
alertIncidents	unifiedRoleManagementAlertIncident コレクション	テナント内のMicrosoft Entraロールに対してPrivileged Identity Management (PIM) でトリガーされた、この種類のアラートのインシデントを表します。 $expand をサポートします。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.unifiedRoleManagementAlert",
  "id": "String (identifier)",
  "alertDefinitionId": "String",
  "scopeId": "String",
  "scopeType": "String",
  "incidentCount": "Integer",
  "isActive": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "lastScannedDateTime": "String (timestamp)"
}

関連コンテンツ

• Microsoft Graph の PIM API を使用して、Microsoft Entraロールのセキュリティ アラートを管理します。