Aracılığıyla paylaş


Assets - Get Assets Export

Sağlanan arama parametreleri için varlıkların listesini dışarı aktarı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}

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
path True

string

İ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

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

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

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

Örnek yanıt

{
  "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. Microsoft One API yönergelerine göre - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Task
TaskPhase

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

TaskState

Görevin içinde olduğu durum.

AssetsExportRequest

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

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 hatalarla ilgili ayrıntılar dizisi.

innererror

Azure.Core.Foundations.InnerError

Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.

message

string

Hatanın insan tarafından okunabilen bir gösterimi.

target

string

Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

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

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Microsoft One API yönergelerine göre - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.

innererror

Azure.Core.Foundations.InnerError

İç hata.

Task

Name Tür Description
completedAt

string

Görevin tamamlanma zamanı.

id

string

Görevin benzersiz tanımlayıcısı.

lastPolledAt

string

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şınmasının nedeni.

startedAt

string

Görevin başladığı zaman.

state

TaskState

Görevin içinde olduğu durum.

TaskPhase

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

Name Tür Description
complete

string

polling

string

running

string

TaskState

Görevin içinde olduğu durum.

Name Tür Description
complete

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string