Udostępnij za pośrednictwem


Assets - Get Delta Details

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

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpoint
path True

string

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

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óżnicowych do pobrania.

kind True

GlobalAssetType

Typ zasobu

date

string

oczekiwany format: rrrr-MM-dd

priorDays

integer

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

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

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

Przykładowa odpowiedź

{
  "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 interfejsu API usługi Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

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

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

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

Nazwa Typ Opis
error

Azure.Core.Foundations.Error

Obiekt błędu.

Azure.Core.Foundations.InnerError

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi interfejsu API usługi Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

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

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óżnicowych do pobrania.

kind

GlobalAssetType

Typ zasobu

priorDays

integer

Liczba dni przed pobraniem różnic.

DeltaDetailType

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

Nazwa Typ Opis
added

string

Dodane

removed

string

Usunięte

DeltaPageResult

Nazwa Typ Opis
nextLink

string

Link umożliwiający dostęp do następnej strony wyników. Nie ustawiono, jeśli na końcu zestawu wyników.

totalElements

integer

Łączna liczba elementów dostępnych w pełnym zestawie wyników.

value

DeltaResult[]

Elementy na bieżącej stronie wyników.

DeltaResult

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

Nazwa Typ Opis
createdAt

string

Przedstawia datę utworzenia elementu zawartości

kind

GlobalAssetType

Pokazuje rodzaj zasobu

name

string

Pokazuje nazwę zasobu

state

GlobalInventoryState

Pokazuje stan spisu

updatedAt

string

Pokazuje datę ostatniej aktualizacji elementu zawartości, zwykle datę, dla którego próbujemy pobrać wyniki

GlobalAssetType

Lista globalnych typów zasobów

Nazwa Typ Opis
as

string

numer systemu autonomicznego

contact

string

kontakt

domain

string

domena

host

string

host

ipAddress

string

adres IP

ipBlock

string

blok ip

mailServer

string

serwer poczty

nameServer

string

serwer nazw

page

string

Strona

resource

string

zasób

sslCert

string

certyfikat ssl

GlobalInventoryState

Lista stanów spisu globalnego.

Nazwa Typ Opis
archived

string

Archiwizowane

associated

string

Programów powiązanych

associatedPartner

string

skojarzony partner

associatedThirdParty

string

skojarzonej z nią innej firmy

autoconfirmed

string

automatycznie potwierdzono

candidate

string

Kandydat

candidateInvestigate

string

badanie kandydata

confirmed

string

Potwierdzone

dismissed

string

Oddalił