取得裝置安全分數Get device secure score

適用於:Applies to:

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

注意

如果您是美國政府客戶,請使用 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

為裝置檢索您的 Microsoft 安全分數Retrieves your Microsoft Secure Score for Devices. 針對裝置的 Microsoft 安全分數較高表示您的端點對 cybersecurity 威脅攻擊的彈性程度較高。A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.

權限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 AlllScore.Read.Alll 「讀取威脅和弱點管理得分」'Read Threat and Vulnerability Management score'
委派 (工作或學校帳戶) Delegated (work or school account) 讀取Score.Read 「讀取威脅和弱點管理得分」'Read Threat and Vulnerability Management score'

HTTP 要求HTTP request

GET /api/configurationScore

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

範例Example

請求Request

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

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

回應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#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

另請參閱See also