Sdílet prostřednictvím


Assets - Get Delta Details

Načte seznam rozdílových hodnot pro zadaný časový rozsah.

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 identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
path True

string

Koncový bod hostující požadovaný prostředek. Například https://{oblast}.easm.defender.microsoft.com/subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/workspaces/{název_pracovního_prostoru}

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

maxpagesize
query

integer

int32

Maximální počet položek výsledků na stránku.

skip
query

integer

int32

Počet položek výsledku, které se mají přeskočit.

Text požadavku

Name Vyžadováno Typ Description
deltaDetailType True

DeltaDetailType

Typ rozdílového detailu, který se má načíst.

kind True

GlobalAssetType

Typ prostředku

date

string

očekávaný formát bude: rrrr-MM-dd

priorDays

integer

Počet dní před načtením rozdílových hodnot pro.

Odpovědi

Name Typ Description
200 OK

DeltaPageResult

Žádost byla úspěšná.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď.

Hlavičky

x-ms-error-code: string

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
https://easm.defender.microsoft.com/.default

Příklady

Assets_GetDeltaDetails

Ukázkový požadavek

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

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

Ukázková odpověď

{
  "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"
    }
  ]
}

Definice

Name Description
Azure.Core.Foundations.Error

Objekt chyby.

Azure.Core.Foundations.ErrorResponse

Odpověď obsahující podrobnosti o chybě.

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní MICROSOFT One API – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

DeltaDetailsRequest

Text požadavku použitý k načtení seznamu rozdílových hodnot.

DeltaDetailType

Seznam typů podrobností o rozdílech

DeltaPageResult
DeltaResult

Výsledek pro každou rozdílovou podrobnou odpověď

GlobalAssetType

Seznam globálních typů prostředků

GlobalInventoryState

Seznam stavů globálního inventáře.

Azure.Core.Foundations.Error

Objekt chyby.

Name Typ Description
code

string

Jeden ze serverem definovaných chybových kódů.

details

Azure.Core.Foundations.Error[]

Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.

innererror

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě než aktuální objekt.

message

string

Lidsky čitelná reprezentace chyby.

target

string

Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name Typ Description
error

Azure.Core.Foundations.Error

Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní MICROSOFT One API – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name Typ Description
code

string

Jeden ze serverem definovaných chybových kódů.

innererror

Azure.Core.Foundations.InnerError

Vnitřní chyba.

DeltaDetailsRequest

Text požadavku použitý k načtení seznamu rozdílových hodnot.

Name Typ Description
date

string

očekávaný formát bude: rrrr-MM-dd

deltaDetailType

DeltaDetailType

Typ rozdílového detailu, který se má načíst.

kind

GlobalAssetType

Typ prostředku

priorDays

integer

Počet dní před načtením rozdílových hodnot pro.

DeltaDetailType

Seznam typů podrobností o rozdílech

Name Typ Description
added

string

Přidány

removed

string

Odstraněn

DeltaPageResult

Name Typ Description
nextLink

string

Odkaz pro přístup na další stránku výsledků Nenastavuje se, pokud je na konci sady výsledků dotazu.

totalElements

integer

Celkový počet položek dostupných v celé sadě výsledků dotazu.

value

DeltaResult[]

Položky na aktuální stránce výsledků.

DeltaResult

Výsledek pro každou rozdílovou podrobnou odpověď

Name Typ Description
createdAt

string

Zobrazuje datum, kdy byl prostředek původně vytvořen.

kind

GlobalAssetType

Zobrazuje druh prostředku.

name

string

Zobrazuje název prostředku.

state

GlobalInventoryState

Zobrazuje stav inventáře.

updatedAt

string

Zobrazuje datum poslední aktualizace prostředku, obvykle datum, kdy se pokoušíme získat výsledky.

GlobalAssetType

Seznam globálních typů prostředků

Name Typ Description
as

string

číslo autonomního systému

contact

string

contact

domain

string

doména

host

string

Hostitel

ipAddress

string

IP adresa

ipBlock

string

ip block

mailServer

string

poštovní server

nameServer

string

názvový server

page

string

Stránka

resource

string

prostředek

sslCert

string

certifikát SSL

GlobalInventoryState

Seznam stavů globálního inventáře.

Name Typ Description
archived

string

Archivované

associated

string

Přidružené

associatedPartner

string

přidružený partner

associatedThirdParty

string

přidružená třetí strana

autoconfirmed

string

automaticky potvrzeno

candidate

string

Kandidát

candidateInvestigate

string

Prošetření kandidáta

confirmed

string

Potvrdil

dismissed

string

Zamítl