Saved Filters - Get Saved Filter

服务:

Defender EASM (preview)

API 版本:

2024-10-01-preview

按 filterName 检索已保存的筛选器。

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

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	托管所请求资源的终结点。 例如，https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
filterName	path	True	string	调用方为资源提供了唯一名称。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	SavedFilter	请求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	意外的错误响应。 标头 x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://easm.defender.microsoft.com/.default

示例

SavedFilters_GetSavedFilter

示例请求

HTTP

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

示例响应

状态代码:

200

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

定义

名称	说明
Azure.Core.Foundations.Error	错误对象。
Azure.Core.Foundations.ErrorResponse	包含错误详细信息的响应。
Azure.Core.Foundations.InnerError	包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。
SavedFilter

Azure.Core.Foundations.Error

Object

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	错误的人工可读表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

Object

包含错误详细信息的响应。

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

Object

包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	Azure.Core.Foundations.InnerError	内部错误。

SavedFilter

Object

名称	类型	说明
description	string
displayName	string	可用于显示的名称。
filter	string
id	string	这通常与名称相同，但对于不同的模型可能不同。
name	string	调用方为资源提供了唯一名称。