创建资源分组
功能介绍
创建资源分组
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/resource-groups
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
租户ID 最小长度：1 最大长度：64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
租户Token 最小长度：1 最大长度：16384 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
group_name |
是 |
String |
资源分组的名称，只能为字母、数字、汉字、-、_，最大长度为128 最小长度：1 最大长度：128 正则匹配：^([\u4E00-\u9FFF]|[a-z]|[A-Z]|[0-9]|_|-)+$ |
enterprise_project_id |
否 |
String |
资源分组归属企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ |
type |
否 |
String |
资源分组添加资源方式，取值只能为EPS（同步企业项目）,TAG（标签动态匹配）,不传为手动添加 正则匹配：^(EPS|TAG|Manual|COMB)$ |
tags |
否 |
Array of ResourceGroupTagRelation objects |
标签动态匹配时的关联标签,type为TAG时必传 数组长度：1 - 10 |
association_ep_ids |
否 |
Array of strings |
该资源分组内包含的资源来源的企业项目ID，type为EPS时必传 数组长度：1 - 10 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
group_id |
String |
资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度：0 最大长度：256 |
error_msg |
String |
请求异常信息 最小长度：0 最大长度：256 |
request_id |
String |
请求ID 最小长度：0 最大长度：256 |
状态码： 401
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度：0 最大长度：256 |
error_msg |
String |
请求异常信息 最小长度：0 最大长度：256 |
request_id |
String |
请求ID 最小长度：0 最大长度：256 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度：0 最大长度：256 |
error_msg |
String |
请求异常信息 最小长度：0 最大长度：256 |
request_id |
String |
请求ID 最小长度：0 最大长度：256 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度：0 最大长度：256 |
error_msg |
String |
请求异常信息 最小长度：0 最大长度：256 |
request_id |
String |
请求ID 最小长度：0 最大长度：256 |
请求示例
创建名称为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" ]
}
响应示例
状态码： 200
Created
{
"group_id" : "rg0123456789xxx"
}
状态码
状态码 |
描述 |
|---|---|
200 |
Created |
400 |
参数校验失败 |
401 |
未认证 |
403 |
认证鉴权失败 |
500 |
系统内部错误 |
错误码
请参见错误码。
