Updating the Status of the Specified Findings

Function

This API is used to update the status of a specified finding.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
AccessAnalyzer:analyzer:updateFindings	Write	analyzer *	g:ResourceTag/<tag-key>	-	-

URI

PUT /v5/analyzers/{analyzer_id}/findings

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
analyzer_id	Yes	String	Definition: Unique identifier of an analyzer. You can call the ListAnalyzers API to obtain the analyzer ID. The response parameters of this API return an analyzer list. The id field of each analyzer object is the analyzer ID. Range: 1 to 36 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
ids	No	Array of strings	Definition: Unique identifier array of findings to be updated. Constraints: N/A Range: The array length ranges from 1 to 50. Default Value: N/A
resource_urn	No	String	Definition: Unique identifier of a resource. Constraints: N/A Range: The value can contain up to 1,500 characters. Default Value: N/A
status	Yes	String	Definition: Status of the findings to be updated. Constraints: N/A Range: active archived Default Value: N/A

Response Parameters

Status code: 200

None

Example Requests

Updating the status of the specified findings

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

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