显示指定的分析器 - ShowAnalyzer

功能介绍

检索有关指定分析器的信息。

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
AccessAnalyzer:analyzer:get	Read	analyzer *	g:ResourceTag/<tag-key>	-	-

URI

GET /v5/analyzers/{analyzer_id}

表1 路径参数
参数	是否必选	参数类型	描述
analyzer_id	是	String	分析器的唯一标识符。最小长度：1 最大长度：36

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
analyzer	AnalyzerSummary 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 数组长度：1 - 2000
resource_tags	Array of Tag objects	资源标签列表。数组长度：1 - 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	与标签键关联的字符串值。

请求示例

检索有关指定分析器的信息。

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

响应示例

状态码：200

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