ソフトウェア インベントリ API の一覧表示
適用対象:
Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。
注意
米国政府機関のお客様は、 Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してください。
ヒント
パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
組織のソフトウェア インベントリを取得します。
OData V4 クエリをサポートします。
OData でサポートされている演算子:
$filter
on: id
、 name
、および vendor
プロパティ。
$top
最大値が 10,000 です。
$skip
.
Microsoft Defender for Endpoint を使用した OData クエリの例を参照してください。
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「エンドポイント API に Microsoft Defender を使用する」を参照してください。
アクセス許可の種類 | アクセス許可 | アクセス許可の表示名 |
---|---|---|
アプリケーション | Software.Read.All | '脅威と脆弱性管理ソフトウェア情報の読み取り' |
委任 (職場または学校のアカウント) | Software.Read | '脅威と脆弱性管理ソフトウェア情報の読み取り' |
GET /api/Software
名前 | 型 | 説明 |
---|---|---|
Authorization | String | ベアラー {token}。 必須。 |
Empty
成功した場合、このメソッドは本文のソフトウェア インベントリで 200 OK を返します。
以下は、要求の例です。
GET https://api.security.microsoft.com/api/Software
以下は、応答の例です。
{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
"value": [
{
"id": "microsoft-_-edge",
"name": "edge",
"vendor": "microsoft",
"weaknesses": 467,
"publicExploit": true,
"activeAlert": false,
"exposedMachines": 172,
"impactScore": 2.39947438
}
...
]
}
ヒント
さらに多くの情報を得るには、 Tech Community 内の Microsoft Security コミュニティ (Microsoft Defender for Endpoint Tech Community) にご参加ください。