Assets - Get Delta Details

Servicio:

Defender EASM (preview)

Versión de la API:

2024-10-01-preview

Recupere una lista de deltas para el intervalo de tiempo proporcionado.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	Punto de conexión que hospeda el recurso solicitado. Por ejemplo, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
maxpagesize	query		integer (int32)	Número máximo de elementos de resultado por página.
skip	query		integer (int32)	Número de elementos de resultado que se van a omitir.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
deltaDetailType	True	DeltaDetailType	Tipo de detalle delta que se va a recuperar.
kind	True	GlobalAssetType	Tipo de recurso
date		string	formato esperado para ser: aaaa-MM-dd
priorDays		integer (int32)	Número de días antes de recuperar deltas para.

Respuestas

Nombre	Tipo	Description
200 OK	DeltaPageResult	La solicitud se ha realizado correctamente.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

Ejemplos

Assets_GetDeltaDetails

Solicitud de ejemplo

HTTP

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

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Cuerpo de la solicitud usado para recuperar una lista de deltas.
DeltaDetailType	Una lista de tipo de detalle delta
DeltaPageResult
DeltaResult	Resultado de cada una de las respuestas de detalles diferenciales
GlobalAssetType	Una lista del tipo de recurso global
GlobalInventoryState	Lista de estados de inventario globales.

Azure.Core.Foundations.Error

Objeto

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Objeto

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Objeto

Objeto que contiene información más específica sobre el error. Según las directrices de la API de REST de Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

DeltaDetailsRequest

Objeto

Cuerpo de la solicitud usado para recuperar una lista de deltas.

Nombre	Tipo	Description
date	string	formato esperado para ser: aaaa-MM-dd
deltaDetailType	DeltaDetailType	Tipo de detalle delta que se va a recuperar.
kind	GlobalAssetType	Tipo de recurso
priorDays	integer (int32)	Número de días antes de recuperar deltas para.

DeltaDetailType

Enumeración

Una lista de tipo de detalle delta

Valor	Description
added	Añadido
removed	Quitado

DeltaPageResult

Objeto

Nombre	Tipo	Description
nextLink	string	Vínculo para acceder a la página siguiente de resultados. No se establece si al final del conjunto de resultados.
totalElements	integer (int64)	Número total de elementos disponibles en el conjunto de resultados completo.
value	DeltaResult[]	Elementos de la página actual de resultados.

DeltaResult

Objeto

Resultado de cada una de las respuestas de detalles diferenciales

Nombre	Tipo	Description
createdAt	string (date-time)	Muestra la fecha en la que se creó originalmente el recurso
kind	GlobalAssetType	Muestra el tipo de recurso
name	string	Muestra el nombre del recurso
state	GlobalInventoryState	Muestra el estado del inventario
updatedAt	string (date-time)	Muestra la fecha en que se actualizó por última vez el recurso, normalmente la fecha en la que intentamos extraer los resultados.

GlobalAssetType

Enumeración

Una lista del tipo de recurso global

Valor	Description
page	página
resource	recurso
mailServer	servidor de correo
nameServer	servidor de nombres
host	anfitrión
domain	dominio
ipAddress	dirección IP
ipBlock	bloque ip
as	número de sistema autónomo
contact	contacto
sslCert	certificado ssl

GlobalInventoryState

Enumeración

Lista de estados de inventario globales.

Valor	Description
candidate	candidato
candidateInvestigate	investigación candidata
confirmed	empedernido
associated	asociado
associatedPartner	asociado
associatedThirdParty	asociado de terceros
archived	Archivados
dismissed	despedido
autoconfirmed	confirmación automática