Assets - Get Delta Details

Serviço:

Defender EASM (preview)

Versão da API:

2024-10-01-preview

Recupere uma lista de deltas para o intervalo de tempo fornecido.

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

Com parâmetros opcionais:

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string (uri)	O ponto de extremidade que hospeda o recurso solicitado. Por exemplo, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
maxpagesize	query		integer (int32)	O número máximo de itens de resultado por página.
skip	query		integer (int32)	O número de itens de resultado a serem ignorados.

Corpo do Pedido

Name	Necessário	Tipo	Description
deltaDetailType	True	DeltaDetailType	O tipo de detalhe delta a ser recuperado.
kind	True	GlobalAssetType	O tipo de ativo
date		string	formato esperado para ser: aaaa-MM-dd
priorDays		integer (int32)	O número de dias antes de recuperar deltas para.

Respostas

Name	Tipo	Description
200 OK	DeltaPageResult	O pedido foi bem-sucedido.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Segurança

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

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

Exemplos

Assets_GetDeltaDetails

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:

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

Definições

Name	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta contendo detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API REST do Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Um corpo de solicitação usado para recuperar uma lista de deltas.
DeltaDetailType	Uma lista do tipo de detalhe delta
DeltaPageResult
DeltaResult	Resultado para cada resposta de detalhe delta
GlobalAssetType	Uma lista do tipo de ativo global
GlobalInventoryState	Uma lista de estados de inventário global.

Azure.Core.Foundations.Error

Object

O objeto de erro.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível por humanos do erro.
target	string	O alvo do erro.

Azure.Core.Foundations.ErrorResponse

Object

Uma resposta contendo detalhes do erro.

Name	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Object

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API REST do Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

DeltaDetailsRequest

Object

Um corpo de solicitação usado para recuperar uma lista de deltas.

Name	Tipo	Description
date	string	formato esperado para ser: aaaa-MM-dd
deltaDetailType	DeltaDetailType	O tipo de detalhe delta a ser recuperado.
kind	GlobalAssetType	O tipo de ativo
priorDays	integer (int32)	O número de dias antes de recuperar deltas para.

DeltaDetailType

Enumeração

Uma lista do tipo de detalhe delta

Valor	Description
added	adicionado
removed	removido

DeltaPageResult

Object

Name	Tipo	Description
nextLink	string	O link para acessar a próxima página de resultados. Não definido se no final do conjunto de resultados.
totalElements	integer (int64)	O número total de itens disponíveis no conjunto completo de resultados.
value	DeltaResult[]	Os itens na página atual de resultados.

DeltaResult

Object

Resultado para cada resposta de detalhe delta

Name	Tipo	Description
createdAt	string (date-time)	Mostra a data em que o ativo foi originalmente criado
kind	GlobalAssetType	Mostra o tipo de ativo
name	string	Mostra o nome do ativo
state	GlobalInventoryState	Mostra o estado do inventário
updatedAt	string (date-time)	Mostra a data em que o ativo foi atualizado pela última vez, geralmente a data em que tentamos extrair os resultados

GlobalAssetType

Enumeração

Uma lista do tipo de ativo global

Valor	Description
page	página
resource	recurso
mailServer	servidor de correio
nameServer	servidor de nomes
host	alojar
domain	domínio
ipAddress	Endereço IP
ipBlock	Bloco de IP
as	número do sistema autónomo
contact	contato
sslCert	Certificado SSL

GlobalInventoryState

Enumeração

Uma lista de estados de inventário global.

Valor	Description
candidate	candidato
candidateInvestigate	candidato a investigar
confirmed	confirmado
associated	associados
associatedPartner	parceiro associado
associatedThirdParty	terceiros associados
archived	arquivado
dismissed	Dispensado
autoconfirmed	auto confirmado