注意事項
如果您是美國政府客戶,請使用適用於美國政府的適用於端點的 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
- aea.api.security.microsoft.com
重要事項
本文中的部分資訊與發行前版本產品有關,在產品正式發行前可能會大幅度修改。 Microsoft 對此處提供的資訊,不提供任何明確或隱含的瑕疵擔保。
依其識別碼擷取安全性建議。
權限
需要下列其中一個權限才能呼叫此 API。 若要深入瞭解,包括如何選擇許可權,請參閱 使用適用於端點的 Microsoft Defender API 以取得詳細資料。
| 權限類型 | 權限 | 權限顯示名稱 |
|---|---|---|
| 應用程式 | SecurityRecommendation.Read.全部 | 「閱讀威脅和弱點管理安全性建議資訊」 |
| 委派 (公司或學校帳戶) | SecurityRecommendation.Read | 「閱讀威脅和弱點管理安全性建議資訊」 |
HTTP 要求
GET /api/recommendations/{id}
要求標頭
| 名稱 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 持有者 {token}。 必要。 |
要求內文
Empty
回應
如果成功,這個方法會傳回 200 OK,其中包含本文中的安全性建議。
範例
請求範例
以下是請求的範例。
GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome
回應範例
以下是回應的範例。
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
"id": "va-_-google-_-chrome",
"productName": "chrome",
"recommendationName": "Update Chrome",
"weaknesses": 38,
"vendor": "google",
"recommendedVersion": "",
"recommendationCategory": "Application",
"subCategory": "",
"severityScore": 0,
"publicExploit": false,
"activeAlert": false,
"associatedThreats": [],
"remediationType": "Update",
"status": "Active",
"configScoreImpact": 0,
"exposureImpact": 3.9441860465116285,
"totalMachineCount": 6,
"exposedMachinesCount": 5,
"nonProductivityImpactedAssets": 0,
"relatedComponent": "Chrome",
"tags": [
"internetFacing"
],
"exposedCriticalDevices": 116
}
相關主題
提示
想要深入了解? 在我們的技術社區中與Microsoft安全社區Engage:適用於端點的 Microsoft Defender技術社區。