检索分析器的列表 - ListAnalyzers

功能介绍

检索分析器的列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
AccessAnalyzer:analyzer:list	List	analyzer *	-	-	-

URI

GET /v5/analyzers

表1 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	单页最大结果数。最小值：1 最大值：200 缺省值：100
marker	否	String	页面标记。最小长度：4 最大长度：400
type	否	String	分析器的类型。 account：账号级外部访问分析器 organization：组织级外部访问分析器 account_unused_access：账号级未使用访问分析器 organization_unused_access：组织级未使用访问分析器 account_privilege_escalation：账号级提权访问分析器 account_iam_best_practice：账号级IAM最佳实践分析器

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
analyzers	Array of AnalyzerSummary objects	分析器列表信息。
page_info	PageInfo object	页面的信息。

表3 AnalyzerSummary
参数	参数类型	描述
configuration	AnalyzerConfiguration object	分析器的配置项。
created_at	String	分析器创建的时间。
id	String	分析器的唯一标识符。
last_analyzed_resource	String	最近分析的资源的唯一资源标识符。
last_resource_analyzed_at	String	最近一次分析资源的时间。
last_all_analyzed_at	String	最近一次分析全量资源的时间。
name	String	分析器的名称。
organization_id	String	组织ID。
status	String	分析器的状态。 active：激活 creating：创建中 disabled：禁用 failed：创建失败
status_reason	StatusReason object	提供有关分析器当前状态的更多详细信息。
tags	Array of Tag objects	自定义标签列表。
type	String	分析器的类型。 account: 账号级外部访问分析器 organization：组织级外部访问分析器 account_unused_access：账号级未使用访问分析器 organization_unused_access：组织级未使用访问分析器 account_privilege_escalation：账号级提权访问分析器 account_iam_best_practice：账号级IAM最佳实践分析器
urn	String	分析器的唯一资源标识符。

表4 AnalyzerConfiguration
参数	参数类型	描述
unused_access	unused_access object	未使用的访问分析器的配置项。

表5 unused_access
参数	参数类型	描述
unused_access_age	Integer	生成分析结果的预设天数。最小值：1 最大值：180 缺省值：90
unused_analysis_rule	UnusedAnalysisRule object	未使用分析规则。

表6 UnusedAnalysisRule
参数	参数类型	描述
exclusions	Array of UnusedAnalysisRuleCriteria objects	排除规则。

表7 UnusedAnalysisRuleCriteria
参数	参数类型	描述
account_ids	Array of strings	账号ID列表。最小长度：1 最大长度：36 数组长度：0 - 2000
resource_tags	Array of Tag objects	资源标签列表。数组长度：0 - 20

表8 StatusReason
参数	参数类型	描述
code	String	分析器当前状态的原因。 delegated_administrator_deregistered：委托管理员未注册 trusted_service_disabled：可信服务未开启 internal_error：内部错误 organization_deleted：组织已删除 service_linked_agency_creation_failed：服务关联委托创建失败
details	String	分析器当前状态的详细原因。

表9 Tag
参数	参数类型	描述
key	String	标签键。
value	String	与标签键关联的字符串值。

**表10** PageInfo
参数	参数类型	描述
current_count	Integer	当前页中的项数。
next_marker	String	如果存在更多可用的输出，那么该值表示可用输出比当前响应中包含的更多。在后续调用此操作时，您可以在标记请求参数中使用此值，以获取输出的下一部分。您应该重复这个过程，直到next_marker返回为null。

请求示例

检索分析器的列表。

GET https://{hostname}/v5/analyzers

响应示例

状态码：200

{
  "analyzers" : [ {
    "created_at" : "2023-09-07T07:26:23.440Z",
    "id" : "{analyzer_id}",
    "last_analyzed_resource" : "iam::{domain_id}:agency:{agency_name}",
    "last_resource_analyzed_at" : "2023-09-07T07:26:23.440Z",
    "name" : "my-analyzer",
    "status" : "active",
    "tags" : [ {
      "key" : "key-1",
      "value" : "value-1"
    } ],
    "type" : "account",
    "urn" : "AccessAnalyzer:{region_id}:{domain_id}:analyzer:{analyzer_id}"
  } ],
  "page_info" : {
    "current_count" : 1,
    "next_marker" : null
  }
}