更新電腦

  • 發行項

適用於：

想要體驗適用於端點的 Microsoft Defender 嗎？ 注册免費試用版。

注意事項

如果您是美國政府客戶，請使用美國政府客戶 適用於端點的 Microsoft Defender 中所列的 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

API 描述

匯報 現有計算機的屬性。

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

限制

  1. 您可以更新 API 中可用的機器。
  2. 更新計算機只會將標籤附加至標籤集合。 如果標籤存在，它們必須包含在本文的 tags 集合中。
  3. 此 API 的速率限制為每分鐘 100 次呼叫，每小時 1500 次呼叫。

權限

呼叫此 API 需要下列其中一個許可權。 若要深入瞭解，包括如何選擇許可權，請參閱使用 適用於端點的 Microsoft Defender API

許可權類型 權限 許可權顯示名稱
應用程式 Machine.ReadWrite.All 「讀取和寫入所有機器的機器資訊」
委派 (公司或學校帳戶) Machine.ReadWrite 「讀取和寫入機器資訊」

注意事項

使用使用者認證取得權杖時：

適用於端點的Defender方案1和方案2支援裝置群組建立。

HTTP 要求

PATCH /api/machines/{machineId}

要求標頭

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

要求內文

在要求本文中，提供應更新之相關欄位的值。

未包含在要求本文中的現有屬性會維護其先前的值，或根據其他屬性值的變更重新計算。

為了達到最佳效能，您不應該包含尚未變更的現有值。

屬性 類型 描述
machineTags 字串集合 一組 機器 標記。
deviceValue 可為 Null 的列舉 裝置的值。 可能的值為：『Normal』、『Low』 和 『High』。

回應

如果成功，這個方法會傳回 200 OK，且響應主體中的 機器 實體會具有更新的屬性。

如果本文中的機器標籤集合不包含現有的電腦標記， 會將所有標記取代為要求本文中提供的標籤。

如果找不到具有指定標識碼的機器 - 404 找不到。

範例

請求

以下是要求的範例。

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

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

提示

想要深入了解? Engage 技術社群中的 Microsoft 安全性社群：適用於端點的 Microsoft Defender 技術社群。