本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListFindingsV2
检索指定分析器生成的发现结果列表。 ListFindings 和 ListFindings V2 都access-analyzer:ListFindings在 IAM 政策声明的Action元素中使用。你必须有权限才能执行该access-analyzer:ListFindings操作。
要了解可用于检索结果列表的筛选密钥,请参阅 IAM 用户指南中的 IAM 访问分析器筛选密钥。
请求语法
POST /findingv2 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": [
{
"analyzedAt": "string",
"createdAt": "string",
"error": "string",
"findingType": "string",
"id": "string",
"resource": "string",
"resourceOwnerAccount": "string",
"resourceType": "string",
"status": "string",
"updatedAt": "string"
}
],
"nextToken": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- findings
-
从分析器检索到的符合指定筛选条件(如果有)的结果列表。
类型:FindingSummaryV2 对象数组
- nextToken
-
用于对返回的结果进行分页的令牌。
类型:字符串
错误
有关所有操作的常见错误信息,请参阅 常见错误类型。
- AccessDeniedException
-
您没有足够的访问权限,无法执行该操作。
HTTP 状态代码:403
- InternalServerException
-
内部服务器错误。
- retryAfterSeconds
-
等待重试的秒数。
HTTP 状态代码:500
- ResourceNotFoundException
-
找不到指定资源。
- resourceId
-
资源的 ID。
- resourceType
-
资源的类型。
HTTP 状态代码:404
- ThrottlingException
-
超出节流限制错误。
- retryAfterSeconds
-
等待重试的秒数。
HTTP 状态代码:429
- ValidationException
-
验证异常错误。
- fieldList
-
未验证的字段列表。
- reason
-
例外的原因。
HTTP 状态代码:400
另请参阅
有关在某个特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: