Assets - Get Delta Details

Služba:

Defender EASM (preview)

Verze rozhraní API:

2024-10-01-preview

Načtěte seznam rozdílů pro zadaný časový rozsah.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod hostující požadovaný prostředek. Například https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
maxpagesize	query		integer (int32)	Maximální počet výsledků položek na stránku.
skip	query		integer (int32)	Počet položek výsledků, 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: rrrr-MM-dd
priorDays		integer (int32)	Počet dní před načtením rozdílových hodnot.

Odpovědi

Name	Typ	Description
200 OK	DeltaPageResult	Požadavek byl ú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

HTTP

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

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

Ukázková odpověď

Stavový kód:

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

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ů pro rozhraní Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Text požadavku použitý k načtení seznamu rozdílových hodnot.
DeltaDetailType	Seznam typu rozdílových podrobností
DeltaPageResult
DeltaResult	Výsledek pro každou rozdílovou podrobnou odpověď
GlobalAssetType	Seznam globálního typu assetu
GlobalInventoryState	Seznam stavů globálního inventáře.

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
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, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

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

Name	Typ	Description
error	Azure.Core.Foundations.Error	Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle pokynů pro rozhraní Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	Azure.Core.Foundations.InnerError	Vnitřní chyba.

DeltaDetailsRequest

Objekt

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

Name	Typ	Description
date	string	očekávaný formát: rrrr-MM-dd
deltaDetailType	DeltaDetailType	Typ rozdílového detailu, který se má načíst.
kind	GlobalAssetType	Typ prostředku
priorDays	integer (int32)	Počet dní před načtením rozdílových hodnot.

DeltaDetailType

Výčet

Seznam typu rozdílových podrobností

Hodnota	Description
added	přidán
removed	odstraněný

DeltaPageResult

Objekt

Name	Typ	Description
nextLink	string	Odkaz pro přístup k další stránce výsledků. Nenastavuje se, pokud je na konci sady výsledků.
totalElements	integer (int64)	Celkový počet položek dostupných v úplné sadě výsledků
value	DeltaResult[]	Položky na aktuální stránce výsledků

DeltaResult

Objekt

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

Name	Typ	Description
createdAt	string (date-time)	Zobrazuje datum, kdy byl asset 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 (date-time)	Zobrazuje datum poslední aktualizace aktiva, obvykle datum, kdy se snažíme získat výsledky pro

GlobalAssetType

Výčet

Seznam globálního typu assetu

Hodnota	Description
page	stránka
resource	prostředek
mailServer	poštovní server
nameServer	názvový server
host	hostitel
domain	doména
ipAddress	IP adresa
ipBlock	blok IP
as	číslo autonomního systému
contact	kontakt
sslCert	Certifikát SSL

GlobalInventoryState

Výčet

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

Hodnota	Description
candidate	kandidát
candidateInvestigate	kandidát prošetření
confirmed	potvrzený
associated	asociovaný
associatedPartner	přidružený partner
associatedThirdParty	přidružená třetí strana
archived	archivovaný
dismissed	propuštěný
autoconfirmed	automatické potvrzení