Reevaluate - Recommendation

服务:

Sentinel

API 版本:

2025-07-01-preview

重新评估建议。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/recommendations/{recommendationId}/triggerEvaluation?api-version=2025-07-01-preview

URI 参数

名称	在	必需	类型	说明
recommendationId	path	True	string (uuid)	建议 ID。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	工作区的名称。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	ReevaluateResponse	OK
Other Status Codes	CloudError	描述作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Reevaluate a recommendation.

示例请求

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/recommendations/6d4b54eb-8684-4aa3-a156-3aa37b8014bc/triggerEvaluation?api-version=2025-07-01-preview

示例响应

状态代码:

200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Recommendations/ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
  "name": "ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
  "type": "Microsoft.SecurityInsights/Recommendations",
  "properties": {
    "lastEvaluatedTimeUtc": "2023-10-10T03:09:03.4888396+00:00"
  }
}

定义

名称	说明
CloudError	错误响应结构。
CloudErrorBody	错误详细信息。
ReevaluateResponse	重新评估响应对象。

CloudError

Object

错误响应结构。

名称	类型	说明
error	CloudErrorBody	错误数据

CloudErrorBody

Object

错误详细信息。

名称	类型	说明
code	string	错误的标识符。 代码是固定的，旨在以编程方式使用。
message	string	描述错误的消息，旨在适合在用户界面中显示。

ReevaluateResponse

Object

重新评估响应对象。

名称	类型	说明
lastEvaluatedTimeUtc	string (date-time)	上次评估建议时的时间戳（UTC）。