オフボード マシン API

適用対象:

• Microsoft Defender for Endpoint Plan 1
• Microsoft Defender for Endpoint
• Microsoft Defender XDR

Defender for Endpoint を試す場合は、 無料試用版にサインアップしてください。

API の説明

Defender for Endpoint からのオフボード デバイス。

制限事項

• この API のレート制限は、1 分あたり 100 呼び出しと 1 時間あたり 1,500 呼び出しです。

  注:

  このページでは、API を使用したマシン アクションの実行に焦点を当てます。 Microsoft Defender for Endpoint を使用 した応答アクション 機能の詳細については、「コンピューターで応答アクションを実行する」を参照してください。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「Defender for Endpoint API を使用する」を参照してください。

HTTP 要求

POST https://api.security.microsoft.com/api/machines/{id}/offboard

デバイスを選択すると、マシン ID が URL に表示されます。 一般に、URL に記載されている 40 桁の英数字です。

要求ヘッダー

要求本文

要求本文で、JSON オブジェクトに次のパラメーターを指定します。

応答

成功した場合、このメソッドは応答本文 200 - Created response コードと Machine Action を 返します。

例

要求

要求の例を次に示します。 JSON コメントが追加されていない場合は、コード 400でエラーが発生します。

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/offboard

{
  "Comment": "Offboard machine by automation"
}