更新電腦

  • 適用於: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender for Business

API 描述

匯報現有機器的屬性。

可更新的屬性有： machineTags 和 deviceValue。

限制

  • 你可以更新 API 裡可用的機器。
  • 更新機器只會把標籤附加到標籤集合中。 若標籤存在，必須包含在正文中的標籤集合中。
  • 此 API 的速率限制為每分鐘 100 次呼叫及每小時 1500 次呼叫。

權限

使用使用者憑證取得令牌時：

  • 使用者至少需要以下角色權限：「警示調查」。 更多資訊請參見： 建立與管理角色。
  • 使用者必須根據裝置群組設定，能夠存取與警示相關的裝置。 欲了解更多資訊，請參閱： 建立與管理裝置群組。

呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱：使用 適用於端點的 Microsoft Defender 適用於端點的 Microsoft Defender APIS

權限類型 權限 權限顯示名稱
應用程式 機器。讀取寫入。全部 「為所有機器讀寫機器資訊」
委託 (工作或學校帳戶) Machine.ReadWrite 「讀寫機器資訊」

HTTP 要求

PATCH /api/machines/{machineId}

要求標頭

名稱 類型 描述
授權 字串 持有人 {token}。 必要。
Content-Type 字串 application/json。 必要。

要求內文

在請求主體中，提供應更新的相關欄位值。

未包含在請求主體中的現有屬性將維持先前的值，或根據其他屬性值的變動重新計算。

為了達到最佳效能，你不應該包含那些沒有改變的現有數值。

屬性 類型 描述
機器標籤 字串集合 一組 機器 標籤。
deviceValue 可空化列舉 裝置 的價值。 可能的數值有：「正常」、「低」和「高」。

回應

若成功，此方法會回傳 200 OK，並返回回應實體及其更新屬性。

如果機器標籤的集合內體中沒有現有的機器標籤——會將所有標籤替換為請求本體中提供的標籤。

如果找不到指定 ID 的機器，則 404 未找到。

範例

請求

以下是請求的範例。

PATCH https://api.security.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}
  • Last updated on