Compartilhar via


Assets - Get Delta Details

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

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string

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

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 ignoradas.

Corpo da solicitação

Nome Obrigató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

O número de dias antes de recuperar deltas.

Respostas

Nome Tipo Description
200 OK

DeltaPageResult

A solicitação foi bem-sucedida.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

OAuth2Auth

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

Escopos

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

Exemplos

Assets_GetDeltaDetails

Solicitação de exemplo

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

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

Resposta de exemplo

{
  "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

Nome Description
Azure.Core.Foundations.Error

O objeto de erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta que contém 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 do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

DeltaDetailsRequest

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

DeltaDetailType

Uma lista de tipos de detalhes delta

DeltaPageResult
DeltaResult

Resultado de cada uma das respostas de detalhes delta

GlobalAssetType

Uma lista do tipo de ativo global

GlobalInventoryState

Uma lista de estados de inventário global.

Azure.Core.Foundations.Error

O objeto de erro.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

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 do erro.

target

string

O destino do erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta que contém detalhes do erro.

Nome Tipo Description
error

Azure.Core.Foundations.Error

O objeto de 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 do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

innererror

Azure.Core.Foundations.InnerError

Erro interno.

DeltaDetailsRequest

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

Nome 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

O número de dias antes de recuperar deltas.

DeltaDetailType

Uma lista de tipos de detalhes delta

Nome Tipo Description
added

string

adicionado

removed

string

Removido

DeltaPageResult

Nome 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

O número total de itens disponíveis no conjunto de resultados completo.

value

DeltaResult[]

Os itens na página atual dos resultados.

DeltaResult

Resultado de cada uma das respostas de detalhes delta

Nome Tipo Description
createdAt

string

Mostra a data em que o ativo foi criado originalmente

kind

GlobalAssetType

Mostra o tipo de ativo

name

string

Mostra o nome do ativo

state

GlobalInventoryState

Mostra o estado do inventário

updatedAt

string

Mostra a data em que o ativo foi atualizado pela última vez, geralmente a data para a qual tentamos obter os resultados

GlobalAssetType

Uma lista do tipo de ativo global

Nome Tipo Description
as

string

número do sistema autônomo

contact

string

contact

domain

string

domínio

host

string

host

ipAddress

string

endereço ip

ipBlock

string

bloco ip

mailServer

string

servidor de email

nameServer

string

servidor de nomes

page

string

página

resource

string

recurso

sslCert

string

certificado ssl

GlobalInventoryState

Uma lista de estados de inventário global.

Nome Tipo Description
archived

string

Arquivado

associated

string

Associado

associatedPartner

string

parceiro associado

associatedThirdParty

string

terceiros associados

autoconfirmed

string

confirmado automaticamente

candidate

string

Candidato

candidateInvestigate

string

candidato investigar

confirmed

string

confirmado

dismissed

string

Demitido