更新时间:2025-11-06 GMT+08:00

更新指定结果的状态 - UpdateFindings

功能介绍

更新指定访问分析结果的状态。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

AccessAnalyzer:analyzer:updateFindings

Write

analyzer *

g:ResourceTag/<tag-key>

-

-

URI

PUT /v5/analyzers/{analyzer_id}/findings

表1 路径参数

参数

是否必选

参数类型

描述

analyzer_id

String

分析器的唯一标识符。

最小长度:1

最大长度:36

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

ids

Array of strings

要更新的访问分析结果唯一标识符数组。

数组长度:1 - 50

resource_urn

String

资源的唯一资源标识符。

status

String

要更新的访问分析结果状态。

  • active:活跃

  • archived:已存档

响应参数

状态码:200

OK

请求示例

更新指定结果的状态。

PUT https://{hostname}/v5/analyzers/{analyzer_id}/findings

{
  "ids" : [ "{finding_id}" ],
  "resource_urn" : "iam::{domain_id}:agency:{agency_name}",
  "status" : "active"
}

响应示例

状态码

状态码

描述

200

OK

错误码

请参见错误码