创建资源分组（推荐）

功能介绍

创建资源分组

URI

POST /v2/{project_id}/resource-groups

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见“获取项目ID”。约束限制: 不涉及。取值范围: 字符串的长度必须在 1 到 64个字符之间。默认取值: 不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释: 用户Token。约束限制: 不涉及。取值范围: 最小字符数量为1，最大为16384。默认取值: 不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
group_name	是	String	参数解释资源分组的名称约束限制不涉及取值范围只能为字母、数字、汉字、-或_，长度为[1,128]个字符默认取值不涉及
enterprise_project_id	否	String	参数解释资源分组归属企业项目ID 约束限制不涉及取值范围由数字、字母和-组成，或者为0（默认企业项目ID）。默认取值不涉及
type	否	String	参数解释资源分组添加资源方式约束限制不涉及取值范围取值只能为EPS（同步企业项目），TAG（标签动态匹配），NAME（实例名称），COMB（组合匹配），不传为手动添加。默认取值不涉及
tags	否	Array of ResourceGroupTagRelation objects	参数解释标签动态匹配时的关联标签。约束限制 type为TAG时必传，不超过50个标签。
association_ep_ids	否	Array of strings	参数解释该资源分组内包含的资源来源的企业项目ID。约束限制 type为EPS时必传，不超过50个企业项目ID。
providers	否	String	参数解释云服务名称,格式为"dcs,ecs",支持的云服务providers请参考《配置审计API参考》中的"支持的服务和资源类型"章节约束限制不涉及取值范围长度为[0,512]个字符默认取值不涉及
enterprise_project_id_and_tags	否	Array of EnterpriseProjectIdAndTags objects	参数解释匹配企业项目或匹配标签参数。约束限制不超过50个条件。
resources	否	Array of Resource objects	参数解释手动创建时的资源详情。约束限制不超过1000个资源。
product_resources	否	Array of ProductResource objects	参数解释手动创建，选择资源层级为云产品时的资源详情。约束限制不超过50个资源。
instances	否	Array of Instance objects	参数解释实例名称匹配参数。约束限制 type为NAME时必传，不超过50个实例。
product_names	否	String	参数解释创建资源层级为云产品时的云产品的取值，一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id"。多个云产品则用“;”隔开，如"SERVICE.BMS,instance_id;SYS.ECS,instance_id"。约束限制不涉及。取值范围长度[0,10240]个字符默认取值不涉及。
resource_level	否	String	参数解释资源层级，资源生效范围。选择云产品，则云产品及其子层级均可进入该资源分组，选择子维度，则只生效具体的子维度。约束限制不涉及。取值范围 product: 云产品 dimension: 子维度默认取值不涉及。
comb_relation	否	CombRelation object	参数解释组合匹配参数。约束限制不涉及。

表4 ResourceGroupTagRelation
参数	是否必选	参数类型	描述
key	是	String	参数解释 TMS标签键规范约束限制不涉及取值范围长度为[1,128]个字符默认取值不涉及
operator	否	String	参数解释 tag操作符，含义是标签key与value的关系约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等，当operator为equal，value为空字符串时表示为全部 all: 表示全部默认取值不涉及
value	否	String	参数解释 TMS标签值规范约束限制不涉及取值范围长度为[0，255]个字符默认取值不涉及

表5 EnterpriseProjectIdAndTags
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释企业项目ID 约束限制不涉及取值范围由字母、数字、_和-组成，长度为[1,128]个字符默认取值不涉及
tag	否	ResourceGroupTagRelation object	参数解释标签的匹配规则约束限制不涉及

表6 Resource
参数	是否必选	参数类型	描述
namespace	是	String	参数解释查询服务的命名空间，各服务命名空间请参考“服务命名空间” 约束限制不涉及取值范围格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_。字符串的长度必须在 3 到 32个字符之间。默认取值不涉及
dimensions	是	Array of ResourceDimension objects	参数解释资源的维度信息约束限制不超过4个维度

表7 ResourceDimension
参数	是否必选	参数类型	描述
name	是	String	参数解释资源维度，如：弹性云服务器，则维度为instance_id；目前最大支持4个维度，各服务资源的指标维度名称可查看：“服务指标维度”。约束限制不涉及取值范围由字母开头，后面可以包含字母、数字、_或-，长度为[1,32]个字符默认取值不涉及
value	是	String	参数解释资源维度值，为资源的实例ID，如：4270ff17-aba3-4138-89fa-820594c39755。约束限制不涉及取值范围长度为[1,256]个字符默认取值不涉及

