Поделиться через


Assets - Get Delta Details

Получение списка изменений для указанного диапазона времени.

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

Параметры URI

Имя В Обязательно Тип Описание
endpoint
path True

string

Конечная точка, в котором размещается запрошенный ресурс. Например, https://{регион}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

Версия API, используемая для данной операции.

maxpagesize
query

integer

int32

Максимальное количество элементов результатов на странице.

skip
query

integer

int32

Количество элементов результатов, которые нужно пропустить.

Текст запроса

Имя Обязательно Тип Описание
deltaDetailType True

DeltaDetailType

Тип извлекаемого разностного значения.

kind True

GlobalAssetType

Тип ресурса

date

string

ожидаемый формат: гггг-ММ-дд

priorDays

integer

Количество дней до получения разностных изменений для.

Ответы

Имя Тип Описание
200 OK

DeltaPageResult

Запрос выполнен успешно.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
https://easm.defender.microsoft.com/.default

Примеры

Assets_GetDeltaDetails

Образец запроса

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

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

Пример ответа

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

Определения

Имя Описание
Azure.Core.Foundations.Error

Объект error.

Azure.Core.Foundations.ErrorResponse

Ответ, содержащий сведения об ошибке.

Azure.Core.Foundations.InnerError

Объект , содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

DeltaDetailsRequest

Текст запроса, используемый для получения списка разностных изменений.

DeltaDetailType

Список разностного типа сведений

DeltaPageResult
DeltaResult

Результат для каждого ответа с разностным подробным описанием

GlobalAssetType

Список глобальных типов ресурсов

GlobalInventoryState

Список состояний глобальных запасов.

Azure.Core.Foundations.Error

Объект error.

Имя Тип Описание
code

string

Один из определяемого сервером набора кодов ошибок.

details

Azure.Core.Foundations.Error[]

Массив сведений о конкретных ошибках, которые привели к этой сообщаемой ошибке.

innererror

Azure.Core.Foundations.InnerError

Объект, содержащий более конкретные сведения об ошибке, чем текущий объект.

message

string

Удобочитаемое представление ошибки.

target

string

Цель ошибки.

Azure.Core.Foundations.ErrorResponse

Ответ, содержащий сведения об ошибке.

Имя Тип Описание
error

Azure.Core.Foundations.Error

Объект error.

Azure.Core.Foundations.InnerError

Объект , содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Имя Тип Описание
code

string

Один из определяемого сервером набора кодов ошибок.

innererror

Azure.Core.Foundations.InnerError

Внутренняя ошибка.

DeltaDetailsRequest

Текст запроса, используемый для получения списка разностных изменений.

Имя Тип Описание
date

string

ожидаемый формат: гггг-ММ-дд

deltaDetailType

DeltaDetailType

Тип извлекаемого разностного значения.

kind

GlobalAssetType

Тип ресурса

priorDays

integer

Количество дней до получения разностных изменений для.

DeltaDetailType

Список разностного типа сведений

Имя Тип Описание
added

string

Добавлено

removed

string

Удалены

DeltaPageResult

Имя Тип Описание
nextLink

string

Ссылка для доступа к следующей странице результатов. Не задано, если в конце результирующий набор.

totalElements

integer

Общее количество элементов, доступных в полном результирующем наборе.

value

DeltaResult[]

Элементы на текущей странице результатов.

DeltaResult

Результат для каждого ответа с разностным подробным описанием

Имя Тип Описание
createdAt

string

Показывает дату первоначального создания ресурса.

kind

GlobalAssetType

Отображение типа ресурса

name

string

Отображение имени ресурса

state

GlobalInventoryState

Отображение состояния инвентаризации

updatedAt

string

Показывает дату последнего обновления ресурса( обычно это дата, для результаты поиска).

GlobalAssetType

Список глобальных типов ресурсов

Имя Тип Описание
as

string

номер автономной системы

contact

string

contact

domain

string

домен

host

string

узел

ipAddress

string

ip-адрес

ipBlock

string

ip-блок

mailServer

string

почтовый сервер

nameServer

string

сервер имен

page

string

страница

resource

string

ресурс

sslCert

string

SSL-сертификат

GlobalInventoryState

Список состояний глобальных запасов.

Имя Тип Описание
archived

string

Архивная

associated

string

Связанные

associatedPartner

string

связанный партнер

associatedThirdParty

string

связанная третья сторона

autoconfirmed

string

автоматическое подтверждение

candidate

string

candidate

candidateInvestigate

string

потенциальные исследования

confirmed

string

confirmed

dismissed

string

Уволен