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