取得暴險分數Get exposure score

適用於:Applies to:

想要體驗適用於端點的 Microsoft Defender 嗎?Want to experience Microsoft 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 the organizational exposure score.

權限Permissions

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

許可權類型Permission type 權限Permission 許可權顯示名稱Permission display name
應用程式Application Read。所有Score.Read.All 「讀取威脅和弱點管理得分」'Read Threat and Vulnerability Management score'
委派 (工作或學校帳戶) Delegated (work or school account) 讀取Score.Read 「讀取威脅和弱點管理得分」'Read Threat and Vulnerability Management score'

HTTP 要求HTTP request

GET /api/exposureScore

要求標頭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 exposure data in the response body.

範例Example

請求Request

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

GET https://api.securitycenter.microsoft.com/api/exposureScore

回應Response

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

注意

在這裡顯示的回應清單可能會因簡潔而截斷。The response list shown here may be truncated for brevity.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ExposureScore/$entity",
    "time": "2019-12-03T07:23:53.280499Z",
    "score": 33.491554051195706
}

另請參閱See also