更新时间:2026-07-28 GMT+08:00
分享

检索分析器的列表 - 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

参数解释

分析器创建的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

id

String

参数解释

分析器的唯一标识符。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)及中划线(-)。

last_analyzed_resource

String

参数解释

最近分析的资源的唯一资源标识符。

取值范围

不涉及。

last_resource_analyzed_at

String

参数解释

最近一次分析资源的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

last_all_analyzed_at

String

参数解释

最近一次分析全量资源的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

name

String

参数解释

分析器的名称。

取值范围

最小长度为1,最大长度为255。仅支持包含字母、数字、下划线(_)、中划线(-)和点号(.)。

organization_id

String

参数解释

组织ID。

取值范围

最小长度为1,最大长度为35,格式为以 “ou-” 开头,后跟 8 到 32 位的小写字母或数字。

status

String

参数解释

分析器的状态。

取值范围

  • active:激活

  • creating:创建中

  • disabled:禁用

  • failed:创建失败

status_reason

StatusReason object

参数解释

提供有关分析器当前状态的更多详细信息。

取值范围

不涉及。

tags

Array of Tag objects

参数解释

自定义标签列表。

取值范围

数组长度为1到20。

type

String

参数解释

分析器的类型。

取值范围

  • account: 账号级外部访问分析器

  • organization:组织级外部访问分析器

  • account_unused_access:账号级未使用访问分析器

  • organization_unused_access:组织级未使用访问分析器

  • account_privilege_escalation:账号级提权访问分析器

  • account_iam_best_practice:账号级IAM最佳实践分析器

urn

String

参数解释

分析器的唯一资源标识符。

取值范围

最大长度为1500。

表4 AnalyzerConfiguration

参数

参数类型

描述

unused_access

unused_access object

参数解释

未使用的访问分析器的配置项。

取值范围

不涉及。

表5 unused_access

参数

参数类型

描述

unused_access_age

Integer

参数解释

生成分析结果的预设天数。

取值范围

最小值为1,最大值为180。

unused_analysis_rule

UnusedAnalysisRule object

参数解释

未使用分析规则。

取值范围

不涉及。

表6 UnusedAnalysisRule

参数

参数类型

描述

exclusions

Array of UnusedAnalysisRuleCriteria objects

参数解释

排除规则。

取值范围

不涉及。

表7 UnusedAnalysisRuleCriteria

参数

参数类型

描述

account_ids

Array of strings

参数解释

组织账号ID列表。创建组织级未使用的访问分析器时可选填,您指定的账号将不会生成分析结果。

您可以通过以下步骤在华为云控制台查看您的组织账号ID列表:

1.登录华为云控制台 。

2.打开页面左上方的服务列表,选择组织 Organizations。

3.单击左侧的账号管理即可看见该组织下的账号ID列表。

取值范围

数组长度为1到2000。数组元素为字符串,最小长度为1,最大长度为36,仅支持包含字母、数字、下划线(_)及中划线(-)。

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

参数解释

标签键。

取值范围

最小长度为1,最大长度为128。支持包含Unicode字母、数字、空格及特殊字符(_ . : = + - @)。

value

String

参数解释

与标签键关联的字符串值。

取值范围

最小长度为0,最大长度为255。支持包含Unicode字母、数字、空格及特殊字符(_ . : / = + - @)。

表10 PageInfo

参数

参数类型

描述

current_count

Integer

参数解释

当前页中的项数。

取值范围

不涉及。

next_marker

String

参数解释

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

取值范围

仅支持包含字母、数字、加号(+)、斜线(/)、等号(=)、下划线(_)和中划线(-)。

请求示例

检索分析器的列表。

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

响应示例

状态码:200

OK

{
  "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
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档