文档首页/ 统一身份认证服务 IAM_统一身份认证服务（新版）/ API参考/ API/ 访问分析/ 分析器/ 创建分析器
更新时间：2025-10-20 GMT+08:00
查看PDF
分享

创建分析器

功能介绍

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

URI

POST /v5/analyzers

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

configuration

否

AnalyzerConfiguration object

分析器的配置项。

name

是

String

分析器的名称。

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

最小长度：1

最大长度：36

数组长度：1 - 2000

resource_tags

否

Array of Tag objects

资源标签列表。

数组长度：1 - 20
表6 Tag

参数

是否必选

参数类型

描述

key

是

String

标签键。

value

是

String

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

响应参数

状态码：201

表7 响应Body参数

参数

参数类型

描述

id

String

分析器的唯一标识符。

urn

String

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

请求示例

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

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

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

响应示例

状态码：201

Created

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

状态码

状态码

描述

201

Created

错误码

请参见错误码。

父主题： 分析器

相关文档