ListFindings - IAM Access Analyzer

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListFindings

检索指定分析器生成的结果列表。 ListFindings 和 ListFindings V2 都access-analyzer:ListFindings在 IAM 策略声明的Action元素中使用。您必须拥有执行该access-analyzer:ListFindings操作的权限。

要了解可用于检索发现结果列表的筛选密钥,请参阅 IAM 用户指南中的 IAM Access Analyzer 筛选密钥

请求语法

POST /finding HTTP/1.1 Content-type: application/json { "analyzerArn": "string", "filter": { "string" : { "contains": [ "string" ], "eq": [ "string" ], "exists": boolean, "neq": [ "string" ] } }, "maxResults": number, "nextToken": "string", "sort": { "attributeName": "string", "orderBy": "string" } }

URI 请求参数

该请求不使用任何 URI 参数。

请求体

请求接受采用 JSON 格式的以下数据。

analyzerArn

要从中检索结果的分析器的 ARN

类型:字符串

模式:[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

必需:是

filter

与要返回的结果相匹配的过滤器。

类型:字符串到 Criterion 对象的映射

必需:否

maxResults

响应中返回的最大结果数。

类型:整数

必需:否

nextToken

用于对返回的结果进行分页的标记。

类型:字符串

必需:否

sort

返回了调查结果的排序顺序。

类型:SortCriteria 对象

必需:否

响应语法

HTTP/1.1 200 Content-type: application/json { "findings": [ { "action": [ "string" ], "analyzedAt": "string", "condition": { "string" : "string" }, "createdAt": "string", "error": "string", "id": "string", "isPublic": boolean, "principal": { "string" : "string" }, "resource": "string", "resourceOwnerAccount": "string", "resourceType": "string", "sources": [ { "detail": { "accessPointAccount": "string", "accessPointArn": "string" }, "type": "string" } ], "status": "string", "updatedAt": "string" } ], "nextToken": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

findings

从分析器检索到的符合指定筛选条件的结果列表(如果有)。

类型:FindingSummary 对象数组

nextToken

用于对返回的结果进行分页的标记。

类型:字符串

错误

有关所有操作返回的常见错误的信息,请参阅常见错误

AccessDeniedException

您没有足够的访问权限,无法执行该操作。

HTTP 状态代码:403

InternalServerException

内部服务器错误。

HTTP 状态代码:500

ResourceNotFoundException

找不到指定资源。

HTTP 状态代码:404

ThrottlingException

超过限制限制错误。

HTTP 状态代码:429

ValidationException

验证异常错误。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: