Assets - Get Delta Details

Tjänst:

Defender EASM (preview)

API-version:

2024-10-01-preview

Hämta en lista över deltan för det angivna tidsintervallet.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string (uri)	Slutpunkten som är värd för den begärda resursen. Till exempel https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.
maxpagesize	query		integer (int32)	Det maximala antalet resultatobjekt per sida.
skip	query		integer (int32)	Antalet resultatobjekt som ska hoppa över.

Begärandetext

Name	Obligatorisk	Typ	Description
deltaDetailType	True	DeltaDetailType	Typ av deltainformation som ska hämtas.
kind	True	GlobalAssetType	Typ av tillgång
date		string	förväntat format att vara: åååå-MM-dd
priorDays		integer (int32)	Antalet dagar innan deltan hämtas för.

Svar

Name	Typ	Description
200 OK	DeltaPageResult	Begäran har slutförts.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

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

Exempel

Assets_GetDeltaDetails

Exempelbegäran

HTTP

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

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
Azure.Core.Foundations.Error	Felobjektet.
Azure.Core.Foundations.ErrorResponse	Ett svar som innehåller felinformation.
Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	En begärandetext som används för att hämta en lista över deltan.
DeltaDetailType	En lista med deltainformationstyp
DeltaPageResult
DeltaResult	Resultat för var och en av deltainformationssvaret
GlobalAssetType	En lista över globala tillgångstyper
GlobalInventoryState	En lista över globala inventeringstillstånd.

Azure.Core.Foundations.Error

Objekt

Felobjektet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	Azure.Core.Foundations.Error[]	En matris med information om specifika fel som ledde till det rapporterade felet.
innererror	Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
message	string	En mänsklig läsbar representation av felet.
target	string	Målet för felet.

Azure.Core.Foundations.ErrorResponse

Objekt

Ett svar som innehåller felinformation.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Felobjektet.

Azure.Core.Foundations.InnerError

Objekt

Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
innererror	Azure.Core.Foundations.InnerError	Inre fel.

DeltaDetailsRequest

Objekt

En begärandetext som används för att hämta en lista över deltan.

Name	Typ	Description
date	string	förväntat format att vara: åååå-MM-dd
deltaDetailType	DeltaDetailType	Typ av deltainformation som ska hämtas.
kind	GlobalAssetType	Typ av tillgång
priorDays	integer (int32)	Antalet dagar innan deltan hämtas för.

DeltaDetailType

Uppräkning

En lista med deltainformationstyp

Värde	Description
added	tillade
removed	avlägsnad

DeltaPageResult

Objekt

Name	Typ	Description
nextLink	string	Länken för att komma åt nästa sida med resultat. Ange inte om i slutet av resultatuppsättningen.
totalElements	integer (int64)	Det totala antalet tillgängliga objekt i den fullständiga resultatuppsättningen.
value	DeltaResult[]	Objekten på den aktuella resultatsidan.

DeltaResult

Objekt

Resultat för var och en av deltainformationssvaret

Name	Typ	Description
createdAt	string (date-time)	Visar det datum då tillgången ursprungligen skapades
kind	GlobalAssetType	Visar tillgångstyp
name	string	Visar tillgångsnamnet
state	GlobalInventoryState	Visar inventeringstillståndet
updatedAt	string (date-time)	Visar det datum då tillgången senast uppdaterades, vanligtvis det datum då vi försökte hämta resultatet för

GlobalAssetType

Uppräkning

En lista över globala tillgångstyper

Värde	Description
page	sida
resource	resurs
mailServer	e-postserver
nameServer	namnserver
host	värd
domain	domän
ipAddress	IP-adress
ipBlock	ip-block
as	autonomt systemnummer
contact	kontakt
sslCert	ssl-certifikat

GlobalInventoryState

Uppräkning

En lista över globala inventeringstillstånd.

Värde	Description
candidate	kandidat
candidateInvestigate	kandidat undersöker
confirmed	bekräftad
associated	associerad
associatedPartner	associerad partner
associatedThirdParty	associerad tredje part
archived	arkiverad
dismissed	Ogillas
autoconfirmed	bekräftas automatiskt