Sdílet prostřednictvím


Assets - Get Assets Export

Exportujte seznam prostředků pro zadané parametry hledání.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
path True

string

Koncový bod hostující požadovaný prostředek. Například https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

filter
query

string

Filtrujte seznam výsledků pomocí daného výrazu.

orderby
query

string

Seznam výrazů, které určují pořadí vrácených prostředků.

Text požadavku

Name Vyžadováno Typ Description
columns True

string[]

Sloupce, které chcete exportovat.

fileName True

string

Název souboru, který se má exportovat.

Odpovědi

Name Typ Description
200 OK

Task

Žádost byla úspěšná.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď.

Hlavičky

x-ms-error-code: string

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

Assets_GetAssetsExport

Ukázkový požadavek

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

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

Ukázková odpověď

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

Definice

Name Description
AssetsExportRequest

Text požadavku použitý k exportu prostředku.

Azure.Core.Foundations.Error

Objekt chyby.

Azure.Core.Foundations.ErrorResponse

Odpověď obsahující podrobnosti o chybě.

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní Microsoft One API – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Task
TaskPhase

Fáze, ve které se úkol nachází.

TaskState

Stav, ve který se úkol nachází.

AssetsExportRequest

Text požadavku použitý k exportu prostředku.

Name Typ Description
columns

string[]

Sloupce, které chcete exportovat.

fileName

string

Název souboru, který se má exportovat.

Azure.Core.Foundations.Error

Objekt chyby.

Name Typ Description
code

string

Jeden ze serverem definované sady kódů chyb.

details

Azure.Core.Foundations.Error[]

Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.

innererror

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě než aktuální objekt.

message

string

Lidsky čitelná reprezentace chyby.

target

string

Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name Typ Description
error

Azure.Core.Foundations.Error

Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní Microsoft One API – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name Typ Description
code

string

Jeden ze serverem definované sady kódů chyb.

innererror

Azure.Core.Foundations.InnerError

Vnitřní chyba.

Task

Name Typ Description
completedAt

string

Čas dokončení úkolu.

id

string

Jedinečný identifikátor úkolu.

lastPolledAt

string

Čas poslední aktualizace stavu úkolu.

metadata

Atributy jedinečné pro úkol. To se liší podle typu úkolu.

phase

TaskPhase

Fáze, ve které se úkol nachází.

reason

string

Důvod, proč byl úkol přesunut do aktuálního stavu, pokud se úkol nedokončil.

startedAt

string

Čas, kdy úkol začal.

state

TaskState

Stav, ve který se úkol nachází.

TaskPhase

Fáze, ve které se úkol nachází.

Name Typ Description
complete

string

polling

string

running

string

TaskState

Stav, ve který se úkol nachází.

Name Typ Description
complete

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string