Compartilhar via


Assets - Get Assets Export

Exporte uma lista de ativos para os parâmetros de pesquisa fornecidos.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string

O ponto de extremidade que hospeda o recurso solicitado. Por exemplo, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

A versão da API a ser usada para esta operação.

filter
query

string

Filtre a lista de resultados usando a expressão fornecida.

orderby
query

string

Uma lista de expressões que especificam a ordem dos recursos retornados.

Corpo da solicitação

Nome Obrigatório Tipo Description
columns True

string[]

As colunas a serem exportadas.

fileName True

string

Nome do arquivo a ser exportado.

Respostas

Nome Tipo Description
200 OK

Task

A solicitação foi bem-sucedida.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

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

Exemplos

Assets_GetAssetsExport

Solicitação de exemplo

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

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

Resposta de exemplo

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

Definições

Nome Description
AssetsExportRequest

Um corpo de solicitação usado para exportar um ativo.

Azure.Core.Foundations.Error

O objeto de erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta que contém detalhes do erro.

Azure.Core.Foundations.InnerError

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Task
TaskPhase

A fase em que a tarefa está.

TaskState

O estado em que a tarefa está.

AssetsExportRequest

Um corpo de solicitação usado para exportar um ativo.

Nome Tipo Description
columns

string[]

As colunas a serem exportadas.

fileName

string

Nome do arquivo a ser exportado.

Azure.Core.Foundations.Error

O objeto de erro.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

details

Azure.Core.Foundations.Error[]

Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.

innererror

Azure.Core.Foundations.InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

message

string

Uma representação legível pelo homem do erro.

target

string

O destino do erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta que contém detalhes do erro.

Nome Tipo Description
error

Azure.Core.Foundations.Error

O objeto de erro.

Azure.Core.Foundations.InnerError

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

innererror

Azure.Core.Foundations.InnerError

Erro interno.

Task

Nome Tipo Description
completedAt

string

A hora em que a tarefa foi concluída.

id

string

O identificador exclusivo da tarefa.

lastPolledAt

string

A última vez que o status da tarefa foi atualizado.

metadata

Atributos exclusivos para a tarefa. Isso difere por tipo de tarefa.

phase

TaskPhase

A fase em que a tarefa está.

reason

string

O motivo pelo qual a tarefa foi movida para seu estado atual, se a tarefa não foi concluída.

startedAt

string

A hora em que a tarefa foi iniciada.

state

TaskState

O estado em que a tarefa está.

TaskPhase

A fase em que a tarefa está.

Nome Tipo Description
complete

string

polling

string

running

string

TaskState

O estado em que a tarefa está.

Nome Tipo Description
complete

string

failed

string

incomplete

string

paused

string

pending

string

running

string

warning

string