アラートを一覧表示する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
alert オブジェクトのリストを取得する。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | SecurityEvents.Read.All | SecurityEvents.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | SecurityEvents.Read.All | SecurityEvents.ReadWrite.All |
HTTP 要求
GET /security/alerts
GET /security/alerts?$top=1
GET /security/alerts?$filter={property} eq '{property-value}'
GET /security/alerts?$filter={property} eq '{property-value}'&$top=5
GET /security/alerts?$filter={property} eq '{property-value}'&{property} eq '{property-value}'
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするために次の OData クエリ パラメーターをサポートします:
$count$orderby$select$skip$top- 各セキュリティ API プロバイダーから集計された上位の結果を返します。$filter
各ベンダー名別の $filter キーワードを次の表に示します。 これらの製品の一部はブランド変更されていますが、API はまだ更新されていません。 フィルター キーワードは、さらなる通知がされるまで、従来の名前を引き続き使用します。 更新プログラムについては、changelog を参照してください。
| ベンダー名 | $filter キーワード |
|---|---|
| Microsoft Defender for Identity | Azure Advanced Threat Protection |
| Azure Security Center | ASC |
| Microsoft Defender for Cloud Apps | MCAS |
| Microsoft Entra ID 保護 | IPC |
| Microsoft Sentinel | Azure Sentinel |
| Microsoft Defender for Endpoint | Microsoft Defender ATP |
| Office 365 | 現在サポートされていません。 |
別のプロパティ セットを返すには、OData $select クエリ パラメーターを使用し、目的の alert プロパティのセットを指定します。 例えば、assignedTo、category、および severity プロパティを返すには、以下をクエリに追加します: $select=assignedTo,category,severity。
注:
$topOData クエリ パラメーターには、1000 件のアラートという制限があります。 最初の GET クエリには、$topのみ含め、$skipは含めないことをお勧めします。 改ページには@odata.nextLinkを使用することができます。$skipを使用する必要がある場合は、500 件のアラートという制限があります。 例えば、/security/alerts?$top=10&$skip=500は応答コード200 OKを返しますが、/security/alerts?$top=10&$skip=501は応答コード400 Bad Requestを返します。 詳細については、「Microsoft グラフ セキュリティ API のエラー応答」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {code}。 必須です。 |
要求本文
このメソッドには、要求本文を指定しません。 要求本文は無視されます。
応答
成功した場合、このメソッドは応答コード 200 OK と alert オブジェクトのコレクションを応答本文で返します。 プロバイダーから 2xx または 404 以外の状態コードが返されるか、プロバイダーがタイムアウトした場合、応答は、警告ヘッダー内のプロバイダーの応答と共に状態コード 206 Partial Content になります。 詳細については、「Microsoft グラフ セキュリティ API のエラー応答」を参照してください。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/security/alerts
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"activityGroupName": "activityGroupName-value",
"assignedTo": "assignedTo-value",
"azureSubscriptionId": "azureSubscriptionId-value",
"azureTenantId": "azureTenantId-value",
"category": "category-value",
"closedDateTime": "datetime-value"
}
]
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示