Assets - Get Assets Export

Szolgáltatás:

Defender EASM (preview)

API-verzió:

2024-10-01-preview

Exportálja a megadott keresési paraméterek objektumlistáját.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A kért erőforrást üzemeltető végpont. Például https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.
filter	query		string	Szűrje az eredménylistát a megadott kifejezéssel.
orderby	query		string	A visszaadott erőforrások sorrendjét meghatározó kifejezések listája.

Kérelem törzse

Name	Kötelező	Típus	Description
columns	True	string[]	Az exportálandó oszlopok.
fileName	True	string	Az exportálandó fájl neve.

Válaszok

Name	Típus	Description
200 OK	Task	A kérés sikeres volt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

Assets_GetAssetsExport

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
AssetsExportRequest	Egy objektum exportálásához használt kérelemtörzs.
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Task
TaskPhase	A tevékenység fázisa.
TaskState	Az az állapot, amelyben a tevékenység szerepel.

AssetsExportRequest

Tárgy

Egy objektum exportálásához használt kérelemtörzs.

Name	Típus	Description
columns	string[]	Az exportálandó oszlopok.
fileName	string	Az exportálandó fájl neve.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

Task

Tárgy

Name	Típus	Description
completedAt	string (date-time)	A tevékenység befejezésének időpontja.
id	string	A tevékenység egyedi azonosítója.
lastPolledAt	string (date-time)	A tevékenység állapotának legutóbbi frissítésekor.
metadata		A tevékenységhez egyedi attribútumok. Ez tevékenységtípusonként eltérő.
phase	TaskPhase	A tevékenység fázisa.
reason	string	Annak oka, hogy a tevékenység át lett helyezve a jelenlegi állapotába, ha a tevékenység nem fejeződött be.
startedAt	string (date-time)	A tevékenység kezdési időpontja.
state	TaskState	Az az állapot, amelyben a tevékenység szerepel.

TaskPhase

Felsorolás

A tevékenység fázisa.

Érték	Description
running
polling
complete

TaskState

Felsorolás

Az az állapot, amelyben a tevékenység szerepel.

Érték	Description
pending
running
paused
complete
incomplete
failed
warning