更新電腦

適用於：

• 適用於端點的 Microsoft Defender 方案 1
• 適用於端點的 Microsoft Defender 方案 2
• Microsoft Defender XDR

想要體驗適用於端點的 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
• ina.api.security.microsoft.com

API 描述

更新現有 電腦的屬性。

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

限制

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

權限

呼叫此 API 需要下列其中一個許可權。 若要深入瞭解，包括如何選擇許可權，請參 閱使用適用於端點的 Defender Microsoft 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"
    ]
}

提示

想要深入了解? 在我們的技術社群中與Microsoft安全性社群互動：Microsoft適用於端點的Defender技術社群。