IP 統計 API の取得Get IP statistics API

• 2021/03/25
• • m

適用対象:Applies to:

• Microsoft Defender for EndpointMicrosoft Defender for Endpoint
• Microsoft 365 DefenderMicrosoft 365 Defender

Defender for Endpoint を体験してみませんか?Want to experience Defender for Endpoint? 無料試用版にサインアップします。Sign up for a free trial.

API の説明API description

指定した IP の統計情報を取得します。Retrieves the statistics for the given IP.

制限事項Limitations

1. この API のレート制限は、1 分あたり 100 回の呼び出しと 1 時間あたり 1500 回の呼び出しです。Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。One of the following permissions is required to call this API. アクセス許可の選択方法など、詳細については 、「Use Microsoft Defender for Endpoint API」を参照してください。To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs

HTTP 要求HTTP request

GET /api/ips/{ip}/stats

要求ヘッダーRequest headers

要求 URI パラメーターRequest URI parameters

要求本文Request body

EmptyEmpty

応答Response

成功した場合と ip が存在する場合 - 200 OK 本文の統計データを使用します。If successful and ip exists - 200 OK with statistical data in the body. IP が存在しない - 404 が見つかりません。IP do not exist - 404 Not Found.

例Example

要求Request

以下は、要求の例です。Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48

応答Response

以下は、応答の例です。Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgIPStats",
    "ipAddress": "10.209.67.177",
    "orgPrevalence": "63515",
    "orgFirstSeen": "2017-07-30T13:36:06Z",
    "orgLastSeen": "2017-08-29T13:32:59Z"
}