你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Assets - Get Observations

检索对资产的观察结果

POST {endpoint}/assets/{assetId}:getObservations?api-version=2024-03-01-preview
POST {endpoint}/assets/{assetId}:getObservations?api-version=2024-03-01-preview&filter={filter}&orderby={orderby}&skip={skip}&maxpagesize={maxpagesize}

URI 参数

名称 必需 类型 说明
assetId
path True

string

系统为资源生成了唯一 ID。

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

使用给定的表达式筛选结果列表。

maxpagesize
query

integer

int32

每页的最大结果项数。

orderby
query

string

指定返回的资源顺序的表达式列表。

skip
query

integer

int32

要跳过的结果项数。

响应

名称 类型 说明
200 OK

ObservationPageResult

请求已成功。

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

示例

Assets_GetObservations

示例请求

POST {endpoint}/assets/aG9zdCQkY29udG9zby5jb20:getObservations?api-version=2024-03-01-preview

示例响应

{
  "totalElements": 0,
  "prioritySummary": {
    "high": 0,
    "medium": 0,
    "low": 0
  },
  "value": []
}

定义

名称 说明
Azure.Core.Foundations.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

ObservationPageResult

观察结果的页面结果响应

ObservationPriority

观察优先级列表

ObservationResult

观察的结果响应

ObservationType

观察类型列表

Azure.Core.Foundations.Error

错误对象。

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

details

Azure.Core.Foundations.Error[]

有关导致此项报告错误的特定错误的详细信息数组。

innererror

Azure.Core.Foundations.InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

message

string

错误的用户可读表示形式。

target

string

错误的目标。

Azure.Core.Foundations.ErrorResponse

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

名称 类型 说明
error

Azure.Core.Foundations.Error

错误对象。

Azure.Core.Foundations.InnerError

包含有关错误的更具体信息的对象。 根据 Microsoft One API 指南 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

innererror

Azure.Core.Foundations.InnerError

内部错误。

ObservationPageResult

观察结果的页面结果响应

名称 类型 说明
prioritySummary

object

按优先级显示的观察计数摘要。

totalElements

integer

元素的总数。

value

ObservationResult[]

观察结果的列表。

ObservationPriority

观察优先级列表

名称 类型 说明
high

string

high

low

string

low

medium

string

none

string

ObservationResult

观察的结果响应

名称 类型 说明
cvssScoreV2

number

CVSS v2 分数。

cvssScoreV3

number

CVSS v3 分数。

name

string

观察的名称。

priority

ObservationPriority

观察的优先级。

types

ObservationType[]

适用类型的列表。

ObservationType

观察类型列表

名称 类型 说明
cve

string

常见漏洞和暴露

insight

string

洞察 力