다음을 통해 공유


Assets - Get Assets Export

제공된 검색 매개 변수에 대한 자산 목록을 내보냅니다.

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 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
path True

string

요청된 리소스를 호스트하는 엔드포인트입니다. 예를 들어 https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

이 작업에 사용할 API 버전입니다.

filter
query

string

지정된 식을 사용하여 결과 목록을 필터링합니다.

orderby
query

string

반환된 리소스의 순서를 지정하는 식 목록입니다.

요청 본문

Name 필수 형식 Description
columns True

string[]

내보낼 열입니다.

fileName True

string

내보낼 파일의 이름입니다.

응답

Name 형식 Description
200 OK

Task

요청이 성공했습니다.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

예제

Assets_GetAssetsExport

샘플 요청

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

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

샘플 응답

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

정의

Name Description
AssetsExportRequest

자산을 내보내는 데 사용되는 요청 본문입니다.

Azure.Core.Foundations.Error

Error 개체.

Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.

Azure.Core.Foundations.InnerError

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Task
TaskPhase

태스크가 있는 단계입니다.

TaskState

작업이 있는 상태입니다.

AssetsExportRequest

자산을 내보내는 데 사용되는 요청 본문입니다.

Name 형식 Description
columns

string[]

내보낼 열입니다.

fileName

string

내보낼 파일의 이름입니다.

Azure.Core.Foundations.Error

Error 개체.

Name 형식 Description
code

string

서버 정의 오류 코드 집합 중 하나입니다.

details

Azure.Core.Foundations.Error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.

innererror

Azure.Core.Foundations.InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

message

string

사람이 읽을 수 있는 오류 표현입니다.

target

string

오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name 형식 Description
error

Azure.Core.Foundations.Error

Error 개체.

Azure.Core.Foundations.InnerError

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name 형식 Description
code

string

서버 정의 오류 코드 집합 중 하나입니다.

innererror

Azure.Core.Foundations.InnerError

내부 오류입니다.

Task

Name 형식 Description
completedAt

string

작업이 완료된 시간입니다.

id

string

작업의 고유 식별자입니다.

lastPolledAt

string

작업의 상태가 마지막으로 업데이트된 시간입니다.

metadata

작업에 고유한 특성입니다. 작업 유형에 따라 다릅니다.

phase

TaskPhase

태스크가 있는 단계입니다.

reason

string

작업이 완료되지 않은 경우 작업이 현재 상태로 이동된 이유입니다.

startedAt

string

작업이 시작된 시간입니다.

state

TaskState

작업이 있는 상태입니다.

TaskPhase

태스크가 있는 단계입니다.

Name 형식 Description
complete

string

polling

string

running

string

TaskState

작업이 있는 상태입니다.

Name 형식 Description
complete

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string