Assets - Get Delta Details

Szolgáltatás:

Defender EASM (preview)

API-verzió:

2024-10-01-preview

Kérje le a megadott időtartomány eltéréseinek listáját.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A kért erőforrást üzemeltető végpont. Például https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.
maxpagesize	query		integer (int32)	Az eredményelemek maximális száma oldalanként.
skip	query		integer (int32)	A kihagyandó eredményelemek száma.

Kérelem törzse

Name	Kötelező	Típus	Description
deltaDetailType	True	DeltaDetailType	A lekérendő változás részleteinek típusa.
kind	True	GlobalAssetType	Az eszköz típusa
date		string	várható formátum: yyyy-MM-dd
priorDays		integer (int32)	A különbözet lekérése előtti napok száma.

Válaszok

Name	Típus	Description
200 OK	DeltaPageResult	A kérés sikeres volt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

Assets_GetDeltaDetails

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkó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"
    }
  ]
}

Definíciók

Name	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	A különbözeti listák lekérésére szolgáló kérelem törzse.
DeltaDetailType	A delta részletes típusának listája
DeltaPageResult
DeltaResult	A delta részletes válaszának eredménye
GlobalAssetType	A globális eszköztípus listája
GlobalInventoryState	A globális leltárállapotok listája.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

DeltaDetailsRequest

Tárgy

A különbözeti listák lekérésére szolgáló kérelem törzse.

Name	Típus	Description
date	string	várható formátum: yyyy-MM-dd
deltaDetailType	DeltaDetailType	A lekérendő változás részleteinek típusa.
kind	GlobalAssetType	Az eszköz típusa
priorDays	integer (int32)	A különbözet lekérése előtti napok száma.

DeltaDetailType

Felsorolás

A delta részletes típusának listája

Érték	Description
added	Hozzáadott
removed	Eltávolított

DeltaPageResult

Tárgy

Name	Típus	Description
nextLink	string	A találatok következő oldalának elérésére szolgáló hivatkozás. Nincs beállítva, ha az eredményhalmaz végén van.
totalElements	integer (int64)	A teljes eredményhalmazban elérhető elemek teljes száma.
value	DeltaResult[]	Az aktuális eredményoldal elemei.

DeltaResult

Tárgy

A delta részletes válaszának eredménye

Name	Típus	Description
createdAt	string (date-time)	Az eszköz eredeti létrehozásának dátumát jeleníti meg
kind	GlobalAssetType	Az eszköztípus megjelenítése
name	string	Az eszköz neve
state	GlobalInventoryState	A készletállapot megjelenítése
updatedAt	string (date-time)	Az eszköz utolsó frissítésének dátumát jeleníti meg, általában azt a dátumot, amikor le szeretnénk állítani az eredményeket a következőhöz:

GlobalAssetType

Felsorolás

A globális eszköztípus listája

Érték	Description
page	oldal
resource	erőforrás
mailServer	levelezési kiszolgáló
nameServer	névkiszolgáló
host	állomás
domain	tartomány
ipAddress	IP-cím
ipBlock	ip-blokk
as	autonóm rendszer száma
contact	érintkezés
sslCert	ssl-tanúsítvány

GlobalInventoryState

Felsorolás

A globális leltárállapotok listája.

Érték	Description
candidate	jelölt
candidateInvestigate	jelölt vizsgálata
confirmed	megrögzött
associated	Kapcsolódó
associatedPartner	társított partner
associatedThirdParty	társított harmadik fél
archived	Archivált
dismissed	Elutasította
autoconfirmed	automatikusan megerősítve