Assets - Get Delta Details

Usługa:

Defender EASM (preview)

Wersja interfejsu API:

2024-10-01-preview

Pobierz listę różnic dla podanego zakresu czasu.

POST {endpoint}/assets:getDeltaDetails?api-version=2024-10-01-preview

Z parametrami opcjonalnymi:

POST {endpoint}/assets:getDeltaDetails?api-version=2024-10-01-preview&skip={skip}&maxpagesize={maxpagesize}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Punkt końcowy hostowany żądany zasób. Na przykład https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
maxpagesize	query		integer (int32)	Maksymalna liczba elementów wyników na stronę.
skip	query		integer (int32)	Liczba elementów wyników do pominięcia.

Treść żądania

Nazwa	Wymagane	Typ	Opis
deltaDetailType	True	DeltaDetailType	Typ szczegółów różnicy do pobrania.
kind	True	GlobalAssetType	Typ zasobu
date		string	oczekiwany format: rrrr-MM-dd
priorDays		integer (int32)	Liczba dni przed pobraniem różnic.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DeltaPageResult	Żądanie zakończyło się pomyślnie.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://easm.defender.microsoft.com/.default

Przykłady

Assets_GetDeltaDetails

Przykładowe żądanie

HTTP

POST {endpoint}/assets:getDeltaDetails?api-version=2024-10-01-preview

{
  "deltaDetailType": "added",
  "priorDays": 30,
  "kind": "domain",
  "date": "2024-03-17"
}

Przykładowa odpowiedź

Kod stanu:

200

{
  "totalElements": 3,
  "value": [
    {
      "kind": "domain",
      "name": "hondawallofdreams.ca",
      "createdAt": "2024-02-23T18:33:06Z",
      "updatedAt": "2024-02-23T18:33:06Z",
      "state": "confirmed"
    },
    {
      "kind": "domain",
      "name": "hondawallofdreamsfr.ca",
      "createdAt": "2024-02-16T16:14:40Z",
      "updatedAt": "2024-02-16T16:14:40Z",
      "state": "confirmed"
    },
    {
      "kind": "domain",
      "name": "parkerhonda.com",
      "createdAt": "2024-03-02T07:29:01Z",
      "updatedAt": "2024-03-09T09:19:23Z",
      "state": "confirmed"
    }
  ]
}

Definicje

Nazwa	Opis
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu API REST platformy Azure — https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Treść żądania używana do pobierania listy różnic.
DeltaDetailType	Lista typów szczegółów różnicowych
DeltaPageResult
DeltaResult	Wynik dla każdej odpowiedzi szczegółów różnicy
GlobalAssetType	Lista globalnych typów zasobów
GlobalInventoryState	Lista stanów spisu globalnego.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu API REST platformy Azure — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

DeltaDetailsRequest

Objekt

Treść żądania używana do pobierania listy różnic.

Nazwa	Typ	Opis
date	string	oczekiwany format: rrrr-MM-dd
deltaDetailType	DeltaDetailType	Typ szczegółów różnicy do pobrania.
kind	GlobalAssetType	Typ zasobu
priorDays	integer (int32)	Liczba dni przed pobraniem różnic.

DeltaDetailType

Wyliczenie

Lista typów szczegółów różnicowych

Wartość	Opis
added	Dodane
removed	Usunięte

DeltaPageResult

Objekt

Nazwa	Typ	Opis
nextLink	string	Link umożliwiający uzyskanie dostępu do następnej strony wyników. Nie ustawiono, jeśli na końcu zestawu wyników.
totalElements	integer (int64)	Całkowita liczba elementów dostępnych w pełnym zestawie wyników.
value	DeltaResult[]	Elementy na bieżącej stronie wyników.

DeltaResult

Objekt

Wynik dla każdej odpowiedzi szczegółów różnicy

Nazwa	Typ	Opis
createdAt	string (date-time)	Pokazuje datę utworzenia zasobu
kind	GlobalAssetType	Pokazuje rodzaj zasobu
name	string	Pokazuje nazwę zasobu
state	GlobalInventoryState	Pokazuje stan spisu
updatedAt	string (date-time)	Pokazuje datę ostatniej aktualizacji zasobu, zazwyczaj datę, dla której próbujemy ściągnąć wyniki

GlobalAssetType

Wyliczenie

Lista globalnych typów zasobów

Wartość	Opis
page	strona
resource	zasób
mailServer	serwer poczty
nameServer	serwer nazw
host	gospodarz
domain	domena
ipAddress	adres IP
ipBlock	blok ip
as	numer systemu autonomicznego
contact	kontakt
sslCert	certyfikat ssl

GlobalInventoryState

Wyliczenie

Lista stanów spisu globalnego.

Wartość	Opis
candidate	kandydat
candidateInvestigate	badanie kandydata
confirmed	Potwierdzone
associated	Programów powiązanych
associatedPartner	skojarzony partner
associatedThirdParty	skojarzona inna firma
archived	Archiwizowane
dismissed	Oddalił
autoconfirmed	automatycznie potwierdzone