Assets - Get Assets Export

Layanan:

Defender EASM (preview)

Versi API:

2024-10-01-preview

Ekspor daftar aset untuk parameter pencarian yang disediakan.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	Titik akhir yang menghosting sumber daya yang diminta. Misalnya, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.
filter	query		string	Filter daftar hasil menggunakan ekspresi yang diberikan.
orderby	query		string	Daftar ekspresi yang menentukan urutan sumber daya yang dikembalikan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
columns	True	string[]	Kolom yang akan diekspor.
fileName	True	string	Nama file yang akan diekspor.

Respons

Nama	Jenis	Deskripsi
200 OK	Task	Permintaan telah berhasil.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://easm.defender.microsoft.com/.default

Contoh

Assets_GetAssetsExport

Permintaan sampel

HTTP

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

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

Respon sampel

Kode status:

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

Definisi

Nama	Deskripsi
AssetsExportRequest	Isi permintaan yang digunakan untuk mengekspor aset.
Azure.Core.Foundations.Error	Objek kesalahan.
Azure.Core.Foundations.ErrorResponse	Respons yang berisi detail kesalahan.
Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Task
TaskPhase	Fase tugas berada.
TaskState	Status tempat tugas berada.

AssetsExportRequest

Objek

Isi permintaan yang digunakan untuk mengekspor aset.

Nama	Jenis	Deskripsi
columns	string[]	Kolom yang akan diekspor.
fileName	string	Nama file yang akan diekspor.

Azure.Core.Foundations.Error

Objek

Objek kesalahan.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
details	Azure.Core.Foundations.Error[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

Azure.Core.Foundations.ErrorResponse

Objek

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	Azure.Core.Foundations.Error	Objek kesalahan.

Azure.Core.Foundations.InnerError

Objek

Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
innererror	Azure.Core.Foundations.InnerError	Kesalahan dalam.

Task

Objek

Nama	Jenis	Deskripsi
completedAt	string (date-time)	Waktu tugas selesai.
id	string	Pengidentifikasi unik tugas.
lastPolledAt	string (date-time)	Terakhir kali status tugas diperbarui.
metadata		Atribut unik untuk tugas. Ini berbeda menurut jenis tugas.
phase	TaskPhase	Fase tugas berada.
reason	string	Alasan tugas dipindahkan ke statusnya saat ini, jika tugas tidak selesai.
startedAt	string (date-time)	Waktu tugas dimulai.
state	TaskState	Status tempat tugas berada.

TaskPhase

Enumerasi

Fase tugas berada.

Nilai	Deskripsi
running
polling
complete

TaskState

Enumerasi

Status tempat tugas berada.

Nilai	Deskripsi
pending
running
paused
complete
incomplete
failed
warning