Assets - Get Delta Details

Service:

Defender EASM (preview)

Version d'API:

2024-10-01-preview

Récupérez une liste de deltas pour l’intervalle de temps fourni.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (uri)	Point de terminaison hébergeant la ressource demandée. Par exemple, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
maxpagesize	query		integer (int32)	Nombre maximal d’éléments de résultat par page.
skip	query		integer (int32)	Nombre d’éléments de résultat à ignorer.

Corps de la demande

Nom	Obligatoire	Type	Description
deltaDetailType	True	DeltaDetailType	Type de détail delta à récupérer.
kind	True	GlobalAssetType	Type de ressource
date		string	format attendu : aaaa-MM-jj
priorDays		integer (int32)	Nombre de jours avant la récupération des deltas.

Réponses

Nom	Type	Description
200 OK	DeltaPageResult	La demande a réussi.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

Assets_GetDeltaDetails

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux directives de l’API REST Azure : https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Corps de la requête utilisé pour récupérer une liste de deltas.
DeltaDetailType	Liste du type de détail delta
DeltaPageResult
DeltaResult	Résultat pour chaque réponse de détail delta
GlobalAssetType	Liste des types d’actifs globaux
GlobalInventoryState	Liste des états d’inventaire globaux.

Azure.Core.Foundations.Error

Objet

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Objet

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Objet

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux directives de l’API REST Azure : https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

DeltaDetailsRequest

Objet

Corps de la requête utilisé pour récupérer une liste de deltas.

Nom	Type	Description
date	string	format attendu : aaaa-MM-jj
deltaDetailType	DeltaDetailType	Type de détail delta à récupérer.
kind	GlobalAssetType	Type de ressource
priorDays	integer (int32)	Nombre de jours avant la récupération des deltas.

DeltaDetailType

Énumération

Liste du type de détail delta

Valeur	Description
added	supplémentaire
removed	Enlevé

DeltaPageResult

Objet

Nom	Type	Description
nextLink	string	Lien permettant d’accéder à la page suivante des résultats. Non défini si à la fin du jeu de résultats.
totalElements	integer (int64)	Nombre total d’éléments disponibles dans le jeu de résultats complet.
value	DeltaResult[]	Éléments de la page actuelle des résultats.

DeltaResult

Objet

Résultat pour chaque réponse de détail delta

Nom	Type	Description
createdAt	string (date-time)	Affiche la date à laquelle la ressource a été créée à l’origine
kind	GlobalAssetType	Affiche le type de ressource
name	string	Affiche le nom de la ressource
state	GlobalInventoryState	Affiche l’état d’inventaire
updatedAt	string (date-time)	Affiche la date de la dernière mise à jour de la ressource, généralement la date à laquelle nous essayons d’extraire les résultats pour

GlobalAssetType

Énumération

Liste des types d’actifs globaux

Valeur	Description
page	page
resource	ressource
mailServer	serveur de messagerie
nameServer	serveur de noms
host	hôte
domain	domaine
ipAddress	adresse IP
ipBlock	bloc ip
as	numéro de système autonome
contact	contacter
sslCert	certificat ssl

GlobalInventoryState

Énumération

Liste des états d’inventaire globaux.

Valeur	Description
candidate	candidat
candidateInvestigate	candidat à l’enquête
confirmed	confirmé
associated	associé
associatedPartner	partenaire associé
associatedThirdParty	tiers associés
archived	Archivés
dismissed	Rejeté
autoconfirmed	confirmation automatique