Assets - Get Delta Details

Dienst:

Defender EASM (preview)

API-Version:

2024-10-01-preview

Dient zum Abrufen einer Liste von Deltas für den angegebenen Zeitraum.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Der Endpunkt, der die angeforderte Ressource hosten soll. Beispiel: https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
maxpagesize	query		integer (int32)	Die maximale Anzahl von Ergebniselementen pro Seite.
skip	query		integer (int32)	Die Anzahl der zu überspringenden Ergebniselemente.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
deltaDetailType	True	DeltaDetailType	Der Typ des abzurufenden Delta-Details.
kind	True	GlobalAssetType	Der Typ der Ressource
date		string	erwartetes Format: jjjj-MM-tt
priorDays		integer (int32)	Die Anzahl der Tage vor dem Abrufen von Deltas für.

Antworten

Name	Typ	Beschreibung
200 OK	DeltaPageResult	Die Anforderung ist erfolgreich.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

Assets_GetDeltaDetails

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Azure-REST-API: . https://aka.ms/AzureRestApiGuidelines#handling-errors
DeltaDetailsRequest	Ein Anforderungstext, der zum Abrufen einer Liste von Deltas verwendet wird.
DeltaDetailType	Eine Liste des Delta-Detailtyps
DeltaPageResult
DeltaResult	Ergebnis für jede Delta-Detailantwort
GlobalAssetType	Eine Liste des globalen Objekttyps
GlobalInventoryState	Eine Liste der globalen Bestandszustände.

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Azure-REST-API: . https://aka.ms/AzureRestApiGuidelines#handling-errors

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

DeltaDetailsRequest

Objekt

Ein Anforderungstext, der zum Abrufen einer Liste von Deltas verwendet wird.

Name	Typ	Beschreibung
date	string	erwartetes Format: jjjj-MM-tt
deltaDetailType	DeltaDetailType	Der Typ des abzurufenden Delta-Details.
kind	GlobalAssetType	Der Typ der Ressource
priorDays	integer (int32)	Die Anzahl der Tage vor dem Abrufen von Deltas für.

DeltaDetailType

Enumeration

Eine Liste des Delta-Detailtyps

Wert	Beschreibung
added	zugefügt
removed	entfernt

DeltaPageResult

Objekt

Name	Typ	Beschreibung
nextLink	string	Der Link, um auf die nächste Seite mit Ergebnissen zuzugreifen. Nicht festgelegt, wenn am Ende des Resultsets.
totalElements	integer (int64)	Die Gesamtzahl der im vollständigen Resultset verfügbaren Elemente.
value	DeltaResult[]	Die Elemente auf der aktuellen Ergebnisseite.

DeltaResult

Objekt

Ergebnis für jede Delta-Detailantwort

Name	Typ	Beschreibung
createdAt	string (date-time)	Zeigt das Datum an, an dem das Objekt ursprünglich erstellt wurde.
kind	GlobalAssetType	Zeigt die Art der Ressource an.
name	string	Zeigt den Objektnamen an.
state	GlobalInventoryState	Zeigt den Bestandsstatus an.
updatedAt	string (date-time)	Zeigt das Datum an, an dem die Ressource zuletzt aktualisiert wurde, in der Regel das Datum, an dem wir versuchen, die Ergebnisse für

GlobalAssetType

Enumeration

Eine Liste des globalen Objekttyps

Wert	Beschreibung
page	Seite
resource	Ressource
mailServer	E-Mail-Server
nameServer	Name Server
host	Gastgeber
domain	Domäne
ipAddress	IP-Adresse
ipBlock	IP-Block
as	autonome Systemnummer
contact	Kontakt
sslCert	SSL-Zertifikat

GlobalInventoryState

Enumeration

Eine Liste der globalen Bestandszustände.

Wert	Beschreibung
candidate	Kandidat
candidateInvestigate	Kandidaten untersuchen
confirmed	bestätigt
associated	assoziiert
associatedPartner	zugeordneter Partner
associatedThirdParty	zugehöriger Drittanbieter
archived	archiviert
dismissed	entlassen
autoconfirmed	Automatisch bestätigt