取得軟體的建議Get recommendation by software

適用于: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

想要體驗 Defender for Endpoint?Want to experience Defender for Endpoint? 注册免費試用版。Sign up for a free trial.

注意

如果您是美國政府客戶,請使用 Microsoft Defender FOR Us 政府客戶的端點中所列的 URIs。If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

提示

為了提高效能,您可以使用伺服器以接近地理位置:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

重要

部分資訊與發行前版本產品有關,在正式發行之前可能會實質上進行修改。Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft 對此處提供的資訊,不提供任何明確或隱含的瑕疵擔保。Microsoft makes no warranties, express or implied, with respect to the information provided here.

會檢索與特定軟體相關的安全性建議。Retrieves a security recommendation related to a specific software.

權限Permissions

需要有下列其中一個許可權才能呼叫此 API。One of the following permissions is required to call this API. 若要深入瞭解,包括如何選擇許可權,請參閱 使用 Microsoft Defender For Endpoint APIs 以取得詳細資訊。To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

許可權類型Permission type 權限Permission 許可權顯示名稱Permission display name
應用程式Application SecurityRecommendation Read。 AllSecurityRecommendation.Read.All 「讀取威脅及弱點管理安全性建議資訊」'Read Threat and Vulnerability Management security recommendation information'
委派 (工作或學校帳戶) Delegated (work or school account) SecurityRecommendation 讀取SecurityRecommendation.Read 「讀取威脅及弱點管理安全性建議資訊」'Read Threat and Vulnerability Management security recommendation information'

HTTP 要求HTTP request

GET /api/recommendations/{id}/software

要求標頭Request headers

名稱Name 類型Type 描述Description
授權Authorization 字串String 載荷 {token}。Bearer {token}. 必要欄位Required.

要求正文Request body

空白Empty

回應Response

若成功,這個方法會傳回 200 OK,與本文中的安全性建議相關聯的軟體。If successful, this method returns 200 OK with the software associated with the security recommendations in the body.

範例Example

請求Request

以下是要求的範例。Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome/software 

回應Response

以下是回應的範例。Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Analytics.Contracts.PublicAPI.PublicProductDto",
    "id": "google-_-chrome",
    "name": "chrome",
    "vendor": "google",
    "weaknesses": 38,
    "publicExploit": false,
    "activeAlert": false,
    "exposedMachines": 5,
    "impactScore": 3.94418621
}