Uzyskaj wynik ekspozycji

Dotyczy:

Chcesz mieć dostęp do programu Microsoft Defender dla punktu końcowego? Zarejestruj się, aby korzystać z bezpłatnej wersji próbnej.

Uwaga

Jeśli jesteś klientem z instytucji rządowych Stanów Zjednoczonych, użyj URI wymienionych w programie Microsoft Defender for Endpoint dla klientów z instytucji rządowych Stanów Zjednoczonych.

Porada

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

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

Ważne

Niektóre informacje odnoszą się do wstępnie wypuszczonych produktów, które mogą zostać znacząco zmodyfikowane przed jego komercyjną premierą. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani dorozumianych, w odniesieniu do podanych tutaj informacji.

Pobiera ocenę ekspozycji organizacyjnej.

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 programu Microsoft Defender dla interfejsów API punktów końcowych.

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

Żądanie HTTP

GET /api/exposureScore

Żądaj nagłówków

Name (Nazwa) Wpisać Opis
Autoryzacja Ciąg Użytkownik {token}. Wymagane.

Treść wniosku

Puste

Odpowiedź

Jeśli ta metoda zwróci wartość 200 OK, z danymi na temat ekspozycji w treści odpowiedzi.

Przykład

Zażądaj

Oto przykład wniosku.

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

Odpowiedź

Oto przykład odpowiedzi.

Uwaga

Wyświetlana tutaj lista odpowiedzi może zostać obcięta w celu zwięzłego wypowiedzeń.

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

Zobacz też