Assets - Get Assets Export

Hizmet:

Defender EASM (preview)

API Sürümü:

2024-10-01-preview

Sağlanan arama parametreleri için varlıkların listesini dışarı aktarın.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	İstenen kaynağı barındıran uç nokta. Örneğin, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
filter	query		string	Verilen ifadeyi kullanarak sonuç listesini filtreleyin.
orderby	query		string	Döndürülen kaynakların sırasını belirten ifadelerin listesi.

İstek Gövdesi

Name	Gerekli	Tür	Description
columns	True	string[]	Dışarı aktaracak sütunlar.
fileName	True	string	Dışarı aktaracak dosyanın adı.

Yanıtlar

Name	Tür	Description
200 OK	Task	İstek başarılı oldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Örnekler

Assets_GetAssetsExport

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:

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

Tanımlar

Name	Description
AssetsExportRequest	Bir varlığı dışarı aktarmak için kullanılan istek gövdesi.
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Task
TaskPhase	Görevin içinde olduğu aşama.
TaskState	Görevin içinde olduğu durum.

AssetsExportRequest

Nesne

Bir varlığı dışarı aktarmak için kullanılan istek gövdesi.

Name	Tür	Description
columns	string[]	Dışarı aktaracak sütunlar.
fileName	string	Dışarı aktaracak dosyanın adı.

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

Task

Nesne

Name	Tür	Description
completedAt	string (date-time)	Görevin tamamlanma zamanı.
id	string	Görevin benzersiz tanımlayıcısı.
lastPolledAt	string (date-time)	Görevin durumunun son güncelleştirilişi.
metadata		Göreve özgü öznitelikler. Bu, görev türüne göre farklılık gösterir.
phase	TaskPhase	Görevin içinde olduğu aşama.
reason	string	Görev tamamlanmadıysa, görevin geçerli durumuna taşınma nedeni.
startedAt	string (date-time)	Görevin başladığı zaman.
state	TaskState	Görevin içinde olduğu durum.

TaskPhase

Numaralandırma

Görevin içinde olduğu aşama.

Değer	Description
running
polling
complete

TaskState

Numaralandırma

Görevin içinde olduğu durum.

Değer	Description
pending
running
paused
complete
incomplete
failed
warning