Pobierz wskaźnik bezpieczeństwa urządzenia

Artykuł
08/14/2024

Dotyczy:

Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto, aby skorzystać z bezpłatnej wersji próbnej.

Uwaga

Jeśli jesteś klientem rządowym USA, użyj identyfikatorów URI wymienionych w usłudze Microsoft Defender for Endpoint dla klientów rządowych USA.

Porada

Aby uzyskać lepszą wydajność, możesz użyć serwera bliżej lokalizacji geograficznej:

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

Pobiera wskaźnik bezpieczeństwa firmy Microsoft dla urządzeń. Wyższy wskaźnik bezpieczeństwa firmy Microsoft dla urządzeń oznacza, że punkty końcowe są bardziej odporne na ataki z powodu zagrożeń cybernetycznych.

Uprawnienia

Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień. Aby dowiedzieć się więcej, w tym jak wybrać uprawnienia, zobacz Używanie interfejsów API usługi Microsoft Defender dla punktów końcowych , aby uzyskać szczegółowe informacje.

Typ uprawnień	Uprawnienie	Nazwa wyświetlana uprawnień
Aplikacja	Score.Read.All	"Odczyt wskaźnika zarządzania zagrożeniami i lukami w zabezpieczeniach"
Delegowane (konto służbowe)	Score.Read	"Odczyt wskaźnika zarządzania zagrożeniami i lukami w zabezpieczeniach"

Żądanie HTTP

GET /api/configurationScore

Nagłówki żądań

Name (Nazwa)	Wpisać	Opis
Autoryzacja	Ciąg	Element nośny {token}. Wymagane.

Treść żądania

Pusty

Odpowiedź

Jeśli to się powiedzie, ta metoda zwróci wartość 200 OK z danymi oceny bezpieczeństwa urządzenia w treści odpowiedzi.

Przykład

Przykład żądania

Oto przykład żądania.

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

Przykład odpowiedzi

Oto przykład odpowiedzi.

Uwaga

Wyświetlona tutaj lista odpowiedzi może zostać obcięta w celu zachowania zwięzłości.

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

Zobacz też

Zapytania OData za pomocą usługi Microsoft Defender dla punktu końcowego