Assets - Get Delta Details

Service:

Defender EASM (preview)

API-versie:

2024-10-01-preview

Haal een lijst met delta's op voor het opgegeven tijdsbereik.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (uri)	Het eindpunt dat als host fungeert voor de aangevraagde resource. Bijvoorbeeld https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
maxpagesize	query		integer (int32)	Het maximum aantal resultaatitems per pagina.
skip	query		integer (int32)	Het aantal resultaatitems dat moet worden overgeslagen.

Aanvraagbody

Name	Vereist	Type	Description
deltaDetailType	True	DeltaDetailType	Het type deltadetail dat moet worden opgehaald.
kind	True	GlobalAssetType	Het type asset
date		string	verwachte notatie: jjjj-MM-dd
priorDays		integer (int32)	Het aantal dagen voordat delta's worden opgehaald.

Antwoorden

Name	Type	Description
200 OK	DeltaPageResult	De aanvraag is voltooid.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

Voorbeelden

Assets_GetDeltaDetails

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors
DeltaDetailsRequest	Een aanvraagbody die wordt gebruikt om een lijst met delta's op te halen.
DeltaDetailType	Een lijst met deltadetailtypen
DeltaPageResult
DeltaResult	Resultaat voor elk van de deltadetailreacties
GlobalAssetType	Een lijst met globaal assettype
GlobalInventoryState	Een lijst met globale inventarisstatussen.

Azure.Core.Foundations.Error

Object

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Object

Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.

DeltaDetailsRequest

Object

Een aanvraagbody die wordt gebruikt om een lijst met delta's op te halen.

Name	Type	Description
date	string	verwachte notatie: jjjj-MM-dd
deltaDetailType	DeltaDetailType	Het type deltadetail dat moet worden opgehaald.
kind	GlobalAssetType	Het type asset
priorDays	integer (int32)	Het aantal dagen voordat delta's worden opgehaald.

DeltaDetailType

Opsomming

Een lijst met deltadetailtypen

Waarde	Description
added	toegevoegd
removed	Verwijderd

DeltaPageResult

Object

Name	Type	Description
nextLink	string	De koppeling voor toegang tot de volgende pagina met resultaten. Niet ingesteld als aan het einde van de resultatenset.
totalElements	integer (int64)	Het totale aantal items dat beschikbaar is in de volledige resultatenset.
value	DeltaResult[]	De items op de huidige pagina met resultaten.

DeltaResult

Object

Resultaat voor elk van de deltadetailreacties

Name	Type	Description
createdAt	string (date-time)	Geeft de datum weer waarop de asset oorspronkelijk is gemaakt
kind	GlobalAssetType	Geeft het assettype weer
name	string	Geeft de assetnaam weer
state	GlobalInventoryState	Geeft de inventarisstatus weer
updatedAt	string (date-time)	Geeft de datum weer waarop de asset voor het laatst is bijgewerkt, meestal de datum waarop de resultaten worden opgehaald voor

GlobalAssetType

Opsomming

Een lijst met globaal assettype

Waarde	Description
page	bladzijde
resource	hulpbron
mailServer	mailserver
nameServer	naamserver
host	gastheer
domain	domein
ipAddress	IP-adres
ipBlock	ip-blok
as	autonoom systeemnummer
contact	contactpersoon
sslCert	ssl-certificaat

GlobalInventoryState

Opsomming

Een lijst met globale inventarisstatussen.

Waarde	Description
candidate	kandidaat
candidateInvestigate	kandidaat onderzoeken
confirmed	bevestigd
associated	bijbehorend
associatedPartner	gekoppelde partner
associatedThirdParty	gekoppelde derde partij
archived	Gearchiveerde
dismissed	Ontslagen
autoconfirmed	automatisch bevestigd