ListFindings - 列出Findings-访问控制(RAM)-阿里云帮助中心

列出指定 Analyzer 下的所有 Finding，支持通过筛选条件过滤结果。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

accessanalyzer:ListFindings

none

*Analyzer

acs:accessanalyzer:{#regionId}:{#accountId}:Analyzer/{#AnalyzerName}

无

请求参数

名称	类型	必填	描述	示例值
Filter	array<object>	否	过滤条件列表
	object	否	过滤条件
Key	string	否	过滤条件的字段名	ResourceType
Values	array	否	过滤条件的值列表
	string	否	过滤条件的值	ACS::OSS::Bucket
MatchType	string	否	过滤条件的匹配方式枚举值： Equals : Equals Exists : Exists Contains : Contains NotEquals : NotEquals	Equals
AnalyzerName	string	是	分析器名称	MyAnalyzer
MaxResults	integer	否	单次请求返回的最大 Finding 数量，默认 100	10
NextToken	string	否	分页标记，首次请求不填，后续请求使用上一次返回的 NextToken 值	eyJpbmRleCI6IjIifQ==

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
NextToken	string	翻页 Token	eyJpbmRleCI6IjIifQ==
Findings	array<object>	Finding 结果列表
	object	Finding 信息
AnalyzedTime	string	资源最后一次被分析的时间。时间格式为 ISO 8601，时区为 UTC。	2024-02-15T08:30:00Z
CreatedTime	string	Finding 创建时间。时间格式为 ISO 8601，时区为 UTC。	2024-02-10T06:00:00Z
UpdatedTime	string	Finding 最后更新时间。时间格式为 ISO 8601，时区为 UTC。	2024-02-15T08:30:00Z
Error	string	分析过程中的错误信息，无错误时为空	ACCESS_DENIED
FindingType	string	Finding 的类型枚举值： InactiveRole : InactiveRole PrivilegeEscalationUser : PrivilegeEscalationUser InactiveUser : InactiveUser OverPrivilegedRole : OverPrivilegedRole ExternalAccess : ExternalAccess OverPrivilegedUser : OverPrivilegedUser SuperRole : SuperRole SuperUser : SuperUser PrivilegeEscalationRole : PrivilegeEscalationRole	ExternalAccess
Id	string	Finding 的唯一标识符	53218979-82fe-476d-bba5-09879ef24b66
ResourceArn	string	被分析资源 Arn	acs:oss:oss-cn-hangzhou:1234567890:my-bucket
ResourceType	string	被分析的资源类型	ACS::RAM::Role
ResourceOwnerAccount	string	被分析资源的归属账号 ID	1234567890
Status	string	Finding 的状态枚举值： Active : 活跃 Resolved : 已解决 Archived : 已归档	Active

示例

正常返回示例

JSON格式

{
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "NextToken": "eyJpbmRleCI6IjIifQ==",
  "Findings": [
    {
      "AnalyzedTime": "2024-02-15T08:30:00Z",
      "CreatedTime": "2024-02-10T06:00:00Z",
      "UpdatedTime": "2024-02-15T08:30:00Z",
      "Error": "ACCESS_DENIED",
      "FindingType": "ExternalAccess",
      "Id": "53218979-82fe-476d-bba5-09879ef24b66",
      "ResourceArn": "acs:oss:oss-cn-hangzhou:1234567890:my-bucket",
      "ResourceType": "ACS::RAM::Role",
      "ResourceOwnerAccount": "1234567890",
      "Status": "Active"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.%s	The specified parameter %s is not valid.	无效参数%s
400	MissingParameter.%s	The specified parameter %s is missing.	参数%s为必填参数。
400	NotSupport.ResourceType	The specified ResourceType is not supported.	当前资源类型不支持。
400	ExceedLimit.%s	The maximum number of %s is exceeded.	数量超过上限
500	InternalError	The request processing has failed due to some unknown error.	内部服务错误。
404	EntityNotExist.%s	The %s does not exist.	%s不存在

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。