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


Assets - Get Assets Export

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

POST {endpoint}/assets:export?api-version=2024-03-01-preview
POST {endpoint}/assets:export?api-version=2024-03-01-preview&filter={filter}&orderby={orderby}

Параметры URI

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

string

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

api-version
query True

string

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

filter
query

string

Отфильтруйте список результатов с помощью заданного выражения.

orderby
query

string

Список выражений, определяющих порядок возвращаемых ресурсов.

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

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

string[]

Столбцы для экспорта.

fileName True

string

Имя файла для экспортирования.

Ответы

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

Task

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

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_GetAssetsExport

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

POST {endpoint}/assets:export?api-version=2024-03-01-preview&filter=state%20%3D%20%22confirmed%22

{
  "fileName": "ThisisaFileName",
  "columns": [
    "asset",
    "name"
  ]
}

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

{
  "id": "ThisisaTaskId",
  "startedAt": "2022-05-02T19:30:14.432+00:00",
  "completedAt": "2022-05-02T19:30:54.432+00:00",
  "lastPolledAt": "2022-05-02T19:30:19.432+00:00",
  "state": "complete",
  "phase": "complete",
  "reason": "This is a Task id"
}

Определения

Имя Описание
AssetsExportRequest

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

Azure.Core.Foundations.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.

Task
TaskPhase

Этап, на который выполняется задача.

TaskState

Состояние, в которое находится задача.

AssetsExportRequest

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

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

string[]

Столбцы для экспорта.

fileName

string

Имя файла для экспортирования.

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

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

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

string

Один из серверных наборов кодов ошибок.

innererror

Azure.Core.Foundations.InnerError

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

Task

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

string

Время выполнения задачи.

id

string

Уникальный идентификатор задачи.

lastPolledAt

string

Время последнего обновления состояния задачи.

metadata

Атрибуты, уникальные для задачи. Это зависит от типа задачи.

phase

TaskPhase

Этап, на который выполняется задача.

reason

string

Причина перемещения задачи в текущее состояние, если задача не была завершена.

startedAt

string

Время запуска задачи.

state

TaskState

Состояние, в которое находится задача.

TaskPhase

Этап, на который выполняется задача.

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

string

polling

string

running

string

TaskState

Состояние, в которое находится задача.

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

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string