表8 ProductResource
参数	是否必选	参数类型	描述
product_name	是	String	参数解释资源所属的云产品，一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id" 约束限制不涉及取值范围长度[0,128]个字符默认取值不涉及
namespace	是	String	参数解释查询服务的命名空间，各服务命名空间请参考“服务命名空间” 约束限制不涉及取值范围格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_。字符串的长度必须在 3 到 32个字符之间。默认取值不涉及
product_instances	是	Array of ProductInstance objects	参数解释产品实例详情约束限制不涉及取值范围不超过1000个实例

表9 ProductInstance
参数	是否必选	参数类型	描述
first_dimension_name	是	String	参数解释资源首层维度，如：弹性云服务器，则维度为instance_id 约束限制不涉及取值范围资源维度，必须以字母开头，只能包含0-9/a-z/A-Z/_/-，维度的最大长度为32。默认取值不涉及
first_dimension_value	是	String	参数解释资源首层维度值，为资源的实例ID，如：4270ff17-aba3-4138-89fa-820594c39755。约束限制不涉及取值范围长度为[1,256]个字符。默认取值不涉及
resource_name	是	String	参数解释资源名称约束限制不涉及取值范围长度[1,128]个字符默认取值不涉及

**表10** Instance
参数	是否必选	参数类型	描述
product_name	是	String	参数解释云产品名称约束限制不涉及取值范围长度为[1,16]个字符默认取值不涉及
logical_operator	是	String	参数解释逻辑运算符约束限制不涉及取值范围 ALL: 所有条件匹配成功 ANY: 任意条件匹配成功默认取值不涉及
instance_names	是	Array of ResourceNameItem objects	参数解释资源名称匹配参数数组约束限制不超过10个名称

**表11** ResourceNameItem
参数	是否必选	参数类型	描述
resource_name	否	String	参数解释资源名称条件值约束限制不涉及取值范围长度[0,128]个字符默认取值不涉及
operator	是	String	参数解释实例操作符，含义是真实资源的名称与资源名称条件值的运算关系。约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等 all: 表示全部默认取值不涉及
resource_name_is_ignore_case	否	Boolean	参数解释资源名称忽略大小写约束限制不涉及取值范围 true: 名称忽略大小写 false: 名称不忽略大小写默认取值 false

**表12** CombRelation
参数	是否必选	参数类型	描述
logical_operator	是	String	参数解释逻辑运算符。约束限制不涉及。取值范围 ALL: 所有条件匹配成功。 ANY: 任意条件匹配成功。默认取值不涉及。
conditions	是	Array of Condition objects	参数解释组合匹配资源分组的匹配条件。约束限制不超过50个条件。

**表13** Condition
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释企业项目ID 约束限制不涉及取值范围由数字、字母和-组成，或者为0（默认企业项目ID）默认取值不涉及
instance_name	否	CombResourceName object	组合匹配资源名称
tag	否	ResourceGroupTagRelation object	参数解释标签的匹配规则约束限制不涉及

**表14** CombResourceName
参数	是否必选	参数类型	描述
resource_name	否	String	参数解释资源名称条件值约束限制不涉及取值范围长度[1,128]个字符默认取值不涉及
operator	是	String	参数解释实例操作符，含义是真实资源的名称与资源名称条件值的运算关系。约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等默认取值不涉及
resource_name_is_ignore_case	否	Boolean	参数解释资源名称忽略大小写约束限制不涉及取值范围 true: 名称忽略大小写 false: 名称不忽略大小写默认取值 false

响应参数

状态码：200

**表15** 响应Body参数
参数	参数类型	描述
group_id	String	参数解释：资源分组ID 约束限制：不涉及。取值范围：以rg开头，后跟22位由字母或数字组成的字符串。长度为[2,24]个字符。默认取值：不涉及。

状态码：400

**表16** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：401

**表17** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：403

**表18** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：500

**表19** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

请求示例

创建名称为rg_test，且资源分组添加资源方式为TAG的资源分组。

{
  "group_name" : "rg_test",
  "enterprise_project_id" : "0",
  "type" : "TAG",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  } ],
  "association_ep_ids" : [ "d61d4705-5658-42f5-8e0c-70eb34d17b02" ]
}