文档首页/ 配置审计 Config/ API参考（吉隆坡区域）/ API/ 资源聚合器/ 创建资源聚合器
更新时间：2026-08-24 GMT+08:00
查看PDF
分享

创建资源聚合器

功能介绍

创建资源聚合器。

调用方法

请参见如何调用API。

URI

PUT /v1/resource-manager/domains/{domain_id}/aggregators

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

账号ID。

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。
表3 请求Body参数

参数

是否必选

参数类型

描述

aggregator_name

是

String

资源聚合器名称。

最小长度：1

最大长度：64

aggregator_type

是

String

聚合器类型（ACCOUNT | ORGANIZATION）。

account_aggregation_sources

否

AccountAggregationSource object

聚合数据的源账号。

tags

否

Array of ResourceTag objects

标签列表
表4 AccountAggregationSource

参数

是否必选

参数类型

描述

domain_ids

否

Array of strings

账号列表。

最小长度：1

最大长度：36

数组长度：1 - 30
表5 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

键。最大长度128个unicode字符。 key符合3.1 KEY字符集规范。

最小长度：1

最大长度：128

value

是

String

值。每个值最大长度255个unicode字符。value符合3.2 VALUE字符集规范。

最小长度：0

最大长度：255

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

aggregator_name

String

资源聚合器名称。

aggregator_id

String

资源聚合器ID。

aggregator_urn

String

资源聚合器标识符。

aggregator_type

String

聚合器类型。

account_aggregation_sources

AccountAggregationSource object

聚合数据的源账号。

updated_at

String

资源聚合器更新时间。

created_at

String

资源聚合器创建时间。

tags

Array of ResourceTag objects

标签列表
表7 AccountAggregationSource

参数

参数类型

描述

domain_ids

Array of strings

账号列表。

最小长度：1

最大长度：36

数组长度：1 - 30
表8 ResourceTag

参数

参数类型

描述

key

String

键。最大长度128个unicode字符。 key符合3.1 KEY字符集规范。

最小长度：1

最大长度：128

value

String

值。每个值最大长度255个unicode字符。value符合3.2 VALUE字符集规范。

最小长度：0

最大长度：255

状态码： 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

请求示例

创建一个账号类型的资源聚合器。

PUT https://{endpoint}/v1/resource-manager/domains/{domain_id}/aggregators

{
  "aggregator_name" : "example_aggregator",
  "aggregator_type" : "ACCOUNT",
  "account_aggregation_sources" : {
    "domain_ids" : [ "3fd23817bd85480e8dc4f520075de348" ]
  }
}

响应示例

状态码： 200

操作成功。

{
  "aggregator_name" : "example_aggregator",
  "aggregator_id" : "7ca3447830bd49c9b630a99680eaf90f",
  "aggregator_urn" : "rms::e74e043fab784a45ad88f5ef6a4bcffc:aggregationAggregator:7ca3447830bd49c9b630a99680eaf90f",
  "aggregator_type" : "ACCOUNT",
  "account_aggregation_sources" : {
    "domain_ids" : [ "3fd23817bd85480e8dc4f520075de348" ]
  },
  "updated_at" : "2020-01-18T02:49:12.465Z",
  "created_at" : "2020-01-18T02:49:12.465Z"
}

状态码

状态码

描述

200

操作成功。

400

输入参数不合法。

403

用户认证失败或无操作权限。

500

服务器内部错误。

错误码

请参见错误码。

父主题： 资源聚合器