描述
请求
请求结构
请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 |
类型 |
是否必需 |
参数位置 |
描述 |
| - |
Group |
是 |
body |
需要创建的资源分组 |
Group
| 参数名称 |
类型 |
是否必需 |
描述 |
| extra |
String |
否 |
资源组的备注，可以为空。最多存储 256 个字符的文本，只能输入中英文字符和数字。 |
| name |
String |
是 |
资源组的名称，同一账户下的名称不能重复，支持中英文及常见符号-_ /.，1～20个字符，必填 |
返回
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 |
类型 |
描述 |
| groupId |
String |
创建的资源组ID |
示例
请求示例
POST /v1/res/group HTTP/1.1
Authorization： bce-auth-v1/f0c3d360f64211e8acd0d73d11c152de/2018-12-02T16:00:00Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/c022ed024e2cc6cc743858b16efc2ea19c090cb575f3b08b46071be98118a919
{
"name"："测试资源组",
"extra"："测试",
}
返回示例
HTTP/1.1 200 OK
Content-Type： application/json; charset=utf-8
X-Bce-Request-Id： b45001e8-6957-44af-b93d-a4880e61398c
{
"groupId": "RESG-Bih3kin5yOC"
}
错误码
| 错误码 |
错误描述 |
HTTP状态码 |
中文解释 |
| ArgumentInvalid |
group name is missing. |
400 |
资源组名字缺失 |
| ArgumentInvalid |
group name is invalid. |
400 |
资源组名称格式不合法 |
| ArgumentInvalid |
Group extra length is invalid. |
400 |
资源组描述长度不合法 |
| ResourceConflict |
group name already exists. |
409 |
资源组名称已经存在 |
| QuotaExceeded |
Number of group quota is exceeded. |
400 |
资源组超出配额限制 |
