次の方法で共有


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 パラメーター

名前 / 必須 説明
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

返されるリソースの順序を指定する式のリスト。

要求本文

名前 必須 説明
columns True

string[]

エクスポートする列。

fileName True

string

エクスポートするファイルの名前です。

応答

名前 説明
200 OK

Task

要求は成功しました。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

予期しないエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

OAuth2Auth

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
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"
}

定義

名前 説明
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

資産のエクスポートに使用される要求本文。

名前 説明
columns

string[]

エクスポートする列。

fileName

string

エクスポートするファイルの名前です。

Azure.Core.Foundations.Error

error オブジェクト。

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

details

Azure.Core.Foundations.Error[]

この報告されたエラーの原因となった特定のエラーに関する詳細の配列。

innererror

Azure.Core.Foundations.InnerError

エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。

message

string

エラーの人間が判読できる表現。

target

string

エラーのターゲット。

Azure.Core.Foundations.ErrorResponse

エラーの詳細を含む応答。

名前 説明
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

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

innererror

Azure.Core.Foundations.InnerError

内部エラー。

Task

名前 説明
completedAt

string

タスクが完了した時刻。

id

string

タスクの一意識別子。

lastPolledAt

string

タスクの状態が最後に更新された時刻。

metadata

タスクに固有の属性。 これはタスクの種類によって異なります。

phase

TaskPhase

タスクのフェーズ。

reason

string

タスクが完了していない場合に、タスクが現在の状態に移動された理由。

startedAt

string

タスクが開始された時刻。

state

TaskState

タスクの状態。

TaskPhase

タスクのフェーズ。

名前 説明
complete

string

polling

string

running

string

TaskState

タスクの状態。

名前 説明
complete

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string