Saved Filters - Get Saved Filter

Serviço:

Defender EASM (preview)

Versão da API:

2024-10-01-preview

Recupere um filtro salvo por filterName.

GET {endpoint}/savedFilters/{filterName}?api-version=2024-10-01-preview

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}
filterName	path	True	string	O chamador forneceu um nome exclusivo para o recurso.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	SavedFilter	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

SavedFilters_GetSavedFilter

Solicitação de exemplo

HTTP

GET {endpoint}/savedFilters/ThisisaSavedFilter?api-version=2024-10-01-preview

Resposta de exemplo

Código de status:

200

{
  "id": "ThisisaSavedFilter",
  "name": "ThisisaSavedFilter",
  "displayName": "ThisisaSavedFilter",
  "filter": "state IN (\"confirmed\")",
  "description": "This is a saved filter"
}

Definições

Nome	Description
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/azure/Guidelines.md#handling-errors.
SavedFilter

Azure.Core.Foundations.Error

Objeto

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 ser humano do erro.
target	string	O destino do erro.

Azure.Core.Foundations.ErrorResponse

Objeto

Uma resposta que contém detalhes do erro.

Nome	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Objeto

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/azure/Guidelines.md#handling-errors.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

SavedFilter

Objeto

Nome	Tipo	Description
description	string
displayName	string	O nome que pode ser usado para fins de exibição.
filter	string
id	string	Normalmente, isso é o mesmo que o nome, mas pode ser diferente para modelos diferentes.
name	string	O chamador forneceu um nome exclusivo para o recurso.