更新时间:2026-09-18 GMT+08:00
分享

创建分析器 - CreateAnalyzer

功能介绍

为您的账号或者组织创建分析器。

调试

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

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

AccessAnalyzer:analyzer:create

Write

analyzer *

-

-

iam:agencies:createServiceLinkedAgencyV5

-

  • g:RequestTag/<tag-key>

  • g:TagKeys

URI

POST /v5/analyzers

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

configuration

否

AnalyzerConfiguration object

参数解释:

分析器的配置项。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

name

是

String

参数解释:

分析器的名称。

约束限制:

必须以字母开头。

取值范围:

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

默认取值:

不涉及。

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最佳实践分析器

默认取值:

不涉及。

表2 AnalyzerConfiguration

参数

是否必选

参数类型

描述

unused_access

否

unused_access object

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 unused_access

参数

是否必选

参数类型

描述

unused_access_age

是

Integer

参数解释:

生成分析结果的预设天数,单位为天。

约束限制:

不涉及。

取值范围:

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

默认取值:

90。

unused_analysis_rule

否

UnusedAnalysisRule object

参数解释:

未使用分析规则。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 UnusedAnalysisRule

参数

是否必选

参数类型

描述

exclusions

否

Array of UnusedAnalysisRuleCriteria objects

参数解释:

排除规则。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表5 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。

默认取值:

不涉及。

表6 Tag

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键。

约束限制:

不能以 _sys_ 开头,首尾不能包含空格。

取值范围:

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

默认取值:

不涉及。

value

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

响应参数

状态码:201

表7 响应Body参数

参数

参数类型

描述

id

String

参数解释:

分析器的唯一标识符。

取值范围:

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

urn

String

参数解释:

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

取值范围:

最大长度为1500。

请求示例

为您的账号或者组织创建分析器。

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

{
  "name" : "my-analyzer",
  "tags" : [ {
    "key" : "key-1",
    "value" : "value-1"
  } ],
  "type" : "account"
}

响应示例

状态码:201

{
  "id" : "{analyzer_id}",
  "urn" : "AccessAnalyzer:{region_id}:{domain_id}:analyzer:{analyzer_id}"
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

相关文档