取得machineAction API

發行項
08/14/2024

適用於：

想要體驗適用於端點的 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 描述

依標識符擷取特定機器動作。

限制

此 API 的速率限制為每分鐘 100 次呼叫，每小時 1500 次呼叫。

權限

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

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

注意事項

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

用戶必須至少有下列角色許可權：[檢視數據] (如需詳細資訊，請參閱建立和管理角色)

HTTP 要求

GET https://api.securitycenter.microsoft.com/api/machineactions/{id}

要求標頭

名稱	類型	描述
授權	字串	持有人 {token}。必要。

要求內文

Empty

回應

如果成功，此方法會傳回 200，[確定] 回應碼與 Machine Action 實體。如果找不到具有指定標識碼的機器動作實體 - 404 找不到。

範例

範例要求

以下是要求的範例。

GET https://api.securitycenter.microsoft.com/api/machineactions/2e9da30d-27f6-4208-81f2-9cd3d67893ba

回應範例

以下是回應的範例。

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}

提示

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

共用方式為