Assets - Get Delta Details

Служба:

Defender EASM (preview)

Версия API:

2024-10-01-preview

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

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Конечная точка, на котором размещен запрошенный ресурс. Например, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Версия API, используемая для этой операции.
maxpagesize	query		integer (int32)	Максимальное количество элементов результатов на страницу.
skip	query		integer (int32)	Количество пропускаемых элементов результата.

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

Имя	Обязательно	Тип	Описание
deltaDetailType	True	DeltaDetailType	Тип извлекаемой разностной детализации.
kind	True	GlobalAssetType	Тип ресурса
date		string	ожидаемый формат: гггг-ММ-дд
priorDays		integer (int32)	Количество дней, предшествующих получению разностных данных.

Ответы

Имя	Тип	Описание
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

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

HTTP

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

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

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

Код состояния:

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

Определения

Имя	Описание
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Текст запроса, используемый для получения списка разностных дел.
DeltaDetailType	Список типов разностных сведений
DeltaPageResult
DeltaResult	Результат для каждого ответа с разностной детализацией
GlobalAssetType	Список глобальных типов активов
GlobalInventoryState	Список состояний глобального инвентаризации.

Azure.Core.Foundations.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	Объект ошибки.

Azure.Core.Foundations.InnerError

Объект

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.

DeltaDetailsRequest

Объект

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

Имя	Тип	Описание
date	string	ожидаемый формат: гггг-ММ-дд
deltaDetailType	DeltaDetailType	Тип извлекаемой разностной детализации.
kind	GlobalAssetType	Тип ресурса
priorDays	integer (int32)	Количество дней, предшествующих получению разностных данных.

DeltaDetailType

Перечисление

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

Значение	Описание
added	Добавили
removed	удаленный

DeltaPageResult

Объект

Имя	Тип	Описание
nextLink	string	Ссылка для доступа к следующей странице результатов. Не задано, если в конце результирующий набор.
totalElements	integer (int64)	Общее количество элементов, доступных в полном результирующем наборе.
value	DeltaResult[]	Элементы на текущей странице результатов.

DeltaResult

Объект

Результат для каждого ответа с разностной детализацией

Имя	Тип	Описание
createdAt	string (date-time)	Показывает дату создания ресурса
kind	GlobalAssetType	Показывает тип ресурса
name	string	Показывает имя ресурса
state	GlobalInventoryState	Показывает состояние инвентаризации
updatedAt	string (date-time)	Показывает дату последнего обновления ресурса, как правило, дату, на который мы пытаемся извлечь результаты.

GlobalAssetType

Перечисление

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

Значение	Описание
page	страница
resource	ресурс
mailServer	почтовый сервер
nameServer	сервер имен
host	хозяин
domain	домен
ipAddress	IP-адрес
ipBlock	IP-блок
as	номер автономной системы
contact	контакт
sslCert	SSL-сертификат

GlobalInventoryState

Перечисление

Список состояний глобального инвентаризации.

Значение	Описание
candidate	кандидат
candidateInvestigate	кандидат расследует
confirmed	хронический
associated	связанный
associatedPartner	связанный партнер
associatedThirdParty	связанная сторонняя сторона
archived	Архив
dismissed	Уволен
autoconfirmed	автоматическое подтверждение