取得裝置安全分數

發行項
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

擷取您 Microsoft裝置的安全分數。更高的適用於裝置的 Microsoft 安全分數表示您的端點更能抵禦網路安全性威脅攻擊。

權限

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

許可權類型	權限	許可權顯示名稱
應用程式	Score.Read.All	「讀取威脅和弱點管理分數」
委派 (公司或學校帳戶)	Score.Read	「讀取威脅和弱點管理分數」

HTTP 要求

GET /api/configurationScore

要求標頭

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

要求內文

Empty

回應

如果成功，此方法會傳回 200 OK，並在響應主體中包含裝置安全分數數據。

範例

要求範例

以下是要求的範例。

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

回應範例

以下是回應的範例。

注意事項

為了簡潔起見，此處顯示的回應清單可能會被截斷。

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

另請參閱

使用適用於端點的 Microsoft Defender 進行 OData 查詢

提示

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

共用方式為