Assets - Get Delta Details

Servizio:

Defender EASM (preview)

Versione API:

2024-10-01-preview

Recuperare un elenco di delta per l'intervallo di tempo specificato.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint che ospita la risorsa richiesta. Ad esempio, https://{area}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
maxpagesize	query		integer (int32)	Numero massimo di elementi dei risultati per pagina.
skip	query		integer (int32)	Numero di elementi dei risultati da ignorare.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
deltaDetailType	True	DeltaDetailType	Tipo di dettaglio delta da recuperare.
kind	True	GlobalAssetType	Tipo di asset
date		string	formato previsto: aaaa-MM-gg
priorDays		integer (int32)	Numero di giorni prima di recuperare i delta.

Risposte

Nome	Tipo	Descrizione
200 OK	DeltaPageResult	La richiesta ha avuto esito positivo.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://easm.defender.microsoft.com/.default

Esempio

Assets_GetDeltaDetails

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Corpo della richiesta utilizzato per recuperare un elenco di delta.
DeltaDetailType	Elenco di tipo di dettaglio delta
DeltaPageResult
DeltaResult	Risultato per ogni risposta di dettaglio delta
GlobalAssetType	Elenco di tipo di asset globale
GlobalInventoryState	Elenco degli stati di inventario globale.

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

DeltaDetailsRequest

Oggetto

Corpo della richiesta utilizzato per recuperare un elenco di delta.

Nome	Tipo	Descrizione
date	string	formato previsto: aaaa-MM-gg
deltaDetailType	DeltaDetailType	Tipo di dettaglio delta da recuperare.
kind	GlobalAssetType	Tipo di asset
priorDays	integer (int32)	Numero di giorni prima di recuperare i delta.

DeltaDetailType

Enumerazione

Elenco di tipo di dettaglio delta

Valore	Descrizione
added	aggiunto
removed	lontano

DeltaPageResult

Oggetto

Nome	Tipo	Descrizione
nextLink	string	Collegamento per accedere alla pagina successiva dei risultati. Non impostato se alla fine del set di risultati.
totalElements	integer (int64)	Numero totale di elementi disponibili nel set di risultati completo.
value	DeltaResult[]	Elementi nella pagina corrente dei risultati.

DeltaResult

Oggetto

Risultato per ogni risposta di dettaglio delta

Nome	Tipo	Descrizione
createdAt	string (date-time)	Mostra la data in cui l'asset è stato creato originariamente
kind	GlobalAssetType	Mostra il tipo di asset
name	string	Mostra il nome dell'asset
state	GlobalInventoryState	Mostra lo stato dell'inventario
updatedAt	string (date-time)	Mostra la data dell'ultimo aggiornamento dell'asset, in genere la data in cui si tenta di estrarre i risultati

GlobalAssetType

Enumerazione

Elenco di tipo di asset globale

Valore	Descrizione
page	pagina
resource	risorsa
mailServer	server di posta
nameServer	server dei nomi
host	ospite
domain	dominio
ipAddress	indirizzo IP
ipBlock	blocco ip
as	numero di sistema autonomo
contact	contatto
sslCert	Certificato ssl

GlobalInventoryState

Enumerazione

Elenco degli stati di inventario globale.

Valore	Descrizione
candidate	candidato
candidateInvestigate	ricerca candidata
confirmed	confermato
associated	associato
associatedPartner	partner associato
associatedThirdParty	terze parti associate
archived	Archiviati
dismissed	licenziato
autoconfirmed	conferma automatica