API 描述
限制
- 你可以根據設定的保留期限，在最後一次出現的裝置上發文。
- 此 API 的速率限制為每分鐘 100 次呼叫及每小時 1500 次呼叫。
權限
使用使用者憑證取得令牌時：
呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱「使用適用於端點的 Microsoft Defender APIS」
| 權限類型 | 權限 | 權限顯示名稱 |
|---|---|---|
| 應用程式 | 機器。讀取寫入。全部 | 「讀取並寫入所有機器資訊」 |
| 委託 (工作或學校帳戶) | Machine.ReadWrite | 「讀寫機器資訊」 |
HTTP 要求
POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue
要求標頭
| 名稱 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 持有人 {token}。 必要。 |
| Content-Type | 字串 | application/json。 必要。 |
要求內文
在請求主體中，提供一個包含以下參數的 JSON 物件：
| 參數 | Type | 描述 |
|---|---|---|
| 裝置值 | Enum | 裝置價值。 允許的數值為：「正常」、「低」和「高」。 必要。 |
回應
若成功，此方法會回傳 200 - Ok 回應代碼及回應實體更新後的機器。
範例
求
這裡有一個請求的範例，該請求會加入機器標籤。
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue
{
"DeviceValue" : "High"
}